Update a UAE Item

Updates an item given its ID on DigiTax. Only the fields you send change; fields you leave out keep their current value.

For hs_code, service_accounting_code, standard_item_id, standard_item_scheme and origin_country_code, send an empty string to clear the value, as long as the item stays valid (for example, an item with a commodity code of goods needs its hs_code, and standard_item_id and standard_item_scheme are cleared together). name, description, commodity_code and item_code cannot be cleared. When sent, item_properties replaces the item's properties in full.

The commodity, HS code and service accounting code rules are the same as on create and are checked against the item as it will be after the update, so changing commodity_code usually means sending the matching codes in the same request.

item_code can only be set on an item that has none yet, and returns an error if the code is already used by another item. It cannot be changed afterwards.

Invoices already created keep the item details they were issued with.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Item ID on DigiTax

Body Params
string

The name of the item

string

A description of the item

string

The commodity type code (G for goods, S for services, B for both). See GET /resources/commodity-codes for available values.

string

The Harmonized System (HS) code for the item. Required when commodity_code is G or B, and not allowed when it is S. See GET /resources/hs-codes.

string

The Service Accounting Code for the item. Required when commodity_code is S or B, and not allowed when it is G. See GET /resources/service-codes.

string

A unique code assigned to the item in your system. Can only be set when the item has no item code yet.

string

A standardised item identifier. Needs standard_item_scheme.

string

The scheme for the standard item identifier. See GET /resources/international-code-designator-schemes for available values.

string

The ISO 3166-1 alpha-2 code of the item's country of origin. See GET /resources/countries for available values.

item_properties
array of objects

Additional item attributes. Replaces the existing properties in full.

item_properties
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json