Evri Fulfilment Plugin - Setup and User Guide

Overview

The Evri Fulfilment plugin connects Neuro to Evri's fulfilment warehouses. If your stock is held by Evri Fulfilment, Neuro will:

• Send your orders to Evri automatically, so they can be picked, packed and despatched.

• Bring despatch and tracking details back from Evri as soon as an order ships, and pass them on to your sales channels as usual.

• Keep your stock in step with the quantity Evri can actually sell, so your channels show accurate stock levels.

• Send cancellations to Evri when you cancel an order in Neuro.

If your stock is spread across more than one Evri warehouse, you can add a separate plugin for each warehouse and manage them all from one Neuro account.

Before You Start

You will need the following from your Evri Fulfilment account manager:

One set of credentials covers one Evri warehouse. If Evri stores your stock in more than one warehouse (for example Basildon and Vianen), Evri will give you a separate username and API key for each one. You then add one Evri Fulfilment plugin per warehouse in Neuro.

You should also check the following:

• Your SKUs match. Neuro links products by SKU. The Customer Ref (SKU) on each product in Evri must match the SKU of the same product in Neuro. Products that do not match will not receive stock from Evri and cannot be sent to Evri on an order.

• You know which shipping services you use. Each Neuro shipping method needs to be linked to one of the Evri shipping services listed in Step 3.

• Amazon Buy Shipping is set up with Evri if you want to use the Amazon shipping services. Evri configure this on their side.

Step 1: Add the Plugin

1. Go to Plugins in the left menu.

2. Click Add Plugin.

3. Choose the store the plugin belongs to and select Evri Fulfillment from the list.

4. Fill in the connection fields below and save.

Connection fields

Neuro does not test your credentials when you save. If the username or API key is wrong, you will see an authentication error in the plugin logs on the first sync. Check the logs a few minutes after you switch the plugin on.

Step 2: Choose the Sync Settings

Under the plugin's sync settings, switch on the parts of the integration you want to use:

Order Management

Inventory Management

Step 3: Map Your Shipping Services

Every order sent to Evri must carry an Evri shipping service. In the Fulfilment Services List, add one row for each Neuro shipping method you use:

Exactly one row must be marked as the default.

The Evri services available are:

All Evri services have a 30 kg maximum parcel weight. The Amazon Buy Shipping services only work once Evri have set up Amazon Buy Shipping on your account.

If an order's shipping method matches no row, the default service is used. If no usable service can be found, the order is not sent and a message naming the shipping method is shown on the order.

Step 4: Decide Which Orders Go to Evri

Orders reach the Evri plugin through your plugin rules, in the same way as other fulfilment plugins.

• One warehouse: mark the Evri plugin as Default in the plugin header, so every order without a more specific rule is sent to it.

• More than one warehouse: add a plugin rule for each Evri plugin, for example by destination country, sales channel or shipping method. Evri does not move orders between its warehouses, so each order must be sent to the plugin of the warehouse that will fulfil it.

Each order is assigned to one plugin at most. If an order matches no plugin, it is not sent anywhere, so check your rules cover every order you expect Evri to fulfil.

If you switch a plugin off and on again, check that its Default setting is still on before new orders arrive.

Step 5: Switch the Plugin On

Turn the plugin Active. Once it is active, Neuro:

1. Subscribes the plugin to Evri's despatch notifications automatically. You do not need to give Evri a webhook URL. The Webhook Management section of the plugin shows Subscribed to Evri with the date and time once this is done.

2. Imports your Evri products and stock (if Import products is on).

3. Starts sending eligible orders.

If you change the username or API key, Neuro subscribes the plugin again with the new details. Switching the plugin off and on again also re-checks the subscription with Evri and restores it if it is missing.

How It Works

Products and stock

When Import products is on, Neuro reads the list of SKUs in your Evri warehouse about once an hour and links each one to the Neuro product with the same SKU. Stock levels are then imported about every five minutes and written to the Neuro warehouse linked to this plugin.

Neuro uses Evri's available figure exactly as Evri returns it. Evri has confirmed that this figure already excludes:

• stock allocated to other orders,

• stock needed for backorders,

• quarantined, damaged or on-hold stock, and goods-in not yet put away,

• expired and short-dated batches (Evri applies its own shelf-life and first-expiry-first-out rules).

