# GoSweetSpot Courier Delivery Setup and Usage

<span class="md-plain md-expand">To view instructions on creating a shipment from an Invoice without an overview of the relevant form components, click [here](https://hugeerp0.co.za/hsofdocs/link/131#bkmrk-creating-a-shipment). </span>

## <span class="md-plain md-expand">Set Up</span>

### <span class="md-plain md-expand">GoSweetSpot Account</span>

#### <span class="md-plain md-expand">Get the API Key</span>

<span class="md-plain">From the GoSweetSpot account navigate to the Preference &amp; Settings page by selecting from the Administration menu. </span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/eytimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/eytimage.png)

Scroll down and click Advanced Settings to expand this section.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/P5timage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/P5timage.png)

Scroll to the bottom of this section and copy the API Access Token to the clipboard.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/UpGimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/UpGimage.png)

#### Get the Site ID 

The Site ID is linked to the collection address that is used when creating an account with GoSweetSpot.

From the GoSweetAccount navigate to the Users &amp; Permissions page by selecting Manage Users from the Administration menu.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/FJMimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/FJMimage.png)

Copy the Site ID from the Site column that is linked to the collection address for courier shipments created from HugeERP. [![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/AKTimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/AKTimage.png)

### API Setup

Return to Huge ERP and navigate to API Setup in the SCM module under Security.

Click the Add button in the top toolbar.

Select GoSweetSpot from the API combo box in the Add form.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/l4oimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/l4oimage.png)

Copy the API Key from GoSweetSpot to the API Key field.

Make sure the Active checkbox is checked.

The User Name and Password fields are not required and can be left blank.

The config field can specify optional settings. Each setting is required to be on a separated line and begins with the name of the setting followed by an equals sign and then the value for the setting. So far the available settings are as follows:

<table border="1" id="bkmrk-name-description-sid" style="border-collapse: collapse; width: 100%; height: 88.8px;"><colgroup><col style="width: 23.5062%;"></col><col style="width: 76.5926%;"></col></colgroup><tbody><tr style="height: 29.6px;"><td style="height: 29.6px;">**Name**</td><td style="height: 29.6px;">**Description**</td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">side\_id</td><td style="height: 29.6px;">The Site ID to use if it is missing from the Company Branch setup </td></tr><tr style="height: 29.6px;"><td style="height: 29.6px;">excludeContactInfo</td><td style="height: 29.6px;">If the value is "yes" without the quotes, then contact info for the delivery recepient, such as the name and phone number, is to be excluded when creating a shipment.</td></tr></tbody></table>

Click Save when done.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/v04image.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/v04image.png)

### Adding the Site ID to the Branch 

Navigate to Copy Profiles in SCM under Administration, and open the form for the company branch in which GoSweetSpot is to be used.

Switch to the Address tab, and copy the Site ID copied from GoSweetSpot into the GoSweetSpot Site field, then save and close the form.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/jNkimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/jNkimage.png)

### Creating a Delivery Company

To select GoSweetSpot as the API for courier delivery from an Invoice form or other document form, it first needs to be added as a Delivery Company in Creditors Setup.

Navigate to Creditors Setup in the Creditors Module under Configuration.

Click the Add button in the top toolbar.

In the Details tab fill in the Credit Code, Name and Short Name fields for the Delivery Company. Other information in this tab is optional.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/JwVimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/JwVimage.png)

Save the form by clicking the Save button and then switch to the Info tab.

In the Use Courier API combo box select GoSweetSpot then save the form again. The form can now be closed.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/8Bximage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/8Bximage.png)

### Adding Shipping Terms

Shipping Terms need to be created for selecting the Delivery Company from an Invoice or other document form.

Navigate to Additional Debtor Properties in the Debtor module under Configuration. Switch to the Shipping Terms tab.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/AHiimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/AHiimage.png)

Click the Add button in the top toolbar.

The opened window may contain the title Shipping Methods but it is for creating and editing a Shipping Terms instance <span style="background-color: rgb(255, 255, 0);">\[TBC fix language tag\]</span>.

In the Shipping Method form enter a Code and Description in the respective fields. Select Delivery for the Ship Type combo box and External for the Delivery By combo box.

The Delivery Company combo box should be enabled after selecting External for the Delivery By combo box. Select the created Delivery Company for the combo box.

Make sure the Active checkbox is checked, and then click Save &amp; Close.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/b7Gimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/b7Gimage.png)

If the Default checkbox is checked, then when an Invoice or other document is first loaded the Shipping Terms from this form will be selected automatically.

It should now be possible to create shipments with GoSweetSpot from Invoice forms.

### Optional - Predefined Parcel Sizes

Predefined parcel sizes can be created in the Courier Setup panel in the Parcel Sizes tab, or in the Defaults tab in the Parcel Selection grid as described in the next section. Predefined parcel sizes can be used as templates to create new parcel entries with the same values for a new shipment from the Parcel Selection for an Invoice. The selected API should be GoSweetSpot and the name should be unique. The dimensions and weight should all be provided.

If there are no predefined parcel sizes created then when adding parcel sizes for a courier delivery from an Invoice form or other document form, the dimensions and weight values will need to be manually specified.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/Aadimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/Aadimage.png)

