Construí sobre Factumel API

Conectá tu ERP, POS, tienda online o SaaS. Factumel recibe datos estructurados, ejecuta el circuito fiscal y permite consultar el estado de cada CFE. Tu integración opera por HTTP con una API key de servidor.

Disponibilidad: los endpoints documentados existen en Factumel. La emisión fiscal real requiere que la empresa y DGI estén habilitados en producción; un ambiente de prueba no genera comprobantes con validez fiscal.

01 · Autenticación

Credenciales separadas por ambiente, scopes y seguridad.

02 · Emitir CFE

Crear, firmar, enviar, consultar y descargar XML firmado.

03 · Webhooks

Firmas HMAC y procesamiento idempotente de eventos.

04 · OpenAPI

Endpoints, métodos, parámetros y esquema JSON para SDKs.

Inicio rápido

Creá una API key de TEST desde Integraciones → API.
Configurá una empresa y su perfil fiscal en el mismo ambiente. La existencia del perfil no implica estar listo para emitir.
Consultá tus empresas y copiá el companyId.
Creá un borrador con un externalId único por venta.
Firmá y validá el comprobante, enviá su sobre a DGI y consultá la aceptación final por estado o webhook.

Descubrir empresas

curl -sS 'https://factumel.com/api/v1/companies?limit=50' \
  -H "Authorization: Bearer $FACTUMEL_API_KEY"

Crear un borrador

curl -sS -X POST https://factumel.com/api/v1/documents \
  -H "Authorization: Bearer $FACTUMEL_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "companyId": "ID_DE_EMPRESA",
    "externalId": "pedido-000123",
    "documentType": "111",
    "currencyCode": "UYU",
    "customerDocumentType": 2,
    "customerTaxId": "RUT_DEL_RECEPTOR",
    "customerName": "Cliente de prueba",
    "items": [
      { "description": "Servicio", "quantity": 1, "unitPrice": 1000, "taxRate": 22 }
    ]
  }'

Este JSON es un ejemplo de la estructura de integración, no es un comprobante fiscal validado. Debés determinar el tipo de CFE, los indicadores fiscales, el RUT válido, los impuestos y los demás campos aplicables conforme al régimen del emisor y el Formato CFE oficial de DGI.

Contratos para integradores

Las respuestas contienen data y usan códigos HTTP. Guardá siempre data.id y externalId. Si se pierde la respuesta, consultá GET /api/v1/documents/lookup?companyId=...&externalId=... antes de reintentar. Una emisión o un envío HTTP exitoso no equivalen a la aceptación por DGI. No des por finalizada una operación hasta obtener un estado terminal compatible con el régimen fiscal.

Continuar con el ciclo de emisión →