Da de alta trámites desde tu herramienta

00Qué cubre esta documentación

01El recorrido, en ocho pasos

Una etapa por llamada y en este orden. Cada respuesta trae el trámite completo, con next_step y pendientes para saber qué falta. Repetir una etapa la sobrescribe; no duplica nada.

1. AltaCrea el trámite con tu referencia, consentimiento y contacto.POST /leads
2. Camino y líneaLínea nueva o portabilidad, y el número.PATCH plan_linea
3. PlanPlan y modalidad (opcional si ya los mandaste).PATCH plan
4. DatosNombre, domicilio, correo y teléfono adicional.PATCH datos
5. Fotos de la INEFrente y reverso, con tu referencia de archivo.POST documents/{kind}
6. ReferenciasDos personas, con teléfonos distintos.PATCH referencias
7. NIPSolo portabilidad, con las fotos ya subidas.PATCH portabilidad
8. SeguimientoConsulta el estado con intervalo.GET estado

02Mapa de rutas

No existe, para una herramienta, listar trámites, buscar por tu referencia, cancelar ni recibir avisos de vuelta: guarda el folio que devuelve el alta y consulta con intervalo.

03Tu primera llamada

Primero comprueba que tu alta funciona. Sin token debe responder 401; con tu token, sobre un folio que no existe, 404: es la señal de que autenticaste y tienes permiso.

T=https://api-activate.brainsuite.mx/v1/sites/zom
curl -s -o /dev/null -w "%{http_code}\n" $T/leads/ZZ000000/estado                                                  # 401
curl -s -o /dev/null -w "%{http_code}\n" -H "Authorization: Bearer $PLANES_PUERTA_TOKEN" $T/leads/ZZ000000/estado  # 404

Después, crea un trámite de prueba. referencia_externa es tu id de negocio y la llave de idempotencia: si el POST no respondió, repítelo idéntico y recibes el mismo folio.

curl -s -X POST "$T/leads" -H "Authorization: Bearer $PLANES_PUERTA_TOKEN" -H "Content-Type: application/json" -d '{
  "source": "herramienta",
  "referencia_externa": "prueba-000123",
  "clase": "prueba",
  "consent": { "basis": "aviso_aceptado", "evidence": { "aceptado_at": "2026-10-22T09:00:00-06:00", "canal": "app_socio" } },
  "contact_name": "Juan Pérez López",
  "contact_phone": "5500000921",
  "plan_ref": "libre-1"
}'

04Errores y reintentos

Los errores llegan como { "error": "CODIGO", "message"?, "field"? }: ramifica por error, nunca por message. Los 401 traen texto libre y se ramifican por el status.

Catálogo completo por ruta en la guía, errores.

05Documentos para descargar

Los tres documentos de esta página, tal como se publican. Si algo difiere entre ellos, manda el contrato.