Integrar Factumel API REST desde ERP, POS o ecommerce
Guía de API REST Factumel con Bearer, permisos, creación de CFE, consulta de estados, OpenAPI, Postman y buenas prácticas.
Elegí la empresa y los permisos
Factumel expone operaciones REST JSON en /api/v1. Antes de integrar, creá una API key de TEST con alcance a una única empresa si el sistema externo sólo maneja esa empresa.
Los permisos son específicos: documents:read permite consultar; documents:write crear; documents:issue firmar; documents:submit transmitir; received:read consultar recibidos y webhooks:manage administrar destinos organizacionales.
Tu primera consulta
Conectá desde el backend, nunca desde el navegador de los clientes. La API exige TLS y devuelve errores HTTP como 401, 403, 404, 409, 422 o 429 según el contexto.
curl -sS "https://factumel.com/api/v1/companies?limit=10" \
-H "Authorization: Bearer $FACTUMEL_API_KEY"Flujo de CFE seguro
La especificación completa está publicada en /api/openapi.json. Hay documentación de desarrolladores en /desarrolladores y una colección Postman de TEST.
- Prepará un externalId estable del pedido o movimiento.
- Validá el RUT de la empresa y el tipo de CFE en TEST.
- Creá el documento por /api/v1/documents o probá la operación one-shot.
- Firmá y enviá con los scopes correspondientes; guardá el documentId.
- Consultá status y reconciliá timeouts antes de reintentar.