Siebel Order Management Guide > Integrating Order Management with Third-Party Taxation Applications > Taxware Integration with Siebel eSales >

Tax Calculator Business Service

The Tax Calculator business service controls the process shown in Figure 2:

Figure 2. Tax Calculation Process Flow

• Siebel EAI passes data from a quote record and the method name to a Siebel output integration object.
• The Siebel Data Transformation Engine maps the Siebel output integration object to a Taxware input integration object.
• The Siebel EAI XML Converter converts the Taxware input integration object into XML, using the CC XML Converter Business Service, and passes the XML data and method name to the Taxware Adapter Service.
• The Taxware Adapter Service business service processes the data and uses Siebel eScript to call the Taxware API.
• The Taxware Adapter Service gets the calculated sales tax from Taxware using the Taxware API.
• The Taxware Adapter Service formats the sales tax data into an XML string.
• The Siebel EAI XML Converter converts the XML into a Taxware output integration object.
• The Siebel Data Transformation Engine maps the Taxware output integration object to a Siebel input integration object.
• Siebel EAI updates the quote record with the calculated sales tax.

The Tax Calculator business service has one method, CalculateTax, with the following input arguments:

• Siebel to Vendor Map Name
• Vendor to Siebel Map Name

The Tax Calculator business service user properties are used to set the values given in Table 13.

For more information on business services, see Using Siebel Tools.

Integration Objects

Integration objects pass static or dynamic values to the business service. The architecture is modular in that you can create and use different integration objects for the same core business service. For example, while the preconfigured integration supports the Quote business component, you can create integration objects to calculate taxes directly on the Order business component.

The Tax Calculator business service uses the following integration objects:

• Tax - Configuration (Taxware). Its user properties are shown in Table 14.

  Table 14. Tax - Configuration (Taxware) User Properties

  Integration Object User Property	Value	Comments
  AUDFILEIND	2	Audit File Indicator: 1: Audit File/Suspense File 2: No Record stored on file 3: Suspense File 4: Audit File
  EXEMPTUSEFLAG	Y	Exemption Use Flag: Y: Call STEP, use default record. L: Call STEP, do not use default record. P: Call STEP, search by product code. D: Call STEP, search by reason code and accept default customer. N: Do not call STEP.
  InputIntObjectName	Tax Integration (Taxware Input)	None
  OutputIntObjectName	Tax Integration (Taxware Output)	None
  SHIPFROMCOUNTRY	US	None
  SalesUseInstalled	Y	None
  VendorDll	taxcommono	Name of the shared library.
  WorldTaxInstalled	N	None
• Tax Integration (Siebel Quote). Its integration components are shown in Table 15.

  Table 15. Tax Integration (Siebel Quote Integration Components)

  Integration Component	Fields
  Quote	Account Id
  	Currency Code
  	Current Quote Ship To City
  	Current Quote Ship To Country
  	Current Quote Ship To Postal Code
  	Current Quote Ship To State
  	EAI Error Message
  	Quote Number
  	Tax Amount
  Quote Item	Extended Line Total
  	Extended Quantity
  	Line Number
  	Line Total
  	Part Number
  	Quantity
  	Row Id
  	Sales Product Flag
  	Sales Service Flag
  	Tax Amount
  	Tax Subcomponent Flag
  	Taxable

• Tax Integration (Taxware Input). Its integration components are shown in Table 16.

  Table 16. Tax Integration (Taxware Input) Integration Components

  Integration Component	Fields That Pass Data from Siebel
  Invoice	Currency Code
  	Customer Id
  	Document Number
  	Invoice Number
  	Ship To City
  	Ship To Country
  	Ship To Postal Code
  	Ship To State
  Invoice Item	Line Number
  	Line Total
  	Part Number
  	Quantity
  	Sales Product Flag
  	Sales Service Flag
  	Ship to City
  	Ship to Country
  	Ship to Postal Code
  	Ship to State

  See your Taxware documentation for more fields that can be passed. For information on how to pass more fields to Taxware, see Passing Data from Other Fields in the Siebel Database.

• Tax Integration (Taxware Output). Its integration components are shown in Table 17.

  Table 17. Tax Integration (Taxware Output) Integration Components

  Integration Component	Fields That Pass Data from Taxware
  Invoice	City Tax Amount County Tax Amount Error Message Federal Tax Amount Invoice Number Secondary City Tax Amount Secondary County Tax Amount Secondary State Tax Amount State Tax Amount
  Invoice Item	City Basis Amount	City Completion Code	City Tax Amount
  	City Tax Rate	County Basis Amount	County Completion Code
  	County Tax Amount	County Tax Rate	Federal Basis Amount
  	Federal Completion Code	Federal Tax Amount	Federal Tax Rate
  	General Completion Code	General Completion Code Desc	Line Number
  	Secondary City Basis Amount	Secondary City Completion Code	Secondary City Tax Amount
  	Secondary City Tax Rate	Secondary County Basis Amount	Secondary County Completion Code
  	Secondary County Tax Amount	Secondary County Tax Rate	Secondary State Basis Amount
  	Secondary State Completion Code	Secondary State Tax Amount	Secondary State Tax Rate
  	State Basis Amount	State Completion Code	State Tax Amount
  	State Tax Rate

  See your Taxware documentation for more fields that can be passed.

For more information on integration objects, see Integration Platform Technologies: Siebel Enterprise Application Integration and Using Siebel Tools.

Data Maps

Data maps are used to map fields in one integration object to another integration object. You can view data maps by navigating to the Administration - Integration screen, and then the Data Maps view.

The data maps used in tax calculation, shown in Table 18, are specified in the call to the Tax Calculator business service.

For more information on modifying integration objects and data maps, see Integration Platform Technologies: Siebel Enterprise Application Integration and Using Siebel Tools.