Ir al contenido

Crear un movimiento

POST/api/cashbox-movement

Crea un movimiento de caja. El servidor guarda el movimiento con estado activo, asigna al usuario autenticado como creador y, si es un egreso con centro de costo, registra también el movimiento del centro de costo.

typestringobligatorio

Tipo de movimiento: ingreso, egreso o conciliación.

account_idintegerobligatorio

Cuenta a la que entra o de la que sale el dinero.

payment_method_idintegerobligatorio

Método de pago. Su configuración decide si el código de operación y la comisión se muestran o son obligatorios.

payment_datedatetimeobligatorio

Fecha del pago. No puede ser posterior a la fecha y hora actual más 5 minutos. Si no, el mensaje es La fecha de pago no puede ser posterior a la fecha y hora actual.

subtotal_amountnumberobligatorio

Monto del movimiento. Mínimo 0.01, con un máximo de 2 decimales.

conceptstringobligatorio

Concepto del movimiento.

third_party_typestringobligatorio

Tipo de tercero: proveedor, cliente u otro. Solo se conservan los identificadores del tipo elegido.

provider_idintegercondicional

Obligatorio si third_party_type es proveedor. Debe existir en proveedores.

customer_idintegercondicional

Obligatorio si third_party_type es cliente. Debe existir en clientes.

cashbox_income_segment_idintegercondicional

Obligatorio si type es ingreso. Debe ser un segmento de ingreso vigente.

opcodestring

Código de operación. Es obligatorio solo si el método de pago lo exige.

include_commissionboolean

Indica si el movimiento lleva comisión. Es obligatorio aceptarla si el método de pago lo exige.

commission_type_idintegercondicional

Obligatorio si include_commission es verdadero.

commission_amountnumbercondicional

Obligatorio si include_commission es verdadero. Debe estar entre el mínimo y el máximo permitidos.

commission_opcodestring

Código de operación de la comisión.

accounting_account_idinteger

Cuenta contable del movimiento.

accounting_account_movementsarray

Reparto del monto entre cuentas contables. Cada elemento lleva accounting_account_id, amount y percentage.

project_idinteger

Proyecto asociado.

cost_center_idinteger

Centro de costo. Solo se usa en egresos; en un ingreso se ignora.

responsiblestring

Responsable del movimiento.

beneficiary_accountstring

Cuenta del beneficiario.

origin_bank_idinteger

Banco de origen.

destination_bank_idinteger

Banco de destino.

provider_account_idinteger

Cuenta del proveedor.

customer_account_idinteger

Cuenta del cliente.

voucher_typestring

Tipo de comprobante.

invoice_numberstring

Número del comprobante.

observationstring

Observación.

cashbox.movement.create, que se valida en CashboxMovementPolicy::create. Ver Permisos y políticas.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/cashbox-movement" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"type": "egreso",
"account_id": 1,
"payment_method_id": 2,
"payment_date": "2026-11-19 10:30:00",
"subtotal_amount": 150.50,
"concept": "Pago de servicio",
"third_party_type": "proveedor",
"provider_id": 12
}'
Movimiento creado201
{
"id": 1520,
"type": "egreso",
"account_id": 1,
"payment_method_id": 2,
"payment_date": "2026-11-19T10:30:00.000000Z",
"subtotal_amount": 150.5,
"total_amount": 150.5,
"concept": "Pago de servicio",
"third_party_type": "proveedor",
"provider_id": 12,
"status": "activo",
"create_user_id": 1
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Datos no válidos422
{
"message": "El concepto es requerido.",
"errors": {
"concept": ["El concepto es requerido."]
}
}