# 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](https://www.businesslink.do/docs/emitir-facturas.md)). |
| Saber cuándo la DGII responde | Webhooks ([webhooks.md](https://www.businesslink.do/docs/webhooks.md)) o `POST /v1/ecf/estados`. |
| Traer las compras (facturas de proveedores) | `GET /v1/recibidos?recibido_desde=...` ([comprobantes-recibidos.md](https://www.businesslink.do/docs/comprobantes-recibidos.md)). |
| Numeración de e-NCF | Secuenciador ([secuencias-encf.md](https://www.businesslink.do/docs/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.
