Skip to main content

Shipping Glossary

Definitions for terms used in Shippo, Local Rules, and Custom Courier API setup.

Origin Address​

The shipping-from address (your store, warehouse, or fulfillment location).

Destination Address​

The shipping-to address entered by the customer at checkout.

Lane​

A route from origin country/region to destination country/region.

Carrier Account​

A shipping carrier connection (for example USPS, UPS, DHL) available in your Shippo account.

Service Level​

A delivery option from a carrier (for example standard, express, next-day).

Shipping Rate​

A quoted price for a delivery service level on a specific shipment.

Webhook​

A callback URL used by Shippo to notify eshopOS about shipping events (for example tracking/status updates).

API Token​

A secret credential used to authenticate server-to-server calls to Shippo.

  • Test format: shippo_test_...
  • Live format: shippo_live_...

Custom Courier API​

A merchant-owned shipping provider API connected directly into eshopOS.

This is not the eshopOS developer API. It refers to an external courier, dispatch, or logistics provider used by the merchant.

Provider API Key​

A secret issued by the merchant's external courier or dispatch provider.

eshopOS stores this key so it can call the provider's quote, shipment, or status endpoints on the merchant's behalf.

No Auth​

The provider accepts server-to-server API requests without any credential.

Bearer Token​

The provider expects a token in the Authorization: Bearer <token> header.

Custom Header Auth​

The provider expects a secret in a named header such as X-API-Key: <token>.

Basic Auth​

The provider expects an HTTP basic auth username and password.

OAuth Client Credentials​

The provider exposes a token endpoint so eshopOS can exchange a client ID and client secret for an access token.

Webhook Signature​

A provider-generated signature sent with a webhook so eshopOS can verify that the payload was not forged or altered.

Shippo No Rates​

A state where Shippo returns no available rates for the current lane/shipment constraints.

Common causes:

  • Unsupported origin/destination lane for connected carriers
  • Missing required shipment details
  • Carrier account limitations

Local Rules​

eshopOS internal shipping engine based on zones and manually configured rates.