Conexión
Tipo: VPN
IP: 10.111.111.46
Request
fecha: Es la fecha en la que se origino la transacción.
codServicio: Indica el código de servicio de las transacciones que sera obtenidas.
{
"fecha": "2020-03-20",
"codServicio": null
}
Response
fechaactualizacion: Es la fecha y hora en que se generó el reporte. Este campo es importante debido a que mantenemos un control de nuestro lado y todas las peticiones en donde se envíen exactamente con los mismos parámetros devolvemos el mismo registro sin consultar nuevamente la base de datos, es decir, mantenemos un caché por petición por 10 minutos (esto en el futuro puede variar según vemos consumo, podremos aumentar pero no disminuir). Entonces sí por algún motivo disparan 2 veces exactamente la misma consulta, verán que la fecha y hora de actualización son exactamente lo mismo, y estamos respondiendo desde nuestro caché, no en linea con la base de datos.
red: Indica de dónde proviene el reporte. El objetivo de este campo es para que tengan identificado o puedan almacenar y distinguir de dónde proviene la información. Es de utilidad cuando tratan con distintas redes y tengan un identificador interno.
parametros: Es un objeto JSON donde muestra los parámetros que nos enviaron para la consulta. El campo es útil tanto para ustedes como para nosotros en caso de verificación del contenido de la información por sí surgiera alguna duda respecto. Acá siempre vamos a devolver todos los parámetros que nos envían, aún cuando los parámetros son opcionales, en dicho caso, estaríamos mostrando los mismos con valor null.
fecha: Es la fecha de la transacción, en el ejemplo pasamos con la hora, minuto y segundos que se produjo la misma.
hora: La hora exacta que se produjo la transacción. Este campo es redundante con el anterior, lo cual vamos a considerar eliminar el mismo. Les confirmaremos.
codtransaccion: Es el código de transacción único generado por la RED. Este campo les recomiendo que tengan la posibilidad de albergar al menos un valor alfanumérico de 20 a 25 posiciones, no es nuestro caso, pero se pueden encontrar que en otras entidades así lo usan para evitar que tenga que hacer un refactoring.
codexterno: Es el código único de transacción generado por la entidad emisora o recaudadora. En el caso de la entidad recaudadora sí consume nuestra API Pagos (pago de nuestros servicios) es un campo obligatorio que nos deben enviar el cual nosotros almacenamos en nuestra base de datos. En el caso del emisor, muchas veces depende del emisor, si contamos con el campo devolvemos lo cual sirve para realizar un cruce de transacciones. En caso de no contar, estaríamos devolviendo null.
cod_servicio: Es el código único identificador del servicio de la RED.
des_servicio: Es el nombre o descripción del servicio según registro en la RED.
cuotas: En el caso que se refiera a un servicio donde el emisor requiera como dato el número de cuota abonado. No todos los emisores tienen este dato, en caso que no cuenten estaríamos retornando 0 (cero).
tipo: Descripción del tipo de transacción, en este caso siempre se refiere a PAGO, es decir, el pago realizado en alguna terminal.
estado: El estado de la transacción, si está APROBADA o RECHAZADA o ANULADA o REVERSADA. La diferencia entre ANULADA y REVERSADA es que la primera se refiere a una solicitud implícita por el usuario cajero desde el pos, o por una solicitud administrativa, en cuanto al segundo se refiere al proceso de reversión del pago que se intentó que es disparado de forma automática por nuestro sistema en caso de capturar la excepción de timeout, es decir, no es una operación controlada por usuario, esto se procesa en background.
moneda: El tipo de moneda de la transacción.
refadicional: Este campo vamos hacer un cambio, debería ser referencia, aquí va el dato el cual relaciona la transacción con el pago del cliente, en el caso de tarjetas de esta primera fase, va a retornar el nro. de tarjeta.
importe: Es el importe total de la transacción que se abonó en caja.
tipopago: Es un objeto JSON de la forma que se realizo el cobro, actualmente tenemos 2 tipos de casos, que son: EFECTIVO y CHEQUE
descripcion: Es la descripción del tipo de pago, que puede ser EFECTIVO o CHEQUE
codigo: Es el identificador único del tipo de pago establecido por la RED.
chenro: Es el número de cheque, null en caso que sea EFECTIVO
chebco: Es el banco al cual pertenece el cheque, null en caso que sea EFECTIVO
chevto: La fecha de vencimiento del cheque, null en el caso que sea EFECTIVO
{
"fechaactualizacion": "2020-03-20T23:59:59.000Z",
"red": "PRONET",
"parametros": {
"fechaconsulta": "2020-03-20T00:00:00.000Z",
"codservicio": 101
},
"datos": [
{
"fecha": "2020-03-20T00:00:00.000Z",
"hora": 52405,
"codtransaccion": 1234567,
"codexterno": "AF23334",
"cod_servicio": "102,",
"des_servicio": "CABAL - Extractos",
"cuotas": 0,
"tipo": "PAGO",
"estado": "APROBADO",
"moneda": "GS",
"refadicional": "963852-1",
"importe": 550000,
"tipopago": {
"descripcion": "CHEQUE",
"codigo": 2,
"chenro": "545454",
"chebco": "BANCO BASA",
"chefvo": "2020-03-20T00:00:00.000Z"
}
}
]
}