You are on page 1of 10

How-to

Transfer balances from Compu-Clearing to


CargoWise bonded warehouse
South Africa

Contents
1. Introduction ...................................................................................................................................................... 3
2. CargoWise setup required ........................................................................................................................... 3
2.1 Organizations ................................................................................................................................................................................ 3
2.2 Warehouse...................................................................................................................................................................................... 3
2.3 Bonded area/locations .......................................................................................................................................................... 3
2.4 Product/s codes with customs information .......................................................................................................... 4
3. Extracting universal XML from Compu-Clearing ................................................................................. 4
3.1 Getting your CargoWise codes ....................................................................................................................................... 5
4. Adding universal XML via EDI messages ................................................................................................. 6
5. Check and finalize the upload adjustment ............................................................................................ 8
6. Use the uploaded adjustment data in a Declaration job .................................................................. 9

How-to – Transfer balances from Compu-Clearing to


CargoWise bonded warehouse | 1
© 2020 WiseTech Global 17 July 2020
Date Version Description of Change

How-to – Transfer balances from Compu-Clearing to


CargoWise bonded warehouse | 2
© 2020 WiseTech Global 17 July 2020
1. Introduction
This document details the requirements for uploading ZA bonded warehouse balances into your CargoWise
system from the Compu-Clearing legacy system. This is done using a warehouse adjustment universal XML
and eHub.

During this process the data will be exported from the third party system and converted to the CargoWise
UXML format, then imported via eAdaptor. This process is the responsibility of the user, and CargoWise
suggests approaching a CargoWise Partner to assist with any technical capabilities.

The following setups in CargoWise are required as prerequisites for the upload to function.

2. CargoWise setup required


2.1 Organizations
First, an Organization must be created and configured for use with the Warehouse Module. This will be used
as the Organization Proxy later and must include all required Customs Codes in the Config tab.

Importer and Supplier Organizations must also be configured to correctly match the data you are importing.

Refer to the following Learning Materials for information on creating and configuring Organizations:

• 1COR037 – How do I create an Organization?


• 1COR065 - How do I configure a Warehouse Organization?

2.2 Warehouse
Once a Warehouse Organization has been created you need to set up the Bonded Warehouse in CargoWise.
You will also need to specify if it will be a Virtual or Physical Bonded Warehouse as this affects the
integration with the Warehouse module.

Refer to the following Learning Materials for information on creating and configuring Bonded
Warehouses:

• 1BRK037 - How do I create a Bonded Warehouse?


• 1WDF011 – How do I create a Warehouse with Basic configurations?
• 1WDF122 - How do I set up a Warehouse with Advance configurations?

2.3 Bonded area/locations


After creating your Warehouse in CargoWise you will need to create and configure Warehouse Locations
and Warehouse Areas for the Bonded Warehouse to function correctly. A minimum of one area and one
location must be added to the Warehouse.

Refer to the following Learning Materials for information on setting up Locations and Areas:

How-to – Transfer balances from Compu-Clearing to


CargoWise bonded warehouse | 3
© 2020 WiseTech Global 17 July 2020
• 1WDF012 - How do I create Warehouse Locations?
• 1WDF014 - How do I configure Warehouse Locations?
• 1WDF013 – How do I create Warehouse Areas?

2.4 Product/s codes with customs information


Product Codes are required in the Legacy System for every bonded warehouse record / line in order for the
data to be successfully updated into CargoWise, these product codes must match (be the same) the
Product Codes created in CargoWise.

Refer to the following Learning Materials for information on setting up Products:

1COR063 – How do I create Products?

1COR064 - How do I create Attributes for Products?

1BZA003 - How do I link Customs information to a Product?

1BRK040 - How can I find products received into a Bonded Warehouse?

1BRK039 - How can I see all inwards and outwards transactions for a Bonded Warehouse?

3. Extracting universal XML from Compu-Clearing


From the Compu-Clearing Main menu, select options 5, 10, 8 and 1

The following capture screen will be display:

It is important all fields are completed in order to produce the XML data file, including the CargoWise
information to be included in the XML message. The following fields are mandatory:

How-to – Transfer balances from Compu-Clearing to


CargoWise bonded warehouse | 4
© 2020 WiseTech Global 17 July 2020
• Email Address: enter the email address where the generated XML file must be sent to.

• Compu-Clearing W/House: enter the Compu-Clearing warehouse code where the data must be
extracted from.

• Compu-Clearing Importer: enter the Compu-Clearing importer code that the data must be extracted
for.

• CW1 Warehouse: enter the three-character CargoWise warehouse code that the data must be uploaded
to.

• CW1 Organization code: enter the CargoWise organisation code for the same Compu-Clearing Importer
previously selected.

• CW1 Location: enter the CargoWise location of the warehouse where the goods are stored.

• CW1 Company Code: enter your CargoWise company code. (See section: 3.1 Getting your CargoWise
Codes for information on how to obtain this code.)

• CW1 Enterprise Id: enter your CargoWise One Enterprise Id. See section: 3.1 Getting your CargoWise
Codes for information on how to obtain this Id.)

• CW1 Server: enter your CargoWise One Server Code. (See section: 3.1 Getting your CargoWise Codes for
information on how to obtain this code.)

The following information is important when completing these fields:

• All fields are mandatory and are required for the import of the XML into CargoWise.
• WH balances can only be extracted per warehouse/importer combination.
• All fields that begin with CW1 indicate that the CargoWise code is required.
• The CW1 location needs to be entered exactly how the warehouse location was set up in
Cargowise.
• Product codes are required in the Legacy System for every bonded warehouse record /
line in order for the data to be successfully updated into CargoWise. These product
codes must match (be the same) the product codes created in CargoWise.

