Actualizar producto de crédito

Actualizar producto de crédito #

Este método permite actualizar un producto de crédito perteneciente a una Fintech del ecosistema de LeanCore.

URL del endpoint #

POST /update-loan-product

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
uid str ID de la entidad financiera
loan_product_name str Nombre del producto de crédito a actualizar
name str Nombre del producto de crédito
description str Descripción del producto de crédito
loan_type str Tipo de préstamo (Ejemplo: Hipotecario, Automotriz)
interest_rate float Tasa de interés del producto de crédito
interest_rate_basis str Base de cálculo de la tasa de interés
grace_period int Período de gracia (en meses)
grace_period_interest_payment bool Especifica si durante el período de gracia se pagan intereses
interest_free_period int Período sin intereses (en meses)
other_expenses list Lista de otros gastos del producto de crédito
payment_frequency str Frecuencia de pago del producto de crédito
billing_interval_type str Tipo de intervalo de facturación (Ejemplo: Diario, Mensual)
arrear_interest_rate float Tasa de interés de mora del producto de crédito
arrear_interest_rate_basis str Base de cálculo de la tasa de interés de mora
arrear_max_interest_rate float Tasa máxima de interés de mora del producto de crédito
tax_rate float Tasa de impuestos aplicable al producto de crédito
initial_charges list Lista de cargos iniciales del producto de crédito

La lista de other_expenses contiene objetos JSON con los siguientes campos:

Parámetro Tipo Descripción
description str Descripción del gasto
amount float Monto del gasto
permanent bool Especifica si el gasto es permanente o no
terms int Número de periodos
in_percentage bool Especifica si el gasto es en porcentaje
outstanding_balance_calculation bool Especifica si el gasto se cobra con base en el saldo insoluto
additional_interest_rate bool Especifica si el gasto se agrega al cálculo de la cuota del crédito como un interés adicional

Cabeceras de la petición #

La petición debe incluir la cabecera Authorization con un token de tipo Bearer.

Respuesta esperada #

  • 200 OK: El servidor ha recibido y procesado la petición correctamente. Devolverá la información de la entidad financiera actualizada en formato JSON.

Ejemplo de respuesta #

{
  "id": "e55c7c2e-3d1a-4b7e-ae4f-1a2f52840d35",
  "name": "Mi entidad financiera",
  "description": "Descripción de mi entidad financiera",
  "nit": "900123456",
  "logo": "https://example.com/my_logo.png",
  "status": "active",
  "loan_products": [
    {
      "name": "Crédito libre destino",
      "description": "Descripción crédito",
      "loan_type": "free_investment",
      "interest_rate": 1.5,
      "interest_rate_basis": "monthly",
      "grace_period": 0,
      "grace_period_interest_payment": true,
      "interest_free_period": 0,
      "other_expenses": [
        {
          "description": "Seguro de vida",
          "amount": 1.0,
          "permanent": true,
          "in_percentage": true,
          "additional_interest_rate": true
        }
      ],
      "payment_frequency": "monthly",
      "billing_interval_type": "whole_month",
      "arrear_interest_rate": 0.1,
      "arrear_interest_rate_basis": "monthly",
      "arrear_max_interest_rate": null,
      "tax_rate": 19.0,
      "initial_charges": [
        {
          "name": "Cobro de onboarding",
          "amount": 100000
        }
      ]
    }
  ]
}

Ejemplo de uso #

import requests
import json

# URL de la API
url = "https://api.leancore.co/update-loan-product"

# Token de autorización
access_token = "<tu_token_de_acceso>"

# Datos del producto de crédito a actualizar
data = {
    "uid": "<uid_del_producto>",
    "loan_product_name": "<nombre_del_producto>",
    "name": "<nuevo_nombre_del_producto>",
    "description": "<descripcion_del_producto>",
    "loan_type": "<tipo_de_prestamo>",
    "interest_rate": <tasa_de_interes>,
    "interest_rate_basis": "<base_de_tasa_de_interes>",
    "grace_period": <periodo_de_gracia>,
    "grace_period_interest_payment": <pago_de_interes_durante_periodo_de_gracia>,
    "interest_free_period": <periodo_sin_interes>,
    "other_expenses": [
        {
            "description": "<descripcion_del_gasto>",
            "amount": <monto_del_gasto>,
            "permanent": <gasto_permanente>,
            "in_percentage": <monto_del_gasto_en_porcentaje>
        },
        # Agrega otros gastos, si los hay
    ],
    "payment_frequency": "<frecuencia_de_pago>",
    "billing_interval_type": "<tipo_de_intervalo_de_facturacion>",
    "arrear_interest_rate": <tasa_de_interes_moratoria>,
    "arrear_interest_rate_basis": "<base_de_tasa_de_interes_moratoria>",
    "arrear_max_interest_rate": <tasa_maxima_de_interes_moratoria>,
    "tax_rate": <tasa_de_impuestos>,
    "initial_charges": [
        {
            "name": "<nombre_del_cargo_inicial>",
            "amount": <monto_del_cargo_inicial>
        },
        # Agrega otros cargos iniciales, si los hay
    ]
}

# Encabezados HTTP
headers = {
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/json"
}

# Realiza la solicitud HTTP POST
response = requests.post(url, data=json.dumps(data), headers=headers)

# Imprime la respuesta
print(response.json())