Upload Waves

Waves are used to process sales orders (SO) and prepare them for shipping. You can create a wave by adding a single or multiple SO line(s) (which will allocate the goods) and then refer them to pick the goods off the shelf for your customer. Once the wave lines are verified or picked, they are closed and ready to be packed and shipped. Waves provide an efficient process for managing the allocation and picking of items in a warehouse.

If you have a csv or API integration with your 3PL then Waves are transmitted to them for processing. The 3PL will process the Wave and ship the order.

Uploading Waves

You can upload the waves in three steps:

• Download the latest CSV template from the “Upload Waves” module.

• Copy Waves information into the CSV template.

• Upload the CSV template into Xoro.

Downloading the CSV template

Start by downloading our Wave template (CSV) file. This file has the correct column headings that are required to perform the import operation.

• Go to Upload Waves using the Search Menu.

• Click on the “Download Template“.

Copying the information into the template

Once you’ve downloaded the template file, you can copy your data using any spreadsheet software. There are columns that you must complete and others that are optional. Mandatory fields are marked with a double asterisk (**) prefix.

Below are some points to be noted when entering the data into the template.

• The file must be a CSV (Comma-separated values) file. The name of your file must end with csv.

• Make sure you don’t change any column headings from row 1 in the template – these are needed for the file to import correctly.

• All date fields will accept a format of MM/DD/YYYY or MM-DD-YYYY.

• Be mindful of any leading zeros in your data, some spreadsheet software will trim them automatically without notifying you. This can be resolved by ensuring your columns have correct formatting.

• Sometimes long numbers (UPC, etc.) are formatted as scientific notation. Be sure to change the formatting on this data to display these long numbers correctly.

If you’re importing more than 5,000 records, we recommend you split up the file.

Upload Waves File Fields

Column Name	Data Type	Description
**WaveNumber	Text	Enter the wave number of the sales order.
**OrderNumber	Text	Enter a sales order number associated with the wave.
**ItemNumber	Text	Enter the item number in the wave.
ItemIdentifierCode	Text	Enter the identifier code associated with the item. The Item identifier code column specifies, how the Item number field value of the file will be used to match the Item in the system. Below are the valid identifier codes to be used: 0 will represent Not Applicable. 1 will represent Item Number. 2 will represent Item UPC. 3 will represent Item Barcode. 4 will represent Alternate item number 1. 5 will represent Alternate item number 2. 6 will represent Alternate item number 3.
**Qty	Numeric	Enter the qty to allocate.
TrackingNumber	Text	Enter the Tracking Number associated with the shipment.
**CarrierCode	Text	Enter the shipping carrier responsible for delivering the order to the customer.
**ShipServiceCode	Text	Enter the ship service that will be used for delivering the order.
Freight	Numeric	Enter the freight used for shipping the order.
CustomerAccountNumber	Numeric	Enter the account number of the customer.
CarrierCost	Numeric	This is the cost incurred for the transportation services provided by a carrier or shipping company.
CartonNumber	Numeric	Enter the Carton Number.
BOL Number(Bill of Landing#)	Numeric	Enter the BOL Number.
Master BOL number	Numeric	Enter the Master BOL number.
Master Tracking Number	Numeric	Enter the Master Tracking Number.
Serial Shipping Container Codes (SSCC)	Numeric	Enter the Serial Shipping Container Codes.
WeightPerCarton	Numeric	Enter the weight of the carton in the shipment.
PackageTypeCode	Text	Enter the package code.
Length	Numeric	Enter the length of the carton.
SizeUomCode	Text	Enter the name of the unit of measure for the carton's size.
Width	Numeric	Enter the width of the carton.
Height	Numeric	Enter the height of the carton.
WeightUomCode	Text	Enter the name of the unit of measure for the carton's weight.
FreightPerCarton	Text	Enter the freight per carton.
ShipmentRefNumber	Numeric	Enter the shipment reference number of the carton.
ContainerRefNumber	Numeric	Enter the reference number of the container.
FreightIdentifierCode	Text	Enter the freight identifier code.
ImportError	Text	If there are any errors from an upload, they will be listed in this column.
ThirdPartyShipmentRefNumber	Numeric	Enter the third party reference number of the shipment.
AutoCreateCarrierFlag	Text	If the carrier is not already created in the system, enter "Y" to automatically create the new carrier.

Uploading the template

Once you have filled the CSV file with your data, you can follow the steps below to upload it into Xoro:

• Click Browse to select the saved CSV template file.

• After the file has been selected, click on Upload and then select one option from the pop up (Pick Wave, Pick and close wave and Pick, close and ship order) to start importing.

• While the import is in progress, the summary of the progress will be displayed at the bottom of the screen with the progress bar.

• After the import has been completed, the result will be displayed with the message for success or error (if any).

• Waves will only get uploaded into the system if there are no errors in the file.

• If there are errors in the file, you can download the error file, fix the errors in the original file and upload it back into Xoro.