Convertir Lead en usuario

Convertir Lead en usuario #

Este método permite convertir un lead en un cliente de una entidad financiera.

URL del endpoint #

POST /turn-lead-into-client

Parámetros de entrada #

Los parámetros deben enviarse en el cuerpo de la solicitud HTTP en formato JSON. A continuación, se detallan los parámetros requeridos:

Parámetro Tipo Descripción
lead_id string Identificador único (UUID) del lead.
financial_entity_id string Identificador único (UUID) de la Fintech.

Encabezados #

Encabezado Valor
Authorization Bearer {token}
Content-Type application/json

Respuesta esperada #

El método devuelve una respuesta en formato JSON con los siguientes campos:

  • En caso de éxito, la respuesta tendrá el código de estado 200 y contendrá los siguientes datos:
{
  "_id": "<user_id>",
  "image": "<image_url>",
  "name": "<name>",
  "lastname": "<lastname>",
  "business_name": "<business_name>",
  "quota": "<quota>",
  "status": "<status>",
  "phone": "<phone>",
  "email": "<email>",
  "nit": "<nit>",
  "address": "<address>",
  "history": [],
  "score": "<score>",
  "payment_data": {},
  "apn_token": "",
  "ecosystem": "<ecosystem>",
  "business_entity": "<business_entity>",
  "additional_data": {}
}
  • Donde los campos representan la información del nuevo usuario creado.

Ejemplos de uso #

Python #

import requests
import json

url = "https://api.leancore.co/turn-lead-into-client"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

data = {
    "lead_id": "<lead_id>",
    "financial_entity_id": "<financial_entity_id>"
}

response = requests.post(url, headers=headers, data=json.dumps(data))

if response.status_code == 200:
    result = response.json()
    print("User ID:", result["_id"])
    print("Name:", result["name"])
    print("Lastname:", result["lastname"])
    print("Business Name:", result["business_name"])
    print("Status:", result["status"])
    # ... imprimir los demás campos necesarios
else:
    print("Error al convertir lead en cliente. Código de respuesta:", response.status_code)
    print("Mensaje de error:", response.text)