facturaBoContingencia

Descripción

Gestiona la contingencia cuando el SIAT no responde: 1) registrar el evento DESPUÉS del corte, 2) emitir las facturas con «contingencia» activada (quedan OFFLINE), 3) enviar el paquete (máx. 500) y 4) validarlo con el código de recepción; solo entonces pasan a EMITIDA y descuentan crédito. Los eventos 5, 6 y 7 exigen un CAFC que se pide al SIN.

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: «Contingencia (SIAT caído)».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial facturabo
operation	select	No	Operación — start_event, send_package, validate_package, list_events
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
event_type	select	No	Tipo de evento — 1, 2, 3, 4, 5, 6, 7
description	text	No	Descripción del evento
start_date	text	No	Inicio del corte — ISO 8601, hora de Bolivia, sin zona
end_date	text	No	Fin del corte — No puede estar en el futuro (el SIAT lo rechaza con 981). Usa el fecha_emision de las facturas, no el reloj local
reception_code	text	No	Código de recepción — El que devuelve «Enviar paquete». Se puede repetir la validación sin cobrar dos veces
document_sector	number	No	Sector de los documentos
event_date	text	No	Fecha (listar)
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": "validate_package",
  "data": {
    "mensajes": []
  },
  "warnings": [],
  "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": "start_event",
  "event_type": 1,
  "description": "Corte de internet en la oficina",
  "start_date": "2026-10-26T10:00:00",
  "end_date": "2026-10-26T12:30:00"
}

Notas

• Flujo: 1) registrar el evento DESPUÉS del corte, 2) emitir las facturas con «contingencia» (quedan OFFLINE), 3) enviar el paquete (máx. 500) y 4) validarlo con el código de recepción; solo entonces pasan a EMITIDA y descuentan crédito. La validación se puede repetir sin cobrar dos veces.
• El fin del corte no puede estar en el futuro en hora de Bolivia (el SIAT rechaza con 981) y se construye con el fecha_emision de las facturas, no con el reloj local.
• Los eventos 5, 6 y 7 exigen un CAFC en cada factura; se solicita al SIN, no es autoservicio.

Nodos Relacionados

• facturaBoEmitirFactura - Emitir factura
• facturaBoAdministrar - Cuenta, sincronización y puntos de venta
• facturaBoWebhooks - Gestionar webhooks