Está en la página 1de 24

Contenido

Activar SIM...................................................................................................................................3
Prefijos válidos.........................................................................................................................3
Preguntas de seguridad............................................................................................................3
Activar SIM - POST....................................................................................................................4
Asociar línea.................................................................................................................................5
Validar ANI...............................................................................................................................5
Verificar código........................................................................................................................5
Canje............................................................................................................................................6
Compras.......................................................................................................................................6
Combos (comprar más)............................................................................................................6
Comprar con saldo – POST.......................................................................................................9
Consumos.....................................................................................................................................9
Combos..................................................................................................................................10
Internet..............................................................................................................................10
Llamadas............................................................................................................................10
SMS....................................................................................................................................11
Detail......................................................................................................................................11
Internet..............................................................................................................................12
Llamadas............................................................................................................................12
SMS....................................................................................................................................13
Extras......................................................................................................................................13
Consumos Extras........................................................................................................................14
Internet..............................................................................................................................14
Llamadas............................................................................................................................14
SMS....................................................................................................................................15
Cuenta........................................................................................................................................15
Líneas.....................................................................................................................................15
Pelochos + saldo + fecha expiración + íconos.........................................................................15
Badge:................................................................................................................................17
Pelocho:..............................................................................................................................18
Movimientos..............................................................................................................................19
Recargas.....................................................................................................................................21
Saldos.........................................................................................................................................23
Activar SIM
Prefijos válidos
Son los prefijos válidos para Tuenti. Es un array de string con el listado de prefijos.

["11", "223", "2320"]
Preguntas de seguridad
Para el get tendríamos que pasar el número de documento y el género.

Siempre son 2 preguntas de seguridad.

{
    "Questions": [
        {
            "QuestionId": 1,
            "Question": "¿Conocés a Lionel Messi?",
            "Options": ["Si", "No"]
        },
        {
            "QuestionId": 2,
            "Question": "¿En qué club juega Messi?",
            "Options": ["Barcelona", "PSG", "Manchester City"]
        }
    ],
    "Reference": "792020-20263060017",
    "User": 462513
}

Campo Descripción Tipo de datos


Reference Referencia String
Questions Las preguntas de seguridad Array de Question
User ID de usuario Numérico

Questions:

Campo Descripción Tipo de datos


QuestionId Es el ID de la pregunta Numérico
Question La pregunta String
Options Son las opciones de respuesta Array de opciones
Options:
Campo Descripción Tipo de datos
Id Es el ID de la respuesta Numérico
Text Texto de la respuesta String

Activar SIM - POST


Este es el POST de los datos cargados en el FE para Activar el chip, primero tiene que validar:

1- Que el Chip (ICC) exista y no haya sido activado con anterioridad.


2- Las respuestas a las preguntas de seguridad sean válidas

{
    "ICC": "8954010111081654793",
    "Prefix": 11,
"Reference": "792020-20263060017",
    "Responses": [
        {
            "QuestionId": 17,
            "ResponseId": 0
        },
        {
            "QuestionId": 2,
            "ResponseId": 2
        }
    ]
}

Campo Descripción Tipo de datos


ICC Número de SIM String
Prefix Prefijo de línea. ¿se usa para activar el chip? Numérico
Reference El número de referencia para activar el chip String
Responses Las respuestas a las preguntas de seguridad Array de Response
Response:

Campo Descripción Tipo de datos


QuestionId Id de la pregunta Numérico
ResponseId Id de la respuesta Numérico
Asociar línea
Validar ANI
Antes de enviar el SMS tiene que realizarse la validación del ANI cargado.

{
    "ani": 12345567890
}

Campo Descripción Tipo de datos


ani El ani a asociar Numérico

En la respuesta tiene que venir lo siguiente:

{
    "Error": false,
    "ErrorMsj": "El número que has introducido no es de Tuenti"
}

Campo Descripción Tipo de datos


Error Si tuvo o no error la asociación Bool
ErrorMsj El mensaje de error String

Por el momento detectamos 4 tipos de errores:

- El número de teléfono ya está asociado


- El número de teléfono no es válido
- El número que has introducido no es de Tuenti
- La línea que asocies debe tener el mismo DNI que la línea que tenés asociada
actualmente. También podés crear un nuevo registro con esa línea

Verificar código
Acá es cuando verifica el código enviado al SMS.

{
    "Code": "1234567"
}

Campo Descripción Tipo de datos


