Actualizar historial de compras de un usuario

Actualizar historial de compras de un usuario #

Este método permite actualizar información relacionada al histórico de compras registrado por un usuario o comercio.

URL del endpoint #

POST /update-user-sales-history

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
user_id string Identificador único (UUID) del usuario
history list (opcional): Historial del usuario.
  • Cada elemento en el array history debe ser un objeto con los siguientes campos:
Parámetro Tipo Descripción
nit str NIT o número de identificación de la empresa de consumo a la que se le realizó la compra.
monto float Monto de la venta.
fecha str Fecha de la venta en formato ISO8601.
emc str Nombre de la Empresa de Consumo Masivo.

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": "<user_image>",
  "name": "<user_name>",
  "lastname": "<user_lastname>",
  "business_name": "<user_business_name>",
  "quota": "<user_quota>",
  "status": "<user_status>",
  "phone": "<user_phone>",
  "email": "<user_email>",
  "nit": "<user_nit>",
  "address": "<user_address>",
  "history": [
    {
      "nit": "<nit>",
      "monto": "<monto>",
      "fecha": "<fecha>",
      "emc": "<emc>"
    }
  ],
  "score": "<user_score>",
  "payment_data": {},
  "apn_token": "<user_apn_token>",
  "ecosystem": "<user_ecosystem>",
  "business_entity": "<user_business_entity>",
  "additional_data": {}
}

Ejemplos de uso #

Python # 

import requests
import json

url = "https://api.leancore.co/update-user-sales-history"
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
data = {
    "user_id": "<user_id>",
    "history": [
        {
            "nit": "<nit_1>",
            "monto": <monto_1>,
            "fecha": "<fecha_1>",
            "emc": "<emc_1>"
        },
        ...
    ]
}

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

if response.status_code == 200:
    result = response.json()
    print("User:", result["name"], result["lastname"])
    print("Updated Sales History:")
    for item in result["history"]:
        print(" - Nit:", item["nit"])
        print("   Monto:", item["monto"])
        print("   Fecha:", item["fecha"])
        print("   EMC:", item["emc"])
else:
    print("Error al actualizar el historial de ventas del usuario. Código de respuesta:", response.status_code)
    print("Mensaje de error:", response.text)