Skip to end of banner
Go to start of banner

Create Order

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Current »

Inbound | POST | /shipping-label/create

Summary

This API call is used to create an order on the logistic aggregator portal.

Description

This API will be used to create an order on the logistic aggregator portal. If the order is already created and just Shipping label needs to be generated, directly make the Pack Order API call.

Request

{

  "billingAddress": {

    "city": "Delhi",

    "country": "India",

    "email": "mohit@gmail.com",

    "firstName": "Mohit",

    "lastName": "Singh",

    "middleName": "",

    "phone": "9121726219",

    "state": "DELHI",

    "street1": "A-102, Balaji Residency",

    "street2": "Motera",

    "street3": "",

    "zip": "110019"

  },

  "currencyCode": "INR",

  "dropAddress": {

    "city": "Delhi",

    "country": "India",

    "email": "mohit@gmail.com",

    "firstName": "Mohit",

    "lastName": "Singh",

    "middleName": "",

    "phone": "9121726219",

    "state": "DELHI",

    "street1": "A-102, Balaji Residency",

    "street2": "Motera",

    "street3": "",

    "zip": "110019"

  },

  "regionType": "INDIAN",

  "orderDetails": {

    "codValue": 0,

    "invoiceNumber": "INV-10",

    "invoiceTime": "2021-06-18T12:00:01Z",

    "invoiceValue": 100.00,

    "isCod": false,

    "orderDate": "2021-06-17T17:32:02Z",

    "orderLineItemList": [

      {

        "clientSkuId": "sku-1",

        "finalAmountPaid": 100.00,

        "imageUrl": "xyz",

        "name": "Shirt",

        "price": 100.00,

        "quantity": 1,

        "storeCreditsUsed": 0.0

      }

    ],

    "orderNumber": "order12345"

  },

  "pickupAddress": {

    "city": "Delhi",

    "country": "India",

    "email": "ram@gmail.com",

    "firstName": "Ram",

    "lastName": "Mehta",

    "middleName": "",

    "phone": "8135671272",

    "state": "DELHI",

    "street1": "Mathalli area",

    "street2": "Opposite Ring road",

    "street3": "",

    "zip": "110020"

  },

  "sellerGstin": "29AADCP7081J1ZY",

  "shipmentDimension": {

    "breadth": 10,

    "height": 10,

    "length": 10,

    "weight": 1

  },

  "shippingAndBillingAddressSame": true, Add payload for when this flag is false as well.

  "logisticAggregatorType": "CLICKPOST",

  "warehouseCode": "wh-1"

}

Parameter Name

Data Type

Description

Mandatory

billingAddress

Object

Billing Address of Customer

yes

billingAddress.city

String

City of Customer

yes

billingAddress.country

String

Country of Customer

yes

billingAddress.email

String

Email of Customer

yes

billingAddress.firstName

String

First Name of customer

yes

billingAddress.lastName

String

Last Name of customer

yes

billingAddress.middleName

String

Middle Name of customer

no

billingAddress.phone

String

Phone Number of Customer

yes

billingAddress.state

String

State of customer

yes

billingAddress.street1

String

1st line of customer address

yes

billingAddress.street2

String 

2nd line of customer address

no

billingAddress.street3

String

3rd line of customer address

no

billingAddress.zip

String

Zip/Pin code of customer address

yes

currencyCode

String

Currency

yes

dropAddress

Object

Shipping Address of customer

dropAddress.city

String

City of customer

yes

dropAddress.country

String

Country of customer

yes

dropAddress.email

String

Email of customer

yes

dropAddress.firstName

String

First Name of customer

yes

dropAddress.lastName

String

Last Name of customer

yes

dropAddress.middleName

String

Middle name of customer

no

dropAddress.phone

String

Phone Number of customer

yes

dropAddress.state

String

State of customer

yes

dropAddress.street1

String 

1st line of customer address

yes

dropAddress.street2

String

2nd line of customer address

no

dropAddress.street3

String

3rd line of customer address

no

dropAddress.zip

String

Zip/Pin code of customer

yes

regionType

String

Can take two values:INDIAN and INTERNATIONAL, specifying the region type of order

yes

orderDetails

Object

Order Details

yes

orderDetails.codValue

Double

If order is of type COD, then this should be greater than 0

yes

orderDetails.invoiceNumber

String

Invoice Id of the order

yes

orderDetails.invoiceTime

Date

Invoice Time of the order

yes

orderDetails.invoiceValue

Double

Invoice value

yes

orderDetails.isCod

Boolean

True if the order is of COD type

yes

orderDetails.orderDate

Date

Order Date

yes

orderDetails.orderLineItemList

Object[]

Order Line Items

yes

orderDetails.orderLineItemList.clientSkuId

String

SKU of the product

yes