If the Name matches a pre-loaded stock size for GoSweetSpot, for instance "GSS-A1 SATCHEL" then the other fields will be ignored by GoSweetSpot and the rates for the delivery will be based on the stock size given by the name. The names have to match exactly. For more information see [GSS Satchel Specific Rates – Help Centre (gosweetspot.com)](https://support.gosweetspot.com/hc/en-us/articles/7668568138511-GSS-Satchel-Specific-Rates)

## <span class="md-plain">Using GoSweetSpot to Create Shipments</span>

<span class="md-plain">Shipments can be created from the document types:</span>

- <span class="md-plain">Invoice</span>
- <span class="md-plain">Sales Order</span>
- <span class="md-plain">Sales Order Confirm</span>
- <span class="md-plain">Dispatch Stock Documents </span>

<span class="md-plain">The process to create a shipment is identical for all document types, however the delivery status can only be updated automatically from the Invoice form at this point.</span>

### <span class="md-plain">Creating Shipments from an Invoice</span>

<span class="md-plain">An Invoice to create a shipment from can be in Preparation or Posted Status. If in Posted status only the fields in the Shipping tab can be edited. </span>

<span class="md-plain">At a minimum, outside of the Shipping tab fields, the Customer, Internal Contact and Contact Person fields are required in addition to the delivery address given in the address fields in the Address tab of the form. </span>

<span class="md-plain">Fields and other UI elements that are used for creating shipments with GoSweetSpot are marked red in the screenshots. Purple indicates that the field is not used.</span>

#### <span class="md-plain">Detail Tab</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/2CZimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/2CZimage.png)

<figure class="md-table-fig table-figure" id="bkmrk-component-used-requi"><table class="md-table" style="width: 99.6296%; height: 313.8px;"><thead><tr class="md-end-block" style="height: 29.6px;"><th style="width: 18.0425%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Component</span>**</span></span></th><th style="width: 10.0099%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Used</span>**</span></span></th><th style="width: 10.3806%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Required</span>**</span></span></th><th style="width: 61.5423%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Description</span>**</span></span></th></tr></thead><tbody><tr class="md-end-block" style="height: 173px;"><td style="width: 18.0425%; height: 173px;"><span class="td-span"><span class="md-plain">Customer</span></span></td><td style="width: 10.0099%; height: 173px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.3806%; height: 173px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 61.5423%; height: 173px;">Required to save the Invoice.

  
The address fields in the Address tab is populated with the address of the selected Customer.

  
<span style="background-color: rgb(255, 255, 0);">\[TODO\]</span> The default contact is used as the delivery contact if the contact person is not set in the Address tab. <span style="background-color: rgb(255, 255, 0);">\[TBC - check if the contact information from the Debtor Details form is still in use\]</span>

</td></tr><tr style="height: 35.2px;"><td style="width: 18.0425%; height: 35.2px;"><span class="td-span"><span class="md-plain">Reference</span></span></td><td style="width: 10.0099%; height: 35.2px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 10.3806%; height: 35.2px;"><span class="td-span"><span class="md-plain">  
</span></span></td><td style="width: 61.5423%; height: 35.2px;"></td></tr><tr class="md-end-block" style="height: 29.6px;"><td style="width: 18.0425%; height: 29.6px;"><span class="td-span"><span class="md-plain">Order Number</span></span></td><td style="width: 10.0099%; height: 29.6px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.3806%; height: 29.6px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 61.5423%; height: 29.6px;"><span class="td-span"><span class="md-plain">Used as the reference for the shipment.</span></span></td></tr><tr class="md-end-block" style="height: 46.4px;"><td style="width: 18.0425%; height: 46.4px;"><span class="td-span"><span class="md-plain">Internal Contact</span></span></td><td style="width: 10.0099%; height: 46.4px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.3806%; height: 46.4px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 61.5423%; height: 46.4px;">Used to get the Site ID from the Company Branch that the selected user belongs to.</td></tr></tbody></table>

</figure>#### <span class="md-plain">Address Tab</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/HDFimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/HDFimage.png)

<figure class="md-table-fig table-figure" id="bkmrk-component-used-requi-1"><table class="md-table" style="width: 100%; height: 628px;"><thead><tr class="md-end-block" style="height: 29.6px;"><th style="width: 22.2442%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Component</span>**</span></span></th><th style="width: 10.257%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Used</span>**</span></span></th><th style="width: 13.4701%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Required</span>**</span></span></th><th style="width: 54.004%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Description</span>**</span></span></th></tr></thead><tbody><tr class="md-end-block" style="height: 46.4px;"><td style="width: 22.2442%; height: 46.4px;"><span class="td-span"><span class="md-plain">Address Type</span></span></td><td style="width: 10.257%; height: 46.4px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 13.4701%; height: 46.4px;"> </td><td style="width: 54.004%; height: 46.4px;"><span class="td-span"><span class="md-plain">Address that when selected will populate the address fields in this tab for editing.</span></span></td></tr><tr class="md-end-block" style="height: 46.4px;"><td style="width: 22.2442%; height: 46.4px;"><span class="td-span"><span class="md-plain">Address Lines 1-4</span></span></td><td style="width: 10.257%; height: 46.4px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 13.4701%; height: 46.4px;"> </td><td style="width: 54.004%; height: 46.4px;">Line 1 is either a street address or building number. If it begins with a number then it is assumed to be a street address, otherwise the street address in contained in Line 2.

The lines following the street address line are for the suburb and city that order.

The address can be validated and corrected from the Shipping tab by clicking the Validate Address button.

</td></tr><tr style="height: 46.4px;"><td style="width: 22.2442%; height: 46.4px;"><span class="td-span"><span class="md-plain">Address Code</span></span></td><td style="width: 10.257%; height: 46.4px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 13.4701%; height: 46.4px;">  
</td><td style="width: 54.004%; height: 46.4px;">The post code for the address.</td></tr><tr class="md-end-block" style="height: 147.2px;"><td style="width: 22.2442%; height: 147.2px;"><span class="td-span"><span class="md-plain">Contact Person</span></span></td><td style="width: 10.257%; height: 147.2px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 13.4701%; height: 147.2px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 54.004%; height: 147.2px;"><span class="td-span"><span class="md-plain">References the contact person for the delivery. The name, email and mobile or phone number of the contact person is included when the shipment is created, unless disabled in the API setup in the config field with the excludeContactInfo setting. </span></span>

<span class="td-span"><span class="md-plain"><span style="background-color: rgb(255, 255, 0);">\[TODO\]</span> Overrides the default contact person for the Customer if selected. The name and email or mobile number of the Contact Person is required. </span></span>

</td></tr><tr class="md-end-block" style="height: 46.4px;"><td style="width: 22.2442%; height: 46.4px;"><span class="td-span"><span class="md-plain">View Button </span></span></td><td style="width: 10.257%; height: 46.4px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 13.4701%; height: 46.4px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 54.004%; height: 46.4px;"><span class="td-span"><span class="md-plain">Can be used to edit the details for the selected Contact Person.</span></span></td></tr><tr class="md-end-block" style="height: 80px;"><td style="width: 22.2442%; height: 80px;"><span class="td-span"><span class="md-plain">Contact No</span></span></td><td style="width: 10.257%; height: 80px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 13.4701%; height: 80px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 54.004%; height: 80px;"><span class="td-span"><span class="md-plain"><span style="background-color: rgb(255, 255, 0);">\[TODO\]</span> If set then this Contact Number is used instead of the Mobile Number for the selected Contact Person or default Debtor Contact Person. </span></span></td></tr><tr class="md-end-block" style="height: 46.4px;"><td style="width: 22.2442%; height: 46.4px;"><span class="td-span"><span class="md-plain">Branch</span></span></td><td style="width: 10.257%; height: 46.4px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 13.4701%; height: 46.4px;"> </td><td style="width: 54.004%; height: 46.4px;"><span class="td-span"><span class="md-plain">The branch address is from the branch the selected Internal Contact belongs to.</span></span></td></tr></tbody></table>

</figure>#### <span class="md-plain">Shipping Tab</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/6QPimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/6QPimage.png)

##### Components Used

Components inside the main panel of the Shipping tab which are not used currently or are redundant in creating shipments or for other API functions with GoSweetSpot are highlighted purple in the next screenshot.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/mDOimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/mDOimage.png)

