Registrar un anticipo de contacto
POST /api/customer-advances/create-customer-advance
Descripción
Recibe un depósito de un contacto y lo registra como saldo de anticipo a su nombre.
Detalles
Suma el monto recibido al saldo de anticipo del contacto y registra la entrada de dinero según el medio de pago elegido. El anticipo se registra desde una caja con sesión abierta. Puede pedir PIN según la configuración del negocio.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| partyId | int | Sí |
min_value:1
|
| amountCents | int | Sí |
min_value:1
|
| paymentMethodId | int | Sí |
min_value:1
|
| cashRegisterSessionId | int | Sí |
min_value:1
|
| notes | string | No |
max:500
|
| pin | string | No |
max:60
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/customer-advances/create-customer-advance \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"partyId": 1,
"amountCents": 1,
"paymentMethodId": 1,
"cashRegisterSessionId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"partyId": 3,
"amountCents": 50000,
"paymentMethodId": 1,
"cashRegisterSessionId": 2,
"notes": "test deposit"
}Response
{
"success": true,
"message": "Anticipo registrado",
"data": {
"prepaidAccountId": "2",
"amountCents": 50000
}
}