Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Machship will select a carrier and service, based on the pickup and delivery addresses, item dimensions and weight and if the user selects “Least Cost” or “fastest”. The freight charges, consignment note number and freight items within the consignment are updated on the Jiwa sales order.

Deployment

Prerequisites

Jiwa REST API Plugin

The Machship plugin has a dependency on the Jiwa REST API plugin, so this plugin must first be enabled.

Open the Plugin Maintenance form in Jiwa, and locate the REST API plugin and ensure it is enabled.

If not intending to send consignments via the Jiwa REST API, then it is not necessary for the Jiwa REST API service to be running, but the Machship plugin will still require the Jiwa REST API plugin to be present and enabled.

Import plugin

Open the Plugin Maintenance form in Jiwa , and locate any other freight integration plugins (such as IFS) and disable and save those.

...

Consignments are created in Machship by either the user pressing the Send to Freight System button on a sales order, Freight tab - or by invoking a REST API route

Code Block
/SalesOrders/{InvoiceID}/SendToFreightSystem

.

Setting a Carrier or Service selection before creating the consignment is optional.

...

The Contact Name and address details on the Delivery Address tab of the sales order is what is sent to Machship as the delivery address in order for it to determine which carrier and which cost(s) apply - so ensure these are set.

...

The Contact Email Address and Contact Phone are custom fields introduced by the Machship plugin. These fields are automatically set .

...

when a contact name is selected, but the values can be overridden.

When a sales order is first created, or a debtor changed on a sales order the Contact Name is selected as the first contact name from the debtor maintenance form, and the Email Address and mobile phone number are populated into the respective delivery address fields.

Contact names on the debtor maintenance form can be ordered as desired, so if the first contact of a debtor is not the desired contact for deliveries, then move the desired contact to be the first contact on the debtor maintenance form.

On the Freight tab of a sales order, change the Status to Ready To Send and press the Send To Freight System button to create a consignment. The Use Least Cost checkbox can be used to instruct Machship to use the lowest cost option for carrier and service selection - leaving unchecked and Machship will use the fastest option.

...