EVRi Corporate

Evri (formerly known as Hermes) offers domestic and international shipping solutions for shipments originating in Great Britain.

This guide provides developers with the details needed to build EVRi Corporate shipping capabilities into your ShipStation API workflows.

ShipStation API also allows you to connect your own existing EVRi International account or use the EVRi services included with ShipStation API. The requirements and service details are different than those for EVRi Corporate. For details about using EVRi from ShipStation, see our EVRi from ShipStation Guide. For details about using EVRi International services, see our EVRi International Guide.

Requirements

Connection Requirements

Shipping Requirements

Connect Account

You can connect an EVRi Corporate account using the POST method to the /v1/connections/carriers/ endpoint, or via the ShipStation API Dashboard.

For instructions on connecting Evri via the ShipStation API dashboard, go to our Evri help article.

Connect via Endpoint

carrier_name: hermescorp

POST /v1/connections/carriers/:carrier_name

Copy

HTTPcURLJavaScriptNodeJSPHPPythonRubyC#JavaGoSwiftObjective-CPowerShell

1
2
3
4
5
6
7
8
9
10
11
12
13
POST /v1/connections/carriers/hermescorp HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
  "nickname": "My Hermes Account",
  "username": "hermes_user",
  "password": "pa55word",
  "client_id": "12345",
  "client_name": "Hermes User",
  "endpoint": "Production"
}

A successful connection will return a response with the carrier_id, which you'll use for any requests for this account going forward.

Rates

EVRi does not send estimated rates to ShipStation API, as EVRi does not have an available Rates API. Your EVRi Corp account contact can provide you with the details about your contracted rates.

Service Details

Available EVRi Corporate services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.

Domestic Services

International Services

Shipping to Northern Ireland

Evri will support B2C and C2C movement types for shipping from Great Britain to Northern Ireland, in accordance with the Windsor Framework. Evri will not support B2B shipments to Northern Ireland.

When shipping B2C and C2C shipments with Evri:

TIP: You may find it helpful to see the Products Object section of our International Shipping page.

From 1 May 2025, Evri will start validating the new data required for Northern Ireland parcels to ensure they can provide this data to HMRC. If the required data is not provided, the label will not be generated.

Return Services

EVRi includes one return service with ShipStation API.

Returns are also supported with the following domestic services:

Review the Return Shipping Labels page for details on creating return labels with ShipStation API.

Packages

EVRi does not include specific carrier package types. You can use the generic package type or custom package types.

Adding Shipment Insurance

All domestic Evri shipments must have carrier insurance added with an insured value that is the same as the total order value. Review the Parcel Insurance page for details on adding carrier insurance with ShipStation API.

Contact Evri to verify whether parcel insurance is part of your contract, as some Evri plans don't require insurance value information. If parcel insurance is in your contract, Evri requires the parcel value to properly validate insurance claims.

Label Support

Label Reference Fields

EVRi Corporate does not support adding custom label messages.

Multi-Package Labels

EVRi Corporate does not support creating multi-package shipments.

Label Branding

EVRi Corporate does not support label branding.

Voiding Labels

EVRi Corporate does not support voiding labels. However, labels that do not show up in their network will not be invoiced to your account.

Paperless Labels

The following EVRi services support paperless/QR code labels:

See our Paperless Labels page for details about creating paperless labels with ShipStation API.

Customs Declarations

You can download commercial invoices for EVRi Corporate shipments from the forms_download object in the label response.

Delivery Confirmation

Additional fees may apply for either signature option. See our Delivery Confirmation page for more details about using the confirmation property.

Advanced Options

EVRi Corporate supports certain advanced options, which you can add to the shipment object when creating a shipment or label.

To ensure you always have the most up-to-date information about a carrier's advanced options, use the list carrier options call.

Manifests

EVRi Corporate does not require manifesting your shipments.

Scheduling Pickups

EVRi Corporate does not support scheduling a pickup.

Service Points (PUDO)

EVRi Corporate supports shipping to service Points for certain services.

Tracking

ShipStation API's integration with EVRi Corporate supports receiving tracking updates. Review our ​Track a Package guides​​ for details on tracking with the ShipStation API.

Disconnecting Your EVRi Corporate Account

See the Disconnect section in our Delete a Carrier page for the process of deleting or disconnecting a carrier from ShipStation API.