orderDetails.orderLineItemList.finalAmountPaid

Double

Final amount paid for the product

yes

orderDetails.orderLineItemList.imageUrl

String

Image url of the product

no

orderDetails.orderLineItemList.name

String

Name of the product

yes

orderDetails.orderLineItemList.price

Double

Price of the product

yes

orderDetails.orderLineItemList.quantity

Integer

Quantity of the product

yes

orderDetails.orderLineItemList.storeCreditsUsed

Double

Store credits for this line item

no

orderDetails.orderNumber

String

Order Number

yes

pickupAddress

Object

Pickup Address

yes

pickupAddress.city

String

City of Warehouse

yes

pickupAddress.country

String

Country of Warehouse

yes

pickupAddress.email

String

Email of Warehouse

yes

pickupAddress.firstName

String

First name of Warehouse

yes

pickupAddress.lastName

String

Last name of Warehouse

yes

pickupAddress.middleName

String 

Middle name of warehouse

no

pickupAddress.phone

String

Phone number of warehouse

yes

pickupAddress.state

String

State of warehouse

yes

pickupAddress.street1

String

1st line of warehouse address

yes

pickupAddress.street2

String

2nd line of warehouse address

no

pickupAddress.street3

String

3rd line of warehouse address

no

pickupAddress.zip

String

Zip/Pin code of warehouse

yes

sellerGstin

String

Seller GSTIN

yes

shipmentDimension

Object

Package Dimensions

yes

shipmentDimension.breadth

Integer

Breadth of package (cms)

yes

shipmentDimension.height

Integer

Height of package(cms)

yes

shipmentDimension.length

Integer

Length of package(cms)

yes

shipmentDimension.weight

Integer

Weight of package(grams for Clickpost/kilograms for Shiprocket)

yes

shippingAndBillingAddressSame

Boolean

True if billing and shipping address are the same

yes

logisticAggregatorType

String

Can be “CLICKPOST” or “SHIPROCKET”, specifies which aggregator type to use for Order Creation

yes

warehouseCode

String

Warehouse Code

yes

Reponse

No response

Generate Shipping Label

Inbound | POST | /shipping-label/pack

Summary

This API call is used to generate AWB and shipping label.

Description

This API call is used to generate AWB and shipping label.

Request

{

  "billingAddress": {

    "city": "Delhi",

    "country": "India",

    "email": "mohit@gmail.com",

    "firstName": "Mohit",

    "lastName": "Singh",

    "middleName": "",

    "phone": "9121726219",

    "state": "DELHI",

    "street1": "A-102, Balaji Residency",

    "street2": "Motera",

    "street3": "",

    "zip": "110019"

  },

  "currencyCode": "INR",

  "dropAddress": {

    "city": "Delhi",

    "country": "India",

    "email": "mohit@gmail.com",

    "firstName": "Mohit",

    "lastName": "Singh",

    "middleName": "",

    "phone": "9121726219",

    "state": "DELHI",

    "street1": "A-102, Balaji Residency",

    "street2": "Motera",

    "street3": "",

    "zip": "110019"

  },

  "regionType": "INDIAN",

  "orderDetails": {

    "codValue": 0,

    "invoiceNumber": "INV-10",

    "invoiceTime": "2021-06-18T12:00:01Z",

    "invoiceValue": 100.00,

    "isCod": false,

    "orderDate": "2021-06-17T17:32:02Z",

    "orderLineItemList": [

      {

        "clientSkuId": "sku-1",

        "finalAmountPaid": 100.00,

        "imageUrl": "xyz",

        "name": "Shirt",

        "price": 100.00,

        "quantity": 1,

        "storeCreditsUsed": 0.0

      }

    ],

    "orderNumber": "order12345"

  },

  "pickupAddress": {

    "city": "Delhi",

    "country": "India",

    "email": "ram@gmail.com",

    "firstName": "Ram",

    "lastName": "Mehta",

    "middleName": "",

    "phone": "8135671272",

    "state": "DELHI",

    "street1": "Mathalli area",

    "street2": "Opposite Ring road",

    "street3": "",

    "zip": "110020"

  },

  "sellerGstin": "29AADCP7081J1ZY",

  "shipmentDimension": {

    "breadth": 10,

    "height": 10,

    "length": 10,

    "weight": 1

  },

  "shippingAndBillingAddressSame": true,

  "logisticAggregatorType": "CLICKPOST",

  "warehouseCode": "wh-1"

}

Response

{

    "documentUrl": "https://pyck-res-bucket.s3.amazonaws.com:443/SELF/2021-06-18/order12345.pdf",

    "courierName": "Self",

    "awbNo": "order12345"

}

Parameter Name

Data Type

Description

documentUrl

String

PDF Url of the shipping label

courierName

String

Courier name

awbNo

String

Awb Number

  • No labels