facturaBoAnular

Descripción

Anula una factura por su CUF con un motivo del catálogo del SIAT (1 factura mal emitida, 2 nota mal emitida, 3 datos incorrectos, 4 devuelta) o revierte una anulación (solo si está ANULADA; dispara el webhook factura.anulacion_revertida).

Forma parte del Hub Fiscal de Bolivia como alternativa a la conexión directa con el SIAT: factura.bo (SimplifyIT S.R.L.) es un proveedor que construye y firma el XML y lo envía al SIN. Nodo: «Anular o revertir factura».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial facturabo
operation	select	Sí	Acción — cancel, revert
cuf	text	Sí	CUF — Código Único de Factura (lo devuelve la emisión)
motivo	number	No	Motivo (código) — Catálogo motivos_anulacion del SIAT
branch_code	number	No	Sucursal (código SIAT) — 0 = casa matriz. Vacío = la sucursal por defecto de la credencial
point_of_sale_code	number	No	Punto de venta (código SIAT) — 0 = punto principal. Vacío = el de la credencial
output_key	text	No	Clave de salida — El resultado se añade a data[clave] sin perder el resto de datos

Credenciales

Este módulo requiere una credencial de tipo facturabo con los campos:

• API key: se obtiene en app.factura.bo → Más → API Key
• Entorno: pruebas (sandbox, SIAT piloto) o producción; la clave no lo delata, lo eliges tú
• NIT y código de sistema del SIAT: para sincronizar CUIS/CUFD y catálogos
• Sucursal y punto de venta por defecto: 0 = casa matriz / punto principal
• Secreto de webhooks (whsec_…): para verificar la firma de los eventos

Salida

{
  "success": true,
  "operation": "cancel",
  "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
  "state": "ANULADA",
  "data": {
    "estado": "ANULADA"
  },
  "environment": "production"
}

La salida se guarda en la clave configurada (output_key, por defecto facturabo) y se conserva el resto de data. En error: error.message, error.type y, si aplica, status y siat_code.

Ejemplo de Uso

{
  "credentials_id": "cred-facturabo",
  "operation": "cancel",
  "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
  "motivo": 1
}

Notas

• Los motivos son los del catálogo motivos_anulacion: 1 factura mal emitida, 2 nota mal emitida, 3 datos incorrectos, 4 devuelta.
• «Revertir» solo es posible si la factura está ANULADA (si no, 409) y dispara el webhook factura.anulacion_revertida.
• Si la factura se emitió en otra sucursal o punto de venta, indícalo; si no, se usan los de la credencial.

Nodos Relacionados

• facturaBoEmitirFactura - Emitir factura
• facturaBoNota - Nota de crédito/débito
• facturaBoConsultar - Consultar facturas