Supplier Integration | PMI

Supplier Integration | PMI

Introduction

This article has been created to show how to setup the supplier integration Kornit X has built to connect to PMI. 

Setup

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. 

Workflow

When an order is processed, it will be sent over HTTO to our Kornit X Server in JSON Format. You would then be assigned a URL to post, for example https://api.pmicorp.com/au/customerID/orders
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
{ 
    "customerID": "SupplierName", 
    "orderData": { 
             "orderID": "1234512345", 
                    "shipments": [ 
                              { 
                                       "shipTo": { 
                                        "name": "Test Test", 
                                          "companyName": "ABC Company", 
                                          "address1": "65-79 Fallon Street", 
                                         "suburb": "Brunswick", 
                                         "state": "VIC", 
                                        "postcode": "3056", 
                                        "phone": "0384129700", 
                                        "isoCountry": "AU" 
                             }, 
                             "shipVia": "STANDARD" 
                  } 
        ], 
        "items": [ 
                  { 
                            "catalogID": "P2700", 
                            "sku": "PB1000", 
                            "description": "Hardcover 8x10 Photobook", 
                            "quantity": "10", 
                            "pages": "100", 
                            "qtyMultiplier": "1", 
                            "coverURL": https://yoururl.com/cover.pdf, 
                            "textURL": https://yoururl.com/text.pdf 
            } 
        ] 
    } 
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.

FAQ

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. 
Response Code
Meaning
200
Ok - order has been received successfully
400
Bad Request - Means the request was unacceptable due to a missing required parameter
401
Unauthorised 
404
Not Found - The request resource does not exist
500
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 cs@pmicorp.com.au

    • Related Articles

    • Supplier Integration | Probo Supplier

      Introduction This article has been created to show how to setup the supplier integration Kornit X has built to connect to Probo.  Setup To setup the Probo integration, please head to your company and within the advanced settings head to "Supplier ...
    • Supplier Integration | Dubow

      Introduction This article has been created to show how to setup the supplier integration Kornit X has built to connect to OnPrintShop.  Setup To setup the Dubow integration, please head to your company and within the advanced settings head to ...
    • Supplier Integration | Staples

      Introduction This article has been created to show how to setup the supplier integration Kornit X has built to connect to Staples. Setup To setup the Staples integration, please head to your company and within the advanced settings head to "Supplier ...
    • Supplier Integration | GrandHome

      Introduction This article has been created to show how to setup the supplier integration Kornit X has built to connect to GrandHome.  Setup To setup the GrandHome integration, please head to your company and within the advanced settings head to ...
    • Supplier Integration | Taylor

      Introduction This article has been created to show how to setup the supplier integration Kornit X has built to connect to Taylor.  For business enquiries with Taylor please click here.  Setup To setup the Taylor integration, please head to your ...