Migrar una integración API FEU/Surtec hacia Factumel

Qué es un adaptador de compatibilidad

Un adaptador traduce la interfaz de un proveedor fiscal al motor de Factumel. Para cambiar únicamente host y clave no basta copiar la ruta: deben coincidir el JSON, los encabezados, el método HTTP, los códigos de error, los IDs y las respuestas.

La API FEU publicada documenta consultas por identificador interno, id externo y PDF, además de CAE, recibidos y creación de CFE. El identificador interno FEU es numérico y no coincide con el ID de Factumel: exige un mapeo explícito.

Etapa de migración recomendada

No supongas que un ticket80 térmico es equivalente al PDF A4. Tampoco asumas que FEU devuelve el mismo envelope JSON que Factumel.

1. Conseguí documentación técnica vigente del proveedor y ejemplos propios anonimizados.
2. Identificá qué rutas consume tu sistema y sus tokens y encabezados (por ejemplo Authorization y X-Emisor).
3. Creá una empresa y ambiente TEST en Factumel, con clave restringida a esa empresa.
4. Probá los contratos de lectura en TEST antes de habilitar escrituras.
5. Mapeá los IDs antiguos y externalId conservando la idempotencia.
6. Sólo después de homologar los flujos fiscales evaluá producción.

Estado del proyecto

Factumel dispone de un piloto FEU de SOLO LECTURA en TEST, desactivado por defecto. Los endpoints reproducidos son GET /comprobantes/e/{id}, GET /comprobantes/{id}, GET /comprobantes/{id}/pdf, GET /v2/consulta/comprobantes/emitidos y GET /v2/consulta/comprobantes/emitidos/{id}. Requieren un host dedicado y una clave Factumel restringida a una empresa. Los IDs numéricos son alias nuevos, no los IDs históricos FEU; token/refresh, emisión, CAE, recibido y ticket80 no están implementados. No se debe anunciar como compatibilidad completa ni sustituto productivo.

Consultá también las guías públicas de la API nativa y los métodos de consulta por externalId antes de diseñar la migración.