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.