Sabrix® Solution
SabrixConnection for SAP
(Basic US/CA Version)
Release Notes
Version 5.0.2.0B
These release notes contain information about Version 5.0.2.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.2.0B, 5.0.1.0B, 5.0.0.1B, and 5.0.0.0B.
Problem: When freight is a condition in the pricing procedure for a line item in SAP, not all fields on the product line are copied onto the freight line that gets created by the SabrixConnection.
Solution: The freight line and the product line are now identical with the exception of the following fields:
· RELATED_LINE_NUMBER: The value of this field is set to the value of the parent line number.
· DESCRIPTION: The value of this field is "Freight for line xx" where xx is the line number from the parent line.
· GROSS_AMOUNT: The value of this field is set based on RFC value FREIGHT_AMT.
· LINE_NUMBER: The value of this field is the line number of parent line filled to the sixth position with leading zeros and then a one (1) added in front, for example, 10 will be 1000010.
· PRODUCT_CODE: The value of this field is set from the freight_prod_code in the SabrixConnection.properties file.
Problem: The SAP connection only supports country.code as the JurisdictionCodeField. It does not support country.code3 or country.isocode.
Solution: country.code3 and country.isocode have been added and made available in the jcMappingsExtenstion.xml file.
Problem: In credit transactions such as credit memos, the discount amount sent to the tax engine was not negative which led to positives values written to the audit log.
Solution: The DISC_AMT field has been negated when the CREDID_IND field is set to True during RFC_UPDATE and RFC_FORCE calls.
Problem: During an invoice update when RFC_FORCE_TAXES_DOC is used, credit transactions, such as credit memos and cancellations, set the CREDIT_IND flag to 1. This signals the SabrixConnection for SAP to change all the amounts (gross, tax and override) to a negative. The connection is changing the gross amount to negative, but leaving the tax amount and override amount positive, resulting in the wrong calculated gross amount.
Solution: The Is_Credit flag has been set correctly and amounts are now audited correctly.
Problem: The gzip flag set backwards. When the gzip_disabled flag is set to false, the payload does not gzip. When the gzip_disabled flag is set to true, the payload does gzip.
Additionally, the address validation header shows "Content-Encoding: x-gzip" but the payload does not gzip. The header claims that the data is gzipped and tries to unzip the payload. Because you cannot unzip non-zipped data, a customer can not do any address validation calls.
Solution: The gzip flag has been set to:
gzip_disabled=false now means yes, gzip
gzip_disabled=true now means do not gzip
SabrixConnection for SAP Guides: Several minor typographical errors where fixed and other minor enhancements were made.
1. 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
2. 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.
3. 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.
4. 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.
5. 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'
1. 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.
2. 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.
3. 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.2.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.2.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. No changes have been made to any of the files all templates can be replaced with the versions you saved in step 5 above.
9. Restart the SabrixConnection.
© 2008, Sabrix, Inc.