Skip to main content

​
Overview

The Merchant Integration API enables you to integrate your merchant systems (e-commerce, PIM, OMS, ERP, WMS, and more) with e-CROSS. This API provides endpoints for managing your catalog, prices, inventory, orders, shipments, and tracking information.

​
Integration Flows

The integration consists of four main flows:
  1. Catalog Integration - Manage your product catalog and SKUs
  2. Price & Inventory Updates - Update product prices and inventory levels
  3. Order Fulfillment - Process and fulfill orders from sales channels
  4. Trackings Monitoring - Monitor shipment status and update tracking events

​
Base URLs

The API is organized across multiple services, each with its own base URL:
  • Authentication: https://auth.api.e-cross.tech
  • Product & Catalog: https://product.api.e-cross.tech
  • Orders: https://order.api.e-cross.tech
  • Shipments & Tracking: https://hermes.api.e-cross.tech

​
Authentication

All API endpoints require authentication using Bearer tokens. You must authenticate first using the authentication endpoint to obtain a token, then include it in the Authorization header of all subsequent requests.
See the Authentication page for detailed information about obtaining and using access tokens.

​
Common Concepts

​
SKUs and Products

  • SKU (Stock Keeping Unit): A specific variation of a product (e.g., size, color, style)
  • Product: A group of related SKUs that share common attributes
  • Catalog integration happens per product, meaning all SKUs of a product must be sent together in a single request

​
Pricing Models

e-CROSS supports two pricing models:
  • Origin Pricing: Prices are defined in your foreign currency, and e-CROSS automatically localizes them for each connected sales channel
  • Destination Pricing: Prices are defined in the destination country’s currency with all operational fees included

​
Order Statuses

Orders progress through various statuses:
  • CREATED - Order has been created
  • APPROVED - Order has been approved for processing
  • HANDLING - Order is being processed
  • PACKED - Order items have been packed
  • INVOICED - Commercial invoice has been generated
  • READY_TO_SHIP - Order is ready to be shipped
  • SHIPPED - Order has been shipped
  • DELIVERED - Order has been delivered
  • CANCELLED - Order has been cancelled

​
Parcel Statuses

Parcels have their own status tracking:
  • SHIPMENT_CREATED - Parcel has been created
  • SHIPPED - Parcel has been shipped
  • ARRIVED_DESTINATION_COUNTRY - Parcel arrived in destination country
  • CUSTOMS_CLEARANCE - Parcel is in customs clearance
  • LAST_MILE - Parcel is with last mile provider
  • DELIVERED - Parcel was delivered
  • SHIPMENT_CANCELED - Parcel was cancelled

​
Rate Limiting

We strongly recommend caching authentication tokens and reusing them until expiration (8 hours) to avoid rate limiting issues. Requesting new tokens for every business request may result in HTTP 429 Too Many Requests errors.

​
Getting Started

  1. Authenticate - Obtain your access token using client credentials
  2. Integrate Catalog - Upload your product catalog and SKUs
  3. Set Prices - Configure pricing using origin or destination model
  4. Update Inventory - Keep inventory levels synchronized
  5. Process Orders - Retrieve and fulfill orders from sales channels
  6. Track Shipments - Monitor and update tracking information

Next Steps

Learn how to authenticate and obtain your access token