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-10-09T02:12:12Z
HTTP 200

Request

{
    "courierUuid": "8a21127a-c386-11f1-a755-a2f78ac020f7",
    "amountCents": 3000,
    "sourceType": "cash"
}

Response

{
    "success": true,
    "message": "Pago registrado",
    "data": {
        "courierUuid": "8a21127a-c386-11f1-a755-a2f78ac020f7",
        "balanceCents": 5000
    }
}