DgiCargarCAE

Descripción

Carga en Floogos un CAE emitido por la DGI: un rango de numeración autorizado para un tipo de Comprobante Fiscal Electrónico (CFE) y una serie determinada. El nodo acepta el CAE tal cual lo entrega la DGI en XML (los campos se extraen automáticamente) o los campos directos en formato JSON.

Una vez cargado, el CAE queda disponible para que el nodo DgiEmitirCFE consuma números de esa numeración de forma atómica. Existe un CAE activo por combinación de tipo de CFE y serie; hay que recargar uno nuevo antes de que se agote el rango o venza.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial dgi
cae_xml	textarea	No	CAE XML emitido por la DGI (se extraen los campos automáticamente)
cae	json	No	Alternativa: campos directos en JSON (cae_id, tipo_cfe, serie, nro_desde, nro_hasta, fecha_vencimiento)

Hay que completar cae_xml o cae; si se dejan ambos vacíos el nodo devuelve error por datos incompletos.

Credenciales

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

• Certificado (.p12): certificado de firma avanzada en base64
• Contraseña del certificado: contraseña del .p12
• RUT: RUT del emisor
• Razón Social: razón social del emisor
• Casa Central / Sucursal: identificación del punto de emisión
• Serie: serie por defecto para los CFE
• Entorno: test (homologación) o prod (producción)

Salida

{
  "cae_id": "12345",
  "tipo_cfe": 111,
  "serie": "A",
  "nro_desde": 1,
  "nro_hasta": 1000,
  "disponibles": 1000,
  "fecha_vencimiento": "2026-12-31",
  "nro_actual": 1
}

Ejemplo de Uso

Carga por campos directos

{
  "credentials_id": "cred-dgi-prod",
  "cae": {
    "cae_id": "12345",
    "tipo_cfe": 111,
    "serie": "A",
    "nro_desde": 1,
    "nro_hasta": 1000,
    "fecha_vencimiento": "2026-12-31"
  }
}

Carga desde el XML que entrega la DGI

{
  "credentials_id": "cred-dgi-prod",
  "cae_xml": "<CAEData>...</CAEData>"
}

Notas

• Si se pasa cae_xml, el nodo lo parsea y toma prioridad sobre los campos de cae.
• El tipo de CFE más común es 111 (e-Factura) y 101 (e-Ticket); el rango completo de tipos se define en la normativa de la DGI.
• disponibles en la salida es el tamaño total del rango cargado, no el saldo restante (para eso, ver DgiConsultarCAE).
• El campo serie es opcional al cargar: si se omite, se usa la serie por defecto de la credencial.

Nodos Relacionados

• DgiConsultarCAE - Consultar saldo disponible de CAE
• DgiEmitirCFE - Emitir un CFE consumiendo numeración del CAE