SiatObtenerCufd

Descripción

Obtiene la CUFD (Código Único de Facturación Diaria) del SIAT del SIN de Bolivia, vigente por 24 horas, junto con su código de control. Este código es un requisito previo obligatorio para emitir o anular facturas: sin una CUFD vigente ningún otro nodo del módulo SIAT puede operar.

Opcionalmente el nodo también puede obtener el CUIS (Código Único de Inicio de Sistemas), si la credencial todavía no tiene uno guardado. Se recomienda usar este nodo al inicio de cada día de facturación, antes de emitir la primera factura.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial siat
obtener_cuis	boolean	No	Obtener también el CUIS (si no lo tenés). Por defecto false

Credenciales

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

• Certificado digital (.p12): certificado de firma, o alternativamente clave privada + certificado en PEM
• Contraseña del certificado: contraseña del .p12
• NIT del emisor: NIT de la empresa que factura
• Token/apikey del SIN: token de acceso a los servicios del SIAT (o token delegado)
• Ambiente: pruebas/piloto o producción

Salida

{
  "cuis": "20260805AB1",
  "cufd": "ABCDEFGHIJK0123456789LMNOPQRSTUVWXYZ",
  "codigoControl": "A1B2",
  "direccion": "Av. Ejemplo 123",
  "fechaVigencia": "2026-08-06T08:00:00"
}

Ejemplo de Uso

{
  "credentials_id": "cred-siat-prod",
  "obtener_cuis": true
}

Notas

• La CUFD vence a las 24 horas; hay que renovarla al inicio de cada día antes de emitir facturas.
• Si no se marca obtener_cuis y no hay un CUIS guardado en la credencial, el nodo intenta conseguir uno igual, pero no corta la ejecución si no lo logra.
• Si el SIN no devuelve la CUFD o el código de control (por ejemplo por un apikey inválido), el nodo termina con error.
• El resultado (cufd, codigoControl, cuis) se pasa como entrada a SiatEmitirFactura o SiatAnular en el mismo workflow.

Nodos Relacionados

• SiatEmitirFactura - Emitir una factura usando la CUFD obtenida
• SiatAnular - Anular una factura (también requiere CUFD vigente)