Recibo
El recibo permite registrar cobros de documentos asociados, indicando el importe del documento, el importe pagado y el método de pago.
Tipo de Documento
Para recibos, el campo tipoDocumento debe ser igual a 0.
Estructura del JSON
El JSON para crear un recibo se compone de tres partes principales:
Datos Generales
Información del recibo como fecha, establecimiento, punto y número.
Datos del Cliente
Información del cliente que realiza el pago.
Documentos y Pagos
Lista de documentos cobrados con importes y método de pago.
Campos Principales
tipoDocumento
integer
Requerido
Para recibo debe ser
0.
receiptid
string
Requerido
Identificador único del recibo en tu sistema. Ejemplo:
"REC-0001".
concepto
string
Requerido
Descripción del cobro realizado. Ejemplo:
"Cobro de factura".
metodoPago
integer
Requerido
Código del método de pago para cada item. Debe seguir la tabla de Métodos de Pago.
Ejemplo de JSON Recibo
JSON
{
"tipoDocumento": 0,
"establecimiento": "1",
"punto": "1",
"numero": "10",
"fecha": "2026-03-15 10:30:00",
"receiptid": "REC-0001",
"concepto": "Cobro de factura",
"codigoSeguridadAleatorio": "123456789",
"cliente": {
"ruc": "80000001-0",
"nombre": "Cliente de Prueba",
"correo": "cliente@correo.com"
},
"items": [
{
"documento": "001-001-0000001",
"importeDocumento": 100000,
"vencimientoDocumento": "2025-03-31",
"importePago": 100000,
"metodoPago": 2,
"numeroCheque": "12345678"
}
]
}Notas Importantes
Método de Pago
El campo metodoPago debe enviarse según los códigos definidos en la tabla de Métodos de Pago.
Documento Asociado
En cada item, el campo documento debe corresponder al número del documento que se está cobrando.
Importe de Pago
El importePago no debe superar el importeDocumento del item correspondiente.