Saltar al contenido
Facturador

Anular nota de venta

POST /api/sale-notes/{sale_note_id}/void

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Anula la nota de venta (estado 11), devuelve el stock y libera lotes y series vendidos. Sus cobros salen de caja/bancos.

Quién puede usarlo: cualquier usuario autenticado. Un administrador accede a todos los registros; un vendedor solo a los que registró él (o en los que figura como vendedor). Si el registro existe pero es de otro vendedor responde 403.

Sin cuerpo.

Errores (409): la nota ya está anulada; la nota ya se convirtió en un comprobante electrónico vigente (el mensaje indica cuál). 403 si es de otro vendedor; 404.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
sale_note_id ruta sí 1

Respuestas

200 — Anulada

{
  "success": true,
  "data": {
    "id": 140,
    "number_full": "NV01-140",
    "state_type_id": "11"
  },
  "message": "N. Venta anulada con éxito"
}

409 — Convertida en comprobante

{
  "success": false,
  "message": "La nota de venta ya se convirtió en B001-532. Anula ese comprobante en lugar de la nota."
}

403 — Registro de otro vendedor

{
  "success": false,
  "message": "No tienes permiso para acceder a este registro."
}

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.