Anular factura

POST/api/v1/facturas/:facturaId/anular

Anula ante el SIAT la factura aceptada identificada por facturaId. Requiere X-API-Key con facturas.anular; la factura debe pertenecer a la empresa de la clave.

Header requerido X-API-KeyVer operaciones de Facturas

Contrato de la operación

Anula ante el SIAT la factura aceptada identificada por facturaId. Requiere X-API-Key con facturas.anular; la factura debe pertenecer a la empresa de la clave.

codigoMotivo es el código oficial de anulación y debe ser entero positivo. El backend obtiene CUIS, CUFD, CUF, punto de venta, sucursal, modalidad y sector desde la factura almacenada. Sólo una factura en estado aceptado puede anularse. Responde 200, 400, 401, 403, 404, 409, 422 o 503.

La respuesta mantiene urlQr y urlXml: identifican el documento original para consultar su estado ante el SIAT y recuperar el XML archivado, aunque la factura esté anulada.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

JSON · cuerpo de solicitud

{
  "codigoMotivo": 1
}

Respuesta

Ejemplo de respuesta

200 OKapplication/json

JSON

{
  "message": "factura anulada correctamente",
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "numeroFactura": 42,
    "cuf": "A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0",
    "codigoRecepcion": "00000000-0000-4000-8000-000000000042",
    "codigoEstado": 908,
    "estado": "anulado",
    "ambiente": "pruebas",
    "fechaEmision": "2026-08-30T16:10:00-04:00",
    "montoTotal": 500,
    "codigoPuntoVenta": 0,
    "codigoDocumentoSector": 1,
    "urlQr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=123456789&cuf=A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0&numero=42&t=2",
    "urlXml": "https://api.example.test/api/v1/public/facturas/A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0/xml",
    "urlPdf": "https://api.example.test/api/v1/public/facturas/A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0/pdf"
  }
}

Datos ficticios; los identificadores y valores cambian en cada respuesta.

Volver a Facturas