cucuEmisionMasiva

Descripción

Emisión masiva del SIAT: abrir un lote, emitir las facturas con «Emitir factura» (entran al lote hasta cerrarlo), cerrar el lote (arma paquetes de 500, los envía y valida; puede tardar minutos), consultarlo y rectificar las rechazadas. No rectifiques paquetes pendientes de validación: duplicarías facturas que el SIAT ya tiene.

Forma parte del Hub Fiscal de Bolivia como alternativa a la conexión directa con el SIAT: CUCU es un proveedor autorizado que se ocupa de la firma, los códigos CUIS/CUFD y el envío al SIN. Nodo: «Emisión masiva».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial cucu
operation	select	No	Operación — open, end, get, rectify
pos_id	text	No	Punto de venta (UUID) — Vacío = el punto de venta por defecto de la credencial
repetitions	number	No	Repeticiones (certificación) — 1 a 10, al cerrar
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 cucu con los campos:

• API key: empieza por sk_test_ (sandbox) o sk_live_ (producción); el entorno se deduce del prefijo
• Entorno: automático, pruebas o producción (si contradice la clave, no se envía nada)
• Punto de venta por defecto (UUID): se usa si el nodo no indica uno
• ID de empresa (UUID): para sucursales y estado del certificado
• Secreto de webhooks (whsec_…): para verificar la firma de los eventos

Salida

{
  "operation": "end",
  "data": {
    "facturasEnLote": 1250,
    "packsEnviados": 3,
    "packsRechazados": 1
  },
  "warnings": [
    "1 paquete(s) rechazado(s)"
  ]
}

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

Ejemplo de Uso

{
  "credentials_id": "cred-cucu",
  "operation": "end",
  "repetitions": 3
}

Notas

• Abre y cierra el modo de emisión masiva del punto de venta. El cierre envía los paquetes al SIAT y puede tardar minutos (el nodo espera hasta 10 min).
• Si hay paquetes rechazados, «Rectificar» reenvía; NO rectifiques los que siguen pendientes.

Nodos Relacionados

• cucuEmitirLote - Emitir facturas en lote
• cucuContingencia - Contingencia (SIAT caído)