Crear un movimiento
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.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»typestringobligatorioTipo de movimiento: ingreso, egreso o conciliación.
account_idintegerobligatorioCuenta a la que entra o de la que sale el dinero.
payment_method_idintegerobligatorioMétodo de pago. Su configuración decide si el código de operación y la comisión se muestran o son obligatorios.
payment_datedatetimeobligatorioFecha 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_amountnumberobligatorioMonto del movimiento. Mínimo 0.01, con un máximo de 2 decimales.
conceptstringobligatorioConcepto del movimiento.
third_party_typestringobligatorioTipo de tercero: proveedor, cliente u otro. Solo se conservan los identificadores del tipo elegido.
provider_idintegercondicionalObligatorio si third_party_type es proveedor. Debe existir en proveedores.
customer_idintegercondicionalObligatorio si third_party_type es cliente. Debe existir en clientes.
cashbox_income_segment_idintegercondicionalObligatorio si type es ingreso. Debe ser un segmento de ingreso vigente.
opcodestringCódigo de operación. Es obligatorio solo si el método de pago lo exige.
include_commissionbooleanIndica si el movimiento lleva comisión. Es obligatorio aceptarla si el método de pago lo exige.
commission_type_idintegercondicionalObligatorio si include_commission es verdadero.
commission_amountnumbercondicionalObligatorio si include_commission es verdadero. Debe estar entre el mínimo y el máximo permitidos.
commission_opcodestringCódigo de operación de la comisión.
accounting_account_idintegerCuenta contable del movimiento.
accounting_account_movementsarrayReparto del monto entre cuentas contables. Cada elemento lleva accounting_account_id, amount y percentage.
project_idintegerProyecto asociado.
cost_center_idintegerCentro de costo. Solo se usa en egresos; en un ingreso se ignora.
responsiblestringResponsable del movimiento.
beneficiary_accountstringCuenta del beneficiario.
origin_bank_idintegerBanco de origen.
destination_bank_idintegerBanco de destino.
provider_account_idintegerCuenta del proveedor.
customer_account_idintegerCuenta del cliente.
voucher_typestringTipo de comprobante.
invoice_numberstringNúmero del comprobante.
observationstringObservación.
Permiso
Sección titulada «Permiso»cashbox.movement.create, que se valida en CashboxMovementPolicy::create. Ver Permisos y políticas.
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}'const response = await fetch( "https://servererp.allendostmen.app/api/cashbox-movement", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ type: "egreso", account_id: 1, payment_method_id: 2, payment_date: "2026-11-19 10:30:00", subtotal_amount: 150.5, concept: "Pago de servicio", third_party_type: "proveedor", provider_id: 12, }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/cashbox-movement', [ '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, ]);{ "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}{ "message": "This action is unauthorized."}{ "message": "El concepto es requerido.", "errors": { "concept": ["El concepto es requerido."] }}