Saltar al contenido principal

Quickstart para integradores

Documentación de la API FEU

Entrá por el flujo mínimo para autenticarte, configurar headers, crear tu primer CFE y consultar su estado sin recorrer toda la documentación.

Logo de Factura Electrónica Uruguay

Qué vas a resolver en esta guía

Esta documentación está pensada para equipos que necesitan autenticar, emitir y consultar comprobantes sin recorrer páginas largas. El foco está en el flujo real de integración.

Flujo base

Empezá con autenticación, definí el emisor, enviá un CFE de prueba y confirmá el estado devuelto por la API y por DGI.

Soporte para diagnóstico

También vas a encontrar errores frecuentes, tablas de referencia y un historial de cambios para revisar ajustes del servicio.

Camino rápido

Si estás integrando por primera vez, seguí este recorrido corto antes de entrar en variantes más específicas.

Entrar por tarea

Elegí la página según la operación que necesitás implementar o depurar.

Autenticación

Credenciales, access token, refresh token y headers requeridos.

Crear CFE

Campos obligatorios, ejemplos de request y respuesta de emisión.

Consultar emitidos

Filtros para revisar comprobantes emitidos y su estado frente a DGI.

Consultar recibidos

Búsqueda de comprobantes recibidos con filtros repetibles y ejemplos.

Errores y tablas

Códigos HTTP, errores comunes y referencias para tipos y estados DGI.

Avisos importantes

Estos puntos suelen explicar la mayoría de los errores de integración temprana.

Test vs producción

Cada ambiente usa endpoints y credenciales separados. Un token de test no sirve en producción.

Bearer token

Los endpoints protegidos exigen Authorization con Bearer y el token vigente.

id_externo

Usalo como clave de idempotencia para evitar emitir el mismo comprobante dos veces.

Estados DGI

Interpretá AE, BE y CE antes de automatizar decisiones sobre comprobantes emitidos o recibidos.

Antes de pasar a producción

Revisá estos puntos antes de automatizar emisiones o consultas en volumen. Son controles simples. Evitan retrabajo.

Credenciales y ambiente

Verificá que el token, el header X-Emisor y la URL correspondan al mismo ambiente. La mayoría de los errores tempranos aparecen acá.

Datos del comprobante

Usá un id_externo estable, validá los campos obligatorios y confirmá los códigos de tablas DGI antes de emitir en lote.

Seguimiento del resultado

No te quedes solo con la emisión. Consultá el estado y procesá la respuesta para distinguir rechazos, observaciones y comprobantes aceptados.

Acceso para pruebas

Para solicitar el archivo de Postman y credenciales de prueba en el ambiente TEST, comunicate al 092 957 958.

WhatsApp al 092 957 958

Últimos cambios

Revisa el changelog para seguir los cambios.

Ir al changelog