<figure class="md-table-fig table-figure" id="bkmrk-component-used-requi-2"><table class="md-table" style="width: 100%; height: 1359.6px;"><thead><tr class="md-end-block" style="height: 63.2px;"><th style="width: 21.997%; height: 63.2px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Component</span>**</span></span></th><th style="width: 8.40336%; height: 63.2px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Used</span>**</span></span></th><th style="width: 10.8749%; height: 63.2px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Required</span>**</span></span></th><th style="width: 58.6999%; height: 63.2px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Description</span>**</span></span></th></tr></thead><tbody><tr class="md-end-block" style="height: 88.4px;"><td style="width: 21.997%; height: 88.4px;"><span class="td-span"><span class="md-plain">Shipping Terms</span></span></td><td style="width: 8.40336%; height: 88.4px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 88.4px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 58.6999%; height: 88.4px;"><span class="td-span"><span class="md-plain">Required to populate the Delivery Company combo box and then select the Courier Company for GoSweetSpot. For more information view the </span><span class="md-meta-i-c  md-link">[<span class="md-plain">Set Up section</span>](https://hugeerp0.co.za/hsofdocs/link/131#bkmrk-set-up)</span><span class="md-plain">. </span></span></td></tr><tr class="md-end-block" style="height: 46.4px;"><td style="width: 21.997%; height: 46.4px;"><span class="td-span"><span class="md-plain">Collect / Ship Date</span></span></td><td style="width: 8.40336%; height: 46.4px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 10.8749%; height: 46.4px;"> </td><td style="width: 58.6999%; height: 46.4px;"><span class="td-span"><span class="md-plain">Currently not used by GoSweetSpot</span></span></td></tr><tr class="md-end-block" style="height: 43.2px;"><td style="width: 21.997%; height: 43.2px;"><span class="td-span"><span class="md-plain">Shipping Options - Email</span></span></td><td style="width: 8.40336%; height: 43.2px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 43.2px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 58.6999%; height: 43.2px;"><span class="td-span"><span class="md-plain">If checked then delivery updates are emailed to the delivery contact.</span></span></td></tr><tr class="md-end-block" style="height: 47.2px;"><td style="width: 21.997%; height: 47.2px;"><span class="td-span"><span class="md-plain">Shipping Options - Signature</span></span></td><td style="width: 8.40336%; height: 47.2px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 47.2px;">No</td><td style="width: 58.6999%; height: 47.2px;">If checked then a signature is required on delivery.</td></tr><tr style="height: 46.4px;"><td style="width: 21.997%; height: 46.4px;"><span class="td-span"><span class="md-plain">Shipping Options - Saturday</span></span></td><td style="width: 8.40336%; height: 46.4px;"><span class="td-span"><span class="md-plain">  
</span></span></td><td style="width: 10.8749%; height: 46.4px;">  
</td><td style="width: 58.6999%; height: 46.4px;"><span class="td-span"><span class="md-plain">If checked then delivery will be on a Saturday, increasing the rates. </span></span></td></tr><tr class="md-end-block" style="height: 46.4px;"><td style="width: 21.997%; height: 46.4px;"><span class="td-span"><span class="md-plain">Pickup Instructions</span></span></td><td style="width: 8.40336%; height: 46.4px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 10.8749%; height: 46.4px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 58.6999%; height: 46.4px;">Not used with GoSweetSpot when using the Site ID. </td></tr><tr class="md-end-block" style="height: 46.4px;"><td style="width: 21.997%; height: 46.4px;"><span class="td-span"><span class="md-plain">Delivery Instructions</span></span></td><td style="width: 8.40336%; height: 46.4px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 46.4px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 58.6999%; height: 46.4px;"><span class="td-span"><span class="md-plain">Special instructions for the delivery driver when delivering the shipment.</span></span></td></tr><tr class="md-end-block" style="height: 52px;"><td style="width: 21.997%; height: 52px;"><span class="td-span"><span class="md-plain">Delivery Company</span></span></td><td style="width: 8.40336%; height: 52px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 52px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 58.6999%; height: 52px;"><span class="td-span"><span class="md-plain">Required to select the Courier Company that has GoSweetSpot set as its Courier API. For more information view the </span><span class="md-meta-i-c  md-link">[<span class="md-plain">Set Up section</span>](https://hugeerp0.co.za/hsofdocs/link/131#bkmrk-set-up)</span><span class="md-plain">. </span></span></td></tr><tr class="md-end-block" style="height: 80px;"><td style="width: 21.997%; height: 80px;"><span class="td-span"><span class="md-plain">Validate Button</span></span></td><td style="width: 8.40336%; height: 80px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 10.8749%; height: 80px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 58.6999%; height: 80px;"><span class="td-span"><span class="md-plain">Clicking this button will validate the address set in the Address tab and open a window with the result and options to update the address. For more information view the [Validating the Delivery Address section](https://hugeerp0.co.za/hsofdocs/link/131#bkmrk-validating-the-deliv).</span></span></td></tr><tr class="md-end-block" style="height: 80px;"><td style="width: 21.997%; height: 80px;"><span class="td-span"><span class="md-plain">Update Customer Address </span><span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/6eLimage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/6eLimage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/6eLimage.png)</span></span></td><td style="width: 8.40336%; height: 80px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 80px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 58.6999%; height: 80px;"><span class="td-span"><span class="md-plain">Opens a window to edit the Customer address selected in the Address tab. When saved the address will be saved to the customer. </span></span>

<span class="td-span" style="background-color: rgb(255, 255, 0);"><span class="md-plain">\[TBC - save to the document too\]</span></span>

</td></tr><tr class="md-end-block" style="height: 63.2px;"><td style="width: 21.997%; height: 63.2px;"><span class="td-span"><span class="md-plain">Parcel Dimensions display field</span></span></td><td style="width: 8.40336%; height: 63.2px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 10.8749%; height: 63.2px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 58.6999%; height: 63.2px;"><span class="td-span"><span class="md-plain">Displays the information about the current parcel selection for the shipment to be created. If blank then there is no parcel selection. If faded then the shipment was created for the parcel selection.</span></span></td></tr><tr class="md-end-block" style="height: 69.8px;"><td style="width: 21.997%; height: 69.8px;"><span class="td-span"><span class="md-plain">Custom Parcel Dimensions button </span><span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/5kWimage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/5kWimage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/5kWimage.png)</span></span></td><td style="width: 8.40336%; height: 69.8px;"><span class="td-span"><span class="md-plain">N/A</span></span></td><td style="width: 10.8749%; height: 69.8px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 58.6999%; height: 69.8px;"><span class="td-span"><span class="md-plain">Clicking on this opens the Parcel Selection window, which is required for specifying information about the parcels for the shipment. This is explained in the next section. </span></span></td></tr><tr class="md-end-block" style="height: 46.4px;"><td style="width: 21.997%; height: 46.4px;"><span class="td-span"><span class="md-plain">Service Type </span></span></td><td style="width: 8.40336%; height: 46.4px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 10.8749%; height: 46.4px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 58.6999%; height: 46.4px;">Is no longer necessary for creating shipments.</td></tr><tr class="md-end-block" style="height: 46.4px;"><td style="width: 21.997%; height: 46.4px;"><span class="td-span"><span class="md-plain">Tracking No</span></span></td><td style="width: 8.40336%; height: 46.4px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 10.8749%; height: 46.4px;"> </td><td style="width: 58.6999%; height: 46.4px;"><span class="td-span"><span class="md-plain">Displays the last Tracking Number that is assigned to the Invoice. This can be edited and be related to shipping functions outside of the Courier API.</span></span></td></tr><tr class="md-end-block" style="height: 63.2px;"><td style="width: 21.997%; height: 63.2px;"><span class="td-span"><span class="md-plain">Tracking No buttons</span></span></td><td style="width: 8.40336%; height: 63.2px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 10.8749%; height: 63.2px;"> </td><td style="width: 58.6999%; height: 63.2px;"><span class="td-span"><span class="md-plain">These buttons can be used to add a new Tracking Number to the Invoice or view the list of existing Tracking Numbers for the Invoice. The tracking numbers do not need to have been created with GoSweetSpot.</span></span></td></tr><tr class="md-end-block" style="height: 63.2px;"><td style="width: 21.997%; height: 63.2px;"><span class="td-span"><span class="md-plain">Delivery Status display field.</span></span></td><td style="width: 8.40336%; height: 63.2px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 63.2px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 58.6999%; height: 63.2px;"><span class="td-span"><span class="md-plain">Displays the current shipping status for the last shipment created.</span></span></td></tr><tr class="md-end-block" style="height: 60px;"><td style="width: 21.997%; height: 60px;"><span class="td-span"><span class="md-plain">Update Delivery Status  
</span><span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/6eLimage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/6eLimage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/6eLimage.png)</span></span></td><td style="width: 8.40336%; height: 60px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 60px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 58.6999%; height: 60px;"><span class="td-span"><span class="md-plain">Clicking this button will perform an API request to update the Delivery Status display field.</span></span></td></tr><tr class="md-end-block" style="height: 63.2px;"><td style="width: 21.997%; height: 63.2px;"><span class="td-span"><span class="md-plain">Auto checkbox</span></span></td><td style="width: 8.40336%; height: 63.2px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 63.2px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 58.6999%; height: 63.2px;"><span class="td-span"><span class="md-plain">Having this checked will cause the Delivery Status display field to be updated when the Invoice is opened and there is a shipment created.</span></span></td></tr><tr class="md-end-block" style="height: 96.8px;"><td style="width: 21.997%; height: 96.8px;"><span class="td-span"><span class="md-plain">Courier API button </span><span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/pvNimage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/pvNimage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/pvNimage.png)</span></span></td><td style="width: 8.40336%; height: 96.8px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 96.8px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 58.6999%; height: 96.8px;"><span class="td-span"><span class="md-plain">This button is required to be clicked on before a shipment for the Invoice can be created with GoSweetSpot. If there is a selection of parcels created, and the other requirements are met, a window with a list of available shipping rates, or services types, will be presented, of which one can be selected to create a shipment. </span></span></td></tr><tr class="md-end-block" style="height: 67.8px;"><td style="width: 21.997%; height: 67.8px;"><span class="td-span"><span class="md-plain">Details  
</span><span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/rVVimage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/rVVimage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/rVVimage.png)</span></span></td><td style="width: 8.40336%; height: 67.8px;"><span class="td-span"><span class="md-plain">No</span></span></td><td style="width: 10.8749%; height: 67.8px;"> </td><td style="width: 58.6999%; height: 67.8px;"><span class="td-span"><span class="md-plain">For unrelated shipping functions. The Pickup and Delivery instructions may also be set in the form that opens after clicking the button, but it is unnecessary when these fields already exist in the current form. </span></span></td></tr><tr class="md-end-block" style="height: 80px;"><td style="width: 21.997%; height: 80px;"><span class="td-span"><span class="md-plain">Save Shipping </span><span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/rHsimage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/rHsimage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/rHsimage.png)</span></span></td><td style="width: 8.40336%; height: 80px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 10.8749%; height: 80px;"><span class="td-span"><span class="md-plain">Yes</span></span></td><td style="width: 58.6999%; height: 80px;"><span class="td-span"><span class="md-plain">Is required to save the Shipping Tab fields if the Invoice Save button is disabled as it is when the Invoice status is Posted. The Customer, Internal Contact and Reference fields are not saved. The Shipping Tab fields are also saved automatically when the Courier API button is clicked.</span></span></td></tr></tbody></table>

