Find Answers

Find Answers

Specified Languages
British English
English

How do I transition to CyberSource's upgraded Global Tax Calculation in 2017?


Doc ID:    C1712
Version:    9.0
Status:    Published
Published date:    02/16/2017
Updated:    02/16/2017
 

Answer

Title: Global Tax Calculation Upgrade Reference Guide
 
Overview
CyberSource is upgrading its Global Tax Calculation solution during the first quarter of 2017. These upgrades will help us to continue to provide accurate tax information for every transaction, and will enhance the data you receive in response to each tax call. We plan to transition CyberSource customers upon request to the upgraded service beginning on January 1st 2017, and continuing through June 2017. The final and mandatory cut over date is TBD but will likely be in the end-of-June 2017 timeframe. At that time, all customers will be switched over to the upgraded service.  New CyberSource customers will automatically be configured for the upgraded service, but existing customers must transition to the upgraded service.

We recommend that you review this article to learn about the implications of the transition and decide if any changes should be made to your implementation. The existing tax service will continue to function even if you do not make any changes, but the data you receive in the response message may change. This step will help make sure you receive the correct tax amounts after you transition to the upgraded service. This reference article contains sections on new features, transition timeline, technical changes, and recommended actions.

If you have questions or concerns not addressed here, please contact CyberSource Customer Support.

The following section contains recommended actions to support your transition to the upgraded service. Additional detail will be provided in subsequent sections of this article.



Recommended Actions
We recommend you take the following actions during this transition:
  1. Continue to send all request fields at least until June 2017, but be aware that once you are transitioned some fields will no longer affect the tax calculation.
  2. Review the product mapping to ensure the new product descriptions and exemptions are accurate for your products.
  3. After you have been switched to the upgraded service, implement the newer product codes by June 2017, when product-based rules and exemptions will no longer be applied to the previously mapped product codes.
Let your sales or technical account manager know between January 2017 and June 2017 when you are ready to transition to the upgraded service.
  
New Features
The upgraded service will include the features and benefits outlined below.
Feature Description Benefit
New Product Codes Multi-regional codes. Approximately 2,000 product codes supported across 138 countries Improved support for international, product-based tax rules and exemptions
Geolocation Tax engine uses the full address to identify taxable jurisdictions Increases accuracy of tax calculation
Relative Shipping Tax Shipping tax depends on taxability of other line items Ensures business is not over-collecting on shipping tax
Data Enhancements Additional data returned in tax response (tax rates, exempt/taxable amounts, jurisdiction names/codes) Gives businesses more visibility into how tax was calculated, and additional data to use for tracking and auditing purposes
 
 
Transition Timeline
CyberSource customers can begin transitioning to the upgraded service on January 1st 2017. The API specification for the upgraded service is currently available upon request and will be published at http://www.cybersource.com/developers/documentation/tax_services/ by March 2017.

Customers will be migrated to the upgraded service upon request from January through June 2017. The final and mandatory cut over date is yet to-be-decided (TBD) but will likely be in the end-of-June 2017 timeframe. At that time, all customers will be switched over to the upgraded service.
 
 
Technical Changes
Transitioning to the upgraded service will involve changes to the request fields, changes to reply fields, changes to product codes, and changes to country support.

Changes to request fields
A subset of the existing request fields will no longer be supported. You can continue to send the fields in the call and the tax service will ignore them. A list of unsupported fields for the Simple Order and SCMP APIs is located in Appendix A of this document. 

We recommend that you continue to send your existing fields in your requests at least until June 2017, but want you to be aware that once you are transitioned these fields will no longer affect the tax calculation.
 
The service features that will no longer be supported are:
Feature Purpose Notes
County-level request fields Identify county tax jurisdiction Upgraded service uses geolocation for more accurate jurisdiction assignment so county-level request fields are no longer necessary
Point of title transfer fields Send incoterm rules for international transactions Incoterm rules are not supported in the upgraded service
Jurisdiction-level tax rate and tax amount overrides Override the amount for a specific jurisdictional tax Tax amount overrides at the offer level (i.e. for specific items in the order) will continue to be supported
Middleman registration fields Trigger tax triangulation rules on international transactions Triangulation is not supported in the upgraded service
Multiple seller registration ID fields Send multiple seller registration numbers in a request Multiple seller registration ID fields are no longer supported: 
 
Simple Order API
taxService_sellerRegistration0...N
item_#_sellerRegistration0...N
 
SCMP API
seller_registration0...N
 
Note: If you send a value in the single seller registration ID field(s) and VAT rules and rates are applicable, then VAT tax will be calculated and the relevant tax amounts will be returned in the response. The single seller registration ID fields are:
 
Simple Order API
taxService_sellerRegistration
item_#_sellerRegistration
 
SCMP API
seller_registration
 
 
Changes to reply fields
There are 19 new reply fields.  Refer to the API guide for field names and descriptions.

