Documento de Integración de Web Service

saleRequest
____________________________________________________________
Tiene como objetivo realizar las transacciones de Pago de Servicio,

es el único método transaccional del Web Service.

Parámetros: saleRequest

Parámetro Nombre Formato Mandatario Descripción

Ticket recibido con el

ticket String Si
método login. Parámetros
Id de la Tienda a la que obtenidos del
storeId Integer Si método
pertenece el usuario.
login.
accountNo String Si Número de cuenta.

El Id Externo debe contener un prefijo

String compuesto por 3 caracteres que será
proporcionado por personal de
(Máx. 30 KONNECTA, seguido de una cadena
externalId caractere Si de caracteres generado por el cliente,
s este debe ser único en el día. En caso
alfanumé de enviar el mismo externalId la
-ricos) transacción no procesara y notificara
Entrada que el ID ya existe.

Ver “Product_Id” en la tabla B de

productId String Si
productos para el envío de la recarga.
accountNa Nombre al cual pertenece la cuenta del
String
me servicio a pagar.
Reference String Si Número al que se abonara el saldo.

Anexo a referencia en caso de ser

necesario para el proveedor. Ejemplo
auxiliary String Si
TELMEX (Auxiliar = Digito
verificador)

1 de 13
 Documento de Integración de Web Service

amount String Monto a procesar del servicio.

Id externo de transacción
externalId String
proporcionado como dato de entrada.

Id de Producto proporcionado como

productId String
dato de entrada.

accountNa Nombre al cual pertenece la cuenta del

me String servicio a pagar.
Número al que se solicitó se aplicara la
Reference String recarga proporcionado como dato de
entrada.
Anexo a referencia en caso de ser
auxiliary String necesario para el proveedor. Ejemplo
TELMEX (Auxiliar = Digito
verificador)
Salida
Monto procesado por el servicio (dato
amount String
de entrada)

charge String Comision cobrada al Cliente final

Código de Respuesta (ver códigos de

trnresponse String
respuesta)
trncarrier String Número de transacción - autorizacion.
trndate String Fecha de la transacción. (yyyy/MM/dd)
trntime String Hora de la transacción. (HH/mm/ss)

trnno String Numero de transaccion Konnecta

seller String User venta

2 de 13
 Documento de Integración de Web Service

saleCheck
_______________________________________________________________
Tiene como objetivo consultar las transacciones de Pago de Servicio, este método sirve
para consultar el estatus de una transacción en caso de pérdida de comunicación o algún
problema en el medio que provoque el desconocimiento del resultado final de dicha
transacción en particular, se busca con el externalId que el cliente haya provisto.

Parámetros: saleCheck

Parámetro Nombre Formato Mandatario Descripción

ticket String Si Ticket recibido con el método login.

Entrada
El Id Externo de la transacción
externalId String Si
específica a la entrada.

Id externo de transacción
externalId String
proporcionado como dato de entrada.
Id de Producto proporcionado como
productId String
dato de entrada.

accountNam Nombre al cual pertenece la cuenta

String
e del servicio a pagar.

Número al que se solicitó se aplicara

Reference String la recarga proporcionado como dato
de entrada.
Anexo a referencia en caso de ser
necesario para el proveedor. Ejemplo
auxiliary String
TELMEX (Auxiliar = Digito
verificador)
Salida Monto procesado por el servicio
amount String
(dato de entrada)

charge String Comision cobrada al Cliente final

3 de 13
 Documento de Integración de Web Service

Código de Respuesta (ver códigos de

trnresponse String
respuesta)

Número de transacción -
trncarrier String
autorizacion.
Fecha de la transacción. (yyyy/MM/
trndate String
dd)

trntime String Hora de la transacción. (HH/mm/ss)

trnno String Numero de transaccion Konnecta

seller String User venta

4 de 13
 Documento de Integración de Web Service

consultRequest
____________________________________________________________
Tiene como objetivo realizar consulta de saldo Pago de Servicio.

Parámetros: consultRequest

Parámetro Nombre Formato Mandatario Descripción

Ticket recibido con el

ticket String Si
método login. Parámetros
Id de la Tienda a la que obtenidos del
storeId Integer Si método
pertenece el usuario.
login.
accountNo String Si Número de cuenta.
Ver “Product_Id” en la tabla B de
productId String Si
productos para el envío de la recarga.
accountNa Nombre al cual pertenece la cuenta del
Entrada String
me servicio a pagar.
reference String Si Número al que se abonara el saldo.

Anexo a referencia en caso de ser

necesario para el proveedor. Ejemplo
auxiliary String Si TELMEX (Auxiliar = Digito
verificador)

