Anular una factura con nota crédito
POST /api/invoicing/create-credit-note
Descripción
Anula una factura de venta emitiendo una nota crédito que la deja sin efecto fiscal.
Detalles
Emite la nota crédito que anula una factura ya aceptada por la entidad fiscal, dejándola sin efecto. No emite una factura nueva, no cambia la orden y no mueve dinero: es solo el paso fiscal de la anulación. Exige indicar el motivo, que queda guardado en la nota crédito. El número de la nota crédito puede dejarse en el consecutivo sugerido o fijarse a uno personalizado dentro del rango de la numeración. Una factura aún sin veredicto no se puede anular; primero hay que esperar la respuesta de la entidad fiscal.
Permisos requeridos
cash.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| invoiceUuid | string | Sí |
max:36
|
| creditNoteConceptId | int | Sí |
min_value:1
|
| creditNoteReason | string | No |
max:300
|
| customConsecutive | int | No |
min_value:1
|
Ejemplo de request
curl -X POST https://restofy.pro/api/invoicing/create-credit-note \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"invoiceUuid": "string",
"creditNoteConceptId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"invoiceUuid": "4debe688-ab4a-11f1-b72d-f2569efa6eee",
"creditNoteConceptId": 2
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"creditNoteNumber": "NC0001",
"documents": [
{
"invoiceUuid": "4ee98123-ab4a-11f1-b72d-f2569efa6eee",
"isElectronic": 0
}
]
}
}