Onboarding Digital

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "template": {
    "id": "TEMPLATE_UUID",
    "name": "Contrato de Arrendamiento"
  },
  "participants": [
    {
      "id": "p-001",
      "role": "Arrendador",
      "email": "juan@example.com",
      "name": "Juan Pérez",
      "token": "tok_abc123def456",
      "url": "https://app.allsign.io/onboarding/tok_abc123def456",
      "status": "pending",
      "variables_count": 3,
      "variables_source": { "idv": 2, "signer": 1 }
    },
    {
      "id": "p-002",
      "role": "Arrendatario",
      "email": "maria@example.com",
      "name": "María García",
      "token": "tok_ghi789jkl012",
      "url": "https://app.allsign.io/onboarding/tok_ghi789jkl012",
      "status": "pending",
      "variables_count": 4,
      "variables_source": { "idv": 2, "signer": 2 }
    }
  ],
  "fixed_variables_count": 5,
  "total_variables": 12,
  "document_id": null,
  "verification_summary": {
    "id_scan": true,
    "selfie": true,
    "biometric_match": true,
    "otp_phone": true
  },
  "signing_method": "autografa",
  "expires_at": "2026-04-06T12:00:00Z",
  "created_at": "2026-04-03T12:00:00Z"
}

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "in_progress",
  "template": {
    "id": "TEMPLATE_UUID",
    "name": "Contrato de Arrendamiento"
  },
  "participants": [
    {
      "id": "p-001",
      "role": "Arrendador",
      "email": "juan@example.com",
      "status": "variables_submitted",
      "identity_verified": true,
      "variables_filled": 3,
      "variables_total": 3,
      "signed": false,
      "completed_at": null
    },
    {
      "id": "p-002",
      "role": "Arrendatario",
      "email": "maria@example.com",
      "status": "verifying_identity",
      "identity_verified": false,
      "variables_filled": 0,
      "variables_total": 4,
      "signed": false,
      "completed_at": null
    }
  ],
  "document_id": null,
  "created_at": "2026-04-03T12:00:00Z"
}

curl -X POST "https://api.allsign.io/v2/onboarding/digital/ONBOARDING_ID/variables" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "tok_abc123def456",
    "variables": {
      "domicilio_arrendador": "Av. Insurgentes Sur 1234, Col. Del Valle, CDMX",
      "rfc_arrendador": "PERJ850101XX1"
    },
    "partial": true
  }'

{
  "success": true,
  "variables_filled": 3,
  "variables_total": 3,
  "all_complete": true,
  "preview_url": "https://api.allsign.io/v2/onboarding/digital/ONBOARDING_ID/preview?token=tok_abc123def456"
}

{
  "preview_url": "https://s3.amazonaws.com/...preview.pdf?X-Amz-Signature=...",
  "variables_filled": 8,
  "variables_total": 12,
  "expires_in": 3600
}

{
  "success": true,
  "participant_status": "variables_submitted",
  "all_participants_ready": false,
  "next_step": "awaiting_other_participants",
  "message": "Tus datos han sido registrados. Serás notificado cuando todos los participantes completen su información para proceder a la firma."
}

{
  "success": true,
  "participant_status": "variables_submitted",
  "all_participants_ready": true,
  "next_step": "signing",
  "document_id": "DOC_UUID",
  "signing_url": "https://app.allsign.io/sign/SIGN_TOKEN",
  "message": "Todos los participantes completaron sus datos. El documento ha sido generado. Procede a firmar."
}

{
  "event": "onboarding.digital.created",
  "onboarding_id": "uuid",
  "template_name": "Contrato de Arrendamiento",
  "participants_count": 2,
  "created_at": "2026-04-03T12:00:00Z"
}

{
  "event": "participant.identity_verified",
  "onboarding_id": "uuid",
  "participant_id": "p-001",
  "role": "Arrendador",
  "email": "juan@example.com",
  "extracted_data": {
    "full_name": "Juan Carlos Pérez López",
    "curp": "PELJ850101HDFRPN09",
    "document_type": "ine"
  },
  "verified_at": "2026-04-03T14:30:00Z"
}

{
  "event": "participant.variables_submitted",
  "onboarding_id": "uuid",
  "participant_id": "p-001",
  "role": "Arrendador",
  "variables_count": 3,
  "submitted_at": "2026-04-03T15:00:00Z"
}

{
  "event": "participant.signed",
  "onboarding_id": "uuid",
  "participant_id": "p-001",
  "role": "Arrendador",
  "signing_method": "autografa",
  "signed_at": "2026-04-03T16:00:00Z"
}

{
  "event": "onboarding.digital.completed",
  "onboarding_id": "uuid",
  "document_id": "DOC_UUID",
  "template_name": "Contrato de Arrendamiento",
  "participants": [
    {
      "role": "Arrendador",
      "email": "juan@example.com",
      "signed_at": "2026-04-03T16:00:00Z"
    },
    {
      "role": "Arrendatario",
      "email": "maria@example.com",
      "signed_at": "2026-04-03T17:30:00Z"
    }
  ],
  "completed_at": "2026-04-03T17:30:00Z"
}

ADMIN (tu sistema)
  │
  ├── POST /v2/onboarding/digital
  │   (template + participantes + verificacion + firma)
  │
  ├── Sistema crea tokens unicos por participante
  │   y envia invitaciones por email
  │
  └── Cada participante recibe su URL unica

PARTICIPANTE A (Arrendador)          PARTICIPANTE B (Arrendatario)
  │                                    │
  ├── Abre URL                         ├── Abre URL
  │                                    │
  ├── Verificacion de identidad        ├── Verificacion de identidad
  │   ├── Escaneo de INE               │   ├── Escaneo de INE
  │   ├── Selfie biometrica            │   ├── Selfie biometrica
  │   └── OTP por SMS                  │   └── OTP por SMS
  │                                    │
  ├── Llenado de variables             ├── Llenado de variables
  │   (split-view: form + preview)     │   (split-view: form + preview)
  │   Variables IDV se pre-llenan      │   Variables IDV se pre-llenan
  │                                    │
  ├── Revision del documento           ├── Revision del documento
  │                                    │
  └── Firma electronica                └── Firma electronica

                    │
                    ▼
        Todos firmaron?
              │
              ├── Si: Temporal workflow genera PDF final
              │       -> documento creado
              │       -> webhook onboarding.digital.completed
              │
              └── No: Espera participantes pendientes
                      -> dashboard muestra progreso en tiempo real

const pollOnboarding = async (onboardingId) => {
  while (true) {
    const response = await fetch(
      `https://api.allsign.io/v2/onboarding/digital/${onboardingId}`,
      { headers: { Authorization: 'Bearer ALLSIGN_LIVE_SK' } }
    )
    const data = await response.json()

    console.log(`Status: ${data.status}`)
    data.participants.forEach((p) => {
      console.log(`  ${p.role}: ${p.status} (${p.variables_filled}/${p.variables_total} vars)`)
    })

    if (data.status === 'completed') {
      console.log('Documento generado:', data.document_id)
      return data
    }

    await new Promise((r) => setTimeout(r, 5000))
  }
}

await pollOnboarding('ONBOARDING_ID')