Restofy Docs
Pagos a domiciliarios POST

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 una caja abierta, el cierre de esa caja lo descuenta del efectivo; si sale de un banco o de una caja fuerte, no afecta ninguna caja. Falla si el valor supera lo que se le debe o si el banco o la caja fuerte no tienen saldo suficiente.

Permisos requeridos

auth-tenant

Request

Nombre Tipo Requerido Reglas
courierUuid string Sí
min:36 max:36
amountCents int Sí
min_value:1
paidFromAccountId int Sí
min_value:1
cashRegisterSessionId 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>" \
  -d '{
    "courierUuid": "string",
    "amountCents": 1,
    "paidFromAccountId": 1
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-11-02T19:00:57Z
HTTP 200

Request

{
    "courierUuid": "c3e183a8-d115-11f1-8bb6-de64ef616b7c",
    "amountCents": 6000,
    "paidFromAccountId": 16,
    "cashRegisterSessionId": 2
}

Response

{
    "success": true,
    "message": "Pago registrado",
    "data": {
        "courierUuid": "c3e183a8-d115-11f1-8bb6-de64ef616b7c",
        "balanceCents": 0
    }
}