Flujo de Developer / Integrador

Gestiona empresas clientes conectadas por API bajo tu cuenta.

Registro

1. Ve a /register.
2. En Tipo de cuenta, selecciona Desarrollador / Integrador.
3. Completa los datos y confirma tu email.
4. Sube tu certificado .p12. también firmarás los e-CF de tus clientes con él (si así lo acuerdan).

Link de referido

Cada developer tiene una URL única:

https://ecf.frandeone.com/register?ref=<tu_api_key_public_id>

Obtén tu link desde Administración → Tu link de referido o via API:

curl https://ecf.frandeone.com/api/provider/referral-link \
  -H "Authorization: Bearer $JWT"

Respuesta:

{
  "success": true,
  "data": {
    "referral_code": "abc123def",
    "referral_url": "https://ecf.frandeone.com/register?ref=abc123def",
    "rnc": "131399950",
    "name": "Mi Integrador SRL"
  }
}

Cualquier empresa que se registre desde ese link queda automáticamente vinculada a tu cuenta (reseller_rnc = tu_rnc) y aparece en tu panel.

Gestionar tus tenants

Listar

curl "https://ecf.frandeone.com/api/provider/tenants?status=active&page=1&pageSize=50" \
  -H "Authorization: Bearer $JWT"

Como developer solo ves los tenants con reseller_rnc = tu_rnc. El owner (Frande) ve todos.

Actualizar

curl -X PATCH https://ecf.frandeone.com/api/provider/tenants/42 \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{"status":"active","monthly_doc_limit":5000}'

Emitir en nombre de un cliente

Usa la API Key del cliente (no la tuya). así el e-CF queda emitido con el RNC del cliente:

curl -X POST https://ecf.frandeone.com/TesteCF/documentos-ecf \
  -H "X-API-KEY: $CLIENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-client-key" \
  -d @ecf_payload.json

Webhook unificado (opcional)

Si quieres recibir notificaciones de todos tus clientes en un solo endpoint, configura el mismo webhook_url en cada sub-tenant. Cada delivery incluye X-ECF-Tenant-Id para diferenciarlos.

Preguntas frecuentes

¿Necesito aprobación para ser developer?

No. El registro es público y automático. Si cometes abuso (spam, violación de términos), se suspende.

¿Cuántos tenants puedo tener bajo mi cuenta?

Sin límite. Los consumos son independientes por tenant.

¿Puedo convertir un cliente existente en sub-tenant?

Sí. el owner puede asignar reseller_rnc desde PATCH /api/admin/tenants/:rnc (panel).