API SendLote

El método 'SendLote' permite ingresar una lista de números de telefonía móvil en el sistema. Dichos números serán cotejados con nuestra base de datos y se retorna la información correspondiente a los últimos movimientos de portabilidad.

Url: https://portabilidad.coverone.la/api/sendlote

Código de ejemplo

Microsoft .Net

Java

Python

Php

Parametros de llamada

Detalle:

{
  "UserName": "[texto] Usuario asinado por CoverOne (OBLIGATORIO)",
  "Token": "[texto] Token (key) asinado por CoverOne (OBLIGATORIO)",
  "CountryCode": "[texto] '+54' (VALOR FIJO)",
  "BulkCod": "[texto] Código que identifica la llamada, si llega vacío se asigna uno (OPCIONAL)",
  "WebhookUrl": "SIN USO",
  "Mode": "SIN USO",
  "Numbers": [
    {
      "ExtCode": "[texto] Código que identifica el número enviado (único por llamada) (OBLIGATORIO)",
      "PhoneNumber": "[texto] Número de telefonía móvil a procesar, sin el 15 y debe incluir el código de área (OBLIGATORIO)"
    }
  ]
}

Cantidad máxima de números por llamada: 15000

Ejemplo:

{
  "UserName": "juanperez",
  "Token": "T4K2NP1R1J51NP2R2Z",
  "CountryCode": "+54",
  "BulkCod": "C4D3G4",
  "WebhookUrl": "",
  "Mode": "",
  "Numbers": [
    {
      "ExtCode": "num001",
      "PhoneNumber": "1187654321"
    },
    {
      "ExtCode": "num002",
      "PhoneNumber": "1122334455"
    },
    {
      "ExtCode": "num003",
      "PhoneNumber": "1132453234"
    },
    {
      "ExtCode": "num004",
      "PhoneNumber": "1234"
    }
  ]
}

Parametros de respuesta

Detalle:

{
  "Success": "[booleano] true: Lote procesado, false: Lote NO procesado",
  "BulkCod": "[texto] Código recibido en la llamada",
  "ErrorCode": "[texto] Código de Error (solo Success=false)",
  "ErrorMessage": "[texto] Mensaje de Error (solo Success=false)",
  "ProcessDate": "[fecha y hora] Fecha y Hora correspondiente a la transacción",
  "TransacctionId": "[texto] Código único, asigando por el sistema, identificador de la transacción",
  "Numbers": [
    {
      "Status": "[numero] 1/2/3/4",
      "NormalizedPhoneNumber": "[texto] número normalizado",
      "CurrentCompany": "[texto] Compañía actual de telefonía móvil",
      "CurrentCompanyName": "[texto] Nombre completo compañía actual",
      "ErrorMessage": "[texto] mensaje de error (solo Status != 1)",
      "PreviousCompany": "[texto] Compañía anterior de telefonía móvil",
      "OriginalCompany": "[texto] Compañía original de telefonía móvil",
      "UpdateDate": "[fecha y hora] Fecha y Hora correspondiente al cambio de compañia",
      "ExtraData": "SIN USO"
    }
  ]
}

ErrorCod/ErrorMessage:
    01: DATOS RECIBIDOS INVÁLIDOS
    02: USUARIO/TOKEN INVÁLIDO
    04: CRÉDITOS INSUFICIENTES 
    05: CLIENTE NO HABILITADO
    06: NÚMEROS INVÁLIDOS
    99: NO SE PUDO DETERMINAR LOS CRÉDITOS DISPONIBLES
Status
    1: Válido
    2: No Válido (número con error de formato)
    3: Error al procesar el número (detalle en ErrorMessage)
    4: El sistema NO posee información de portabilidad. Número válido de telefonía móvil.
    Se retorna la compañía identificada mediante los segmentos del número.
CurrentCompany/PreviousCompany/OriginalCompany:
    CLARO
    MOVISTAR
    PERSONAL
    NEXTEL

Ejemplo:

{
  "Success": "true",
  "BulkCod": "C4D3G4",
  "ErrorCode": "",
  "ErrorMessage": "",
  "ProcessDate": "2021-06-14T07:44:28.4119759-03:00",
  "TransacctionId": "20210614074428-1199042226",
  "Numbers": [
    {
      "ExtCode": "num001",
      "PhoneNumber": "1187654321",
      "Status": "3",
      "NormalizedPhoneNumber": "1187654321",
      "CurrentCompany": "",
      "CurrentCompanyName": "",
      "ErrorMessage": "NÚMERO NO IDENTIFICADO O NO PERTENECE A TELEFONÍA MÓVIL",
      "PreviousCompany": "",
      "OriginalCompany": "",
      "UpdateDate": "",
      "ExtraData": ""
    },
    {
      "ExtCode": "num002",
      "PhoneNumber": "1122334455",
      "Status": "3",
      "NormalizedPhoneNumber": "1122334455",
      "CurrentCompany": "MOVISTAR",
      "CurrentCompanyName": "TELEFONICA MOVILES ARGENTINA SOCIEDAD ANONIMA",
      "ErrorMessage": "NÚMERO SIN INFORMACIÓN DE PORTABILIDAD",
      "PreviousCompany": "MOVISTAR",
      "OriginalCompany": "MOVISTAR",
      "UpdateDate": "",
      "ExtraData": ""
    },
    {
      "ExtCode": "num003",
      "PhoneNumber": "1132453234",
      "Status": "1",
      "NormalizedPhoneNumber": "1132453234",
      "CurrentCompany": "MOVISTAR",
      "CurrentCompanyName": "TELEFONICA MOVILES ARGENTINA SOCIEDAD ANONIMA",
      "ErrorMessage": "",
      "PreviousCompany": "PERSONAL",
      "OriginalCompany": "CLARO",
      "UpdateDate": "2015-11-13T05:00:00",
      "ExtraData": ""
    },
    {
      "ExtCode": "num004",
      "PhoneNumber": "1234",
      "Status": "2",
      "NormalizedPhoneNumber": "1234",
      "CurrentCompany": "",
      "CurrentCompanyName": "",
      "ErrorMessage": "NUMERO CON MENOS DE 8 DIGITOS",
      "PreviousCompany": "",
      "OriginalCompany": "",
      "UpdateDate": "2015-11-13T05:00:00",
      "ExtraData": ""
    }
  ]
}