Order Labels

There are 3 ways to get the label from Janio:

Method Description	Suitable for...	Complexity
URL link that can be generated after calling Submit Order API	Users that will print labels 1 by 1 Users that will print using a browser page	Low
.pdf link that can be obtained by querying the View Order API	System/User that must print using a .pdf file System/Users that prints the labels in bulk (see notes below regarding bulk printing)	Medium
Webhook endpoint that will wait for a .pdf link	System/User that must print using a .pdf file System/Users that prints the labels in bulk (see notes below regarding bulk printing)	High

For more information regarding our labels, please vist our FAQ Page.

URL link that can be generated after calling Submit Order API

1) After receiving a 201 response from Submit Order API, on your system, generate this url: “ https://label.janio.asia/[tracking_no],[consignee_email] ”.

2) When a user clicks this link, it will bring them to our Janio label generation page that will generate a PDF label for the user to download and print.

.pdf link that can be obtained by querying the View Order API

1) After receiving a 201 response from Submit Order API, from your system, use the View Order API to get the orders’ details.

2) The URL is as follows. Kindly see actual response in apidocs.janio.asia.

a)(single)

https://api.int.janio.asia/api/order/order/?secret_key=[your_secret_key]&tracking_no=[tracking_no]

b)(multiple)

https://api.int.janio.asia/api/order/order/?secret_key=[your_secret_key]&tracking_no=[tracking_no1],[tracking_no2],[tracking_no3]

3) There will be a “order_label_url” field under “orders”. This will be the .pdf link to download the label as a PDF.

4) Important note: “order_label_url” may not be immediately available after order submission. It will be None if Janio’s backend system is still synchronising with our partners. Therefore, your system will have to regularly poll to get the “order_label_url” until it is not None. This is where the medium complexity lies.

Webhook endpoint that will wait for a link

1) Create an endpoint URL on your system that will receive this JSON payload:

Headers:
{
  "authorization": "Basic amFuaW86MTIz", ← Basic Access Auth with username ‘Janio’ and password ‘123’
  "content-type": "application/json",
}
Payload:
{
  "tracking_no": "TRACKINGNUM123",
  "order_label_url": "https://www.print.com/document",
  "label_base64": "JVBERi0xLj...MNCiXi0YNCg=="
}

2) We use Basic Access Authentication (https://en.wikipedia.org/wiki/Basic_access_authentication) to give a certain level of security while ensuring that implementation remains simple.

3) Then, inform us regarding the endpoint URL and the Basic Access Authentication password (username is fixed to “janio”) so we can configure this in Janio’s backend. We will inform you when it is done.

4) When your system uses the Submit Order API and receives a 201 response, your system will wait for Janio’s system to call the endpoint URL.

5) After about 5-30 or more seconds, Janio’s system will send the payload to the endpoint URL.

6) Only then should your System allows the user to download labels. Before that, your system should block users from trying to download labels as Janio has yet to send the label to your system. This is where the high complexity lies.