Get Invoice API

Outbound | GET | {Client’s URL}

Summary

This API will fetch invoice URL along with tax details .

Description

This API will fetch invoice URL and the tax details. Invoice URL should point to invoice file in pdf format.

Request Params

shipmentCode
orderCode

Parameter Name	Data Type	Description	Mandatory
`shipmentCode`	String	Unique code used by the channel to identify the shipment	yes
`orderCode`	String	Unique code used by the channel to identify the order	yes

Response

{
  "invoiceCode": "INV123",
  "invoiceUrl": "https://mybrand.com/invoice123.pdf",
  "invoiceDate": "2020-10-16T20:22:28.000+05:30",
  "invoice": "invoiceBase64String",
  "invoiceDetails": [
    {
      "channelSkuCode": "100000789702",
      "orderItemCode": "item123",
      "netTaxAmountPerUnit": 60,
      "netTaxAmountTotal": 120,
      "baseSellingPricePerUnit": 500,
      "baseSellingPriceTotal": 1000,
      "actualSellingPricePerUnit": 560,
      "actualSellingPriceTotal": 1120,
      "quantity": 2,
      "taxItems": [
        {
          "type": "SGST",
          "rate": 6,
          "taxPerUnit": 30,
          "taxTotal": 60
        },
        {
          "type": "CGST",
          "rate": 6,
          "taxPerUnit": 30,
          "taxTotal": 60
        }
      ]
    }
  ]
}

HttpStatus : 200

Note:

At least one of invoiceUrl or invoice should be present.
If invoice details are being sent, then taxItems are mandatory.

Parameter Name	Data Type	Description	Mandatory
`invoiceCode`	String	Invoice Number that is printed on the invoice PDF	Yes
`invoiceUrl`	String	Downloadable pdf url of the invoice document(either of invoice and invoice Url is mandatory)	no
`invoiceDetails`	Object[]	Tax Details of the invoice	Yes
`invoiceDate`	String	Date of invoice generated by Assure	Yes
`invoice`	String	Base64 encoded string of invoice PDF(either of invoice and invoice Url is mandatory)	no
`invoiceDetails.channelSkuCode`	String	SKU code of order item	Yes
`invoiceDetails.orderItemCode`	String	This is provided by the channel to uniquely identify each order item.	No
`invoiceDetails.netTaxAmountPerUnit`	Double	Per unit tax applicable for the SKU	Yes
`invoiceDetails.netTaxAmountTotal`	Double	Total tax applicable for the SKU	Yes
`invoiceDetails.baseSellingPricePerUnit`	Double	Per unit base selling price of the SKU	Yes
`invoiceDetails.baseSellingPriceTotal`	Double	Total base selling price of the SKU	Yes
`invoiceDetails.actualSellingPricePerUnit`	Double	Per unit actual selling price of the SKU	Yes
`invoiceDetails.actualSellingPriceTotal`	Double	Total actual selling price of the SKU	Yes
`invoiceDetails.quantity`	Integer	Total quantity of a sku for a line item	Yes
`invoiceDetails.taxItems`	Object[]	Distribution of tax with tax type	Yes
`taxItems.type`	String	Type of tax applicable	Yes
`taxItems.rate`	Double	Tax rate for this tax type	Yes
`taxItems.taxPerUnit`	Double	Per unit tax applicable for this type of tax	Yes
`taxItems.taxTotal`	Double	Total tax applicable for this type of tax	Yes