Versions Compared

Old Version 2

changes.mady.by.user Shivani Verma (Unlicensed)

Saved on

compared with

New Version Current

changes.mady.by.user Suprit Bhattacharjee

Saved on

Key

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

...

This API will compute and fetch the tax details. Tax details can optionally be stored in MiniOMS RMS against a unique reference no based on the request parameter “store”.

Tax Computation Logic

  1. The user uploads the applicable tax rate rule (e.g. GST_APPAREL, GST_FOOTWEAR, GST_5, GST_8) using the UI for all HSNs

  2. Caller invokes the APIs with line items (with HSN codes and tax rule)

  3. If Tax Rule is given, that is consumed directly

  4. Else, The system finds the applicable tax rate using the following logic

    1. Find the rule for matching 8 digit HSN code.

    2. If not found, then find rule for matching 6 digit HSN  code

  5. From the selling price and state data compute

    1. Base price

    2. Taxes

    3. Tax breakup

Request Params

  • store

Parameter Name

Data Type

Description

Mandatory

store

Boolean

This parameter specifies if the tax details need to be stored or not. This parameter is true if tax details need to be stored.

yes

...

  "fromZip": "560102",

  "referenceNoorderCode": "order1234",

  "shipmentCode": "s101",

  "toStatetoBillingState": "Gujarat",

  "toTin"toBillingZip": "394518",

"toShippingState": "19AADCP7081J1ZZGujarat",

  "toZiptoBillingZip": "394518",

  "toTin": "19AADCP7081J1ZZ",

  "lineItems": [

     {

       "actualSellingPricePerUnit": 100.00,

...

Parameter Name

Data Type

Description

Mandatory

fromCountryCode

String

Country Code of Seller

yes

fromState

String

State of Seller

yes

fromTin

String

Seller GSTIN

yes

fromZip

String

Zip/Pin code of Seller

yes

referenceNoorderCode

String

Unique Id to identify the order/shipment against which tax is Identifier for the order whose tax details are being calculated

yes

shipmentCode

String

Identifier for the shipment whose tax details are being calculated

yes

toStatetoShippingState

String

Shipping State of Customer

yes

toShippingZip

String

Shipping Zip/Pin code of Customer

yes

toTintoBillingState

String

Billing State of Customer GSTIN

noyes

toZiptoBillingZip

String

Billing Zip/Pin code of Customer

yes

toTin

String

Customer GSTIN

no

attributes

Object[]

Order level extra attributes to be stored

no

attributes.key

String

Name of attribute

yes

attributes.value

String 

Value of attribute

yes

lineItems

Object[]

Line Items for which tax details needs to be calculated

yes

lineItems.actualSellingPricePerUnit

Double

Selling price of the item per unit

yes

lineItems.hsn

String

HSN code for the product

yes

lineItems.lineItemId

Long

Unique Id to identify the line item

yes

lineItems.quantity

Integer

Quantity of the product

yes

lineItems.sku

String

SKU of the product

yes

lineItems.orderItemCode

String

Order Item Code in your system

no

lineItems.channelSku

String

Channel Sku of item

no

lineItems.taxRule

String

Tax Rule for the product. If passed, this will be used for tax calculation. Otherwise tax rule will be fetched from the HSN-Tax Rule mapping uploaded on UI

no

lineItems.attributes

Object[]

LineItem level extra attributes to be stored

no

lineItems.attributes.key

String

Name of attribute

yes

lineItems.attribute.value

String

Value of attribute

yes

...

            ]

        }

    ]

}

FAQs

For which countries is tax computation supported by RMS?

Right now, tax computation is supported for India and UAE. For India, tax computation is supported for shipments being transported within India and outside India as well.

If the request parameter “store“ is being passed as true and the data is being stored, where can I see this stored data?

You can see the stored data in the RMS Reports section in RMS UI.

Since both billing and shipping states and zips are being passed in the request payload, how does RMS decide whether IGST is to be applied or CGST/SGST is to be applied?

If the “toTin“ field has some value that is not “NA“ or ““(empty string), then it is considered as a B2B transaction and the billing state/zip would be considered for tax computation. Otherwise, it would be considered as B2C transaction.