Registrar recibo de venta

Descripción

Crea un nuevo recibo financiero vinculado a una venta existente, registrando el pago y ejecutando las reglas financieras de EVO necesarias.

🚧 Notas
La venta reportada debe existir.
La venta debe tener un saldo pendiente para poder ser recibida.
El endpoint debe crear un nuevo recibo financiero vinculado a la venta reportada.
El sistema debe reflejar la operación en la caja registradora, las transacciones financieras y la auditoría.
Si la venta ya está totalmente pagada, la API debe devolver un error de validación.
Será posible registrar valores superiores al saldo pendiente siempre que el empleado reportado tenga los permisos suficientes para esta operación.
Si no se proporciona idEmployee, el sistema debe usar automáticamente SUPORTEEVO (ID 1).

🔑 Parámetros de consulta

Parámetro	Tipo	Obligatorio	Descripción
`idBranch`	int32	No	Filtra la operación por sucursal. Aplicable solo a tokens multi-sucursal.

📨 Cuerpo de la solicitud

Parámetro	Tipo	Obligatorio	Descripción
`idSale`	int32	Sí	ID de la venta que recibirá el recibo.
`idEmployee`	int32	No	ID del empleado responsable del recibo. Si no se especifica, el sistema asigna automáticamente al empleado predeterminado `SUPORTEEVO` (ID `1`).
`paymentMethod`	int32	Sí	Método de pago utilizado en la transacción. Ver más abajo.
`receivingDate`	datetime	Sí	Fecha y hora del pago.
`amount`	number	Sí	Importe total de la transacción.
`amountPaid`	number	Sí	Importe recibido después de comisiones y descuentos.
`tid`	string	No	Identificador de la transacción. Aplicable a tarjetas de crédito.
`nsu`	string	No	NSU de la transacción. Aplicable a tarjetas de crédito.
`authorization`	string	No	Código de autorización. Aplicable a tarjetas de crédito.
`brand`	string	No	Marca de la tarjeta. Aplicable a tarjetas de crédito.
`acquirer`	string	No	Entidad adquirente responsable de la transacción. Aplicable a tarjetas de crédito.
`totalInstallments`	int32	No	Número total de cuotas. Aplicable a tarjetas de crédito.
`reference`	string	No	Referencia de la transacción. Aplicable a boletos, transferencias, Pix, transferencias bancarias y tarjetas de regalo.

🔷 Valores admitidos para `paymentMethod`

Valor	Método de pago
`1`	Tarjeta de crédito
`13`	Transfer
`14`	Efectivo
`15`	Tarjeta de regalo

📌 Campos adicionales por método de pago

Tarjeta de crédito (`1`)

Parámetro	Tipo	Obligatorio	Descripción
tid	string	No	Identificador de la transacción.
nsu	string	No	Transacción NSU.
authorization	string	No	Código de autorización.
brand	string	No	Marca de la tarjeta.
acquirer	string	No	Adquirente responsable de la transacción.
totalInstallments	int32	No	Número total de cuotas.

Transferencia (`13`)

Parámetro	Tipo	Obligatorio	Descripción
reference	string	No	Referencia de transferencia.

Tarjeta de regalo (`15`)

Parámetro	Tipo	Obligatorio	Descripción
reference	string	No	Referencia de tarjeta de regalo.

📤 Estructura de respuesta

Campo	Tipo	Descripción
`success`	booleano	Indica si la operación fue exitosa.
`idSale`	int32	ID de venta.
`receiptWidth`	int32	Ancho del recibo.
`receipt`	string	Recibo generado por la operación.

Solicitud

Autorización

Envía tus solicitudes HTTP con un encabezado

Authorization

que contenga la palabra Basic seguida de un espacio y una cadena codificada en base64 username:password

Ejemplo:

Authorization: Basic *****************

Parámetros de consulta

Parámetros del Body application/json-patch+json

Ejemplo

{
    "idSale": 0,
    "idEmployee": 0,
    "paymentMethod": 1,
    "receivingDate": "2019-08-24T14:15:22.123Z",
    "amount": 0,
    "amountPaid": 0,
    "tid": "string",
    "nsu": "string",
    "authorization": "string",
    "brand": "string",
    "acquirer": "string",
    "totalInstallments": 0,
    "reference": "string"
}

Ejemplos de solicitud

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Collects (registers) a payment for a sale

Registrar recibo de venta

Descripción

🔑 Parámetros de consulta

📨 Cuerpo de la solicitud

🔷 Valores admitidos para `paymentMethod`

📌 Campos adicionales por método de pago

Tarjeta de crédito (`1`)

Transferencia (`13`)

Tarjeta de regalo (`15`)

📤 Estructura de respuesta

Solicitud

Ejemplos de solicitud

Respuestas

Collects (registers) a payment for a sale

Registrar recibo de venta#

Descripción#

🔑 Parámetros de consulta#

📨 Cuerpo de la solicitud#

🔷 Valores admitidos para paymentMethod#

📌 Campos adicionales por método de pago#

Tarjeta de crédito (1)#

Transferencia (13)#

Tarjeta de regalo (15)#

📤 Estructura de respuesta#

Solicitud

Ejemplos de solicitud

Respuestas

Registrar recibo de venta

Descripción

🔑 Parámetros de consulta

📨 Cuerpo de la solicitud

🔷 Valores admitidos para `paymentMethod`

📌 Campos adicionales por método de pago

Tarjeta de crédito (`1`)

Transferencia (`13`)

Tarjeta de regalo (`15`)

📤 Estructura de respuesta