--- schema_version: "1" id: f33bcb80a44903010e9d728536ac9796146a3a8d060fb48754f9f1783388aec9 title: TaxRate collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_taxrate.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_taxrate.htm source_site: developer.salesforce.com content_type: documentation content_hash: 2a127ea68aa87dec53d858fa7189f7b14c71be35ba5308209be4bd27db68f17c description: Represents a tax rate for a tax code and country. This object is available in API version 56.0 and later. --- # TaxRate Represents a tax rate for a tax code and country. This object is available in API version 56.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update(), upsert() ## Special Access Rules The TaxRate object is available if B2B Commerce or D2C Commerce is enabled. ## Fields | Field | Details | | --- | --- | | ApplicationBasis | Type picklist Properties Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Specifies whether the tax rate is applied on the net or gross amount. Possible values are: - Gross - Net The default value is Gross. | | City | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The city to which the tax rate applies. | | Country | Type string Properties Filter, Group, Nillable, Sort Description The country name that’s derived from the GeoCountry field value. This field is a calculated field. | | CurrencyIsoCode | Type picklist Properties Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The currency ISO code that’s applicable to the tax rate. Possible values are: - AUD—Australian Dollar - EUR—Euro - GBP—British Pound - USD—U.S. Dollar The default value is USD. | | EndDate | Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The date until when the tax rate is valid. | | FlatTaxAmount | Type double Properties Create, Filter, Nillable, Sort, Update Description The flat tax amount that’s applied to the transaction. | | GeoCountryId | Type reference Properties Create, Filter, Group, Sort Description The ID of the GeoCountry for which the tax rate applies. You can define only one tax rate per GeoCountry and tax code combination. This field is a relationship field. Relationship Name GeoCountry Relationship Type Lookup Refers To GeoCountry | | GeoStateId | Type reference Properties Create, Filter, Group, Nillable, Sort Description The ID of the GeoState for which the tax rate applies. This field is a relationship field. Relationship Name GeoState Refers To GeoState | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last accessed this record, a record related to this record, or a list view. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last viewed this record or list view. If this value is null, it's possible the user accessed data in this record or list view but didn't viewed it directly. | | LegalEntityId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The legal entity to which the tax rate applies. This field is a relationship field. Relationship Name LegalEntity Refers To LegalEntity | | Name | Type string Properties Autonumber, Defaulted on create, Filter, idLookup, Sort Description The unique ID of the tax rate. | | OwnerId | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The TaxRate record owner. By default, the record owner is the user who created the record. This field is a polymorphic relationship field. Relationship Name Owner Relationship Type Lookup Refers To Group, User | | Priority | Type int Properties Create, Defaulted on create, Filter, Group, Nillable, Sort, Update Description Reserved for future use. | | ProductCode | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The code of the product for which the tax rate applies. | | Rate | Type double Properties Create, Filter, Sort, Update Description The tax percentage rate that will be applied to orders. | | RateUsageType | Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description Specifies whether the tax rate is created for Commerce or Revenue Cloud. Possible values are: - Commerce - RevCloud—Revenue Cloud The default value is Commerce. | | StartDate | Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The date from when the tax rate is valid. | | State | Type string Properties Filter, Group, Nillable, Sort Description The state name that’s derived from the GeoState field value. This field is a calculated field. | | TaxCode | Type string Properties Create, Filter, Group, Sort Description The code used to calculate the tax rate for the invoice line. | | ZipCode | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The postal or ZIP code to which the tax rate applies. | ## Associated Objects This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later. [TaxRateChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") Change events are available for the object. [TaxRateFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") Feed tracking is available for the object. [TaxRateHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. [TaxRateOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.") Sharing rules are available for the object. [TaxRateShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.") Sharing is available for the object.