# Fegora

> Documentación de Fegora — facturación electrónica para Guatemala, El Salvador y República Dominicana

## Docs

- [Obtener u renovar un token de acceso](https://docs.fegora.com/api-reference/autenticación/obtener-u-renovar-un-token-de-acceso.md): Endpoint OAuth2 (grant types `password` y `refresh_token`). El token de acceso (JWT Bearer) tiene una vigencia de 24 horas; el `refresh_token` permite renovarlo sin volver a enviar credenciales.
- [Buscar productos de una cuenta](https://docs.fegora.com/api-reference/catálogos/buscar-productos-de-una-cuenta.md)
- [Consultar un contribuyente por NIT/CUI](https://docs.fegora.com/api-reference/catálogos/consultar-un-contribuyente-por-nitcui.md): Consulta el nombre registrado de un contribuyente (Guatemala): primero en el caché local, luego en el servicio del certificador (Digifact SHAREDINFO).
- [Listar localidades](https://docs.fegora.com/api-reference/catálogos/listar-localidades.md): Catálogo jerárquico de países, departamentos y municipios/zonas. Sin `idLocalidadSuperior`, devuelve los países. Endpoint público.
- [Listar plantillas de DTE de una cuenta](https://docs.fegora.com/api-reference/catálogos/listar-plantillas-de-dte-de-una-cuenta.md)
- [Obtener un producto por id](https://docs.fegora.com/api-reference/catálogos/obtener-un-producto-por-id.md)
- [Obtener una localidad por id](https://docs.fegora.com/api-reference/catálogos/obtener-una-localidad-por-id.md)
- [Actualizar parcialmente una cuenta](https://docs.fegora.com/api-reference/cuentas/actualizar-parcialmente-una-cuenta.md): Actualización parcial — útil, por ejemplo, para alternar `estaEnAmbienteDePruebas` o rotar el certificado de firma.
- [Actualizar una cuenta (reemplazo completo)](https://docs.fegora.com/api-reference/cuentas/actualizar-una-cuenta-reemplazo-completo.md)
- [Crear una cuenta](https://docs.fegora.com/api-reference/cuentas/crear-una-cuenta.md)
- [Eliminar una cuenta](https://docs.fegora.com/api-reference/cuentas/eliminar-una-cuenta.md)
- [Listar cuentas](https://docs.fegora.com/api-reference/cuentas/listar-cuentas.md)
- [Obtener una cuenta por NIT](https://docs.fegora.com/api-reference/cuentas/obtener-una-cuenta-por-nit.md)
- [Agregar un recurso a un DTE recibido](https://docs.fegora.com/api-reference/dte-recibidos/agregar-un-recurso-a-un-dte-recibido.md)
- [Buscar DTEs recibidos](https://docs.fegora.com/api-reference/dte-recibidos/buscar-dtes-recibidos.md): Lista los documentos donde la cuenta es el receptor (facturas de proveedores). Mismo sobre `{ data, meta, links }` que `GET /dte`.
- [Marcar un DTE recibido como anulado](https://docs.fegora.com/api-reference/dte-recibidos/marcar-un-dte-recibido-como-anulado.md): Marca localmente el documento recibido como anulado (no notifica al certificador — la anulación real ocurre en la cuenta emisora).
- [Obtener el PDF de un DTE recibido](https://docs.fegora.com/api-reference/dte-recibidos/obtener-el-pdf-de-un-dte-recibido.md)
- [Obtener un DTE recibido por id](https://docs.fegora.com/api-reference/dte-recibidos/obtener-un-dte-recibido-por-id.md)
- [Registrar un DTE recibido a partir de su XML](https://docs.fegora.com/api-reference/dte-recibidos/registrar-un-dte-recibido-a-partir-de-su-xml.md): Registra un documento recibido de un tercero, a partir de su XML certificado. Acepta los mismos dos formatos de cuerpo que `POST /dte/xml` (JSON o base64 en texto plano). Si no se especifica `accountId`, se resuelve a partir del NIT del receptor dentro del XML. Endpoint público (integraciones de res…
- [Agregar un recurso a un DTE](https://docs.fegora.com/api-reference/dte/agregar-un-recurso-a-un-dte.md): Adjunta un archivo, una URL o una referencia a otro DTE al documento indicado. Endpoint público.
- [Anular o restaurar un DTE (legacy)](https://docs.fegora.com/api-reference/dte/anular-o-restaurar-un-dte-legacy.md): Endpoint legacy para anular (`anulado: true`) o restaurar (`anulado: false`) un documento. El header `x-force: true` omite la validación de "ya anulado" y fuerza la actualización incluso si el certificador de prueba rechaza la anulación.
- [Anular un DTE](https://docs.fegora.com/api-reference/dte/anular-un-dte.md): Anula un documento certificado ante el certificador correspondiente. El `dteId` del cuerpo debe coincidir con `{id}` — de lo contrario responde 400 con el cuerpo de texto plano `"DTE ID mismatch"` (no el formato `Error` estándar).
- [Buscar DTEs emitidos](https://docs.fegora.com/api-reference/dte/buscar-dtes-emitidos.md): Lista los DTEs de la cuenta con filtros y paginación. Devuelve el sobre `{ data, meta, links }`.
- [Crear (y certificar) un DTE](https://docs.fegora.com/api-reference/dte/crear-y-certificar-un-dte.md): Crea un documento tributario electrónico y, por defecto, lo certifica de inmediato ante la autoridad fiscal correspondiente al país de la cuenta emisora (SAT en Guatemala, Ministerio de Hacienda en El Salvador, DGII en República Dominicana). La respuesta incluye el documento certificado con sus enla…
- [Exportar DTEs a Excel](https://docs.fegora.com/api-reference/dte/exportar-dtes-a-excel.md)
- [Exportar el resumen de DTEs a Excel](https://docs.fegora.com/api-reference/dte/exportar-el-resumen-de-dtes-a-excel.md)
- [Ingresar un DTE emitido a partir de su XML (resguardo)](https://docs.fegora.com/api-reference/dte/ingresar-un-dte-emitido-a-partir-de-su-xml-resguardo.md): Registra en el resguardo de emitidos un documento ya certificado, a partir de su XML. Acepta dos formatos de cuerpo: (1) JSON `{ xmlContent, isBase64Encoded, forceTestEnvironment }`, o (2) el string en base64 del XML como cuerpo plano (`Content-Type: text/plain` o sin especificar) — usado por integr…
- [Obtener el PDF de un DTE](https://docs.fegora.com/api-reference/dte/obtener-el-pdf-de-un-dte.md): Devuelve la representación gráfica en PDF. Se genera de forma diferida en la primera solicitud (o cuando `regenerar=true`) y luego se sirve desde el CDN. Endpoint público — el enlace se comparte directamente con el receptor.
- [Obtener un DTE por id](https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id.md): El `{id}` es el número de autorización del documento (el mismo `id` devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.
- [Obtener un DTE por número de transacción](https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-número-de-transacción.md): Busca el documento por el `numeroTransaccion` (identificador de idempotencia) que el cliente envió al crearlo.
- [Reenviar un DTE por correo](https://docs.fegora.com/api-reference/dte/reenviar-un-dte-por-correo.md): Reenvía el documento (PDF + XML) al receptor por correo, usando la plantilla configurada en la cuenta. Endpoint público (integraciones históricas lo invocan sin token).
- [Registrar la certificación de un DTE](https://docs.fegora.com/api-reference/dte/registrar-la-certificación-de-un-dte.md): Registra en Fegora el resultado de una certificación ya obtenida externamente. No forma parte del flujo normal de emisión (`POST /dte` certifica automáticamente); pensado para migraciones o integraciones que certifican por su cuenta.
- [Resumen de DTEs por cuenta y mes](https://docs.fegora.com/api-reference/dte/resumen-de-dtes-por-cuenta-y-mes.md): Cantidad de documentos emitidos, agrupados por canal, cuenta, año y mes.
- [Introducción al API](https://docs.fegora.com/api-reference/introduccion.md): URL base, autenticación, formato de contenido y convenciones generales del API de Fegora.
- [Actualizar el estado/avance de un lote](https://docs.fegora.com/api-reference/lotes/actualizar-el-estadoavance-de-un-lote.md)
- [Crear un lote de carga masiva](https://docs.fegora.com/api-reference/lotes/crear-un-lote-de-carga-masiva.md): Sube un archivo Excel con varias operaciones de DTE para procesamiento asíncrono.
- [Listar lotes](https://docs.fegora.com/api-reference/lotes/listar-lotes.md)
- [Obtener un lote por id](https://docs.fegora.com/api-reference/lotes/obtener-un-lote-por-id.md)
- [Obtener el usuario autenticado](https://docs.fegora.com/api-reference/otros/obtener-el-usuario-autenticado.md): Devuelve el perfil del usuario dueño del token, con sus cuentas, canales y roles asignados. `GET /usuario` (sin segmento adicional) es un alias equivalente.
- [Obtener un usuario por id](https://docs.fegora.com/api-reference/otros/obtener-un-usuario-por-id.md): Devuelve el perfil de un usuario por su identificador interno, con sus cuentas, canales y roles asignados.
- [Anulación de un DTE](https://docs.fegora.com/dte/anulacion.md): Cuándo se puede anular un documento certificado, las dos rutas del API para hacerlo y qué ocurre fiscalmente con el DTE anulado.
- [Carga masiva (lotes)](https://docs.fegora.com/dte/carga-masiva.md): Emita muchos DTE de una sola vez subiendo un archivo Excel: crear el lote, seguir su estado y obtener los resultados por fila.
- [Casos especiales](https://docs.fegora.com/dte/casos-especiales.md): Contingencia, exportación, pagos a plazos, plantillas reutilizables, envío por correo, resguardo de XML y recursos adjuntos.
- [Datos adicionales](https://docs.fegora.com/dte/datos-adicionales.md): Pares nombre/valor para adjuntar información extra a un DTE, su receptor o sus ítems — y las claves reservadas por país.
- [Estructura del DTE](https://docs.fegora.com/dte/estructura.md): Referencia completa de campos del documento JSON que se envía a POST /dte: objeto raíz, receptor, ítems, impuestos y datos adicionales.
- [Impuestos](https://docs.fegora.com/dte/impuestos.md): Cómo funciona el IVA implícito, la exención de IVA, y los impuestos específicos de Guatemala (ITH, IDP, TDP, IFB, IDB) con sus tablas de tarifas.
- [Tipos de documento](https://docs.fegora.com/dte/tipos-de-documento.md): Catálogo de tipos de DTE (factura, notas, recibos, ticket): qué son, cuándo usarlos, qué países los soportan y sus campos obligatorios adicionales.
- [Carga masiva](https://docs.fegora.com/guia-web/carga-masiva.md): Emitir varios documentos a la vez subiendo un archivo Excel.
- [Crear una factura](https://docs.fegora.com/guia-web/crear-factura.md): Flujo completo para emitir una factura u otro documento tributario desde Fegora Smart Invoice.
- [Cuentas](https://docs.fegora.com/guia-web/cuentas.md): Administrar las empresas (Cuentas) de un Canal: datos fiscales, establecimientos, certificador y usuarios.
- [Documentos recibidos](https://docs.fegora.com/guia-web/documentos-recibidos.md): Consultar los documentos tributarios que su Cuenta ha recibido de sus proveedores.
- [Facturas emitidas](https://docs.fegora.com/guia-web/facturas-emitidas.md): Buscar, ver, descargar, exportar y anular los documentos que su Cuenta ha emitido.
- [Introducción](https://docs.fegora.com/guia-web/introduccion.md): Qué es Fegora Smart Invoice y cómo está organizada la aplicación web.
- [Primeros pasos](https://docs.fegora.com/guia-web/primeros-pasos.md): Cómo iniciar sesión, elegir Canal o Cuenta y moverse por la aplicación.
- [Resumen](https://docs.fegora.com/guia-web/resumen.md): Panel del Canal con la cantidad de documentos emitidos por cada empresa administrada.
- [Bienvenido a Fegora](https://docs.fegora.com/index.md): Facturación electrónica para Guatemala, El Salvador y República Dominicana: un solo API, integración en minutos.
- [El Salvador](https://docs.fegora.com/paises/el-salvador.md): Sistema DTE del Ministerio de Hacienda: tipos de comprobante, campos MH y numeración secuencial.
- [Guatemala](https://docs.fegora.com/paises/guatemala.md): Régimen FEL de la SAT: certificadores, tipos de documento, impuestos específicos y frases de exención de IVA.
- [República Dominicana](https://docs.fegora.com/paises/republica-dominicana.md): Comprobantes fiscales electrónicos (e-CF) de la DGII: tipos de NCF, secuencias por tipo y campos específicos.
- [Ambientes: pruebas y producción](https://docs.fegora.com/primeros-pasos/ambientes.md): Cómo funciona el modo de pruebas de Fegora y qué implica para la validez fiscal de un DTE.
- [Autenticación](https://docs.fegora.com/primeros-pasos/autenticacion.md): Cómo obtener y renovar un token de acceso para usar el API de Fegora.
- [Manejo de errores](https://docs.fegora.com/primeros-pasos/errores.md): Formato de las respuestas de error, convenciones de código HTTP y catálogo de códigos conocidos.
- [Emita su primer DTE](https://docs.fegora.com/primeros-pasos/primer-dte.md): Guía rápida para emitir un Documento Tributario Electrónico de principio a fin.

## OpenAPI Specs

- [openapi](https://docs.fegora.com/api-reference/openapi.json)