This article has been created to show how to setup the supplier integration Kornit X has built to connect to PMI.
To setup the PMI supplier integration, please head to your company and within the advanced settings head to "Supplier Integrations" and click to enable the PMI Option. This has been shown below.
When setting this up you will need to set your "Customer ID", "Username" and "Password". All of this information will be provided to you from PMI before you set up this integration.
You can set additional options within the integration setup menu such as the "Orders Provider" with the options of "Standard" and "Events Based". You can also set your own timings for push minimum order age.
Orders must contain a valid catalog ID (PMI’s internal product code) or customers sku pre-mapped in our system.
Once the order is completed and shipped, we will postback a JSON containing the shipping Information and tracking details within the order. Below is an example JSON post from the PMI Integration
"name": "Test Test",
"companyName": "ABC Company",
"address1": "65-79 Fallon Street",
"description": "Hardcover 8x10 Photobook",
All PMI Product codes will be provided to you the customer based on the product you will be ordering. You can set your own internal product codes, to clarify this MUST be provided to PMI way before they give you the products so that they can pre-map these SKUs to the PMI catalogue ID in their system.
ALL artwork should be set in the PDF format. If any orders do not contain a cover and a text url than the artwork will be stored in whole under the entire coverURL.
We wanted to specify some questions that have come up within the supplier integration so these have been shared and listed below.
How do I know my order has been received?
To ensure an order has been received, you will receive an acceptance message indicated by a 200-ok response along with a recouped ID and timestamp.
What Error messages should I be aware of?
Any errors will be indicated by a rejection with a reason which will be sent back with a "Success: false" error message, for example if a SKU or authentication is incorrect. There are 5 different possible error messages which have been shown below.
Ok - order has been received successfully
Bad Request - Means the request was unacceptable due to a missing required parameter
Not Found - The request resource does not exist
Internal Server Error - Meaning there is a problem with the PMI server, please try again later
How do I get my shipping notification?
Whenever an order is shipped, you will receive a shipping notification will be sent to your endpoint that you provide, the format will be JSON and it will contain the timestamp, order ID, status, message, tracking code and tracking link.
What if I need to cancel my orders?
This is planned to be added to the interface, but for now this is only possible by sending a cancelation request to firstname.lastname@example.org