¿Qué significa FEL?
FEL significa Factura Electrónica en Línea. Es el modelo operativo de Guatemala para emitir, transmitir, certificar y conservar electrónicamente los documentos tributarios autorizados por la Superintendencia de Administración Tributaria (SAT).
El régimen incluye facturas, notas de crédito y débito, recibos y otros documentos. Su definición y documentación oficial están disponibles en el portal de Factura Electrónica en Línea de la SAT.
¿Qué es un DTE y cuándo queda autorizado?
Un Documento Tributario Electrónico (DTE) es un documento del régimen FEL. El tipo que corresponde a una operación depende del régimen fiscal del contribuyente y del documento que necesita emitir.
En el flujo de API FelCore, una emisión queda confirmada cuando Agencia Virtual devuelve el número de autorización del DTE. Ese identificador permite relacionar el documento con la venta y consultarlo después.
Registrar una venta en tu sistema o recibir un timeout no confirma una emisión. Si falta una respuesta concluyente, consulta y recupera el resultado antes de emitir otra vez.
XML y PDF: dos formatos con funciones distintas
- XML: contiene la información estructurada del documento tributario electrónico. Es el formato que tu sistema puede conservar y procesar para sus registros.
- PDF: es una representación legible del documento, útil para compartirlo con el comprador o descargarlo desde un portal.
- Número de autorización: identifica el DTE autorizado. Conserva su relación con la venta y con los archivos recuperados.
Generar un PDF por tu cuenta no equivale a autorizar un DTE. Para conocer los formatos y parámetros disponibles, consulta los contratos de descarga de XML y descarga de PDF.
¿Qué papel tienen SAT y API FelCore?
La SAT administra el régimen FEL. Agencia Virtual ofrece el flujo que utiliza esta integración para procesar documentos tributarios.
API FelCore es una plataforma privada e independiente de la SAT. Proporciona una API HTTP/JSON y un portal para conectar tus sistemas con ese flujo, administrar clientes y establecimientos y consultar la actividad de las operaciones.
FelCore facilita la integración; no sustituye la autorización de la SAT ni la revisión fiscal del contribuyente.
¿Para qué sirve una API de facturación electrónica?
Una API permite que tu ERP, POS o aplicación envíe los datos de una venta y procese la respuesta de emisión dentro de su propio flujo. También puede consultar documentos, recuperar archivos o solicitar una anulación cuando corresponda.
Para comenzar, necesitas preparar el cliente, su establecimiento, acceso a la plataforma y credenciales de integración. La guía para integrar una API FEL con tu ERP o POS explica estos pasos y cómo manejar respuestas incompletas sin duplicar documentos.
Si trabajas con una tienda WordPress, consulta el plugin FEL para WooCommerce en Guatemala.