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

  1. La empresa completa la certificación con la DGII (el equipo de BusinessLink acompaña el proceso).
  2. Registre los rangos de e-NCF que la DGII autorizó (si BusinessLink numera): secuencias-encf.md.
  3. Cree una clave bl_live_. Con ella los comprobantes son reales y se reportan a la DGII.

Recursos

¿Dudas? Escríbenos o escribe a soporte@businesslink.do.