# 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

```bash
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

```bash
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

```bash
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](https://www.businesslink.do/docs/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](https://www.businesslink.do/docs/secuencias-encf.md).
3. 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](https://www.businesslink.do/docs/errores-e-idempotencia.md)
- Uso desde asistentes de IA (MCP): [mcp.md](https://www.businesslink.do/docs/mcp.md)
