DGI Uruguay — Facturación electrónica (CFE / e-Factura)

Descripción

Los nodos DGI conectan tus workflows con la facturación electrónica de Uruguay (Comprobantes Fiscales Electrónicos, DGI), mediante integración directa con los servicios web oficiales. Floogos gestiona la numeración autorizada (CAE), arma el XML del CFE, lo firma digitalmente, lo envía al receptor y lo incluye en el Reporte Diario a la DGI.

Nodo	Qué hace
DGI: Cargar CAE (dgiCargarCAE)	Carga un rango de numeración autorizado por la DGI
DGI: Consultar saldo de CAE (dgiConsultarCAE)	Numeración disponible por tipo/serie
DGI: Emitir CFE (dgiEmitirCFE)	Emite un comprobante (consume CAE, arma, firma, guarda)
DGI: Enviar CFE al receptor (dgiEnviarReceptor)	Envía el comprobante al receptor y procesa el acuse
DGI: Reporte diario (dgiReporteDiario)	Envía a la DGI el reporte diario de CFE
DGI: Consultar CFE (dgiConsultarCFE)	Estado de un comprobante en la DGI
DGI: Representación / QR (dgiRepresentacion)	Genera el comprobante imprimible con QR

Modelo uruguayo: reporte diario, no aprobación en tiempo real

A diferencia de otros países, la DGI no aprueba cada comprobante en el momento. Vos consumís numeración de un CAE (rango que autoriza la DGI), emitís y firmás el CFE, se lo enviás al receptor, y a la DGI le mandás un Reporte Diario con todos los comprobantes del día. Por eso hay que gestionar el CAE (tiene numeración con saldo) y correr el reporte diario (idealmente programado).

Credencial

Los nodos usan una credencial de tipo DGI. Creala en Credenciales → Agregar → Uruguay DGI / CFE con:

Campo	Descripción
Certificado (.p12)	Tu certificado de firma avanzada, en base64.
Contraseña del certificado	La clave del .p12. Nunca se muestra en logs.
RUT y Razón social	Datos del emisor.
Ambiente	test/homologación o prod.
Sucursal y Serie	Código de sucursal DGI y serie por defecto.

El mismo certificado firma los comprobantes y autentica ante la DGI por TLS mutuo.

El flujo completo

1. Cargá el CAE que te emitió la DGI con Cargar CAE (una vez por rango, uno por tipo de CFE). Podés pegar el CAE XML y se extraen los datos.

2. Emití el comprobante con Emitir CFE. Consume el próximo número del CAE (de forma segura ante concurrencia), arma el XML, lo firma y lo guarda.

3. Enviá el comprobante al receptor con Enviar CFE al receptor (procesa el acuse de recibo).

4. Reportá a la DGI con Reporte diario (idealmente en un workflow programado, una vez al día).

5. Generá la representación impresa con Representación / QR para entregar/imprimir el comprobante.

Cargar y consumir el CAE

El CAE es el rango de numeración que la DGI te autoriza (uno por tipo de CFE, vigencia ~2 años). Primero lo cargás con Cargar CAE; después Emitir CFE consume automáticamente el próximo número disponible. El consumo es seguro ante concurrencia: dos emisiones simultáneas nunca toman el mismo número. Con Consultar saldo de CAE podés alertar antes de quedarte sin numeración.

Emitir un CFE

Nodo: DGI: Emitir CFE. El comprobante se toma del campo cfe (JSON) o de los datos de entrada. Ejemplo de una e-Factura:

{
  "tipoCfe": 111,
  "fechaEmision": "2026-07-29",
  "receptor": { "tipoDocumento": 2, "documento": "218765432109", "razonSocial": "Cliente SA" },
  "items": [
    { "descripcion": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 12200, "indFact": 3 }
  ]
}

indFact indica la afectación de IVA por ítem: 1 exento, 2 tasa mínima (10%), 3 tasa básica (22%). Los precios se toman con IVA incluido y el nodo calcula el neto y el IVA.

Tipos de CFE (tipoCfe)

tipoCfe	Comprobante	Requisitos
101 / 111	e-Ticket / e-Factura	—
102 / 103 / 112 / 113	Notas de crédito y débito	referencia (tipo/serie/número del CFE original)
121 / 122 / 123	e-Factura de exportación	Moneda USD por defecto
181	e-Remito	Sin importes (mueve mercadería)
182	e-Resguardo	valorRetencion por ítem

Enviar al receptor

Enviar CFE al receptor envuelve el comprobante en un Sobre firmado y lo envía al endpoint del receptor (por-receptor) por SOAP con TLS mutuo, procesando el Acuse de Recibo. Identificás el CFE por tipo/serie/número (lo recupera de la base) o lo pasás en la entrada.

Reporte diario

Reporte diario junta los comprobantes emitidos que aún no fueron reportados, los envuelve en un Sobre tipo reporte firmado y lo envía a la DGI, marcándolos como reportados. Está pensado para correr en un workflow programado (una vez al día). Si no hay pendientes, no hace nada.

Representación impresa (QR)

Representación / QR genera el comprobante imprimible en HTML (exportable a PDF por el navegador), con el código de seguridad y el QR de consulta de la DGI. Podés pasarle el CFE ya emitido (tipo/serie/número) o un CFE en JSON para previsualizar.

Manejo de errores

Situación	Reintentable	Qué hacer
Sin CAE disponible	No	Cargá un CAE con numeración vigente para ese tipo.
Rechazo de la DGI / receptor	No	El nodo devuelve el estado y la glosa. Corregí el comprobante.
Certificado vencido	No	Renová el .p12 y actualizá la credencial.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Homologación obligatoria y validación contra el XSD

Antes de producción es obligatorio pasar el proceso de homologación de la DGI. La estructura del XML, los servicios y el formato del QR siguen la especificación pública y deben validarse contra el ambiente de pruebas.

Ver también

• Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
• Nodo HTTP — para servicios de la DGI no cubiertos por estos nodos.