</figure>### Validating the Delivery Address

To validate and to correct the address that is entered into the address fields in the Address tab, click the Validate button [![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/lBRimage.png) ](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/lBRimage.png)in the Shipping tab. The address that is validated is the address as it is in the fields, not the saved address. After the address is validated by GoSweetSpot a window will open with named address fields and the validation result in the Log field. If a field has been corrected by GoSweetSpot then an asterisk will appear next to it.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/cPwimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/cPwimage.png)

After editing the address, validation can be performed again by clicking the Validate button [![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/yJ6image.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/yJ6image.png) next to the Postcode field.

Clicking the Close button will close the window, without making any changes.

Clicking the Apply button [![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/jqhimage.png) ](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/jqhimage.png)will copy the address fields as they are to the address fields in the Address tab of the Invoice form.

Clicking the Inv Only or Doc Only button [![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/1CHimage.png) ](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/1CHimage.png)will also save the address as the address type selected in the Address tab, to the document.

Clicking the "Inv &amp; Cus" or "Doc &amp; Cus" button [![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/qZZimage.png) ](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/qZZimage.png)will copy the address to the form, save it, and save the address to the customer selected in the Detail tab as the address type selected in the Address tab.

### <span class="md-plain">Parcel Selection Grid</span>

<span class="md-plain">The Parcel Selection Grid is opened in a new window by clicking the Custom Parcel Dimensions button </span><span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/aVgimage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/aVgimage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/aVgimage.png)</span><span class="md-plain"> next to the Parcel Dimensions field. It is required to have at least one parcel created before a new shipment can be created with GoSweetSpot.</span>

