Skip to main content

TaxableItemSnapshot

Zuora

TaxableItemSnapshot

This feature is in Limited Availability. If you want to have access to the feature, submit a request at Zuora Global Support

The TaxableItemSnapshot object holds a taxable item snapshot for an individual invoice item or an individual invoice item adjustment. You can create and query snapshots using this object.

See Taxable Item Snapshot for more information.

Supported calls

You can use this object with the following calls:

You are not allowed to update the TaxableItemSnapshot object. You can delete the snapshot and create a new one.

Field Descriptions

All field names are case sensitive. Check enumerated values in descriptions to confirm capitalization and spacing. See Field Types for additional information.

Name Required to Create? Allowed Operations Description
TaxableItemId required Create
Query
Delete
Filter

The Id of an invoice item or invoice item adjustment that the taxation item applies to.

Type: zns:ID
Character limit: 32
Version notes: WSDL 82.0+
Values: A valid item Id of an invoice or invoice item adjustment

ItemType required Create
Query
Delete
Filter

Type of the item.

Type: string (enum)
Character limit: 10
Version notes: WSDL 82.0+
Values

  • Invoice
  • InvoiceItemAdjustment
TaxDate required Create
Query
Delete
Filter

The date that the tax is applied to the charge.

Type: dateTime
Character limit: 29
Version notes: WSDL 82.0+
Values: A valid date format in yyyy-mm-dd

TaxCodeName required Create
Query
Delete
Filter

A meaningful string used to identify the tax code, and is mapped to the product charge. For example, "Freight service".

Type: string 
Character limit: 64
Version notes: WSDL 82.0+
Values: A string of 64 characters or fewer

TaxMode required Create
Query
Delete
Filter

The type of tax mode for the account.

Type: string (enum)
Character limit: 32
Version notes: WSDL 82.0+
ValuesTaxExclusiveTaxInclusive

CompanyCode optional Create
Query
Delete
Filter

A unique code that identifies a company account.

Type: string
Character limit: 50
Version notes: WSDL 82.0+
Values: A string of 50 characters or fewer

VatId optional Create
Query
Delete
Filter

EU Value Added Tax ID.

Type: string
Character limit: 25
Version notes: WSDL 82.0+
Values: A valid Value Added Tax ID

TaxExemptStatus optional Create
Query
Delete
Filter

Status of the account's tax exemption.

Type: string (enum)
Character limit: 19
Version notes: WSDL 82.0+
Values

  • Yes
  • No
  • PendingVerification
TaxExemptCertificateID optional Create
Query
Delete
Filter

ID of your customer's tax exemption certificate.

Type: string
Character limit: 32
Version notes: WSDL 82.0+
Values: A string of 32 characters or fewer

TaxExemptCertificateType optional Create
Query
Delete
Filter

Type of the tax exemption certificate that your customer holds. 

Type: string
Character limit: 32
Version notes: WSDL 82.0+
Values: A string of 32 characters or fewer

TaxExemptEffectiveDate optional Create
Query
Delete
Filter
The date when the customer's tax exemption starts.

Type: dateTime
Character limit: 29
Version notes:  WSDL 82.0+
Values: A valid date format in yyyy-mm-dd

TaxExemptEntityUseCode optional Create
Query
Delete
Filter

A unique entity use code to apply exemptions in Avalara AvaTax.

This account-level field is required only when you choose Avalara as your tax engine. See Exempt Transactions for more details. 

Type: string
Character limit: 32
Version notes: WSDL 91.0+
Values: A string of 32 characters or fewer

TaxExemptExpirationDate optional Create
Query
Delete
Filter

The date when the customer's tax exemption certificate expires.

Type: dateTime
Character limit: 29
Version notes: WSDL 82.0+
Values: The date format in yyyy-mm-dd

TaxExemptIssuingJurisdiction optional Create
Query
Delete
Filter
Indicates the jurisdiction in which the customer's tax exemption certificate was issued.

Type: string
Character limit: 32
Version notes: WSDL 82.0+
Values: A string of 32 characters or fewer

TaxExemptDescription optional Create
Query
Delete
Filter

Description of the tax exemption certificate that your customer holds.

Type: string
Character limit: --
Version notes: WSDL 82.0+
Values: A string

DestAddressRegion optional Create
Query
Delete
Filter

The region of the destination address.

Type: string
Character limit: 32
Version notes: WSDL 82.0+
Values: A string of 32 characters or fewer

DestAddressCountry required Create
Query
Delete
Filter

The country of the destination address.

Type: string
Character limit: 32
Version notes: WSDL 82.0+
Values: A string of 32 characters or fewer

DestAddressState optional Create
Query
Delete
Filter

The state of the destination address.

Type: string
Character limit: 40
Version notes: WSDL 82.0+
Values: A string of 40 characters or fewer

DestAddressCounty optional Create
Query
Delete
Filter

The county of the destination address.

Type: string
Character limit: 32
Version notes: WSDL 82.0+
Values: A string of 32 characters or fewer

DestAddressCity optional Create
Query
Delete
Filter

The city of the destination address.

Type: string
Character limit: 40
Version notes: WSDL 82.0+
Values: A string of 40 characters or fewer

DestAddressPostalCode optional Create
Query
Delete
Filter

The postcode of the destination address.

Type: string
Character limit: 20
Version notes: WSDL 82.0+
Values: A string of 20 characters or fewer

DestAddressLine1 optional Create
Query
Delete
Filter

The address line 1 of the destination address.

Type: string
Character limit: 255
Version notes: WSDL 82.0+
Values: A string of 255 characters or fewer

DestAddressLine2 optional Create
Query
Delete
Filter

The address line 2 of the destination address.

Type: string
Character limit: 255
Version notes: WSDL 82.0+
Values: A string of 255 characters or fewer

Example

The following is a sample SOAP request for creating a taxable item snapshot.

<ns1:create>
<ns1:zObjects xsi:type="ns2:TaxableItemSnapshot">
  <ns2:DestAddressCountry>US</ns2:DestAddressCountry>
  <ns2:ItemType>InvoiceItem</ns2:ItemType>
  <ns2:TaxableItemId>4028902a58bd5d130158bebbe1b9036b</ns2:TaxableItemId>
  <ns2:TaxCodeName>TaxCode2</ns2:TaxCodeName>
  <ns2:TaxDate>2019-12-02</ns2:TaxDate>
  <ns2:TaxMode>TaxExclusive</ns2:TaxMode>
</ns1:zObjects>
</ns1:create>