Calculate Tax as a Seller
Learn about calculating tax for sellers.
Calculate tax as a seller
| Endpoint | Method | Key values | Required fields |
|---|---|---|---|
/v2/supplies | POST | saleMessageType | transactionType, lineItems |
This request represents tax calculation from the seller's perspective. It performs a calculation request based on the set property of the Sale Message Type. Valid values are: Quotation, Invoice, or Distribute Tax. Based on the SaleMessageType value, a tax calculation is performed and may or may not be saved for reporting and tax remittance.
Sales message types
| Message type | Description |
|---|---|
| Quotation | A quotation request is used to estimate taxes on a proposed sale or rental by the seller. Because it is an estimate, a quotation request is subject to change until the transaction is finalized and is not stored for reporting and remittance. |
| Invoice | An Invoice request is used to initiate tax calculation on a transaction. Use this request to calculate tax at the time of shipping, billing, or invoicing from the seller's perspective. Invoice transactions are stored and used for reporting and remittance. |
| Distribute Tax | A Distribute tax message is used to initial a Distribute Tax Calculation. This request can be used for a tax-only adjustment (debit or credit) to reconcile a tax underpayment or overpayment. It accepts a combined total tax amount for a purchase and distributes that tax to the appropriate jurisdictions. The engine uses the total tax amount with the combined rate for the taxing jurisdictions to determine the taxable base and then redistributes the calculated taxes to each level for remittance. Distribute tax transactions are stored and may affect revenue and be used in reporting and remittance. |
Child lines and the lineItems array
All calculation requests include alineItems array, which is the header for a component (a line) of a transaction. A separate lineItems array is required for each component (line) to be calculated in a tax calculation request.
One of the objects in a header-level lineItems array is a sub-level lineItems array, used for the calculation of child lines. Child lines are transaction lines that belong to a parent line on a transaction. Child lines are required for complex taxing scenarios, such as bundled services, multi-line calculation for line-based telecommunications taxes, and the allocation of accruals.
A sub-level lineItems array includes the same objects and fields as a header-level lineItems array, so each sub-level lineItems array contains its ownlineItems array. To allow for flexibility during calculation, O Series supports the calculation of child lines that belong to other child lines.
Sample request - Calculate tax as a seller
curl --request POST \
--url https://developer.vertexcloud.com/api/v2/supplies
--header 'accept: application/json'
--header 'content-type: application/json'
--data '
{
"accumulationCustomerNumber": "string",
"accumulationDocumentNumber": "string",
"billingType": "string",
"companyCodeCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"currencyConversionFactors": [
{
"conversionFactor": 0,
"sourceCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"targetCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
}
}
],
"customer": {
"administrativeDestination": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"customerCode": {
"classCode": "string",
"isBusinessIndicator": true,
"value": "string"
},
"destination": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"exemptionCertificate": {
"exemptionCertificateNumber": "string",
"value": "string"
},
"exemptionReasonCode": "string",
"isTaxExempt": true,
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
]
},
"deliveryTerm": "EXW",
"discount": {
"discountType": "DiscountAmount",
"discountValue": 0,
"userDefinedDiscountCode": "string"
},
"documentDate": "2025-01-30",
"documentNumber": "string",
"documentSequenceId": "string",
"documentType": "string",
"exemptOverrides": [
{
"amount": 0,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"reasonCode": "string"
}
],
"franchiseAreaId": "string",
"impositionInclusions": [
{
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO"
}
],
"isTaxOnlyAdjustmentIndicator": true,
"lineItems": [
{
"amountBilledToDate": 0,
"chainTransactionPhase": "MANUFACTURER",
"commodityCode": {
"commodityCodeType": "string",
"value": "string"
},
"companyCodeCurrencyTaxAmount": 0,
"companyCodeCurrencyTaxableAmount": 0,
"cost": 0,
"costCenter": "string",
"countryOfOriginISOCode": "string",
"customer": {
"administrativeDestination": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"customerCode": {
"classCode": "string",
"isBusinessIndicator": true,
"value": "string"
},
"destination": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"exemptionCertificate": {
"exemptionCertificateNumber": "string",
"value": "string"
},
"exemptionReasonCode": "string",
"isTaxExempt": true,
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
]
},
"deliveryTerm": "EXW",
"departmentCode": "string",
"discount": {
"discountType": "DiscountAmount",
"discountValue": 0,
"userDefinedDiscountCode": "string"
},
"exemptOverrides": [
{
"amount": 0,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"reasonCode": "string"
}
],
"exportProcedure": "string",
"extendedPrice": 0,
"fairMarketValue": 0,
"flexibleFields": {
"flexibleCodeFields": [
{
"fieldId": 0,
"value": "string"
}
],
"flexibleDateFields": [
{
"fieldId": 0,
"value": "2025-01-30"
}
],
"flexibleNumericFields": [
{
"fieldId": 0,
"value": 0
}
]
},
"franchiseAreaId": "string",
"freight": 0,
"generalLedgerAccount": "string",
"impositionInclusions": [
{
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO"
}
],
"inputTotalTax": 0,
"intrastatCommodityCode": "string",
"isMulticomponent": true,
"landedCost": 0,
"lineItemId": "string",
"lineItemNumber": 0,
"lineType": {
"accumulationLocation": "string",
"content": "string",
"direction": "string",
"status": "string",
"value": "string"
},
"lineTypes": [
{
"accumulationLocation": "string",
"basis": "string",
"content": "string",
"count": 0,
"direction": "string",
"lineTypeNumber": 0,
"status": "string",
"value": "string"
}
],
"locationCode": "string",
"materialCode": "string",
"materialOrigin": "string",
"modeOfTransport": 0,
"natureOfTransaction": 0,
"netMassKilograms": 0,
"nonTaxableOverrides": [
{
"amount": 0,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"reasonCode": "string"
}
],
"product": {
"productClass": "string",
"value": "string"
},
"projectNumber": "string",
"quantity": {
"unitOfMeasure": "string",
"value": 0
},
"rateOverrides": [
{
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"rate": 0
}
],
"returnsFields": {
"returnsCodeFields": [
{
"name": "string",
"value": "string"
}
],
"returnsDateFields": [
{
"name": "string",
"value": "2025-01-30"
}
],
"returnsIndicatorFields": [
{
"name": "string",
"value": true
}
],
"returnsNumericFields": [
{
"name": "string",
"value": 0
}
]
},
"seller": {
"administrativeOrigin": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"company": "string",
"department": "string",
"dispatcher": {
"dispatcherCode": {
"classCode": "string",
"value": "string"
},
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
]
},
"division": "string",
"nexusIndicator": true,
"nexusReasonCode": "string",
"physicalOrigin": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
],
"utilityProvider": "REGULATED_TAXPAYER"
},
"simplificationCode": "CONSIGNMENT",
"situsOverride": {
"taxingLocation": "ADMINISTRATIVE_DESTINATION"
},
"statisticalValue": {
"amount": 0,
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
}
},
"supplementaryUnit": {
"unitType": "string",
"value": 0
},
"previousTaxPaid": 0,
"taxDate": "2025-01-30",
"taxIncludedIndicator": true,
"taxOverride": {
"overrideReasonCode": "string",
"overrideType": "TAXABLE"
},
"titleTransfer": "ORIGIN",
"transactionType": "SALE",
"unitPrice": 0,
"usage": "string",
"usageClass": "string",
"vendorSKU": "string",
"volume": {
"unitOfMeasure": "string",
"value": 0
},
"weight": {
"unitOfMeasure": "string",
"value": 0
}
}
],
"locationCode": "string",
"nonTaxableOverrides": [
{
"amount": 0,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"reasonCode": "string"
}
],
"orderType": "string",
"originalCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"paymentDate": "2025-01-30",
"postToJournal": true,
"postingDate": "2025-01-30",
"proratePercentage": 0,
"rateOverrides": [
{
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"rate": 0
}
],
"returnAssistedParametersIndicator": true,
"returnGeneratedLineItemsIndicator": true,
"returnTimeElapsedDetailsIndicator": true,
"roundAtLineLevel": true,
"saleMessageType": "QUOTATION",
"seller": {
"administrativeOrigin": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"company": "string",
"department": "string",
"dispatcher": {
"dispatcherCode": {
"classCode": "string",
"value": "string"
},
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
]
},
"division": "string",
"nexusIndicator": true,
"nexusReasonCode": "string",
"physicalOrigin": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
],
"utilityProvider": "REGULATED_TAXPAYER"
},
"simplificationCode": "CONSIGNMENT",
"situsOverride": {
"taxingLocation": "ADMINISTRATIVE_DESTINATION"
},
"taxOverride": {
"overrideReasonCode": "string",
"overrideType": "TAXABLE"
},
"taxPointDate": "2025-01-30",
"transactionId": "string",
"transactionType": "SALE"
}
'
Sample response - Calculate tax as a seller
{
"data": {
"accumulationCustomerNumber": "string",
"accumulationDocumentNumber": "string",
"billingType": "string",
"companyCodeCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"currencyConversionFactors": [
{
"conversionFactor": 0,
"sourceCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"targetCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
}
}
],
"customer": {
"administrativeDestination": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"customerCode": {
"classCode": "string",
"isBusinessIndicator": true,
"value": "string"
},
"destination": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"exemptionCertificate": {
"exemptionCertificateNumber": "string",
"value": "string"
},
"exemptionReasonCode": "string",
"isTaxExempt": true,
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
]
},
"deliveryTerm": "EXW",
"discount": {
"discountType": "DiscountAmount",
"discountValue": 0,
"userDefinedDiscountCode": "string"
},
"documentDate": "2025-01-30",
"documentNumber": "string",
"documentSequenceId": "string",
"documentType": "string",
"exemptOverrides": [
{
"amount": 0,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"reasonCode": "string"
}
],
"franchiseAreaId": "string",
"impositionInclusions": [
{
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO"
}
],
"isTaxOnlyAdjustmentIndicator": true,
"lineItems": [
{
"amountBilledToDate": 0,
"assistedParameters": [
{
"originalValue": "string",
"paramName": "string",
"phase": "PRE",
"ruleName": "string",
"value": "string"
}
],
"chainTransactionPhase": "MANUFACTURER",
"commodityCode": {
"commodityCodeType": "string",
"usedCommodityCode": "string",
"userDefined": true,
"value": "string"
},
"companyCodeCurrencyTaxAmount": 0,
"companyCodeCurrencyTaxableAmount": 0,
"costCenter": "string",
"countryOfOriginISOCode": "string",
"customer": {
"administrativeDestination": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"customerCode": {
"classCode": "string",
"isBusinessIndicator": true,
"value": "string"
},
"destination": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"exemptionCertificate": {
"exemptionCertificateNumber": "string",
"value": "string"
},
"exemptionReasonCode": "string",
"isTaxExempt": true,
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
]
},
"deliveryTerm": "EXW",
"departmentCode": "string",
"discount": {
"discountType": "DiscountAmount",
"discountValue": 0,
"userDefinedDiscountCode": "string"
},
"exemptOverrides": [
{
"amount": 0,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"reasonCode": "string"
}
],
"exportProcedure": "string",
"extendedPrice": 0,
"fairMarketValue": 0,
"flexibleFields": {
"flexibleCodeFields": [
{
"fieldId": 0,
"value": "string"
}
],
"flexibleDateFields": [
{
"fieldId": 0,
"value": "2025-01-30"
}
],
"flexibleNumericFields": [
{
"fieldId": 0,
"value": 0
}
]
},
"franchiseAreaId": "string",
"freight": 0,
"generalLedgerAccount": "string",
"impositionInclusions": [
{
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO"
}
],
"inputTotalTax": 0,
"intrastatCommodityCode": "string",
"isMulticomponent": true,
"lineItemId": "string",
"lineItemNumber": 0,
"lineItems": [
null
],
"lineType": {
"accumulationLocation": "string",
"content": "string",
"direction": "string",
"status": "string",
"value": "string"
},
"lineTypes": [
{
"accumulationLocation": "string",
"basis": "string",
"content": "string",
"count": 0,
"direction": "string",
"lineTypeNumber": 0,
"status": "string",
"value": "string"
}
],
"locationCode": "string",
"materialCode": "string",
"materialOrigin": "string",
"modeOfTransport": 0,
"natureOfTransaction": 0,
"netMassKilograms": 0,
"nonTaxableOverrides": [
{
"amount": 0,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"reasonCode": "string"
}
],
"product": {
"productClass": "string",
"value": "string"
},
"projectNumber": "string",
"quantity": {
"unitOfMeasure": "string",
"value": 0
},
"rateOverrides": [
{
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"rate": 0
}
],
"returnsFields": {
"returnsCodeFields": [
{
"name": "string",
"value": "string"
}
],
"returnsDateFields": [
{
"name": "string",
"value": "2025-01-30"
}
],
"returnsIndicatorFields": [
{
"name": "string",
"value": true
}
],
"returnsNumericFields": [
{
"name": "string",
"value": 0
}
]
},
"seller": {
"administrativeOrigin": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"company": "string",
"department": "string",
"dispatcher": {
"dispatcherCode": {
"classCode": "string",
"value": "string"
},
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
]
},
"division": "string",
"nexusIndicator": true,
"nexusReasonCode": "string",
"physicalOrigin": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
],
"utilityProvider": "REGULATED_TAXPAYER"
},
"simplificationCode": "CONSIGNMENT",
"situsOverride": {
"taxingLocation": "ADMINISTRATIVE_DESTINATION"
},
"statisticalValue": {
"amount": 0,
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
}
},
"supplementaryUnit": {
"unitType": "string",
"value": 0
},
"taxDate": "2025-01-30",
"taxIncludedIndicator": true,
"taxOverride": {
"overrideReasonCode": "string",
"overrideType": "TAXABLE"
},
"taxes": [
{
"accumulateAsImposition": {
"impositionId": "string",
"jurisdictionId": "string",
"userDefined": true,
"value": "string"
},
"accumulateAsImpositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"accumulateAsJurisdiction": {
"effectiveDate": "2025-01-30",
"expirationDate": "2025-01-30",
"externalJurisdictionCode": "string",
"jurisdictionId": "string",
"jurisdictionType": "APO",
"value": "string"
},
"accumulateAsLineType": {
"userDefined": true,
"value": "string"
},
"accumulationRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"assistedParameters": [
{
"originalValue": "string",
"paramName": "string",
"phase": "PRE",
"ruleName": "string",
"value": "string"
}
],
"basisApportionmentRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"basisReductionPercentage": 0,
"basisRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"blockingRecoverablePercent": 0,
"buyerRegistrationId": "string",
"calculatedTax": 0,
"calculationRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"certificateNumber": {
"certificateType": "string",
"value": "string"
},
"creditRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"dispatcherRegistrationId": "string",
"effectiveRate": 0,
"exempt": 0,
"exemptMeasure": {
"unitOfMeasure": "string",
"value": 0
},
"filingCategoryCode": 0,
"filingCurrencyAmounts": {
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"filingCalculatedTax": 0,
"filingExempt": 0,
"filingNonTaxable": 0,
"filingRecoverableAmount": 0,
"filingTaxable": 0,
"filingUnrecoverableAmount": 0
},
"imposition": {
"impositionId": "string",
"jurisdictionId": "string",
"userDefined": true,
"value": "string"
},
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"includedTax": 0,
"inclusionRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"taxInclusion": [
{
"direction": "PULL",
"inclusionRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"jurisdiction": {
"effectiveDate": "2025-01-30",
"expirationDate": "2025-01-30",
"externalJurisdictionCode": "string",
"jurisdictionId": "string",
"jurisdictionType": "APO",
"value": "string"
},
"imposition": {
"impositionId": "string",
"jurisdictionId": "string",
"userDefined": true,
"value": "string"
},
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"includedTax": 0
}
],
"inputOutputType": "INPUT",
"invoiceTextCodes": [
0
],
"invoiceTexts": [
{
"code": "string",
"invoiceTextRuleId": "string",
"text": "string",
"userDefined": true
}
],
"isService": true,
"jurisdiction": {
"effectiveDate": "2025-01-30",
"expirationDate": "2025-01-30",
"externalJurisdictionCode": "string",
"jurisdictionId": "string",
"jurisdictionType": "APO",
"value": "string"
},
"markUpRate": 0,
"maxTaxIndicator": true,
"maxTaxRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"nominalRate": 0,
"nonTaxable": 0,
"nonTaxableMeasure": {
"unitOfMeasure": "string",
"value": 0
},
"notRegisteredIndicator": true,
"originalTax": 0,
"ownerRegistrationId": "string",
"partialExemptRecoverablePercent": 0,
"postCalculationEvaluationRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"rateClassification": "string",
"reasonCode": "string",
"recipientRegistrationId": "string",
"recoverableAmount": 0,
"recoverablePercent": 0,
"recoverableRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"reportingBasis": 0,
"reportingBasisRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"sellerRegistrationId": "string",
"situs": "ADMINISTRATIVE_DESTINATION",
"summaryInvoiceText": "string",
"taxApportionmentRate": 0,
"taxApportionmentRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"taxCode": "string",
"taxCollectedFromParty": "SELLER",
"taxRateAdjustmentRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"taxResult": "TAXABLE",
"taxStructure": "BRACKET",
"taxType": "SALES",
"taxable": 0,
"taxableMeasure": {
"unitOfMeasure": "string",
"value": 0
},
"telecomUnitConversionRuleId": {
"salesTaxHolidayIndicator": true,
"userDefined": true,
"value": "string"
},
"unrecoverableAmount": 0,
"vertexTaxCode": "string"
}
],
"titleTransfer": "ORIGIN",
"totalTax": 0,
"transactionType": "SALE",
"unitPrice": 0,
"usage": "string",
"usageClass": "string",
"vendorSKU": "string",
"volume": {
"unitOfMeasure": "string",
"value": 0
},
"weight": {
"unitOfMeasure": "string",
"value": 0
}
}
],
"locationCode": "string",
"nonTaxableOverrides": [
{
"amount": 0,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"reasonCode": "string"
}
],
"orderType": "string",
"originalCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"paymentDate": "2025-01-30",
"postToJournal": true,
"postingDate": "2025-01-30",
"proratePercentage": 0,
"rateOverrides": [
{
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"jurisdictionType": "APO",
"rate": 0
}
],
"returnAssistedParametersIndicator": true,
"returnGeneratedLineItemsIndicator": true,
"roundAtLineLevel": true,
"saleMessageType": "QUOTATION",
"seller": {
"administrativeOrigin": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"company": "string",
"department": "string",
"dispatcher": {
"dispatcherCode": {
"classCode": "string",
"value": "string"
},
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
]
},
"division": "string",
"nexusIndicator": true,
"nexusReasonCode": "string",
"physicalOrigin": {
"city": "string",
"country": "string",
"currencyConversion": {
"currency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"rate": 0
},
"externalJurisdictionCode": "string",
"latitude": "string",
"locationCode": "string",
"locationCustomsStatus": "FREE_CIRCULATION",
"longitude": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
},
"taxRegistrations": [
{
"hasPhysicalPresenceIndicator": true,
"impositionType": {
"impositionTypeId": "string",
"userDefined": true,
"value": "string",
"withholdingType": "string"
},
"isoCountryCode": "string",
"jurisdictionId": "string",
"mainDivision": "string",
"nexusOverrides": [
{
"city": true,
"country": true,
"district": true,
"locationRole": "ADMINISTRATIVE_DESTINATION",
"mainDivision": true,
"subDivision": true
}
],
"physicalLocations": [
{
"city": "string",
"country": "string",
"mainDivision": "string",
"postalCode": "string",
"streetAddress1": "string",
"streetAddress2": "string",
"subDivision": "string",
"taxAreaId": "string"
}
],
"taxRegistrationNumber": "string",
"filingCurrency": {
"isoCurrencyCodeAlpha": "string",
"isoCurrencyCodeNum": 0,
"isoCurrencyName": "string"
},
"taxRegistrationType": "VAT Registration"
}
],
"utilityProvider": "REGULATED_TAXPAYER"
},
"simplificationCode": "CONSIGNMENT",
"situsOverride": {
"taxingLocation": "ADMINISTRATIVE_DESTINATION"
},
"subTotal": 0,
"taxOverride": {
"overrideReasonCode": "string",
"overrideType": "TAXABLE"
},
"taxPointDate": "2025-01-30",
"total": 0,
"totalTax": 0,
"transactionId": "string",
"transactionType": "SALE"
},
"meta": {
"app": "string",
"timeElapsed(ms)": 0,
"timeReceived": "2025-01-30T16:44:09.191Z",
"timeElapsedDetails": [
{
"key": "string",
"value": "string"
}
]
}
}
Updated 4 months ago