Inbound | POST | /invoice/invoice-pdf
Summary
This API is used to create Invoice PDF.
Description
This API will be used to create the Invoice PDF for the orders for which tax details were already calculated. So, before making this API call, the compute tax details API call would need to be made first with the request param “store” as true.
Request Params
referenceNo
Parameter Name | Data Type | Description | Mandatory |
| String | This is the unique id against which the tax details were calculated and the invoice PDF needs to be generated. | yes |
Request
{
"billingAddress":{
"city":"Surat",
"country":"India",
"email":"mohit@gmail.com",
"street1":"A-102, Balaji Residency",
"street2":"Motera",
"street3":"",
"firstName":"Mohit",
“middleName”:””,
“lastName”:”Singh”,
"phone":"9121726219",
"state":"Gujarat",
"zip":"394518"
},
"shippingAddress":{
"city":"Surat",
"country":"India",
"email":"mohit@gmail.com",
"street1":"A-102, Balaji Residency",
"street2":"Motera",
"street3":"",
"firstName":"Mohit",
“middleName”:””,
“lastName”:”Singh”,
"phone":"9121726219",
"state":"Gujarat",
"zip":"394518"
},
"fromAddress":{
"city":"Bangalore",
"country":"India",
"email":"ram@gmail.com",
"street1":"Mathalli area",
"street2":"Opposite Ring road",
"street3":"",
"firstName":"Ram",
“middleName”:””,
“lastName”:”Mehta”,
"phone":"8135671272",
"state":"Karnataka",
"zip":"560102"
},
"clientPanNo":"AAAAA1111A",
"currency":"INR",
"fromPartyName":"Puma",
"orderTime":"2021-04-15T05:30:00+05:30",
"timeZone":"Asia/Kolkata",
"toPartyName":"Customer",
"orderType":"SALES",
"internalOrderId":"122334",
“channelOrderId”:”channel-order-23”,
“channelName”:”FLIPKART”,
"invoiceItems":[
{
"lineItemId":1,
"channelSku":"flipkart-sku-2",
"itemName":"Shirt"
}
]
}
Parameter Name | Data Type | Description | Mandatory |
| Object | Billing Address of the customer | Yes |
| String | City of customer | Yes |
| String | Country of customer | Yes |
| String | Email of customer | No |
| String | 1st line of customer address | Yes |
| String | 2nd line of customer address | No |
| String | 3rd line of customer address | No |
| String | First Name of customer | Yes |
| String | Middle Name of customer | No |
| String | Last Name of customer | Yes |
| String | Phone number of customer | No |
| String | State of customer | Yes |
| String | Zip/Pin code of customer | Yes |
| Object | Total quantity of a sku for a line item | Yes |
| String | City of customer | Yes |
| String | Country of customer | Yes |
| String | Email of customer | No |
| String | 1st line of customer address | Yes |
| String | 2nd line of customer address | No |
| String | 3rd line of customer address | No |
| String | First Name of customer | Yes |
| String | Middle Name of customer | No |
| String | Last Name of customer | Yes |
| String | Phone Number of customer | No |
| String | State of customer | Yes |
| String | Zip/Pin code of customer | Yes |
| Object | Seller Address | Yes |
| String | City of Seller | Yes |
| String | Country of Seller | Yes |
| String | Email of Seller | No |
| String | 1st line of Seller address | Yes |
| String | 2nd line of Seller address | No |
| String | 3rd line of Seller address | No |
| String | First Name of Seller | Yes |
| String | Middle Name of Seller | No |
| String | Last Name of Seller | Yes |
| String | Phone Number of Seller | No |
| String | State of Seller | Yes |
| String | Zip/Pin code of Seller | Yes |
| String | Client Pan Number | Yes |
| String | Currency (default value is “INR”) | No |
| String | Name of Seller | Yes |
| Date | Order Date and Time | Yes |
| String | Time Zone in which order time and invoice time will be printed | Yes |
| String | Name of customer | Yes |
| String | Type of order. Can have one of these two values:”SALES” and “STOCK_TRANSFER” | Yes |
| String | Internal Order Id in Seller’s system | Yes |
| String | Channel Order Id | No |
| String | Channel Name | No |
| Object[] | Invoice Items | No |
| Long | Unique Identifier for the line items (should be the same as the line item id used for computing tax) | Yes |
| String | Channel SKU | Yes |
| String | Item Name | Yes |
Response
{
"referenceNo":"order1234",
"invoiceId":"INCREFF_1003",
"documentUrl":"https://storage.googleapis.com/dev-oltp-nextscm-com/1001080/Invoice/invoice_INCREFF_1003.pdf",
"invoiceDate":"2021-06-11T19:43:20.673+05:30"
}
Parameter Name | Data Type | Description | Mandatory |
| String | Unique Identifier for which Invoice is being generated | Yes |
| String | Invoice Id for the Invoice generated | Yes |
| String | Downloadable URL of the InvoicePDF | Yes |
| Date | Invoice Time | Yes |
FAQs
For E-Invoice generation, will the same API be used?
Yes, the same API will be used. You will get the additional e-invoice applicable fields in the response such as IRN, QR code etc. Refer the below sample response for E-Invoice.
Is it mandatory to make the Compute Tax API call before the Create Invoice API call?
It is mandatory to make the Compute Tax API call before the Create Invoice API call if you are not passing the tax details in the request payload of the create invoice API call.
If you are passing the tax details in the request payload of the Create Invoice API call, then the Compute Tax call is not required to be made.