Code El código que se envió por SMS string
Canje
"Canje": [
        {
            "Id": 1,
            "Texts": ["Te regalamos 1GB", "Válido por 1 día a partir de
su activación"],
            "Title": "Cumple Tuenti"
        },
        {
            "Id": 2,
            "Texts": ["Te regalamos 1GB ", " Válido por 1 día a partir de
su activación "],
            "Title": "Aniversario Tuenti"
        }
]

Con este servició se obtendrán los premios canjeables. Es un array donde cada ítem tiene:

Campo Descripción Tipo de datos


Id Es el Id del productoVinculado, que es el Numérico
Id que se usa a la hora de canjear el
premio.
Texts Descripción detallada del canje. Array de string
Title Título para identificar el canje. String

Compras
Combos (comprar más)
{
    "Balance": 100.00,
"CurrencySymbol": "$",
    "Data": [
        {
            "Id": 1,
            "Amount": 60,
            "Texts": ["+ WhatsApp Gratis", "Caduca en 1 día"],
            "Title": "Extra Día 1 GB x 24hs"
        },
        {
            "Id": 2,
            "Amount": 70,
            "Texts": ["2 GB YouTube y TikTok + Whatsapp Gratis", "Caduca 
en 7 días"],
            "Title": "Extra Influencer"
        },
        {
            "Id": 3,
            "Amount": 90,
            "Texts": ["+ 500 MB YouTube y TikTok + WhatsApp Gratis", "Cad
uca en 3 día"],
            "Title": "Extra 1 GB x 3 días"
        },
        {
            "Id": 4,
            "Amount": 150,
            "Texts": ["+ 1 GB YouTube y TikTok + WhatsApp Gratis", "Caduc
a en 3 día"],
            "Title": "Extra 3 GB x 3 días"
        }
    ],
    "Call": [
        {
            "Id": 5,
            "Amount": 60,
            "Texts": ["Caduca en 7 días"],
            "Title": "Extra 25 MIN"
        },
        {
            "Id": 6,
            "Amount": 90,
            "Texts": ["Caduca en 7 días"],
            "Title": "Extra 50 MIN"
        }
    ],
    "SMS": [
        {
            "Id": 7,
            "Amount": 35,
            "Texts": ["Caduca en 1 día"],
            "Title": "Extra 500 SMS"
        }
    ],
"Combos": [
        {
            "Id": 8,
            "Amount": 150,
            "Texts": ["500 SMS, 500 MIN Tuenti, 50 MIN y Whatsapp
ilimitado", "Caduca en 30 días"],
            "Title": "Extra mini"
        },
{
            "Id": 9,
            "Amount": 150,
            "Texts": ["2 GB, 50 SMS, 50 MIN y Whatsapp ilimitado",
"Caduca en 7 días"],
            "Title": "Combo semana"
        }

    ]
}

Con este servició se obtendrá el Balance la línea y los combos disponibles que podrá comprar.

Campo Descripción Tipo de datos


Balance Balance de la línea que consulta. Numérico
Tipo de moneda, por el momento solo $
CurrencySymbol
pesos
Data Listado de combos para datos Array de Item
Call Listado de combos para llamadas Array de Item
SMS Listado de combos para SMS Array de Item
Combos Listado de combos Array de Item

Item

Campo Descripción Tipo de datos


Id Identificador único del combo. Entero positivo.
Amount Ese el valor del combo. Numérico positivo
Texts Descripción detallada del combo. Array de string
Title Título para identificar el combo. String

Comprar con saldo – POST


Cuando la compra de combo se realiza usando parte del saldo de la cuenta. Habría que
asignarle ese combo y descontar ese monto de su saldo.

{
    "IdCombo": 1,
    "Amount": 85.00,
    "Ani": 541122540040
}

Campo Descripción Tipo de datos


IdCombo El Id del combo que se seleccionar Numérico
Amount El monto a descontar al saldo Numérico
Ani El ANI al que hay que asignarle el combo y descontarle del Numérico
saldo

Consumos
El formato del json es el mismo para Internet (Data), Llamadas (Call) y SMS.Como parámetro
pasamos el ANI a consultar y el tipo que puede ser: Data, Call o SMS.

{
    "Combos": [
        {
            "Texts": ["Combo Hit 3GB", "Caduca el 11 jun '21"],
            "Title": "3 GB de 3 GB"
        }
    ],
    "Detail": [        
        {
            "Date": "19/05/2021",
            "Items": []
        },
        {
            "Date": "20/05/2021",
            "Items": [
                {
                    "Amount": 0,
                    "Texts": ["Datos"],
                    "Title": "20,4 MB",
                    "Value": 21390878
                }
            ]
        }
    ],
"Extras": {
        "Amount": 10.00,
        "CurrencySymbol": "$"
    }
}

Combos
"Combos": [
        {
            "Texts": ["Combo Hit 3GB", "Caduca el 11 jun '21"],
            "Title": "3 GB de 3 GB"
        }
    ]

Combos es el array de “combos” adquiridos por el usuario y está compuesto por:

Campo Descripción Tipo de datos


Texts Son los textos que acompañan al título y se tienen que Array
ordenar según el orden de aparición de arriba hacia abajo. Por
el momento tienen el nombre del combo y la fecha de
caducidad
Title Es la cantidad disponible sobre el total de datos, minutos y String
SMS.
Internet
Este print lo saqué de desa.

Llamadas
Este print lo saqué de producción.
SMS
Este print lo saqué de producción.

Detail
Muestra el detalle de consumos de los últimos 30 días. Cada ítem de detail es un día.

Se utiliza para armar el gráfico de consumos, calcular el consumo acumulado, consumo medio
y mostrar el detalle de consumo.

El formato es el mismo para Internet (Data), Llamadas (Call) y SMS

"Detail": [        
        {
            "Date": "19/05/2021",
            "Items": []
        },
        {
            "Date": "20/05/2021",
            "Items": [
                {
                    "Amount": 0,
                    "Texts": ["Datos"],
                    "Title": "20,4 MB",
                    "Value": 21390878
                }
            ]
        }
    ]

Detail es un array con los consumos de los últimos 30 días.

Campo Descripción Tipo de datos


Date Fecha en el que se realiza el consumo String: dd/mm/aaaa
Items Trae el detalle de consumo Array

Items está compuesto por:


Campo Descripción Tipo Tipo de datos
Amount Ese el monto consumido en pesos Todos Numérico
Internet Array que sólo contiene el ítem
Son los textos que acompañan al “Datos”
título y se tienen que ordenar Llamadas Array que contiene 2 ítems: “HH:MM”
Texts
según el orden de aparición de y “SMS – Enviado”
arriba hacia abajo. SMS Array que contiene 2 ítems: “HH:MM”
y “SMS – Enviado”

Internet

Campo Descripción Tipo de datos


Amount Ese el monto consumido en pesos Numérico
Son los textos que acompañan al título y se
Array que sólo contiene el ítem
Texts tienen que ordenar según el orden de aparición
“Datos”
de arriba hacia abajo.
Title Es la cantidad de MB consumidos. Ej: 20.4 MB String
Value Es la cantidad consumida en bytes Numérico

Llamadas

Campo Descripción Tipo de datos


Amount Ese el monto consumido en pesos Numérico
Array que sólo contiene 2 ítems:
- La hora (HH:MM) y los
Son los textos que acompañan al título y se
segundos o minutos
Texts tienen que ordenar según el orden de aparición
consumidos
de arriba hacia abajo.
- “Llamada – saliente” o
“Llamada – entrante”
Title Es el ANI con el que se comunicó el cliente String
Value Es la cantidad consumida en segundos Numérico
SMS

Campo Descripción Tipo de datos


Amount Ese el monto consumido en pesos Numérico
Son los textos que acompañan al título y se Array que sólo contiene 2 ítems:
Texts tienen que ordenar según el orden de aparición - La hora (HH:MM)
de arriba hacia abajo. - “SMS - Enviado”
Title Es el ANI con el que se comunicó el cliente String
Value Es la cantidad consumida de SMS Numérico

Extras
El formato del json es el mismo para Internet (Data), Llamadas (Call) y SMS.

"Extras": {
        "Amount": 10.00,
        "CurrencySymbol": "$"
    }
Es el monto extra consumido y la moneda (por ahora siempre va $).
Consumos Extras
{
    "CurrencySymbol": "$",
    "DetailExtras": [        
        {
            "Date": "02/06/2021",
            "Items": []
        },
        {
            "Date": "03/07/2021",
            "Items": [
                {
                    "Amount": -5,
                    "Texts": ["Datos"],
                    "Title": "69 KB",
                    "Value": 5
                }
            ]
}        
    ]
}

Se agrega el símbolo de la moneda ($). La fecha (Date) es lo mismo que en consumos. Los
ítems son los mismos que en consumo solo que el monto (Amount) va con signo negativo.

Internet
Campo Descripción Tipo de datos
Amount Ese el monto consumido en pesos Numérico negativo
Son los textos que acompañan al título y se
Array que sólo contiene el ítem
Texts tienen que ordenar según el orden de aparición
“Datos”
de arriba hacia abajo.
Title Es la cantidad de MB consumidos. Ej: 20.4 MB String
Value Ese el monto consumido en pesos Numérico

Llamadas
Campo Descripción Tipo de datos
Amount Ese el monto consumido en pesos Numérico negativo
Array que sólo contiene 2 ítems:
- La hora (HH:MM) y los
Son los textos que acompañan al título y se
segundos o minutos
Texts tienen que ordenar según el orden de aparición
consumidos
de arriba hacia abajo.
- “Llamada – saliente” o
“Llamada – entrante”
Title Es el ANI con el que se comunicó el cliente String
Value Ese el monto consumido en pesos Numérico
SMS
Campo Descripción Tipo de datos
Amount Ese el monto consumido en pesos Numérico negativo
Son los textos que acompañan al título y se Array que sólo contiene 2 ítems:
Texts tienen que ordenar según el orden de aparición - La hora (HH:MM)
de arriba hacia abajo. - “SMS - Enviado”
Title Es el ANI con el que se comunicó el cliente String
Value Ese el monto consumido en pesos Numérico

Cuenta
Líneas

[
    {
        "Id": 541122509555, à Id único
        "Line": "011 2250-9555", à ANI
        "Segment": "Línea móvil · Prepago" à El tipo de línea
    },
    {
        "Id": 541173624452,
        "Line": "011 7362-4452",
        "Segment": "Línea móvil · Prepago"
    }
]

Pelochos + saldo + fecha expiración + íconos


Como parámetro pasamos el ANI a consultar.

{
    "Badge": [
        {            
            "Asset": "TuentiLogo",            
            "Text": "App Tuenti"
        },
        {
            "Asset": "WhatsappLogo",
            "Text": "WhatsApp Gratis"
        }
    ],
"Balance": 100.00,
"CurrencySymbol": "$",
    "ExpirationDay": "25 de oct",
    "Pelochos": [
        {
            "id": 1,
            "consumed": 2147483648,
            "expires": "11 jun '21",
            "link": "Data”,
            "remaining": 8589934592,
            "status": "ok",
            "title": "Datos móviles",
            "type": "DATA_BYTES"
        },
        {
            "id": 2,
            "consumed": 0,
            "expires": " 11 jun '21",
            "link": "Data",
            "remaining": 2147483648,
            "status": "ok",
            "title": "Youtube y TikTok",
            "type": "DATA_BYTES"
        },
        {
            "id": 3,
            "consumed": 0,
            "expires": "11 jun '21",
            "link": "Data",
            "remaining": 0,
            "status": "unlimited",
            "title": "Spotify y Whatsapp",
            "type": "DATA_BYTES"
        },
        {
            "id": 4,
            "consumed": 0,
            "expires": "11 jun '21",
            "link": "Call",
            "remaining": 180000,
            "status": "ok",
            "title": "Minutos",
            "type": "VOICE_CALL_SECONDS"
        },
        {
            "id": 5,
            "consumed": 0,
            "expires": "11 jun '21",
            "link": "SMS",
            "remaining": 3000,
            "status": "ok",
            "title": "SMS",
            "type": "SMS"
        }
    ]
}

Badge:

Por el momento solamente vi 2 tipos de logos (Asset) en la app productiva. Las opciones de
Asset pueden ser:

- TuentiLogo
- WhatsappLogo

Algunas propiedades cambian dependiendo si son para Internet (Data), Llamadas (Call) o
mensajes (SMS), el resto se mantienen igual para todos los tipos.
Pelocho:

Campo Descripción Tipo Tipo de valores


id El Id tiene que ser único Todos Numérico
expires Fecha de expiración Todos nro mes año
Internet Bytes
consumed Consumos Llamadas Segundos
Mensajes Cantidad de SMS
Internet Data
A qué sección tendría que redireccionar
link Llamadas Call
el pelocho
Mensajes SMS
Internet Bytes
remaining Consumo restante Llamadas Segundos
Mensajes Cantidad de SMS
Verde ok
status De esto depende el color del pelocho
Gratis unlimited
title El título del pelocho Todos Texto
Internet DATA_BYTES
Define el texto que acompaña a los
type Llamadas VOICE_CALL_SECONDS
consumos
Mensajes SMS
Movimientos
Existen los movimientos de ingreso y egreso de crédito. Para el egreso pueden ser por compra
de combos o gastos en datos, llamadas y/o SMS sin tener un combo activo.

[
    {
        "Date": "11/06/2021",
        "Movements": [
            {
                "Amount": -800.00,
                "Time": "16:45",
                "Title": "Max 6GB",
                "Type": "Compra"
            },
            {
                "Amount": 750.00,
                "Time": "14:45",
                "Title": "Recarga de saldo",
                "Type": "Recarga"
            }
        ]
    },
{
        "Date": "04/06/2021",
        "Movements": [
            {
                "Amount": -50.00,
                "Time": "14:00 1m 31s",
                "Title": "011 4157-8295",
                "Type": "Llamada-saliente"
            }
        ]
    },
    {
        "Date": "01/06/2021",
        "Movements": [
            {
                "Amount": 50.00,
                "Time": "14:45",
                "Title": "Recarga de saldo",
                "Type": "Recarga"
            }
        ]
    }
]
Campo Descripción Tipo de valores
Date Fecha en el que se realiza el movimiento. String: dd/mm/aaaa
Tiene que estar ordenado de mayor a
menor
Movements Los movimientos realizados en el día. Array de movements

Movements:

Existen varios tipos: Compra, Compra de bono, Datos, Llamada - saliente, Recarga, SMS -
enviado.

Campo Tipo Descripción Tipo de valores


Amount Todos El monto consumido o cargado Numérico positivo o
negativo
Todos menos Llamada Hora y minutos que se realiza la HH:MM
- saliente operación
Time Llamada - saliente Hora y minutos que se realiza la HH:MM mm ss
operación y la duración de la
misma. Ej: 20:16 1m 31s
Compra El título del combo que se compra String
Compra de bono Para los consumos sin combos, se String
compran “bonos”. Ej.: Día 200 MB
Datos Cantidad de datos consumidos. String
Expresados en KB o MB.
Title
Llamada - saliente El ANI al que se llama. Ej.: 011 String
4157-8295
Recarga Para la recarga de saldo String
SMS - enviado El ANI al que se envía SMS. Ej.: String
011 4157-8295
Type Todos Los tipos: Compra, Compra de String
bono, Datos, Llamada - saliente,
Recarga, SMS - enviado.

Más ejemplos de movimientos. De una de las líneas (sin combo) de Seba:


Recargas
Como parámetro pasamos el ANI a consultar.

Existen 2 tipos de recargas: cuando el cliente tiene combo activo y cuando el cliente no tiene
combo activo.

El formato del json es el mismo para los dos y lo único que cambia es en contenido del array de
Combos.

{
    "Balance": 105.00,
    "Combos": [
        {
            "Amount": 500,
            "Description": "3GB, 1000 SMS, 3000 MIN y Whatsapp ilimitado"
,
            "Title": "Combo Hit"            
        },
        {
            "Amount": 620,
            "Description": "6GB, 2000 SMS, 3000 MIN, Whatsapp ilimitado y 
Tuenti ilimitado",
            "Title": "Combo Max"            
        }
    ],
    "CurrencySymbol": "$",
    "Values": {
        "Max": 3000,
        "Min": 5,
        "MinCombo": 500
    }    
}
Campo Tipo Descripción Tipo de valores
Balance Es el saldo que tiene Numérico
$
Tipo de moneda, por el momento solo
CurrencySymbol
pesos
Numérico
Max El importe máximo que se puede cargar

Numérico
Values
Min El importe mínimo que se puede cargar

Numérico
MinCombo El precio del combo más barato
ANI con Array de combo
El array va vacío
combo activo
Combos
ANI sin combo Listado de combos ordenados de menor Array de combo
activo precio a mayor

Combo:

Campo Descripción Tipo de valores


Amount El precio del combo Numérico
String
Pequeña descripción con las cosas que tiene
Description
el combo
String
Title Título del combo
Saldos
Como parámetro pasamos el ANI a consultar.

{
    "Balance": 100.00,
    "BalanceTypes": [
        {
            "Id": 1,
            "Amount": 100.50,
            "CurrencySymbol": "$",
            "Status": "Active",
            "Texts": ["Caduca el 3 oct"],
            "Title": "Crédito de recargas",
            "Type": "Reload"
        }
    ],
    "CurrencySymbol": "$"

Campo Descripción Tipo de valores


Id El Id tiene que ser único Numérico
Amount El monto a mostrar numérico con hasta 2
decimales
$
Tipo de moneda, por el momento
CurrencySymbol
solo pesos
Active
El estado. Por el momento solo
Status
conocemos un estado
[string]
Los textos que se muestran en cada
Texts
tipo de saldo
string
Title El título del tipo de saldo
Type El tipo de saldo, solo conocemos un Reload
tipo

También podría gustarte