Documentación de la API, SupplierIntelligence

API asíncrona: inteligencia de proveedores con IA

Sube un catálogo CSV o un ZIP con hasta 200 catálogos CSV. El worker usa pandas, sentence-transformers y FAISS para encontrar candidatos de productos entre proveedores y después emplea una revisión de IA acotada para señalar referencias ambiguas. Los resultados son oportunidades de compras, no decisiones de adquisición.

Punto de acceso: POST https://mxprocess.com/api/files/start-process
Autenticación: Bearer JWT desde POST /api/login_check
Coste: 250 tokens, cobrados tras el éxito.

Iniciar la acción

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'file=@"/path/to/supplier-catalogues.zip"' \
--form 'actionName="SupplierIntelligence"' \
--form 'parameters=[["language",["English"]],["supplierName",[""]]]' \
--form 'async=true'

Entrada aceptada: un CSV o un ZIP con 1–200 archivos CSV, hasta 150 MB comprimidos y 250 MB sin comprimir. Los encabezados de nombre de producto como product_name, name o description son obligatorios. Las columnas de proveedor, referencia, precio y moneda son opcionales.

Respuesta inicial y seguimiento

{"id":123,"action":{"actionName":"SupplierIntelligence","slug":"ai-supplier-intelligence"},"accomplished":false,"trackingUrl":"https://mxprocess.com/api/actions/get-action-infos/123"}

Consulta /api/actions/get-action-infos/123 con el mismo JWT. Al completarse incluye CSV de índice de productos, coincidencias semánticas y oportunidades de precio, una revisión Markdown y JSON. Descarga todos los artefactos, incluido el JSON, con /api/actions/download-action-result/123/FILENAME.

Ejemplo de error funcional

{"error":"ERROR_SIP004 AI Supplier Intelligence accepts CSV or ZIP files up to 150 MB."}

Para un cliente que pueda esperar el procesamiento, usa la API API síncrona.

Contáctenos