HowTo: Add a new shipment method 2.0

This document shows how to add a new shipment method without integrating it with the shipment provider system.

Set up the state machine

The state machine which handles orders using this shipment method needs to use a manual event for shipping so that it can be triggered from the Back Office.

The corresponding XML for this transition would be:

<states>
   <state name="exported" reserved="true"/>
   <state name="shipped" reserved="true"/>
//..
</states>
<transitions>
    <transition happy="true">
        <source>exported</source>
        <target>shipped</target>
        <event>ship</event>
    </transition>
//..
</transitions>
<events>
    <event name="ship" manual="true"/>
//..
</events>

Add a new shipment method

To add a new shipment method, follow these steps:

1. In the Back Office, navigate to the Delivery Methods section and click Create new carrier company.
2. Specify a name for the carrier company and the corresponding glossary key for having a localized name.
3. To use this carrier company in the shop, select Enabled.
4. Click Save.

When you have a new shipment carrier, you can add a new shipment method to it.

Add a new carrier company

To add a shipment method to a carrier, follow these steps:

1. Click Create new delivery method. The Create Delivery Method page opens.
2. Select the CARRIER you have created in the Add a new delivery method section.
3. Add the NAME and store- and currency-specific net and gross prices.
4. Select IS ACTIVE.
5. Select the corresponding TAX SET.
6. Click Save.

The shipment methods with price are retrieved depending on your preconfigured price mode + current store and the selected currency.

Shipment methods can be excluded if their active flag is off. The connected AvailabilityPlugin plugin excludes them; otherwise, it has a price as NULL.

In this current example, the new shipment method is available in the shop for DE store, EUR currency, and gross price mode as 7 EUR.