Sabrix^® Solution

SabrixConnection for SAP

(Basic US/CA Version)

Release Notes

Version 5.0.0.1B

These Release Notes contain information about Version 5.0.0.1B of the SabrixConnection for SAP, including download and installation instructions.

For your convenience, these notes are cumulative: they contain information about the major release and its subsequent patches.

Version 5.0.0.1B of the SabrixConnection for SAP is compatible with the Sabrix Solution 5.0 release, using Compatibility Version "G" XML. In order to use the new features of the Sabrix Solution, you must use this release of the Basic SabrixConnection for SAP.

Version 5.0.0.1B Updates

Documentation Updates

1. SabrixConnection for SAP Guides – Several minor typographical errors were fixed, some screen prints replaced, and other minor enhancements were made.

Technical Changes

1. City Can Be Returned to SAP During Address Validation

Problem: The city returned in the Sabrix Solution Output XML was not written back to SAP.

Solution: During US Address Validation only, if no city were supplied in SAP, and Sabrix found a city other than Unincorporated, then the city could be returned to the SAP address screen. This behavior can be configured through the use of an option in the SabrixConnection.properties file. The default setting is true, which means that no city override would be performed. If this option were set to the value of true and the condition mentioned above were fulfilled, then a city would be returned.

2. Parameters Were Not Evaluated by SAP During Address Validation: max_jurisdiction_addresses and truncate_to_max_addresses

Problem: Values set for the parameters max_jurisdiction_addresses and truncate_to_max_addresses in the SabrixConnection.properties file where not taken into account during runtime.

Solution: The SabrixConnection for SAP now takes this value into account when addresses are returned to SAP.

3. Parameter Did Not Work Properly: external_company_id_prepend

Problem: Even if a prepend value was set, it was not passed to the Sabrix Solution.

Solution: Values set for external_company_id_prepend in the SabrixConnection.properties file are now properly passed on to the Sabrix Solution.

4. Quantities Not Sent Correctly to Sabrix

Problem: The quantity sent to Sabrix was incorrect (by a factor of 1000) due to an incorrect decimal place setting.

Solution: Quantity values are now sent correctly taking the SAP decimal places into account

5. Errors in IntegrationServerStartup.bat and IntegrationServerStartup.sh Files

Problem: Some of the path variables were missing or incorrect.

Solution: Path settings were corrected.

6. Errors in IntegrationServerStartup.bat and IntegrationServerStartup.sh files

Problem: With the initial release of 5.0.0.0B, the encryption of the user/password pair was not implemented.

Solution: Users can now opt to encrypt the user/password for the JCo communication with SAP via a setting in the SabrixConnection.properties file.

Version 5.0.0.0B (Initial Release)

Documentation Updates

1. SabrixConnection for SAP Installation and RFC Configuration Guide Version 5.0.0.0B – This release introduces this guide showing you how to enable SAP RFC communication with the Sabrix Solution. This guide walks you through the process of installing the Basic SabrixConnection for SAP, configuring SabrixConnection Properties, and configuring SAP RFC.

2. SabrixConnection for SAP Custom Attributes – This document describes the process of adding custom attributes to the tax interface, which is an option to assist you in meeting your business needs. If you need a copy of it, please contact Sabrix Professional Services.

3. SabrixConnection for SAP US/CA Tax Configuration Guide Version 5.0.0.0B – This release introduces the SabrixConnection for SAP US/CA Tax Configuration Guide. This guide walks you through the process of IMG configurations in FI, SD, MM, Master Data Maintenance, and ABAP programming so that you can calculate tax through the Sabrix Solution.

4. SabrixConnection Version – As of this release, the Basic SabrixConnection for SAP Version number is 5.0.0.0B where B indicates the Basic SabrixConnection.

5. Bug Notes – This document describes any existing bugs that will be fixed in the next maintenance release.

Functional Changes

The following features of the Sabrix Solution version 5.0.1.0 can be enabled by the Basic SabrixConnection for SAP version 5.0.0.0B. To enable these features in the Basic Connection, you will need to do enhancements in the user exit, as well as pass custom attributes through a TransEditor in the Sabrix Solution. Please see Sabrix Professional Services for additional help.

1. Date Determination Logic

The Sabrix Solution can now evaluate the Invoice Date and Goods Movement Date to determine the correct Tax Point Date, Tax Exchange Rate Date and Tax Determination Date.

2. Location Tax Categories

XML elements are available to identify locations with special tax treatment, such as a Bonded Warehouse, on all the applicable addresses in Sabrix.

3. Units of Measure Conversion