The reply fields that will no longer be supported are:
Simple Order API
taxReply_city
taxReply_postalCode
taxReply_state
taxReply_county
taxReply_item_#_districtTaxAmount
taxReply_totalDistrictTaxAmount
 

SCMP API
tax_city_name
tax_zip
tax_state_name
tax_county_name
tax_district_tax#
tax_total_district_tax
 
 
For Canada, the following reply fields and associated values are changing:
Canada Tax Type Changing FROM Changing TO
GST Simple Order API
taxReply_item_#_stateTaxAmount
taxReply_totalStateTaxAmount
 
SCMP API
tax_state_tax#
tax_total_state_tax
New Simple Order API Field
taxReply_item_#_countryTaxAmount
taxReply_totalCountryTaxAmount
 
New SCMP API Field
tax_country_tax#
tax_total_country_tax
PST, HST, QST Simple Order API
taxReply_item_#_countyTaxAmount
taxReply_totalCountyTaxAmount
 
SCMP API
tax_county_tax#
tax_total_county_tax
Existing Simple Order API Field
taxReply_item_#_stateTaxAmount
taxReply_totalStateTaxAmount
 
Existing SCMP API Field
tax_state_tax#
tax_total_state_tax
 

For Value-Added Tax (VAT), amounts are now returned in a NEW reply field as follows:
Simple Order API
taxReply_item_#_countryTaxAmount
taxReply_totalCountryTaxAmount
 
SCMP API
tax_country_tax#
tax_total_country_tax
 
Changes to product codes
A new set of multi-regional product codes is available to help ensure accurate tax rules and product exemptions are applied. A list of these new product codes and descriptions are available upon request and can be used in your tax calls once you are switched over to the new version of the service.

In order to make your transition to the upgraded service as seamless as possible, we have mapped a subset of the existing product codes (those which are commonly used) to the corresponding product codes in the new set. These codes have been programmatically mapped in the upgraded service. This means you can continue to send a subset of the older product code in your tax request and similar product-based rules and exemptions will be applied. The product description and associated exemptions may be slightly different for the new codes. Therefore, we recommend you review the mapping to ensure the new product descriptions and exemptions are accurate for your products.

The mapping between the old and new product codes is available upon request. This mapping will continue to be supported through June 2017, after which the older product codes will no longer be recognized. We recommend you implement the newer product codes by this date. You can continue to send the older, unsupported codes in the request messages, but there will be no tax rules or product exemptions applied; the product will be considered fully taxable.

Changes to country support
The following countries will no longer be supported:
  • Brazil
 
Recommended Actions
To summarize, we recommend you take the following actions during this transition:
  1. Continue to send all request fields at least until June 2017, but be aware that once you are transitioned some fields will no longer affect the tax calculation.
  2. Review the product mapping to ensure the new product descriptions and exemptions are accurate for your products.
  3. After you have been switched to the upgraded service, implement the newer product codes by June 2017, when product-based rules and exemptions will no longer be applied to the previously mapped product codes.
Let your sales or technical account manager know between January 2017 and June 2017 when you are ready to transition to the upgraded service.  You will have an opportunity to transition first in the Test Environment and, once your testing of the upgraded service is complete, you can then transition to the upgraded service in the Production Environment.
 

 

Appendix A - Unsupported Fields

 
County-level request fields:
Simple Order API
billTo_county
shipFrom_county
shipTo_county
taxService_orderAcceptanceCounty
taxService_orderOriginCounty
item_#_orderAcceptanceCounty
item_#_orderOriginCounty
item_#_shipFromCounty 

SCMP API
bill_county
ship_from_county
ship_to_county
order_acceptance_county
order_origin_county
 

Point of title transfer fields: 
Simple Order API
taxService_pointOfTitleTransfer
item_#_pointOfTitleTransfer

SCMP API
point_of_title_transfer
 
 
 
Jurisdiction-level tax rate and tax amount overrides:
Simple Order API
item_#_countryOverrideRate
item_#_stateOverrideRate
item_#_countyOverrideRate
item_#_cityOverrideRate
item_#_countryOverrideAmount
item_#_ stateOverrideAmount
item_#_countyOverrideAmount
item_#_cityOverrideAmount
 
SCMP API
country_override_rate
state_override_rate
county_override_rate
city_override_rate
country_override_amount
state_override_amount
county_override_amount
city_override_amount
 
 
 
Middleman registration fields:
Simple Order API
taxService_middlemanRegistration
item_#_middlemanRegistration

SCMP API
middleman_registration
 
 
 
Multiple seller registration ID fields: 
Simple Order API
taxService_sellerRegistration0...N
item_#_sellerRegistration0...N

SCMP API
seller_registration0...N
 

Attached File

Tax_SO_API.pdf
331K • < 1 minute @ 56k, < 1 minute @ broadband


Attached File

Tax_SCMP_API.pdf
311K • < 1 minute @ 56k, < 1 minute @ broadband



Rate This Item