Once all the required information has been entered, press Enter on your keyboard to generate, and send the
Warehouse Adjustment XML message to the email address entered.

After the email containing the XML File has been received, save the XML file to your local PC hard drive or a
‘Network’ location.

3.1 Getting your CargoWise codes


The CargoWise Enterprise Code, CargoWise Company Code, and CargoWise Server Code can be found by
navigating to the Jump menu in your CargoWise system. Then click on the Help option at the bottom of the
screen and select About.

The following window will open with the required codes:

How-to – Transfer balances from Compu-Clearing to


CargoWise bonded warehouse | 5
© 2020 WiseTech Global 17 July 2020
The three highlighted codes on the top of the window correspond to the ‘Compu-Clearing capture fields’ as
follows:

• CW1 Enterprise Code - the 1st three-character code (HYE in the example above)

• CW1 Company Code - the 2nd three-character code (BNE in the example above)

• CW1 Server Code - the 3rd three-character code (UAT in the example above)

4. Adding universal XML via EDI messages


In your CargoWise system navigate to EDI Messages under: Maintain > System > EDI Messages.

In the EDI Messages search screen click on the Actions drop-down menu and select Add Inbound
Universal XML Message.

Locate the XML file to be downloaded, and click on the Open button.

How-to – Transfer balances from Compu-Clearing to


CargoWise bonded warehouse | 6
© 2020 WiseTech Global 17 July 2020
In the system prompt that displays, review the message number and click on the OK button.

Back in the EDI Messages search screen use the search filters to locate the message number. The message
number will only appear after importing the universal XML into CargoWise.

Note: the ‘WAR’ status indicates that the message was successfully imported into your system.
However, it contains warnings.

In the results grid, highlight the message and click on the View button. In the View Message window click on
the Notes tab and review the message. A Docket ID will be displayed at the end of the message, which can
be used to search for the adjustment and see if it has been created.

How-to – Transfer balances from Compu-Clearing to


CargoWise bonded warehouse | 7
© 2020 WiseTech Global 17 July 2020
Note: ensure that the WHSAdjustmentline matches the number of product lines added in the XML.

5. Check and finalize the upload adjustment


Go to Operate > Warehouse > Adjustments.

In the Adjustments search screen, use the search filters to locate the Docket ID of the adjustment created
from the universal XML import message.

In the results grid, highlight the record and click on the Edit button. In the Edit Adjustment window under the
Entry screen review the adjustments.

Refer to the following Learning Materials for information on Adjustments and Inventory:
• 1WDF008 - How do I create an Adjustment?
• 1WDF079 - How do I create an Internal Warehouse Adjustment?
• 1WDF009 - How do I query Inventory?

How-to – Transfer balances from Compu-Clearing to


CargoWise bonded warehouse | 8
© 2020 WiseTech Global 17 July 2020
6. Use the uploaded adjustment data in a Declaration
job
Go to Operate > Customs > Customs > Customs Declaration.

In the Customs Declaration search screen click on the New button.

In the New Customs Declaration window, ensure the Shipment Type is set to EXW – Ex-Bond, or EXP –
Export.

Complete all the required information under the Declaration and Entry Instruction tabs. Click on the
Brokerage menu and select Bonded Warehouse > Select Inventory.

In the Inventory Selection search window, use the search filters to locate the stock that you would like to
use included on the custom declaration.

Then, within the Products grid, enter:

a. Product Quantity to Draw: you are not be allowed to draw more stock than is available in the
Product Quantity on Hand field
Navigate to the Selected Products grid and review the select stock.

Once the Selected Products grid contains all the stock required to be drawn click on the Select button.

The invoice lines for the declaration job will now be automatically created from the selected inventory and
you will be taken to the Invoice Lines tab.

How-to – Transfer balances from Compu-Clearing to


CargoWise bonded warehouse | 9
© 2020 WiseTech Global 17 July 2020
The invoice price will be calculated using a factor calculated as follows:

• The Total Stock Price divided by the Total Stock Quantity will result in a factor. The draw quantity is then
multiplied by the factor to arrive at the Invoice Line price for the out of bond invoice line.

Note: if the stock was placed into the warehouse on an entry submitted from CargoWise or Uploaded via
universal XML, the MRN (Previous Movement Reference Number) will be automatically recorded.

If the stock was manually updated using the Update Bonded Warehouse function, then the MRN Number
field will display: ‘<PendingCustomsResponse>’. Ensure that the correct MRN number is captured for any
invoice lines where the ‘<PendingCustomsResponse>’ is found.

Once all the information for the declaration job has been captured then use the normal functions to
Generate / Merge the entry and send it to Customs.

The draw stock will now display a pending status until the entry submitted to customs has been cleared. If
the entry is rejected by Customs, the stock on the entry will be placed back into the warehouse available
quantity.

Note: the Tariff Heading used on the invoice line will be from the one setup against the product code
instead of what was uploaded in the universal XML Data File.

Refer to the following Learning Materials for more information:

• 1BZA020 - How do I create a Customs Declaration into a Bonded Warehouse?


• 1BZA021 - How do I create a Customs Declaration to remove product from a Bonded Warehouse?

Support: Press the F1 key from anywhere within CargoWise to raise an eRequest.

How-to – Transfer balances from Compu-Clearing to


CargoWise bonded warehouse | 10
© 2020 WiseTech Global 17 July 2020

You might also like