Sabrix® Solution
SabrixConnection for SAP
(Basic US/CA Version)
Release Notes
Version 5.0.1.0B
These release notes contain information about Version 5.0.1.0B 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. See release notes for the following versions: 5.0.1.0B, 5.0.0.1B, 5.0.0.0B.
Tax Override Section Updated
Problem: For forced transactions other than US, Canada and EU VAT, various jurisdiction levels were being summed in the override field during submission to Sabrix audit.
Solution: Country specific mappings have been added to the tax override section following the authority model of these countries. Jurisdiction levels are no longer being summed in the override field during forced transactions. Additionally, the tax override logic has been enhanced to use the following lookup logic:
1st ShipTo_Country AND jurisLevel
2nd ShipTo_Country
3rd jurisLevel
UNIT_OF_MEASURE to UOM in Quantity Element Mapped
Problem: Fee on the quantity calculation method was used, but the line had a missing or incomplete quantity error.
Solution: The Sabrix Solution input XML UOM tag within the quantity structure now holds the SAP quantity value. Review your TransEditors to see if you have any based on the old QUANTITY tag in the XML.
Unique Invoice Number Value Created
Problem: Unique_Invoice_Number field was not populated at the time of auditing.
Solution: In support of enhanced audit uniqueness, this field is now concatenated from the External_Company_ID, Invoice_Number, and Company_Role fields into a string with a pipe ( | ) delimiter. This creates a unique invoice number that ensures a proper audit key in Sabrix. Together with Host_System and Calling_System_Number these three fields build the primary audit key in Sabrix.
Freight Line Exemption Mapped from the Product Line
Problem: Freight line exemption is not mapped from the product line.
Solution: When the freight line is created and the RFC EXEMP_IND is set, that value is passed to the <IS_EXEMPT><ALL> XML element of both the product and freight lines. For further detail, please see Mapping SAP Fields to Sabrix XML in the installation guide.
County Fields Added to the Jurisdiction Code Mapping File
Problem: A null pointer exception was caused when county mappings were set up in the jcMappingsExtension.xml file.
Solution: The values below have been added:
jurisdictionField name='county.code'
jurisdictionField name='county.code3'
jurisdictionField name='county.isocode'
Enhanced Proxy Server Feature to Support HTTPS Calls
Problem: The proxy server feature of the SabrixConnection for SAP did not support https calls to the Sabrix Solution.
Solution: The proxy server feature of the SabrixConnection for SAP has been enhanced to support the proxy server feature for https clients.
Value of SAP_HOME and SBX_PATH Set Correctly
Problem: Values provided in the IntegrationServerStartup.sh script for the SAP_HOME and SBX_PATH variables were prepended with "./", causing the operating system to interpret them incorrectly.
Solution: The parameters were changed to use a relative path so that the operating system will interpret the values correctly.
SabrixIntegrationServer.log Updated
Problem: The SabrixIntegrationServer.log shows the plain text USERNAME and PASSWORD.
Solution: The following is returned in the log’s indata:
<PASSWORD>REMOVED FOR SECURITY</PASSWORD>
<USERNAME>REMOVED FOR SECURITY</USERNAME>
Problem: Customers running the SabrixConnection for SAP on a Microsoft platform want to run it as a Windows service.
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.
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.
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.
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.
To download and install this release:
1. Retrieve the SabrixConnSAP5.0.1.0B .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.1.0B .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.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. If you run the SabrixConnection on a Microsoft platform please follow the instructions given in the install guide on installing the Windows service and how to run it. The IntegrationServerStartup.bat is no longer used and supported.
8. Changes have been made to the taxMappingsExtension.xml file; make sure you review your settings and only move what is still applicable to the new file. All other templates can be replaced with the versions you saved in step 5 above.
9. Restart the SabrixConnection.
© 2008, Sabrix, Inc.