International Growth Engine for Ambitious Brands
Ctrlk
ESW Help CenterTalk to an Expert
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Overview

Share product catalog data with ESW to calculate duties and taxes at checkout and support customs compliance.

The Customs Catalog API ingests retailer product catalogs, classifies items using Harmonized System (HS) codes, and serves per-product duty and VAT rates to downstream checkout and shipment systems.

Use the Customs Catalog API to share your product catalog with ESW. ESW uses this data to calculate duties and taxes at checkout. It also supports customs compliance for cross-border shipments.

For catalog file integration, see catalog file to send your product master data to ESW.

What this API does

Cover

Catalog Ingestion

Cover

HS Classification

Catalog basics

A catalog is the product dataset you share with ESW.

Each record usually represents one product or variant.

Typical fields include:

  • Product code

  • Name

  • Description

  • Material

  • Country of origin

  • HS code

  • HS code region

You can also send category, size, gender, age group, product URLs, image URLs, and extra identifiers.

Catalog data drives duty and tax calculation at checkout.

It also supports classification and customs compliance.

Good catalog data helps you:

  • Improve duty and VAT accuracy

  • Reduce invalid or unclassified products

  • Avoid customs delays

  • Keep shopper pricing consistent

The Customs Catalog API processes uploads asynchronously.

  1. Send a full catalog during onboarding.

  2. Send only new or changed items after that.

  3. ESW validates the payload and accepts the request.

  4. Products are processed, classified, and enriched.

  5. Invalid products are surfaced for review and reprocessing.

Processing continues after the request is accepted.

NextConcepts

Last updated

Was this helpful?