Boxes/Package Dimensions Setup

You must add and set up at least one Box in Acumatica. Additionally, to use a Box with a Ship Via code, you must add it to the Ship Via code.

Create the Box(es)

1. Select Distribution > Sales Orders > Configuration > Setup > Boxes.
2. Click the ” + ” sign to add the box to the chart.
3. To ensure the Box is added to a newly created Ship Via, check the Active By Default check box.
4. Repeat these steps to add more boxes.
   

Add Box(es) to the Ship Via code

1. In Acumatica, go to Distribution > Sales Orders > Configuration > Setup > Ship Via
   Codes.
2. Select the Ship Via Code.
3. Click on the Packages tab.
4. Click the ” + ”  sign to add the box to the Ship Via code.
   

Support for Package Dimensions (for Acumatica Shipments)

StarShip now allows importing of package dimensions (Length, Width, and Height) for the Shipments document. This can be set up in a few different ways, depending upon your needs.

Map or Default the Package ID Only

If you only want to import the Box Name from Acumatica, you can map/default the Package ID and use value translations for that field (and clear dims/tare weight mappings). The Package Name must be added to StarShip Maintain Packaging, and the Package Name must be identical to the Box Name in Acumatica. You must set up a value translation in Write-Back Setup to be mapped to the correct Box in Acumatica so that write-back can occur.  When this package is imported into StarShip, without dimensions, the Package ID will populate properly.

Map or Default Dimensions/Tare Weight Only

If you only want to import Dimensions/Tare Weight into StarShip, map or default these fields to StarShip shipment fields. In this case you would remove any field mappings for Package ID in Shipment > Packaging > Packaging. StarShip will bring in dims/tare weight and use Custom Packaging. The dimensions import and the box becomes ‘Custom Packaging’ on write-back. You must set up a value translation in Write-Back Setup to be mapped to the correct Box in Acumatica so that write-back can occur. For example, create a Box in Acumatica called Custom and for the write-back value translation, map ‘Custom Packaging’ in StarShip to ‘Custom’ in Acumatica.

Map or Default Both Package ID and Dimensions/Tare Weight

In this scenario you would map the Package ID and Dimensions/Tare Weight to StarShip shipment fields. You will need to add a package in StarShip Maintain Packaging with the package dimensions. The Package Name and Dimensions in StarShip must be identical to the Box name and dimensions in Acumatica. You must also set the value translation in Write-Back Setup to be mapped to the correct Box in Acumatica so that write-back can occur. If either the Package ID or Dimensions do not match a StarShip package, Custom Packaging will be used for the package when shipping.