DgiCargarCAE

Description

Loads into Floogos a CAE issued by the DGI: an authorized numbering range for a given Comprobante Fiscal Electronico (CFE) type and series. The node accepts the CAE exactly as delivered by the DGI in XML (fields are extracted automatically) or the fields directly as JSON.

Once loaded, the CAE becomes available for the DgiEmitirCFE node to atomically consume numbers from that range. There is one active CAE per combination of CFE type and series; a new one must be loaded before the range runs out or expires.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	dgi credential
cae_xml	textarea	No	CAE XML issued by the DGI (fields are extracted automatically)
cae	json	No	Alternative: direct fields as JSON (cae_id, tipo_cfe, serie, nro_desde, nro_hasta, fecha_vencimiento)

Either cae_xml or cae must be provided; if both are left empty, the node returns an error for incomplete data.

Credentials

This module requires a dgi credential type with the following fields:

• Certificate (.p12): advanced signature certificate in base64
• Certificate password: password for the .p12 file
• RUT: issuer’s tax ID
• Company Name: issuer’s legal name
• Head Office / Branch: identification of the issuing point
• Series: default series for the CFE
• Environment: test (homologation) or prod (production)

Output

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

Usage Example

Loading with direct fields

{
  "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"
  }
}

Loading from the XML issued by the DGI

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

Notes

• If cae_xml is provided, the node parses it and it takes priority over the cae fields.
• The most common CFE types are 111 (e-Invoice) and 101 (e-Ticket); the full list of types is defined in DGI regulations.
• disponibles in the output is the total size of the loaded range, not the remaining balance (for that, see DgiConsultarCAE).
• The serie field is optional when loading: if omitted, the credential’s default series is used.

Related Nodes

• DgiConsultarCAE - Query available CAE balance
• DgiEmitirCFE - Issue a CFE consuming numbering from the CAE