amount String Monto a procesar del servicio.

Id de Producto proporcionado como

productId String
dato de entrada.

accountNa Nombre al cual pertenece la cuenta del

me String servicio a pagar.
Número al que se solicitó se aplicara la
Reference String recarga proporcionado como dato de
entrada.

5 de 13
 Documento de Integración de Web Service

Anexo a referencia en caso de ser

necesario para el proveedor. Ejemplo
auxiliary String
TELMEX (Auxiliar = Digito
verificador)

Salida Monto procesado por el servicio (dato

amount String
de entrada)

charge String Comision cobrada al Cliente final

Código de Respuesta (ver códigos de

trnresponse String
respuesta)
trncarrier String Número de transacción - autorizacion.
trndate String Fecha de la transacción. (yyyy/MM/dd)
trntime String Hora de la transacción. (HH/mm/ss)

trnno String Numero de transaccion Konnecta

seller String User venta

6 de 13
 Documento de Integración de Web Service

Conciliación

¿Qué es?

La conciliación de saldos es una herramienta que nos permite comparar el registro propio
de las transacciones para un determinado cliente, contra los registros contenidos en la
base de datos general encargada de almacenar la totalidad de las transacciones de la
plataforma.

De esta forma, se busca generar certeza, tanto para el cliente como para el proveedor de
servicios con respecto al manejo de las transacciones y la afectación de estas a los saldos
individuales para cada cliente.

Estructura del Nombre del Archivo

El nombre del archivo de conciliación debe estructurarse de acuerdo a la siguiente tabla:

Campo Tipo Longitud Valor

Id de la Compañía que concilia. Es un
Compañía Numérico 5 parámetro devuelto en el método “login” en el
campo “companyId”.
Tienda que concilia. Es un parámetro devuelto
Tienda Numérico 5
en el método “login” en el campo “storeId”.
Tienda que concilia. Es un parámetro devuelto
Terminal Numérico 5
en el método “login” en el campo “terminalId”.
Fecha de la conciliación en formato
Fecha Numérico 8
“yyyyMMdd”.

Para este caso, la longitud de los campos es fija, por lo que en caso de no completar la
longitud marcado, el valor deberá ser completado con caracteres ‘0’ hacia el lado
izquierdo.

7 de 13
 Documento de Integración de Web Service

Ejemplo de nombre de archivo

00512000100000120170713.txt

Estructura del contenido del archivo

El contenido del archivo deberá de estructurarse de la siguiente forma:

CABECERA

CONTENIDO

PIE
Cabecera

La cabecera del archivo se compone de los siguientes campos:

Campo Tipo Longitud Valor

Indicador Alfanumérico 3 Indicador de cabecera de archivo “HDR”.
Año Numérico 4 Año de la conciliación.
Mes Numérico 2 Mes de la conciliación.
Día Numérico 2 Día de la conciliación.

Para este caso, la longitud de los campos es fija, por lo que en caso de no completar la
longitud marcada, el valor deberá ser completado con caracteres ‘0’ hacia el lado
izquierdo.

8 de 13
 Documento de Integración de Web Service

Contenido

Campo Tipo Longitud Valor

Indicador Alfanumérico 3 Indicador de cabecera de archivo “REG”.
Número consecutivo correspondiente al
Consecutivo Numérico 8 número de registros contenidos del
archivo.
Identificador del cliente que se proceso la
External ID Alfanumérico 30
transacción.
Fecha de la transacción en formato
Fecha Numérico 8
“yyyyMMdd”.
Hora de la transacción en formato
Hora Numérico 6
“HHmmss”.
Número de
Número de la autorización generado para
Autorización Numérico 30
la transacción.
carrier
Referencia Numérico 30 Número de referencia para la transacción.
Monto de la transacción, tomando 4
Monto Numérico 6 posiciones para números enteros y 2 para
decimales.
Moneda Alfanumérico 2 Tipo de Moneda MX - Pesos.
Producto Alfanumérico 15 Código del producto transaccionado.
Compañía Numérico 5 Compañía que llevó acabo la transacción.
Tienda Numérico 5 Tienda que llevó acabo la transacción.
Terminal Numérico 5 Terminal que llevó acabo la transacción.

Para este caso, la longitud de los campos es fija, por lo que en caso de no completar la
longitud marcada, el valor deberá ser completado con caracteres ‘0’ hacia el lado
izquierdo.

9 de 13
 Documento de Integración de Web Service

Pie
El pie del archivo estará conformado de la siguiente manera:

Campo Tipo Longitud Valor