<span class="md-plain">When there is one or more parcel for the new shipment, the Parcel Dimensions field in the Shipping tab of the Invoice form will be updated to reflect this. In this case the text is coloured black. If the parcel dimensions are greyed out, then the parcels the dimensions for it have been assigned to the last created shipment. To create a new shipment, new parcel dimensions will need to be added.</span>

<span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/ceEimage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/ceEimage.png)</span><span class="md-plain"> Example of Parcel Dimensions created for the next shipment.</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/ceEimage.png)</span>

<span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/RY7image.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/RY7image.png)</span><span class="md-plain"> Example of Parcel Dimensions assigned to the last created shipment.</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/RY7image.png)</span>

<span class="md-plain">The Parcel Selection Grid is used for several purposes:</span>

- <span class="md-plain">To add and edit the required information about the parcel sizes for a new shipment</span>
- <span class="md-plain">Editing predefined parcel sizes to use instead of having to reenter the same values each time.</span>
- <span class="md-plain">Keeping a record of past shipments</span>
- <span class="md-plain">Viewing and updating the tracking information for parcels that have been assigned to a shipment</span>

#### <span class="md-plain">Editing Parcel Dimensions</span>

<span class="md-plain">For a shipment to be created with GoSweetSpot the dimensions and weight need to be specified or the name needs to match with a name of the a pre-loaded stock size from GoSweetSpot. The quantity greateer than one is optional and can be used instead of copying a parcel repeatedly.</span>

