Cancelar Factura

POST /invoicing/lite/cancel

Cancela una factura electrónica previamente emitida. La cancelación se registra ante el proveedor de facturación autorizado.

Autenticación

Requiere header X-SOLERBA-TOKEN. Ver .

Request Body

Campo	Tipo	Requerido	Descripción
id	integer	Sí	ID de la factura a cancelar
reason	string	No	Razón de la cancelación (entre 15 y 255 caracteres)

Ejemplo

curl -X POST "https://api.solerba.com/external-api/invoicing/lite/cancel" \
  -H "X-SOLERBA-TOKEN: tu-api-token-aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 18819,
    "reason": "Cancelación por datos incorrectos del cliente"
  }'

Ejemplo JS

const response = await fetch('https://api.solerba.com/external-api/invoicing/lite/cancel', {
  method: 'POST',
  headers: {
    'X-SOLERBA-TOKEN': process.env.SOLERBA_TOKEN,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    id: 18819,
    reason: 'Cancelación por datos incorrectos del cliente'
  })
});

const result = await response.json();
console.log(result);

Ejemplo Py

import requests

response = requests.post(
    'https://api.solerba.com/external-api/invoicing/lite/cancel',
    headers={
        'X-SOLERBA-TOKEN': 'tu-api-token-aqui',
        'Content-Type': 'application/json'
    },
    json={
        'id': 18819,
        'reason': 'Cancelación por datos incorrectos del cliente'
    }
)

result = response.json()
print(result)

Respuesta exitosa

HTTP 200 OK

{
  "success": true,
  "result": {
    "id": 18819,
    "canceled": true,
    "canceledAt": "2026-03-20T16:00:00.000Z"
  }
}

Cancelación irreversible

Una vez cancelada, la factura no puede reactivarse. Asegúrate de que la cancelación es correcta antes de enviar la solicitud.

Problemas comunes

Error	Causa	Solución
401 Unauthorized	Token inválido o expirado	Verifica tu API Token
400 — id requerido	No se envió el ID de la factura	Incluye el campo id en el body
400 — reason inválido	La razón no cumple con la longitud	La razón debe tener entre 15 y 255 caracteres
404 Not Found	La factura no existe	Verifica que el ID sea correcto y pertenezca a la empresa del token
Factura ya cancelada	La factura ya fue cancelada previamente	No se puede cancelar una factura que ya está cancelada

Siguientes pasos

• — Consulta el estado de una factura
• — Emite una nueva factura
• — Guía completa sobre cancelación y notas de crédito