Integración FEU/Surtec: piloto de lectura
En construcción. Este adaptador es únicamente de lectura y sólo funciona con credenciales de TEST. No es un reemplazo certificado de la API FEU, no emite CFE y no permite migrar identificadores internos antiguos sin un proceso de mapeo.
Factumel mantiene su API propia en /api/v1. Como primera fase de interoperabilidad, replica un subconjunto de rutas de consulta publicadas por FEU. Todos los datos proceden de tu propia empresa en Factumel: no se conecta a servidores de FEU ni extrae datos de cuentas ajenas.
Rutas FEU reproducidas parcialmente
| Método | Path preservado | Soporte |
|---|---|---|
| GET | /comprobantes/e/{id_externo} | Consulta por externalId, con clave Factumel de una empresa. |
| GET | /comprobantes/{id} | Detalle por alias numérico generado por Factumel. |
| GET | /comprobantes/{id}/pdf | PDF A4. El parámetro ticket80 devuelve 422, no un ticket simulado. |
| GET | /v2/consulta/comprobantes/emitidos | Listado paginado: pageNumber y pageSize; filtros id_externo, TipoComprobante, Serie y EstadoDgi. |
| GET | /v2/consulta/comprobantes/emitidos/{id} | Detalle por alias numérico generado por Factumel. |
Los filtros de FEU que aún no están traducidos devuelven 422 unsupported_feu_filter: no se ignoran silenciosamente. Los alias de Factumel son estables, pero no representan los IDs previamente emitidos por FEU.
Seguridad y activación
Por defecto todas las rutas del piloto devuelven 404. El operador necesita configurar un host dedicado en DNS/proxy y las variables privadas:
FEU_COMPAT_READS_ENABLED=true
FEU_COMPAT_HOST=feu-test-compat.tu-dominio.comEl cliente utiliza una API key fmk_test_, restringida a una sola empresa de Uruguay, con documents:read. Los endpoints que lo exigen validan X-Emisor contra el RUT de esa empresa. No se admiten claves de producción ni de toda la organización.
Consulta ilustrativa
curl -sS "https://feu-test-compat.tu-dominio.com/comprobantes/e/pedido-123" \
-H "Authorization: Bearer $FACTUMEL_TEST_API_KEY"
curl -sS "https://feu-test-compat.tu-dominio.com/v2/consulta/comprobantes/emitidos?pageNumber=1&pageSize=20" \
-H "Authorization: Bearer $FACTUMEL_TEST_API_KEY" \
-H "X-Emisor: $RUT_EMPRESA"Qué falta para migrar cambiando sólo host y credenciales
- Autenticación FEU:
POST /token, emisión y renovación de tokens. Factumel todavía utiliza su propia API key. - Recuperación o importación de los IDs numéricos originales FEU, evitando resolverlos a documentos ajenos.
- Compatibilidad de creación
POST /comprobantes/crear, validación de impuestos/IVA, referencias y casos DGI especiales. - Filtros completos, comprobantes recibidos, CAE, certificado y el PDF ticket80.
- Pruebas golden de request/response y de errores, más verificación fiscal en TEST y homologación.
Revisá la documentación pública de FEU ↗ y la consulta v2 ↗, que son las fuentes de este piloto.