The purpose of this document is to understand the use cases for iDistributor from both non-technical and technical perspectives and is an addition to the technical documentation.
Active distribution of safety data sheets
Description
According to legislation in EU a company selling chemical products for professional use, must actively deliver safety data sheets. iDistributor solves that by sending e-mails triggered from your ERP-system. You are also obliged to send updated versions during a 12-month period after the initial purchase of the product.
To make it easier to adapt to any ERP-system we have built a logic that receives all products sold from the ERP and keeps track of what have been sent previously.
Use case – deliver a safety data sheet
When a customer buys a product, a request is sent to our API, we check if it has been sent before or not. In this way a customer can buy the same product every week but will only get one e-mail during a 12-month period.
NOTE for testing /setup
Since our logic checks if the request has the same-mail address and product is sent previously, you must test with different products and e-mail addresses.
Important highlights for the request
iDistributor Distribution API | |
Delivery_id | The delivery_id is an id which is used to identify the transaction. It can be used if any problem occurs, and requests must be resent. Use any unique id from your ERP, order number, delivery note number or similar |
Recipient_id | A unique id that identifies the e-mail recipient. This can be used to update an e-mail address |
Use case – e-mail address is missing or has been changed
To preserve the history of the previously sent e-mails it is important to use the recipient_id in case of a missing e-mail address or a changed e-mail address. If a previous request has been made with a missing e-mail address and you send a new request with the same recipient_id, the e-mail address will be updated and any other requests with the same recipient_id and without e-mail will be sent also.
If the e-mail address has been changed, it will change the e-mail address for this send-out and for future e-mails.
Use case – an updated version of the safety data sheet
When an updated version of a safety data sheets is received to Intersolia, our logic will send it to customers who bought it during last 12 months. This is triggered when Intersolia updates the safety data sheet and has no need of configuration.
Request frequency – best practice
Intersolia does not have any preference to which frequency our API shall be requested. It is more preferred to choose that from your business processes. Shall the request be done when an invoice is issued? Or a batch run in the evenings?
Provide links for safety data sheets
Description
Intersolia is collecting and updating safety data sheets as a service and iDistributor collects them in one place. We provide links to the safety data sheets to have them updated in any other system, like an ERP, web shop or similar.
Use case – retrieve links for safety data sheets manually
Links for safety data sheets can be retrieved manually in two ways:
- If many products will be handled at the same time:
Use a Links report in iDistributor, this can be exported to Excel for further import in any other system. - If a few products will be handled at the same time:
The link can be copied from the Links report in iDistributor
Use case – retrieve links for safety data sheets via API (optional)
Links for safety data sheets can be retrieved via an API.
The API will list all safety data sheets, or which are changed from a specific date.