API Documentation, SupplierIntelligence

Asynchronous API: AI Supplier Intelligence

Upload one CSV catalogue or a ZIP containing up to 200 CSV catalogues. The queued worker uses pandas, sentence-transformers and FAISS to find cross-supplier product candidates, then uses bounded AI review to flag ambiguous references. Results are procurement leads, not purchasing decisions.

Endpoint: POST https://mxprocess.com/api/files/start-process
Authentication: Bearer JWT from POST /api/login_check
Cost: 180 tokens, charged after success.

Start the action

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'

Accepted input is one CSV or one ZIP with 1–200 CSV files, up to 150 MB compressed and 250 MB uncompressed. Product-name headers such as product_name, name or description are required. Supplier, reference, price and currency columns are optional.

Initial response and polling

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

Poll /api/actions/get-action-infos/123 with the same JWT. Completion includes product-index CSV, semantic-match CSV, potential-price-opportunity CSV, Markdown review and JSON. Download every artifact, including JSON, with /api/actions/download-action-result/123/FILENAME.

Functional error example

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

For a client that can wait for processing, use the synchronous API.