##### <span class="md-plain">Selection Grid </span>

<span class="md-meta-i-c  md-link" style="background-color: rgb(191, 237, 210);">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/A2Limage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/A2Limage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/A2Limage.png)</span>

<figure class="md-table-fig table-figure" id="bkmrk-component-descriptio"><table class="md-table" style="width: 100%;"><thead><tr class="md-end-block"><th style="width: 21.75%;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Component</span>**</span> </span></th><th style="width: 78.2253%;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Description</span>**</span> </span></th></tr></thead><tbody><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Search button</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">Clicking this will reload the grid from the server with the search results.</span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Add </span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">Clicking this opens a dialog to add a new parcel</span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Edit</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">When one row is selected and is for a parcel without a shipment, the same dialog that is opened with the Add button is opened to edit information for the selected row.</span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Delete</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">When at least one row is selected and the rows do not include rows for created shipments, the rows will be deleted without confirmation. Multiple rows are selected by holding down the control key and clicking on the rows to add to the selection.</span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Include Tracked</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">To include parcels with a shipment in the grid this checkbox is checked. To only show the parcels for the next shipment, it is unchecked. </span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Name column</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">The name given to the parcel. If the name matches a pre-loaded stock size from GoSweetSpot, then this stock size is used by GoSweetSpot when creating a shipment. </span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Shipment column</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">This column is hidden by default. To unhide it, open the menu for the column and check the box for it in the "Columns" submenu. For a parcels that are new it will show "Not Created". If there is a shipment number for the parcel then it is shown. If there is not shipment number but there is tracking number then "Unavailable" is shown.   
  
To group the rows by this column, open the menu for the column and click "Group by this field". </span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Shipment Created</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">This column is hidden by default and needs to be enabled in the Columns submenu. If a shipment was created that includes the parcel this column shows the date and time it was created.</span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Dimensions (L x W x H)</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">Show the length, width and height of the parcel in centimeters </span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Wgt</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">The weight in kilograms</span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Qty</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">The number of identical parcels in the shipment</span></span></td></tr><tr class="md-end-block"><td style="width: 21.75%;"><span class="td-span"><span class="md-plain">Close button</span></span></td><td style="width: 78.2253%;"><span class="td-span"><span class="md-plain">Closes the window. When the window is closed the Parcel Dimensions field in the Shipping tab of the Invoice form will be refreshed from the server.</span></span></td></tr></tbody></table>

</figure>##### <span class="md-plain">Add / Edit dialog</span>

<span class="md-plain">Opened by clicking the Add or Edit buttons</span>

<span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/D5ximage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/D5ximage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/D5ximage.png)</span>

<span class="md-plain">The Parcel combo box can be used to select a parcel template created in the Defaults grid and prefill the remaining fields. </span>

##### <span class="md-plain">Defaults grid</span>

<span class="md-plain">Lists predefined parcel dimensions that can be selected and added to the Selection grid for the next shipment.</span>

<span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/CHnimage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/CHnimage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/CHnimage.png)</span>

<span class="md-plain">To select more than one row, hold down the Control key before clicking on the next row. </span>

<span class="md-plain">When one or more rows are selected the Add Selected button becomes enabled. Clicking on it will create new parcel dimensions from the selected rows in the Selection grid that are to be included in the next shipment. When the new rows are added successfully, the tab is automatically switched to the Selection grid.</span>

#### <span class="md-plain">Editing Predefined Parcel Dimensions</span>

<span class="md-plain">To add or edit predefined parcel dimensions click the add or edit buttons. A row needs to be selected before it can be edited. Multiple rows can be deleted together by selecting more than one by holding the Control key, and then clicking the Delete button. </span>

##### <span class="md-plain">Add / Edit Dialog</span>

<span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/358image.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/358image.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/358image.png)</span>

