iDistributor — Onboarding Guide
11. Legislation 22. Things to consider 33. Technical implementation 44. Overview & follow-up
Technical implementation
An overview of the API integration, the most important endpoints, and the implementation flow.
System architecture
How does it all fit together?
ERP system
Order / purchase
triggers request
Your system
→
REST API
HTTPS / JSON
Your integration
→
iDistributor
Validates and sends
SDS automatically
Intersolia
→
End customer
Receives SDS
via email
Recipient
Key API endpoints
Three endpoints to get started
POSTapi/v1/Auth/Login
Authentication. Send customer_id, username and password. Returns a token_id used in all subsequent calls.
POSTapi/v1/Distribution/DistributeBulk
The main endpoint for SDS distribution. Send a list of article numbers for all chemical products in an order. iDistributor automatically determines what needs to be sent.
GETapi/v1/Distribution/List
Retrieve distribution status — useful for troubleshooting and checking what has been sent to a specific customer or delivery.
Example
What an API call looks like
POST /api/v1/Distribution/DistributeBulk — JSON body
{
  "token_id":      "81D8170D-51F9-41F1-85DC-DE1FC712242E",
  "art_no_list":   ["1234", "4567", "8910"],
  "country":       "SE",
  "delivery_id":   "ORDER-20240415-9981",   // Unique per request!
  "recipient_id":  "CUST-00421",             // Unique per end customer
  "email":         "purchasing@customerco.com"
}
Implementation flow
From setup to go-live
1
Product matching
You send your product list (product name, article number, supplier) to Intersolia. We match against the global database, source missing SDS, and upload the products with your own article numbers.
Intersolia
2
ERP configuration & API integration
You flag chemical products in your ERP, set up the email collection process, and build the integration against iDistributor's REST API. Intersolia provides technical documentation and can assist with testing.
Customer (with support from Intersolia)
3
Email template & country rules
You customise the text in the SDS email that end customers receive (body text). Intersolia configures language and country rules according to your preferences.
Intersolia
4
Test & go-live
Test with different products and email addresses (NOTE: the delivery_id and recipient_id combination is checked — always test with unique values). Intersolia will follow up at go-live.
Intersolia + Customer
Technical API documentation
The complete technical documentation for the iDistributor Distribution API is available here:
Download: iDistributor Distribution API.pdf
Important during testing: Since the system checks whether the same recipient_id and article number combination has already received an SDS, you must test with different products and/or email addresses for each test call. Otherwise the response will be "already distributed".
Optional features
Additional capabilities
Product Links API Add-on
Always retrieves up-to-date SDS links for your webshop or intranet. The link always points to the latest version — never needs manual updating.
ProductData API Add-on
Provides structured chemical information (sections 1, 2, 3, 9 from the SDS) plus GHS pictograms and ADR information — perfect for webshop integration.