Skip to main content
Version: 7.6.x

Taxes

Taxes describe the amount of tax owing for orders, shipments and shipment lineitems.

Read Order Taxes​

Retrieves the total tax for an order; which includes the order’s tax amount, currency, and type of tax (VAT - Value Added Tax, HST - Harmonized Sales Tax, etc.).

Workflow​

  1. Start with order
  2. GET the link with rel: tax
  3. Render the response

Response Fields​

Type: taxes.taxes​

NameDescriptionType
totalThe total tax.object
  currencyThe currency the cost is in.string
  amountThe decimal value of the cost.decimal
  displayFormatted currency string that can be displayed on the client application.string
costThe cost of the tax(es).array
  titleThe name of the tax.string
  currencyThe currency the cost is in.string
  amountThe decimal value of the cost.decimal
  displayFormatted currency string that can be displayed on the client application.string

Read Shipment Taxes​

Retrieves the total tax for a shipment; which includes the shipments’ tax amount, currency, and type of tax (VAT, HST, etc.).

Workflow​

  1. Start with shipment
  2. GET the link with rel: tax
  3. Render the response

Response Fields​

Type: taxes.taxes​

NameDescriptionType
totalThe total tax.object
  currencyThe currency the cost is in.string
  amountThe decimal value of the cost.decimal
  displayFormatted currency string that can be displayed on the client application.string
costThe cost of the tax(es).array
  titleThe name of the tax.string
  currencyThe currency the cost is in.string
  amountThe decimal value of the cost.decimal
  displayFormatted currency string that can be displayed on the client application.string

Read Shipment Line Item Taxes​

Retrieve the tax amount for a shipment line item.

Workflow​

  1. Start with shipment-line-item
  2. GET the link with rel: tax
  3. Render the response

Response Fields​

Type: taxes.taxes​

NameDescriptionType
totalThe total tax.object
  currencyThe currency the cost is in.string
  amountThe decimal value of the cost.decimal
  displayFormatted currency string that can be displayed on the client application.string
costThe cost of the tax(es).array
  titleThe name of the tax.string
  currencyThe currency the cost is in.string
  amountThe decimal value of the cost.decimal
  displayFormatted currency string that can be displayed on the client application.string