SiatAnular

Descripción

Anula una factura previamente emitida en el SIAT del SIN de Bolivia, identificándola por su CUF (Código Único de Facturación) e indicando un código de motivo del catálogo oficial del SIN (por ejemplo, factura mal emitida o corrección por nota de crédito-débito).

Al igual que la emisión, la anulación requiere una CUFD vigente (propia o tomada de la credencial); sin ella el nodo no llega a contactar al SIN. Cuando el SIN confirma la anulación, el estado interno del documento pasa a cancelled.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial siat
cuf	text	Sí	CUF de la factura a anular
codigo_motivo	text	Sí	Código de motivo de anulación (catálogo del SIN). Por defecto “1”
cufd	text	No	CUFD vigente (si no está en la credencial)

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

{
  "cuf": "8A1B2C3D4E5F60718293A4B5C6D7E8F9",
  "estado": "cancelled",
  "codigoMotivo": "1"
}

Ejemplo de Uso

{
  "credentials_id": "cred-siat-prod",
  "cuf": "8A1B2C3D4E5F60718293A4B5C6D7E8F9",
  "codigo_motivo": "1",
  "cufd": "ABCDEFGHIJK0123456789LMNOPQRSTUVWXYZ"
}

Notas

• Requiere una CUFD vigente (propia o tomada de la credencial); sin ella el nodo corta antes de llamar al SIN.
• El código de motivo corresponde al catálogo oficial del SIN (por ejemplo 1 para factura mal emitida); conviene validar el catálogo vigente antes de anular.
• Si el SIN rechaza la anulación, el nodo devuelve error con los mensajes recibidos y el documento conserva su estado anterior.
• Al confirmarse, el estado interno del documento (tabla de facturas emitidas) pasa a cancelled.

Nodos Relacionados

• SiatEmitirFactura - Emitir la factura que luego se anula
• SiatObtenerCufd - Obtener la CUFD vigente necesaria para anular