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.
Table 13. Tax Calculator Business Service User Properties
Business Service User Property |
|
Taxware:Adapter Business Service |
Taxware Adapter Service |
Taxware:Configuration Object |
Tax - Configuration (Taxware) |
Taxware:Input IntObject Name |
Tax Integration (Taxware Input) |
Taxware:Output IntObject Name |
Tax Integration (Taxware Output) |
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 |
|
|
AUDFILEIND |
2 |
Audit File Indicator: (1, 2, 3, 4)
- 1: Audit File/Suspense File
- 2: No Record stored on file
- 3: Suspense File
- 4: Audit File
|
EXEMPTUSEFLAG |
Y |
Exemption Use Flag: (Y, L, P, D, N)
- 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)
|
|
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
|
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
|
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, 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.
Table 18. Tax Calculation Data Maps
|
|
|
TaxCalculation_QuoteToTaxware |
Tax Integration (Siebel Quote) |
Tax Integration (Taxware Input) |
TaxCalculation_TaxwareToQuote |
Tax Integration (Taxware Output) |
Tax Integration (Siebel Quote) |
For more information on modifying integration objects and data maps, see Integration Platform Technologies: Siebel Enterprise Application Integration and Using Siebel Tools.
|