<span class="md-plain">Entering a name is required and if a Courier API is selected then it is required to be unique for the selected API. The name will appear in the combo box in the add/edit dialog for the parcel selection grid. The dimensions and weight are required by GoSweetSpot if the name does not match with the name of a pre-loaded stock size. </span>

#### <span class="md-plain">Viewing Past Shipments</span>

<span class="md-plain">In the parcel selection grid created shipments can be viewed by checking the Include Tracking checkbox. If a shipment was created with the parcel then the Shipment, Shipment Created, Tracking Number and Tracking Number columns will contain values for shipment. </span>

<span class="md-plain">These columns are hidden by default and will need to be initially unhidden. </span>

<span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/K6Fimage.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/K6Fimage.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/K6Fimage.png)</span>

<span class="md-plain">Rows can be grouped by their Shipment numbers or Shipment Created dates, but while grouped are not able to be sorted in descending order <span style="background-color: rgb(255, 255, 0);">\[TBD - find out if this can be fixed\]</span>. To only show the parcels for a single shipment, one can be selected from the Shipment combo box in the search panel. Available shipments in the drop down list are sorted by the time and date they were created in descending order.</span>

#### <span class="md-plain">Updating Tracking Information</span>

<span class="md-meta-i-c  md-link">[<span class="md-image md-img-loaded" data-src="https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/Xj2image.png">![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/Xj2image.png)</span>](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/Xj2image.png)</span>

<span class="md-plain">To update the Delivery Status for all the parcels belonging to a shipment, select a row for a parcel with a Shipment number, then click the Status button in the top toolbar of the window. If successful then the columns API Status, API Parcel Status and Status Updated will be updated. The API Status column is the Delivery Status for the shipment, whereas the API Parcel Status is the delivery status of the consignment the parcel is part of, if the shipment was split into multiple consignments. The Status Updated column is the date and time the delivery status was last successfully updated. </span>

<span class="md-plain">If a parcel has a quantity greater than one, then in the API Parcel Status column there will be a new line for each of the parcels that make up the quantity.</span>

### <span class="md-plain">Creating a Shipment</span>

#### <span class="md-plain">Invoice Set up</span>

<span class="md-plain">A shipment is created with GoSweetSpot from an Invoice by first clicking on the Get Rates or Courier API button in the Shipping Tab when the required information has been saved to the Invoice and is correct, and then when the GoSweetSpot Delivery Options window is opened, ,clicking on the Select button in the Action column of the grid for the chosen option.</span>

##### <span class="md-plain">Required Steps</span>

<span class="md-plain">To create a Shipment with GoSweetSpot from an Invoice form the following is required before clicking on the Get Rates or Courier API button in the Shipping Tab:</span>

- <span class="md-plain">The API needs to be set up correctly. See the [Set Up section](https://hugeerp0.co.za/hsofdocs/link/131#bkmrk-set-up).</span>
- <span class="md-plain">The Invoice needs to have a Customer selected</span>
- The address in the Address tab needs to be valid. It can be validated by Validate button in the Shipping tab.
- <span class="md-plain">An Internal Contact needs to be selected.</span>
- <span class="md-plain">The Site ID for the Branch the Internal Contact belongs to needs to be valid. </span>
- <span class="md-plain">A Contact Person needs to be selected, even if contact info is to be excluded. <span style="background-color: rgb(255, 255, 0);">\[TODO - disable this check if contact is not required by GoSweetSpot\]</span></span>
- <span class="md-plain">For an address to be valid it needs to be in the following format:</span>
    
    <figure class="md-table-fig table-figure"><table class="md-table" style="width: 95.1743%; height: 207.2px;"><thead><tr class="md-end-block" style="height: 29.6px;"><th style="width: 15.0476%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Field</span>**</span></span></th><th class="" style="width: 61.7676%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Description</span>**</span></span></th><th style="width: 23.0475%; height: 29.6px;"><span class="td-span"><span class="md-pair-s ">**<span class="md-plain">Example</span>**</span> </span></th></tr></thead><tbody><tr class="md-end-block" style="height: 29.6px;"><td style="width: 15.0476%; height: 29.6px;"><span class="td-span"><span class="md-plain">Address Line 1</span></span></td><td class="" style="width: 61.7676%; height: 29.6px;"><span class="td-span"><span class="md-plain">The building name (Optional)</span></span></td><td style="width: 23.0475%; height: 29.6px;"><span class="td-span"><span class="md-plain">Unit 2</span></span></td></tr><tr class="md-end-block" style="height: 29.6px;"><td style="width: 15.0476%; height: 29.6px;">Address Line 2</td><td class="" style="width: 61.7676%; height: 29.6px;">The street address</td><td style="width: 23.0475%; height: 29.6px;">46 Bracken Place</td></tr><tr class="md-end-block" style="height: 29.6px;"><td style="width: 15.0476%; height: 29.6px;"><span class="td-span"><span class="md-plain">Address Line 3</span></span></td><td class="" style="width: 61.7676%; height: 29.6px;"><span class="td-span"><span class="md-plain">The suburb</span></span></td><td style="width: 23.0475%; height: 29.6px;"><span class="td-span"><span class="md-plain">Avonhead</span></span></td></tr><tr class="md-end-block" style="height: 29.6px;"><td style="width: 15.0476%; height: 29.6px;"><span class="td-span"><span class="md-plain">Address Line 4</span></span></td><td class="" style="width: 61.7676%; height: 29.6px;"><span class="td-span"><span class="md-plain">The city</span></span></td><td style="width: 23.0475%; height: 29.6px;"><span class="td-span"><span class="md-plain">Christchurch</span></span></td></tr></tbody></table>
    
    If the building name is ommitted then Line 1 becomes the street address and the other lines are moved up with it.
    
    </figure>
- <span class="md-plain">From the Parcel Selection grid accessed from the Shipping Tab, there needs to be at least one parcel created, with dimensions and a weight or a name matching a GoSweetSpot pre-loaded name, and without a tracking number or shipping number. </span>
- <span class="md-plain">In the Shipping Tab the Shipping Terms that apply to GoSweetSpot needs to be selected</span>
- <span class="md-plain">In the Shipping Tab the Delivery Company for GoSweetSpot needs to be selected</span>
- <span class="md-plain">Changes to the Invoice outside of the Shipping tab need to be saved. Unsaved information is not sent to GoSweetSpot. If it is a processed Invoice then clicking the Save Shipping button in the Shipping Tab can be used, however the Customer and fields outside of the Shipping Tab will not be saved. </span>

##### <span class="md-plain">Optional Steps</span>

- <span class="md-plain">If the Email checkbox is checked in Shipping Options in the Shipping Tab, then a tracking email will be sent to the email address of the delivery contact.</span>
- <span class="md-plain">If the Signature checkbox is checked, then the delivery is required to be signed for.</span>
- <span class="md-plain">If the Saturday checkbox is checked, then the delivery will be scheduled for Saturday, which may substantially increase the cost of delivery.</span>
- <span class="md-plain">Special instructions for delivery can be set from the Shipping Tab in the Delivery Instructions field.</span>
- <span class="md-plain">If the Order Number field in the Detail Tab is set then this becomes the reference printed on the label. </span>

#### <span class="md-plain">Selecting from the Available Rates</span>

<span class="md-plain">When the Invoice is ready clicking the Get Rates or Courier API button in the Shipping Tab will present a new window, GoSweetSpot Delivery Options, with a list of the available rates or Delivery Options and their costs and other relevant information. </span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/5Ejimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/5Ejimage.png)

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/xHJimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/xHJimage.png)