Sabrix can convert Units of Measure (UOM) on line items into the UOM specified by the tax authority.

4. Licenses

License functionality in Sabrix can be enabled by sending the customer number from SAP.

5. Currency Conversion

Document currency from SAP can be converted into an authority currency.

6. Incoterms

Incoterms passed from SAP on a line item level to Sabrix can be mapped to a PoTT (Point of Title Transfer) in the Sabrix Solution. Sabrix has provided new sample code for this in the tax interface user exit if you do not want to perform the mapping in the Sabrix Solution.

7. Freight Taxability follows Product Taxability

A group_id that is the line number of a parent item is mapped using the related_line_id for accurate tax determination for a child part number.

New Functionality

The following features are new in Version 5.0.0.0B of the SabrixConnection for SAP. Please see the Tax Configuration Guide for more information.

1. Logging Improvements

In the SabrixIntegrationServerLoggingConfig.xml file, you can now specify many different configurations for your log data.

2. Boolean Representation in the .properties File

In the SabrixConnection.properties file, Boolean values have been changed from 0 and 1 to False and True, respectively.

3. LanguageMappingsExtension.xml

The SabrixConnection now includes this file to enable custom language configurations.

4. Gzip HTTP Call for Address Validation

The AddressValidation http call is gzipped, which sends fewer bytes and improves performance.

5. Stop Script

The SabrixConnection now provides a stop script along with the start script. The updated start and stop (IntegrationServerStartup.sh and IntegrationServerShutdown.sh) scripts are packaged with the 5.0.0.0B SabrixConnection.

6. Dummy Log File

The SabrixConnection has added an empty log file called SabrixSapIntegration.log to the log directory in the packaging script.

7. IS_CREDIT Indicator

The SabrixConnection now sets the IS_CREDIT field on the Input Line Level instead of the Input Invoice Level.

8. SAP ACCNT_NO Mapping

The SabrixConnection now maps ACCNT_NO to LINE.CUSTOMER_NUMBER for Sales transactions and ACCNT_NO to LINE.VENDOR_NUMBER for Purchases transactions.

9. Handling Currency Decimals Setting

The Sabrix Solution rounds results to 2 digits of precision by default. If currency decimals are set to 4 in SAP, the results returned by the SabrixConnection will be rounded to 2 digits of precision.

10. API_VERSION

The SabrixConnection now returns an API Version of 5.0.0.0B in EXT_CONTROL_DATA-API_VERSION.

11. Proxy Host Ability from SAP

If the proxy server is down, SAP will still connect directly to the tax engine by bypassing the proxy server.

Bug Fixes

The following bug fixes are included in this release:

1. The ZONE_LEVEL field in the taxMappings.xml and taxMappingsExtension.xml files have been replaced with the EFFECTIVE_ZONE_LEVEL field.

2. For Canadian taxes, the SabrixConnection was previously returning a negative exempt amount. It now returns the correct amount.

3. The SabrixConnection now returns exemption data to SAP standard RFC fields.

Downloading and Installing This Release

To download and install this release:

1. Retrieve the SabrixConnSAP5.0.0.1B .zip file from the Sabrix Customer Center. To do so:

· Open the Customer Center at https://customercenter.sabrix.com/sabrixcc

· Log in using the User Name and Password provided by Sabrix.

· In the Available Products list, verify that the SabrixConnection for SAP (Basic US/Canada Version) Current Installed Version is set to None.

· Click the SabrixConnection for SAP (Basic US/Canada Version) Download button.

· Save the file.

2. Unzip the SabrixConnSAP5.0.0.1B .zip file.

3. Log on to the server where the current SabrixConnection for SAP is installed.

4. Stop the SabrixConnection if it is currently running.

5. Back up the following files, as you will need to reference them once you install the new release:

· SabrixConnection.properties

· IntegrationServerStartup.bat (if used at your implementation)

· IntegrationServerStartup.sh (if used at your implementation)

· IntegrationServerShutdown.sh (if used at your implementation)

· taxMappingsExtensons.xml

· jcMappingsExtension.xml

· authorityLanguageMappingsExtension.xml

· SabrixIntegrationServerLoggingConfig.xml

6. Unzip and extract the files in the .zip file to the directories where you installed the previous release of the SabrixConnection for SAP.

7. Some changes have been made to the .properties, IntegrationServerStartup.bat, IntegrationServerStartup.sh, and IntegrationServerShutdown.sh files; merge your settings into the new templates where appropriate. All other templates can be replaced with the versions you saved in step 5 above.

8. Restart the SabrixConnection.