Inicio rápido (5 minutos, sandbox)
Todo se hace desde un servidor (backend, función serverless o API route). /v1 rechaza llamadas con cabecera Origin (error llamada_desde_navegador) para que la clave nunca viva en el navegador.
1. Consiga una clave de prueba
En el portal (https://ui.businesslink.do) entre a Mi Empresa → Claves de API y cree una clave de prueba. Empieza con bl_test_. Se muestra una sola vez: guárdela como secreto (variable de entorno). Las claves bl_live_ (producción) solo se pueden crear cuando la empresa terminó la certificación con la DGII.
2. Pruebe la conexión
curl https://api.businesslink.do/v1/me -H "Authorization: Bearer $BL_API_KEY"
Devuelve la empresa, el modo (test o live) y los permisos de la clave.
3. Emita una factura de prueba
curl -X POST https://api.businesslink.do/v1/facturas \
-H "Authorization: Bearer $BL_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"tipo_ecf": "31",
"comprador": {"rnc": "101000228", "razon_social": "Cliente Ejemplo SRL"},
"lineas": [{"descripcion": "Consultoria", "cantidad": 2, "precio_unitario": 1500, "itbis": "18", "tipo": "servicio"}],
"tipo_pago": "contado"
}'
Respuesta: encf, estado, totales, codigo_seguridad, url_consulta_qr y consultar (la ruta para ver el estado).
4. Consulte el estado, el PDF y el XML
curl https://api.businesslink.do/v1/facturas/E310000000001 -H "Authorization: Bearer $BL_API_KEY"
curl -o factura.pdf https://api.businesslink.do/v1/facturas/E310000000001/pdf -H "Authorization: Bearer $BL_API_KEY"
curl -o factura.xml https://api.businesslink.do/v1/facturas/E310000000001/xml -H "Authorization: Bearer $BL_API_KEY"
5. Reciba el resultado por webhook (en vez de consultar)
Registre POST /v1/webhooks con la URL https de su backend. Ver webhooks.md.
Pasar a producción
- La empresa completa la certificación con la DGII (el equipo de BusinessLink acompaña el proceso).
- Registre los rangos de e-NCF que la DGII autorizó (si BusinessLink numera): secuencias-encf.md.
- Cree una clave
bl_live_. Con ella los comprobantes son reales y se reportan a la DGII.
Recursos
- OpenAPI: https://api.businesslink.do/v1/openapi.json
- Errores e idempotencia: errores-e-idempotencia.md
- Uso desde asistentes de IA (MCP): mcp.md