Indicador Alfanumérico 3 Indicador de pie de archivo “TRL”.
Número total de registros contenidos en el
Total de registros Numérico 6
archivo.
Monto total de las transacciones
contenidas en el archivo, tomando 10
Monto total Numérico 12
posiciones para los números enteros y 2
para los decimales.

Para este caso, la longitud de los campos es fija, por lo que en caso de no completar la
longitud marcada, el valor deberá ser completado con caracteres ‘0’ hacia el lado
izquierdo.

Ejemplo del contenido de un archivo de conciliación:

HDR20170713
REG00000001AAA00000000000149651817034766720170713170130000000000000000000000000303182000000000000000000007774170855020000MX000000000TELMEX005720000100001
REG00000002AAA00000000000149739717035167020170713170135000000000000000000000000307250000000000000000000005539930632025000MX000000000TELMEX005720000100001
REG00000003AAA00000000000149844817035608020170713170139000000000000000000000000311241000000000000000000005555555555999900MX000000000TELMEX005720000100001
TRL000100000001044900

10 de 13
 Documento de Integración de Web Service

Transferencia por FTP

Estructura
La dirección ftp, así como el usuario y contraseña de ingreso, le serán otorgadas a cada
cliente para que pueda hacer uso de este ftp. En dicha dirección se encontrarán dos
carpetas, denominadas In y Out. En la primera, se colocará el archivo a conciliar y en la
segunda se colocará de forma automática el archivo con el resultado de la conciliación
del primer archivo.

Resultado
En el archivo de resultado se encontrarán listadas únicamente las transacciones que no
hayan podido ser conciliadas, dicho archivo tendrá el mismo formato que el archivo de
entrada y contará exactamente con la misma distribución de cabecera, detalle y pie que
fue descrita anteriormente.

Políticas de Conciliación
1. La conciliación se realizará por día.
2. Se podrá subir el archivo por ftp hasta antes de las 9 de la mañana del día siguiente al
que se va a conciliar.
3. Los resultados estarán disponibles por ftp a partir de las 13:00 horas del mismo día.
4. Las aclaraciones se tendrán que realizar antes de las 17:30 del mismo día.
5. Para realizar cualquier aclaración se requieren los documentos XML entregados por
la plataforma Konnecta.
6. En caso de no cumplir con dichas políticas Konnecta se reserva el derecho de realizar
cualquier tipo de aclaración.
7. Para obtener los accesos al FTP primero se recibirá el archivo construido por su
sistema vía correo electrónico para certificado y se enviaran por el mismo medio.

11 de 13
 Documento de Integración de Web Service

Anexos
________________________________________________________

Tabla A
Códigos de respuesta:

Código Descripción
0 Venta Exitosa.
1 Teléfono suscriptor no válido / Teléfono no soporta el servicio.
2 Destino no disponible.
3 Paquete de datos o monto no valido.
4 Número de referencia No Susceptible de Abono.
5 Crédito insuficiente.
6 Mantenimiento en curso.
7 Rechazo por tabla de transacciones llena.
8 Rechazo por time out interno.
9 Autorizador no disponible.
10 Gestor de servicios no disponible, mayor información *264.
Cuenta con una suscripción vigente, sólo puede contratar dentro de las últimas
11
24 hrs. de la suscripción actual.
Si tiene Black Berry no puede contratar Nokia Messaging/Banda Ancha y
12 viceversa / Su petición no puede ser procesada, actualmente tiene activo otro
paquete.
Para dar de alta un producto de roaming Internacional debe existir producto
13
nacional; en caso de no tenerlo, no podrá activar el servicio.
14 Activación no permitida para la región.
30 Número inválido de dígitos en el número de cuenta
31 Número de cuenta no válido
32 El número de cuenta es válido pero no puede recibir pagos como este.
33 El saldo ya se ha pagado
34 Error inesperado (todo lo introducido era correcto)
12 de 13
 Documento de Integración de Web Service

35 Factor incorrecto para el número de cuenta proporcionado

36 El nombre de cuenta es requerido
37 Factura atrasada
38 Sospecha de fraude
Formato de código de barras inválido. Por favor, intente hacer el pago con el
39
número de cuenta
40 El facturador no admite la búsqueda de saldo
41 Parámetros no válidos o faltantes
42 Problema de búsqueda de saldo

Datos de Desarrollo

** Para hacer uso del WS de desarrollo, favor de solicitar una ventana al correo de su
contacto para garantizar el servicio.

URL http://dev.services.konnecta.mx:8080/WSKNNTMP/Service?wsdl
Company CORPORATIVO
User TEST
Password 123456 (MD5)

13 de 13