Pagar a un domiciliario
POST /api/courier-settlements/create-courier-payment
Descripción
Registra el pago total o parcial de lo que se le debe a un domiciliario.
Detalles
Descuenta del saldo del domiciliario el valor pagado y registra el movimiento contable correspondiente. Si el pago sale de la caja, queda atado al turno abierto y el cierre de ese turno lo descuenta del efectivo esperado; si sale de una cuenta de banco o bóveda, no afecta la caja. Falla si el valor supera lo que se le debe o si se paga en efectivo sin una caja abierta.
Permisos requeridos
auth-tenant
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| courierUuid | string | Sí |
min:36
max:36
|
| amountCents | int | Sí |
min_value:1
|
| sourceType | string | Sí |
max:10
|
| accountId | int | No |
min_value:1
|
Ejemplo de request
curl -X POST https://restofy.pro/api/courier-settlements/create-courier-payment \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"courierUuid": "string",
"amountCents": 1,
"sourceType": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"courierUuid": "37cbad60-ab4a-11f1-b72d-f2569efa6eee",
"amountCents": 3000,
"sourceType": "cash"
}Response
{
"success": true,
"message": "Pago registrado",
"data": {
"courierUuid": "37cbad60-ab4a-11f1-b72d-f2569efa6eee",
"balanceCents": 5000
}
}