Asociar venta a la caja abierta
POST /api/cash/store-cash-document
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Vincula un comprobante o una nota de venta (y sus pagos) a la caja abierta del usuario. Úsalo si la venta se registró sin caja o en otro canal y debe figurar en el cierre. Repetir la llamada no duplica la asociación.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
document_id |
integer | Sí, si no envías sale_note_id |
Id del comprobante (factura/boleta). |
sale_note_id |
integer | Sí, si no envías document_id |
Id de la nota de venta. |
quotation_id |
integer | No | Id de la cotización de origen, si aplica. |
Reglas:
- Si la venta es al crédito queda registrada como crédito pendiente de la caja.
Errores:
422{success: false, message: {campo: [errores]}}si falla la validación de campos. (ninguno de los dos ids).404{success: false, message: "Registro no encontrado."}si el usuario no tiene caja abierta o el id no existe.
Cuerpo
Content-Type: application/json
{
"document_id": "1",
"sale_note_id": null,
"quotation_id": null
}
Respuestas
200 — Asociada
{
"success": true,
"message": "Venta con éxito"
}
422 — Sin ids
{
"success": false,
"message": {
"document_id": [
"El campo document id es obligatorio cuando sale note id es ."
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.