Saltar al contenido
Facturador

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.