Shipper Integration | Express Bird (We Chat)

Shipper Integration | Express Bird (We Chat)

Introduction

This article has been created to show how to setup the Shipper Integration that Kornit X has built to connect to Express Bird.
Please note the Express Bird shipper integration was developed as an E-Commerce solution within an app called We Chat which is based solely within China. This means this integration is only usable for those customers based within China and the Chines version of the Kornit X platform. 

Setup

To setup the Express Bird integration, please head to your Dropship company and within the advanced settings head to "Shipper Integrations" and click to enable the Express Bird option. This had been in the screenshot below taken from the Kornit X Platform. 

When setting this up  you will need to set your "API Key" and "E Business ID" which can be retrieved from the KDNIAO platform. There are option fields to set for the Customer Name, Customer PWD, Month Code and Send Site which will be sent and shown in the request data, 
 

Workflow

With the Express Bird Shipper integration you can set multiple options detailed below.
  1. "Ahead Of Time" slider - With this toggle enabled, the system will attempt to create a shipment against the order, making the call to the carrier, shortly after order creation. Once enabled there will be an option to add a start time stamp (UTC) which will mean that the integration will only try to ship orders that were created after this time.
  2. "Is Testing Enabled" slider - Enabling this toggle will result in the integration being set to a testing scenario so not one that is live.
  3. "Shipment Strategy" dropdown - This dropdown offers users the options to set this to either "Combined Parcels" or "Individual Parcels". 
  4. "From Sender" textboxes - Users must input the following shipper details of Company, Address line 1 & 2, town, state, postcode and country. Please note for this integration to work these fields are mandatory. 
  5. "Shipment Strategy" dropdown - This dropdown offers users the options to set this to either "Combined Parcels" or "Individual Parcels". 
  6. "Use Item Level Pricing" slider - Finally with this slider enabled the products being sent will pull the pricing from the Ecommerce pricing, this will not work if the products do not have pricing. 

How To Enable, Run & Debug This Integration

In order to send a  valid request, the data must be sent in a very specific format as explained below. 
  1. EBusinessID - The account number given.
  2. RequestType - Will be ‘1007’ for the shipping request.
  3. RequestData - This is the request data containing the order, item, shipper and receiver information. This data must be url encoded before it’s sent.
  4. DataSign - This is a very specific value which must be sent. First, the ‘RequestData' and ‘ApiKey’ are concatenated and MD5 hashed. Then this value is to be base64 encoded.
Finally this value must be urlencoded. It’s essential the RequestData and RequestData used in the DataSign are identical (Pre-encryption). The php document below is an example of how to send a successful request.
  1. Endpoints Sandbox - http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json 
  2. Production - https://api.kdniao.com/api/EOrderService 
For more information on Express Bird there is information relevant to this integration located in the "Electronic Bill Interface" section of the following link found here - Link

    • Related Articles

    • Shipper Integration | DHL Express

      Introduction & Prerequisites Kornit X has created this shipper integration to connect with companies which can integrate with DHL Express to allow for shipping label creation via dispatch scan points. Once an item has been scanned, a shipment is ...

    • Shipper Integration | UPS

      Introduction & Prerequisites Kornit X has created this shipper integration to connect with companies which can integrate with UPS to allow for shipping label creation via dispatch scan points. Once an item has been scanned, a shipment is created in ...

    • Shipper Integration | Fedex

      Introduction & Prerequisites Kornit X has created this shipper integration to connect with companies which can integrate with Fedex to allow for shipping label creation via dispatch scan points. Once an item has been scanned, a shipment is created in ...

    • Shipper Integration | ParcelHub

      Introduction This article has been created to show how to setup the Shipper Integration that Kornit X has built to connect to ParcelHub.  Setup To setup the ParcelHub integration, please head to your Dropship company and within the advanced settings ...

    • Shipper Integration | Nucleus

      Introduction This article has been created to show how to setup the Shipper Integration that Kornit X has built to connect to Nucleus, otherwise known as "ClickNShip". The following link takes you to the API documentation created by Nucleus - API ...