API de Factura Electrónica Uruguay
Esta guía resume la API de FEU para autenticarte, emitir comprobantes y consultar documentos emitidos o recibidos sin depender de una sola página enorme.
Lectura rápida
- Leé Autenticación para obtener el token.
- Seguí con Crear CFE para emitir comprobantes.
- Si necesitás un documento puntual, revisá Consulta directa de comprobantes.
- Usá Consultar emitidos o Consultar recibidos según el flujo.
- Si administrás numeración, revisá Consulta de CAEs e Importar un CAE.
- Consultá Consulta DGI o Certificados para operaciones complementarias.
- Revisá Errores y Tablas de referencia cuando necesites diagnóstico o códigos.
- Consulta el Changelog para ver cambios documentados.
Ambientes
Ambiente de prueba
Los ejemplos de esta guía usan las URLs de test.
| Ambiente | Auth base URL | API base URL |
|---|---|---|
| Test | https://auth-test.facturaelectronica.com.uy | https://api-test.facturaelectronica.com.uy |
| Producción | Credenciales y endpoints separados del ambiente de test. | Los tokens de test no sirven en producción. |
Mapa de rutas
| Operación | Endpoint de test | Guía |
|---|---|---|
| Obtener token de acceso | POST /token sobre auth-test.facturaelectronica.com.uy | Autenticación |
| Crear un CFE | POST /comprobantes/crear | Crear CFE |
| Consultar un comprobante puntual | GET /comprobantes/{id} | Consulta directa de comprobantes |
| Consultar por id externo | GET /comprobantes/e/{id} | Consulta directa de comprobantes |
| Descargar PDF de un comprobante | GET /comprobantes/{id}/pdf | Consulta directa de comprobantes |
| Consultar CFE emitidos | GET /v2/consulta/comprobantes/emitidos | Consultar emitidos |
| Consultar CFE recibidos | GET /v2/consulta/comprobantes/recibidos | Consultar recibidos |
| Consultar CAEs por empresa | GET /v2/cae/consulta | Consulta de CAEs |
| Importar un CAE | POST /v2/cae/importar | Importar un CAE |
| Consultar actividad empresarial DGI | GET /consulta-dgi/actividad-empresarial/{rut} | Consulta DGI |
| Importar certificado | POST /certificado/importar | Certificados |
| Consultar certificado | GET /certificado/consultar | Certificados |
Antes de integrar
- Los tokens son específicos por ambiente.
- Los endpoints protegidos usan
Authorization: Bearer .... - Muchas rutas también requieren
X-Emisorcon el RUT de la empresa que emite o consulta. - Cuando una ruta no muestra
X-Emisoren esta guía, es porque tampoco aparece como header explícito en la colección Postman publicada.