How invoicing works
There can be different invoicing cases(discounts, additional charges) on an order. This guide outlines different invoicing cases on an order.
Before we start
This guide assumes that you're familiar with creating an Order.
Step by step guide
Cart Discount
It is implemented on the whole order, the total discount is divided equally on each item. Refer to the below table while creating an order request.
Attribute
Field
Value
Order
subtotal
sum of all lineItemTotal of an order
Order
orderTotal
subtotal + shipping charges
Order
balanceDue
If order is COD, balanceDue = orderTotal
Items
items.discount
Discount(in case of multiple items discount = total Discount/No of items)
Items
items.customerPrice
Selling Price[Inclusive of taxes]
Items
items.lineItemTotal
(Selling Price- Discount)*Quantity
Sample request when cart discount is applied on an order:
{
"id": 1842937,
"externalChannelID": "TATA CLIQ VELOCY KAPAS KRAFT",
"customerOrderNumber": "OD119208447831346000",
"vendorOrderNumber": "11920832654052201",
"shipMethod": "STD",
"orderDate": "2020-07-09 17:51:05",
"expectedShipDate": "2020-07-10 15:00:00",
"promiseDeliveryDate": "0000-00-00 00:00:00",
"isCOD": "0",
"paymentType": "DebitCard",
"taxAmount": 0,
"shipChargeAmount": 150,
"subtotal": 1499,
"orderTotal": 1649,
"balanceDue": 0,
"thirdPartyShipping": true,
"onHold": false,
"created_at": "2020-07-09 18:03:29",
"updated_at": "2020-07-09 18:03:29",
"shippingAddress": {
"customerName": "John Doe",
"addressLine1": "Kapas Kraft Apparels Limited",
"addressLine2": "Banglore",
"city": "bengluru",
"state": "Karnataka",
"postalCode": "560005",
"countryCode": "IN",
"countryName": "India",
"contactPhone": "9998889998",
"email": "johndoe@gmail.com"
},
"billingAddress": {
"customerName": "John Doe",
"addressLine1": "Kapas Kraft Apparels Limited",
"addressLine2": "Banglore",
"city": "bengluru",
"state": "Karnataka",
"postalCode": "560005",
"countryCode": "IN",
"countryName": "India",
"contactPhone": "9998889998",
"email": "johndoe@gmail.com"
},
"items": [
{
"lineItemSequenceNumber": 123279,
"orderItemID": "11920832654052201",
"itemID": "DB9U03FMGWZ",
"sku": "1234_S",
"productName": "Step Maro Sol",
"quantity": 1,
"customerPrice": 1999,
"discount": 500,
"lineItemTotal": 1499,
"taxRate": 0,
"taxAmount": 0,
"giftMessage": "",
"giftLabelContent": "",
"cancellationReason": "",
"cancellationTime": "0000-00-00 00:00:00",
"original_order_item_id": null
}
],
"expectedDeliveryDate": null
}
Shipping Fees
The shipping fee is the cost used to ship items to a buyer. Refer to the below table while creating an order request.
Attribute
Field
Value
Order
shipChargeAmount
shipping charges on the order level
Order
subtotal
sum of all lineItemTotal of an order
Order
orderTotal
subtotal + shipping charges
Sample request when shipping fee is added to an order:
{
"id": 1842996,
"externalChannelID": "TATA CLIQ VELOCY KAPAS KRAFT",
"customerOrderNumber": "OD119208447831346000",
"vendorOrderNumber": "11920832654052201",
"shipMethod": "STD",
"orderDate": "2020-07-09 18:08:10",
"expectedShipDate": "2020-07-10 15:00:00",
"promiseDeliveryDate": "0000-00-00 00:00:00",
"isCOD": "1",
"paymentType": "CashOnDelivery",
"taxAmount": 0,
"shipChargeAmount": 150,
"subtotal": 2399,
"orderTotal": 2549,
"balanceDue": 2549,
"thirdPartyShipping": true,
"onHold": false,
"created_at": "2020-07-09 18:13:32",
"updated_at": "2020-07-09 18:13:32",
"shippingAddress": {
"customerName": "John Doe",
"addressLine1": "Kapas Kraft Apparels Limited",
"addressLine2": "Banglore",
"city": "bengluru",
"state": "Karnataka",
"postalCode": "560005",
"countryCode": "IN",
"countryName": "India",
"contactPhone": "9998889998",
"email": "johndoe@gmail.com"
},
"billingAddress": {
"customerName": "John Doe",
"addressLine1": "Kapas Kraft Apparels Limited",
"addressLine2": "Banglore",
"city": "bengluru",
"state": "Karnataka",
"postalCode": "560005",
"countryCode": "IN",
"countryName": "India",
"contactPhone": "9998889998",
"email": "johndoe@gmail.com"
},
"items": [
{
"lineItemSequenceNumber": 123282,
"orderItemID": "11920832654052201",
"itemID": "DB9U03FMGWZ",
"sku": "1234_S",
"productName": "Reazor Edge",
"quantity": 1,
"customerPrice": 2399,
"discount": 0,
"lineItemTotal": 2399,
"taxRate": 0,
"taxAmount": 0,
"giftMessage": "",
"giftLabelContent": "",
"cancellationReason": "",
"cancellationTime": "0000-00-00 00:00:00",
"original_order_item_id": null
}
],
"expectedDeliveryDate": null
}
Last updated
Was this helpful?