Cómo integrar factura electrónica en tu ERP en 6 pasos

Si ya tenés un ERP, POS o e-commerce, no necesitás implementar XML, firma ni OAuth2 contra Hacienda. Integrás una API y listo. Esta es la ruta.

1. Creá tu cuenta de integrador

Un self-signup en el portal te deja en estado trial + sandbox. Desde ahí generás tu primer par API Key + API Secret (el secret se muestra una sola vez — guardalo en tu vault).

2. Subí el certificado del emisor

Cargás el .p12 de cada comercio que vas a facturar, junto con su usuario y contraseña de TRIBU-CR. Lo custodiamos cifrado con AES-256-GCM; el archivo nunca vuelve a salir en claro.

3. Autenticá server-to-server

Todas las llamadas llevan X-API-Key y X-API-Secret, y las emisiones además un Idempotency-Key (así un reintento nunca genera doble documento ni doble cobro).

4. Emití con un POST

curl -X POST https://api.facturaencr.com/v2/efactura/documents/factura \
  -H "X-API-Key: efk_…" -H "X-API-Secret: efs_…" \
  -H "Idempotency-Key: pedido-123" \
  -d '{ "emisorLegalId": "3101000000", "condicionVenta": "01", "medioPago": ["01"], "detalle": [ … ] }'

Respondemos 202 Accepted con la clave de 50 dígitos y el consecutivo de 20. La clave y el consecutivo los generamos nosotros para garantizar la correlatividad legal.

5. Escuchá el webhook

Registrás una URL HTTPS y te avisamos cuando Hacienda acepta (document.accepted) o rechaza. Verificás la firma HMAC y actualizás tu sistema.

6. Pasá a producción

Cuando tu prueba en sandbox emite una FE + una NC que la referencia, ambas aceptadas, seguís el checklist (cert de producción probado, IP whitelist, secret en vault) y solicitás el cambio a production.

Todo el sandbox es gratis, así que podés dejar la integración lista antes de emitir un solo documento real.