<span class="md-plain">Clicking a Select button will create a shipment with GoSweetSpot with the option for the row.</span>

<span class="md-plain">Clicking the Cancel button will close the window without creating a shipment. </span>

<span class="md-plain">If the Select button was clicked and a Shipment was created successfully with GoSweetSpot, then a success message with details for the created shipment will appear.</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/bnvimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/bnvimage.png)

<span class="md-plain">When the success message is dismissed, the parcel labels will be automatically downloaded by the browser as a PDF file. This file will also be saved as an attachment to the Invoice.</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/MKnimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/MKnimage.png)

<span class="md-plain">The Parcel Dimensions field in the Shipping Tab will be greyed out to indicate that the parcels it references are assigned to a shipment.</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/2xximage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/2xximage.png)

<span class="md-plain">The tracking number will be added to the Invoice in the Tracking No field and to the Tracking Number list </span><span class="md-plain">opened by clicking the View Tracking Numbers button [![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/Krjimage.png) ](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/Krjimage.png)</span><span class="md-plain">next to it.</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/Jezimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/Jezimage.png)

<span class="md-plain">In the Parcel Selection window the Shipment combo box will show the Shipment number for the created shipment with the date and time it was created.</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/q7Mimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/q7Mimage.png)

<span class="md-plain">The rows for the parcels belonging to the Shipment are updated as follows:</span>

- <span class="md-plain">The ID or number given to the Shipment by GoSweetSpot will be set in the Shipment column</span>
- <span class="md-plain">The Shipment Created column will be updated with date and time the Shipment was created</span>
- <span class="md-plain">The Status column will be updated to "In Transit"</span>
- <span class="md-plain">The Tracking Number and Tracking URL for the shipment will be set.</span>
- <span class="md-plain">The API Status column remains empty but can now be updated by selecting a row and clicking the Status button.</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/CE2image.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/CE2image.png)

### <span class="md-plain">Attachments</span>

<span class="md-plain">The attachments created by GoSweetSpot</span><span class="md-plain"> can be viewed with the other attachments for the Invoice, in the Attachments window, opened by clicking the Attachments button in the top toolbar.</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/jD0image.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/jD0image.png)

<span class="md-plain"><span style="color: rgb(0, 0, 0); background-color: rgb(255, 255, 0);">\[TODO\] </span>The attachments added for the created shipment will include the name of the Courier Delivery company, for example "GoSweetSpot", and the tracking number in their names.</span>

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/YNyimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/YNyimage.png)

### <span class="md-plain">Delivery Status Updates</span>

The Delivery Status for the last created shipment belonging to the Invoice can be updated by clicking the Update Delivery Status button [![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/MvEimage.png) ](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/MvEimage.png)next to the Delivery Status field in the Shipping Tab. To automatically update the delivery status when any Invoice is opened the Auto checkbox next to the button can be checked. This feature is currently only available from Invoice forms.

[![image.png](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/scaled-1680-/psnimage.png)](https://hugeerp0.co.za/hsofdocs/uploads/images/gallery/2024-07/psnimage.png)