You do not need to set up any batch or allocation rules in Neuro for Evri stock.

If you use more than one Evri warehouse, each plugin writes stock only to its own Neuro warehouse, and Skip unfulfillable orders checks only the stock of the warehouse the order is going to.

Sending orders

Orders are sent to Evri one at a time, about once a minute. For each order, Neuro sends:

• Reference: your sales channel's order number. For Amazon orders this is always the Amazon order ID, as Evri requires.

• Reference 2: the Neuro order ID.

• Prime flag: Amazon Prime orders are marked as Prime, so Evri can apply its Prime handling and Amazon Buy Shipping.

• Shipping service: from your Fulfilment Services List (Step 3).

• Delivery address, contact details and order lines, with prices.

Once Evri accepts an order, the Evri order ID is saved against it. If Evri rejects an order, the order is marked as failed and Evri's error message is shown on the order and in the plugin logs.

Neuro also handles a few cases for you:

How the despatch date works

Evri needs a despatch date on every order: the date its warehouse team should process it. Evri rejects dates in the past.

Neuro sets it to the order date plus the Despatch date offset, in the plugin's Timezone, and never earlier than today. With the default offset of 0, a new order is sent with today's date. If an order is retried on a later day, the date is worked out again so it is never rejected as past.

You do not need to manage cut-off times. Evri applies your agreed warehouse cut-off and moves late orders to the next day automatically.

Step 6: Despatch and Tracking

When Evri despatches an order, it notifies Neuro straight away. Neuro then:

• creates a fulfilment for each parcel, with its tracking number, carrier and service, so orders sent in more than one parcel keep every tracking number,

• places the despatched quantities back on the original order lines (including lines that were combined or sent as kit components), and

• sends the fulfilment on to your sales channel in the usual way.

A repeated notification from Evri never creates a duplicate fulfilment. Partial despatches are recorded as they happen, and the order stays partly fulfilled until the rest ships.

As a safety net, Neuro also checks every open order it has sent to Evri about once an hour. If an order has been despatched and the notification was missed, the fulfilment is created from Evri's order details instead. If Evri has cancelled an order on its side, the order is marked as cancelled in Neuro and an activity is added to it.

Refetching fulfilments

If you need Neuro to check Evri again for despatched orders, use Refetch Fulfilments on the plugin and choose the date to check from. The check runs on the next sync.

Step 7: Cancelling Orders

With Push order cancellations on, cancelling an order in Neuro sends the cancellation to Evri within about ten minutes.

Evri can cancel an order at most stages, including while it is being picked. It cannot cancel an order once it is processing, packing, printing documents, packed or despatched, or while it is paused. In those cases the order shows Cancellation Failed with Evri's reason, and you will need to contact Evri directly.

If Evri had already cancelled the order, Neuro treats the cancellation as successful.

Stock after a cancellation during picking: Evri does not release picked stock immediately. Its team first returns the items to their pick locations, and until then the units stay allocated in Evri. Your Neuro stock for those items will therefore stay lower for a while after this kind of cancellation. This is expected and corrects itself once Evri puts the stock back.

Things to Know

• An order's Reference can only be used once. Evri rejects any new order whose Reference has been used before. If this happens, Neuro marks the order as synced with an Already in Evri warning in the plugin logs, rather than retrying it. Because Evri does not return its order ID in this case, Neuro can still record the despatch when it arrives, but it cannot cancel the order or check its status. Cancel or query these orders with Evri directly.

• Re-sending an order to Evri (for example after cancelling it there) may be refused for the same reason. Contact Evri if you need an order re-created.

• Evri's warehouse status is not shown in Neuro. If Evri holds an order (for example awaiting approval, backorder, waiting for EU product information or waiting for documents), it shows in Neuro as sent but not shipped. If an order has been sent but not despatched for longer than you would expect, check its status in the Evri portal.

• Returns are not imported. Orders that Evri marks as despatched and later returned are not updated in Neuro.

• Parcel weight, dimensions, batch and serial numbers from Evri's despatch details are not stored on the fulfilment.

• Advance shipping notices (ASNs) and creating SKUs in Evri are not part of this plugin. Manage these in the Evri portal.

Troubleshooting

If you need more help, contact Neuro support with the order number and, where possible, the Evri order ID.