Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Code Block
languagejson
{
  "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

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