Anular anticipo
POST /api/customer-advances/cancel-customer-advance
Descripción
Anula un anticipo revirtiendo su saldo vigente, devolviéndolo o dejándolo como ingreso.
Detalles
Revierte el saldo que aún tiene el anticipo del contacto. Si se devuelve, el dinero sale de la cuenta elegida: una caja con sesión abierta, una cuenta bancaria o una caja fuerte. Si queda como ingreso, el saldo se imputa a la cuenta de ingreso configurada para ese fin. Lo que el contacto ya había consumido no se modifica.
Permisos requeridos
finance.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| prepaidAccountId | int | Sí |
min_value:1
|
| cancellationType | string | Sí |
in:refund,income
|
| refundAccountId | int | No |
min_value:1
|
| cashRegisterSessionId | int | No |
min_value:1
|
| reason | string | No |
max:200
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/customer-advances/cancel-customer-advance \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"prepaidAccountId": 1,
"cancellationType": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"prepaidAccountId": "2",
"cancellationType": "refund",
"cashRegisterSessionId": 2,
"reason": "Devolución al contacto"
}Response
{
"success": true,
"message": "Anticipo anulado",
"data": {
"prepaidAccountId": 2,
"journalEntryId": "2",
"balanceCents": 50000
}
}