Integrar un ERP o sistema propio con BusinessLink
Odoo
El módulo l10n_do_ecf_businesslink (Odoo 14 a 18) envía cada factura posteada a BusinessLink, actualiza el estado con la respuesta de la DGII y trae los comprobantes recibidos de proveedores como facturas de compra. Se instala con la URL y la clave de API de la empresa. Módulos complementarios (autocompletar contactos desde el directorio de RNC de la DGII sin IAP, tasas diarias del Banco Central) viven en businesslink-odoo-addons.
Otro ERP, POS o sistema propio
| Necesita | Use |
|---|---|
| Enviar una factura ya calculada y numerada | POST /v1/ecf (JSON completo de la DGII, con Idempotency-Key). |
| Que BusinessLink calcule impuestos y numere | POST /v1/facturas (emitir-facturas.md). |
| Saber cuándo la DGII responde | Webhooks (webhooks.md) o POST /v1/ecf/estados. |
| Traer las compras (facturas de proveedores) | GET /v1/recibidos?recibido_desde=... (comprobantes-recibidos.md). |
| Numeración de e-NCF | Secuenciador (secuencias-encf.md). |
| Validar clientes y proveedores | GET /v1/rnc/{rnc} y GET /v1/rnc?q=. |
| Tasa de cambio oficial | GET /v1/tasas?moneda=USD. |
Autenticación
Una clave de API por app, con permisos mínimos (facturas:emitir, facturas:leer, recibidos:leer, rnc:leer, secuencias:leer, secuencias:gestionar, webhooks:gestionar) y modo test o live. Se crean y revocan en el portal, Mi Empresa → Claves de API.
Los ERP existentes que usan la API anterior (/fe/* con usuario y contraseña) siguen funcionando; migran a /v1 con una clave de API sin cambiar el formato del documento.