Guatemala

En Guatemala, Floogos se conecta a la SAT (Superintendencia de Administración Tributaria) bajo el régimen FEL (Factura Electrónica en Línea) a través de un certificador habilitado. A diferencia de países donde el motor firma y envía directo al ente fiscal, en Guatemala la certificación del DTE (Documento Tributario Electrónico) siempre pasa por un tercero autorizado por la SAT.

Modelo de integración

• Vía certificador obligatorio: el DTE se arma con el estándar FEL (esquema DTE 0.2.0) y se envía al certificador configurado en la credencial (por ejemplo INFILE u otro proveedor genérico), que es quien certifica el documento ante la SAT.
• Firma opcional del emisor: si la credencial tiene cargado un certificado propio (.p12), el DTE se firma localmente antes de enviarlo. Si no hay certificado, el certificador firma por vos como parte del servicio de certificación.
• Número de Autorización (UUID): cada DTE certificado recibe un UUID único que la SAT usa para identificarlo. Ese UUID es el que hay que guardar para anular el documento o generar su representación impresa.
• IVA 12%: el Impuesto al Valor Agregado se calcula al 12% sobre el valor de cada ítem, indicando si es bien (B) o servicio (S).

Cuándo queda válido un documento

Un DTE no tiene validez fiscal por el solo hecho de armarlo o firmarlo: recién queda válido cuando el certificador lo certifica ante la SAT y devuelve el Número de Autorización (UUID). Si el certificador rechaza el envío, el DTE no existe fiscalmente y hay que corregir los datos y reenviarlo.

Nodos disponibles

Nodo	Descripción
FelEmitirFactura	Arma el DTE de factura, opcionalmente lo firma y lo envía al certificador; devuelve el UUID
FelEmitirNota	Emite Nota de Crédito (NCRE) o Débito (NDEB) referenciando el UUID del documento de origen
FelAnular	Anula un DTE certificado por su UUID, indicando el motivo
FelRepresentación	Genera la representación impresa (HTML/PDF) con el QR de verificación del SAT

Flujo típico

1. FelEmitirFactura — arma y certifica la factura; se obtiene el UUID (Número de Autorización).
2. FelEmitirNota — (si corresponde) emite una nota de crédito o débito referenciando el UUID de la factura.
3. FelAnular — (si hubo un error) anula el DTE por su UUID, dentro del plazo permitido por la SAT.
4. FelRepresentación — genera el HTML con el QR de verificación para entregarle al cliente su comprobante impreso o en PDF.

Notas

• La credencial de tipo fel guarda el NIT del emisor, el certificador habilitado, sus credenciales de acceso, el certificado (.p12) opcional y el ambiente (pruebas o producción).
• Floogos valida que el certificado digital no esté vencido antes de intentar firmar y enviar un DTE.
• No todos los certificadores soportan anulación en el mismo adaptador; conviene confirmar esa capacidad con el proveedor configurado.