cucuAnular

Descripción

Anula una factura dentro de plazo (hasta el día 9 del mes siguiente a la emisión), fuera de plazo con la Resolución Administrativa del SIN, anula una nota de crédito/débito (irreversible) o revierte una anulación (vuelve a VALIDADA). Se identifica por ID o por CUF.

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: «Anular o revertir factura».

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial cucu
mode	select	Sí	Acción — invoice, administrative, note, revert
invoice_id	text	No	ID de la factura (UUID) — El id que devuelve CUCU al emitir. Si lo dejas vacío, indica el CUF
cuf	text	No	CUF — Código Único de Factura. Se usa si no indicas el ID
motivo	number	No	Motivo (código) — Catálogo cancellation-reasons del SIAT. En notas: 1 error de datos, 2 devolución, 3 periodo posterior, 4 otro
administrative_resolution	text	No	Resolución administrativa — Obligatoria al anular fuera de plazo: número de la Resolución de Aprobación que notifica el SIN
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

{
  "success": true,
  "mode": "invoice",
  "state": "CANCELLED",
  "cancellation_type": "SIAT",
  "invoice": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "invoiceNumber": 1,
    "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
    "state": "CANCELLED",
    "amountTotal": 500
  }
}

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",
  "mode": "invoice",
  "cuf": "2872F7294502332E637FABFBC3654EA82202AD48E0969F14EBEB8AF74",
  "motivo": 1
}

Notas

• La anulación normal solo es posible hasta el día 9 del mes siguiente. Fuera de plazo (CANCEL_OUT_OF_WINDOW) hay que usar la anulación administrativa con la resolución del SIN.
• Anular una nota de crédito/débito es irreversible. «Revertir» devuelve la factura a VALIDATED.
• Se puede identificar la factura por ID (UUID) o por CUF.

Nodos Relacionados

• cucuEmitirFactura - Emitir factura
• cucuNotaCreditoDebito - Nota de crédito/débito
• cucuConsultar - Consultar facturas