Update a product tax information.
put
https://api.mercadoe.com/v1/products/taxes/{taxId}
Updates the tax configuration for a specific product, including its relevant jurisdictions, base amount, tax rate, validity period, and other fiscal details.
Request
Headers
X-ME-CORRELATION-ID
string
Internal client code to be identified in the webhook. It can be, for example, a product code in your ERP, an order number, etc.
Path Parameters
taxId
int32
required
Body
application/json
clientProductId
string
Identifier of the product as registered by the client.
clientSupplierId
string
Identifier of the supplier as defined by the client.
clientGroupId
string
Identifier of the product group or category as defined by the client.
issuingStateTax
string
State of origin (UF) of the product used for ICMS tax calculation.
receivingStateTax
string
Destination state (UF) of the product used for ICMS tax calculation.
icmsTax
double
Amount of ICMS tax calculated for the product.
taxBaseAmount
double
Tax base amount used for calculating ICMS.
startDate
date-time
Start date when this tax configuration becomes valid.
endDate
date-time
End date for the validity of this tax configuration.
isEnabled
boolean
Indicates whether this tax configuration is inactive or disabled.
applicationType
string
Code that identifies the product’s application or intended use.
productIdentificationCode
string
NCM (Common Mercosur Nomenclature) code used for fiscal classification of the product.
materialOrigin
int32 | null
Identifier of the material’s origin (e.g., domestic, imported) used in tax calculations.
1 = Domestic origin
2 = Foreign origin
1 = Domestic origin
2 = Foreign origin
estimatedPrice
double | null
Indicates if the product has a fixed unit price based on quantity.
businessOrganizations
array of object | null
Business Organizations is a list consisting of company code, description, delivery center code, delivery center description, and entity type.
Responses
202
400
404
Accepted
Body
application/json
clientProductId
string
Identifier of the product as registered by the client.
clientSupplierId
string
Identifier of the supplier as defined by the client.
clientGroupId
string
Identifier of the product group or category as defined by the client.
issuingStateTax
string
State of origin (UF) of the product used for ICMS tax calculation.
receivingStateTax
string
Destination state (UF) of the product used for ICMS tax calculation.
icmsTax
double
Amount of ICMS tax calculated for the product.
taxBaseAmount
double
Tax base amount used for calculating ICMS.
startDate
date-time
Start date when this tax configuration becomes valid.
endDate
date-time
End date for the validity of this tax configuration.
isEnabled
boolean
Indicates whether this tax configuration is inactive or disabled.
applicationType
string
Code that identifies the product’s application or intended use.
productIdentificationCode
string
NCM (Common Mercosur Nomenclature) code used for fiscal classification of the product.
materialOrigin
int32 | null
Identifier of the material’s origin (e.g., domestic, imported) used in tax calculations.
1 = Domestic origin
2 = Foreign origin
1 = Domestic origin
2 = Foreign origin
estimatedPrice
double | null
Indicates if the product has a fixed unit price based on quantity.
businessOrganizations
array of object | null
Business Organizations is a list consisting of company code, description, delivery center code, delivery center description, and entity type.