Restofy Docs
Caja POST

Registrar una transferencia entre cuentas

POST /api/cashier/create-transfer

Descripción

Mueve un monto de dinero desde una cuenta a otra. El origen y el destino pueden ser una caja registradora o una cuenta bancaria del negocio.

Detalles

Registra el movimiento de un monto entre dos cuentas distintas del negocio (caja a caja, caja a banco, banco a caja, etc.). Toda transferencia queda asociada a una caja con sesión abierta del usuario, aunque el dinero no sea en efectivo. Si origen o destino es una caja, usa esa sesión; si ninguno lo es, usa la caja en la que el usuario está operando. Falla si origen y destino coinciden, si alguna cuenta no es válida o si el usuario no tiene una caja abierta. Puede requerir PIN según la configuración del negocio.

Permisos requeridos

auth-tenant

Request

Nombre Tipo Requerido Reglas
originAccountId int Sí
min_value:1
destinationAccountId int Sí
min_value:1
amountCents int Sí
min_value:1
notes string Sí
min:1 max:255
originSessionId int No
min_value:1
destinationSessionId int No
min_value:1
operatingSessionId int No
min_value:1
pin string No
max:60

Ejemplo de request

curl -X POST https://app.restofy.co/api/cashier/create-transfer \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "originAccountId": 1,
    "destinationAccountId": 1,
    "amountCents": 1,
    "notes": "string"
}'

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

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "originAccountId": 25,
    "destinationAccountId": 9111,
    "amountCents": 5000,
    "notes": "banco a boveda con sesion operadora",
    "operatingSessionId": 2
}

Response

{
    "success": true,
    "message": "Transferencia registrada",
    "data": {
        "journalEntryId": "1",
        "amountCents": 5000
    }
}
Volver a Caja