# ESW ## Home - [ESW Developer Platform](https://developer.esw.com/readme.md): ESW developer documentation for APIs, integrations, authentication, checkout, orders, webhooks, setup guides, and technical references. ## Get Started with ESW - [Overview](https://developer.esw.com/getting-started/get-started-with-esw/readme.md): Start here to explore ESW APIs and jump to the main service areas, including customs, pricing, checkout, orders, returns, callbacks, and fulfillment. - [Authentication](https://developer.esw.com/getting-started/get-started-with-esw/readme/quickstart.md): Learn how ESW STS authentication works, how to request OAuth 2.0 access tokens with client credentials, and how to send Bearer tokens on API requests. - [Access Tokens](https://developer.esw.com/getting-started/get-started-with-esw/readme/publish-your-docs.md): Request OAuth 2.0 access tokens from ESW STS using client credentials. Includes required parameters, token endpoint, and code examples - [Postman Collection](https://developer.esw.com/getting-started/get-started-with-esw/readme/postman-collection.md): Download and import the ESW Postman collection + environment to run the sandbox flow (token → PreOrder → redirect). - [Test Cards](https://developer.esw.com/getting-started/get-started-with-esw/readme/test-cards.md): Test card numbers for validating ESW Checkout payments, including non-3DS and 3DS scenarios (Adyen and Computop) with OTP notes. - [Finance and Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement.md): Making worldwide commerce simple - [Settlement and Billing](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing.md) - [Reconciliation Process](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/reconciliation-process.md): Reconciliation process for settlements and billing - [Sales](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/sales.md): Sales process for settlements and billing - [Returns](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/returns.md): Returns process for settlements and billing - [Refunds](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/refunds.md) - [Reconciliation Report](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/reconciliation-report.md): Reconciliation process for settlements and billing - [Pricing](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/pricing.md) - [Pricing Advisor Example to Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/pricing/pricing-advisor-example-to-settlement.md): Follow a worked example from Pricing Advisor output to final ESW settlement, including uplift, blended duty and VAT, FX conversion, rounding, and retailer payout. - [Order Flow from Confirmation to Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/order-flow-from-confirmation-to-settlement.md) - [Flow to Order Confirmation & Payloads](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/order-flow-from-confirmation-to-settlement/flow-to-order-confirmation-and-payloads.md) - [Order Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/order-flow-from-confirmation-to-settlement/order-settlement.md) - [Invoicing, Tax and Duties Payment](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment.md) - [Fully Trade Compliant](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment/fully-trade-compliant.md) - [Trade Compliance Flow](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment/trade-compliance-flow.md): Follow the six-step trade compliance flow from product normalization and pricing through customs checks, documentation, and compliant invoicing. - [Invoicing requirements](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment/invoicing-requirements.md): ESW invoice and credit note requirements by region, including EU, US, rest-of-world, and domestic VAT treatment. - [Payment Terms](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/payment-terms.md): How ESW settlement payments work, including payout cadence, net settlement components, and how duties, taxes, sales, and returns are treated. - [FAQs and Customization](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/faqs-and-customization.md): Find answers to common questions about ESW’s merchant-of-record model, reporting, settlement options, and key operational definitions. - [Best Practices](https://developer.esw.com/getting-started/get-started-with-esw/best-practices.md): This section describes the best practices and ESW recommendations that you can follow to ensure the smooth flow of data between your servers and ESW servers. - [APIs](https://developer.esw.com/getting-started/get-started-with-esw/best-practices/apis.md): Best practices for endpoints ESW calls: authenticate requests, return correct status codes, handle retries and bursts, and acknowledge quickly. - [Webhooks](https://developer.esw.com/getting-started/get-started-with-esw/best-practices/webhooks.md): Best practices for ESW webhooks: HTTPS and domain requirements, validate event type/version, respond within 3 seconds, and design for async delivery. - [FAQs](https://developer.esw.com/getting-started/get-started-with-esw/faqs.md): Some frequently asked questions. - [Glossary](https://developer.esw.com/getting-started/get-started-with-esw/glossary.md): Definitions of key ESW terms across checkout, payments, logistics, and reporting. - [Copy of Overview](https://developer.esw.com/getting-started/get-started-with-esw/readme-1.md): Start here to explore ESW APIs and jump to the main service areas, including customs, pricing, checkout, orders, returns, callbacks, and fulfillment. - [Authentication](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/quickstart.md): Learn how ESW STS authentication works, how to request OAuth 2.0 access tokens with client credentials, and how to send Bearer tokens on API requests. - [Access Tokens](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/publish-your-docs.md): Request OAuth 2.0 access tokens from ESW STS using client credentials. Includes required parameters, token endpoint, and code examples. - [Postman Collection](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/postman-collection.md): Download and import the ESW Postman collection + environment to run the sandbox flow (token → PreOrder → redirect). - [Test Cards](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/test-cards.md): Test card numbers for validating ESW Checkout payments, including non-3DS and 3DS scenarios (Adyen and Computop) with OTP notes. ## Integrations - [Integration Methods](https://developer.esw.com/integrations/integration-methods.md): Choose how to integrate with ESW APIs, SFTP file feeds, platform apps, or webhooks—and compare when to use each - [Core Integrations](https://developer.esw.com/integrations/integration-methods/core-integrations.md): What you integrate for an end-to-end ESW implementation: Catalog, Checkout, and Package. - [Catalog File Integration](https://developer.esw.com/integrations/catalog-file-integration.md): How to name, format, and deliver Excel/CSV catalog files to ESW via SFTP, including required fields. - [Sample Customs Catalog Template](https://developer.esw.com/integrations/catalog-file-integration/sample-customs-catalog-template.md): Download a sample customs catalog template and reference allowed enum values for file-based catalog uploads. - [File Processing](https://developer.esw.com/integrations/catalog-file-integration/file-processing.md): Understand file processing notifications and download sample templates for Excel, CSV, customs catalog, and sales report uploads. - [Package File Integration](https://developer.esw.com/integrations/package-file-integration.md): How to name, format, and deliver XML package files to ESW via SFTP, including required fields. - [Tracking XML File Spec](https://developer.esw.com/integrations/tracking-xml-file-spec.md): Schema and delivery rules for ESW tracking outbound XML files. ## Agentic Commerce - [Coming Soon](https://developer.esw.com/agentic-commerce/coming-soon.md) - [Model Context Protocol (MCP)](https://developer.esw.com/agentic-commerce/model-context-protocol-mcp.md): Connect AI clients to the ESW MCP server, configure OAuth or service tokens, and use approved ESW knowledge tools. ## Worldwide Omnichannel - [Worldwide Omnichannel](https://developer.esw.com/worldwide-omnichannel/worldwide-omnichannel.md): Overview of ESW omnichannel services for order management, fulfilment, delivery, compliance, and returns - [Order Management](https://developer.esw.com/worldwide-omnichannel/worldwide-omnichannel/order-management.md): Overview of order lookup, order details, and customer support workflows in the ESW Customer Service Portal. - [Shipping and Fulfillment](https://developer.esw.com/worldwide-omnichannel/worldwide-omnichannel/shipping-and-fulfillment.md): Overview of ESW-managed fulfilment workflows, inventory synchronization, order processing, and shipment confirmation. - [Delivery and Compliance](https://developer.esw.com/worldwide-omnichannel/worldwide-omnichannel/delivery-and-compliance.md): Overview of package data, shipping labels, tracking, carrier management, and customs steps in the ESW hub model. - [Global Returns](https://developer.esw.com/worldwide-omnichannel/worldwide-omnichannel/global-returns.md): Overview of the ESW returns portal, return request workflows, reverse logistics, and return visibility. ## Global Checkout - [Embedded Checkout](https://developer.esw.com/global-checkout/embedded-checkout.md) - [Direct Integration](https://developer.esw.com/global-checkout/embedded-checkout/direct-integration.md) - [iFrame Integration](https://developer.esw.com/global-checkout/embedded-checkout/iframe-integration.md): Enabling iFrame on ESP using Light Touch Integration (LTI) - [Iframe Integration Steps](https://developer.esw.com/global-checkout/embedded-checkout/iframe-integration-steps.md) - [Domain Masking](https://developer.esw.com/global-checkout/domain-masking.md) ## Shopify - [Shopify Native](https://developer.esw.com/shopify/shopify-native.md): ESW integration leverages Shopify's native checkout to handle shopper's purchase flow. - [Quick Start Guide](https://developer.esw.com/shopify/shopify-native/quick-start-guide.md): Install and configure the ESW Shopify apps, coordinate ESW onboarding provisioning, and prepare for testing and go-live. - [Install ESW Shopify Apps](https://developer.esw.com/shopify/shopify-native/quick-start-guide/install-esw-shopify-apps.md): Install ESW Shopify apps - [Install Returns and Exchanges App](https://developer.esw.com/shopify/shopify-native/quick-start-guide/install-returns-and-exchanges-app.md): Install the ESW Returns and Exchanges app in Shopify, then contact ESW to provision and configure your tenant. - [Supported Countries](https://developer.esw.com/shopify/shopify-native/quick-start-guide/supported-countries.md): Reference list of ESW-supported countries for Shopify, with ISO 3166-1 alpha-2 codes. - [Test Cards](https://developer.esw.com/shopify/shopify-native/quick-start-guide/test-cards.md): Supported test cards - [Configuration](https://developer.esw.com/shopify/shopify-native/configuration.md): Configure markets, pricing, languages, redirection, and shipping for ESW on Shopify. - [Create a New Market](https://developer.esw.com/shopify/shopify-native/configuration/create-a-new-market.md): Create a Shopify market, set customer conditions, and inherit or customize settings for a new region. - [Add Legal Messaging](https://developer.esw.com/shopify/shopify-native/configuration/add-legal-messaging.md): Add the ESW Privacy Notice block to Shopify checkout to meet legal requirements before go-live. - [Product Pricing](https://developer.esw.com/shopify/shopify-native/configuration/product-pricing.md): Choose a pricing approach and manage exchange rates per market in Shopify. - [Languages & Domains](https://developer.esw.com/shopify/shopify-native/configuration/languages-and-domains.md): Add storefront languages and assign languages and domains per market in Shopify. - [Setup Automatic Country and Language Redirection](https://developer.esw.com/shopify/shopify-native/configuration/setup-automatic-country-and-language-redirection.md): Automatically route shoppers to the right market and language using location and browser settings. - [Shipping Methods, Rates, EDD for New Markets](https://developer.esw.com/shopify/shopify-native/configuration/shipping-methods-rates-edd-for-new-markets.md): Set up fulfillment locations and shipping rates, including transit times for estimated delivery dates (EDD). - [Integration](https://developer.esw.com/shopify/shopify-native/integration.md): Connect Shopify and ESW using webhooks and ESW APIs for catalog, pricing, and order lifecycle sync. - [Integration Overview](https://developer.esw.com/shopify/shopify-native/integration/integration-overview.md): How Shopify checkout, webhooks, and ESW order import fit together. - [Product Catalog Sync](https://developer.esw.com/shopify/shopify-native/integration/product-catalog-sync.md): Sync Shopify product and variant updates to ESW using webhooks and the ESW Catalog API. - [Pricing Import](https://developer.esw.com/shopify/shopify-native/integration/pricing-import.md): Calculate localized prices with ESW Pricing Advisor and import fixed prices into Shopify markets. - [Order Management](https://developer.esw.com/shopify/shopify-native/integration/order-management.md) - [Shipping Address Update](https://developer.esw.com/shopify/shopify-native/integration/shipping-address-update.md): Capture post-purchase shipping address changes in Shopify and sync them to ESW. - [Order and Item-Level Cancellations](https://developer.esw.com/shopify/shopify-native/integration/order-and-item-level-cancellations.md): Keep cancellation state in sync between Shopify and ESW, including partial (item-level) cancels. - [Appeasements](https://developer.esw.com/shopify/shopify-native/integration/appeasements.md): Reflect ESW-initiated appeasements (refunds or compensation) back into Shopify. - [Integration Workflow](https://developer.esw.com/shopify/shopify-native/integration-workflow.md): Overview of the ESW-managed Shopify integration workflow across catalog sync, pricing import, order ingestion, address updates, fulfilment, and cancellations. - [Product Catalog Integration](https://developer.esw.com/shopify/shopify-native/integration-workflow/product-catalog-integration.md): The app syncs Shopify product changes to ESW using Shopify webhooks and the ESW Catalog API. - [Pricing Import](https://developer.esw.com/shopify/shopify-native/integration-workflow/pricing-import.md): Fetch pricing rules from ESW Pricing Advisor and write fixed prices to Shopify markets. - [Order Ingestion](https://developer.esw.com/shopify/shopify-native/integration-workflow/order-ingestion.md) - [Address Update](https://developer.esw.com/shopify/shopify-native/integration-workflow/address-update.md): Capture post-purchase shipping address changes in Shopify and sync them to ESW. - [Fulfilment and Shipping](https://developer.esw.com/shopify/shopify-native/integration-workflow/fulfilment-and-shipping.md): Sync ESW shipment and tracking updates back into Shopify fulfillments. - [Cancellations](https://developer.esw.com/shopify/shopify-native/integration-workflow/cancellations.md): Keep cancellation state in sync between Shopify and ESW (full and item-level). - [Overview](https://developer.esw.com/shopify/salesforce-commerce-cloud/overview.md): Start here for ESW + Salesforce Commerce Cloud (SFCC) documentation. - [Getting Started Guide](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide.md): Install and configure the ESW cartridge in Salesforce Commerce Cloud (SFCC), including prerequisites and initial setup steps. - [Download ESW Cartridge](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide/download-esw-cartridge.md): You can download the ESW cartridge package from the AppExchange listing - [Import Metadata](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide/import-metadata.md): Import essential metadata files into Salesforce Commerce Cloud (SFCC) - [Upload metadata XML files](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide/upload-metadata-xml-files.md): How to import metadata using the Business Manager - [Import Jobs and Services](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide/import-jobs-and-services.md): How to import job and service configuration files using the Business Manager - [Configure Content Slots and Payment Methods](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide/configure-content-slots-and-payment-methods.md): How to configure content slots and payment methods - [Configure ESW Services](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide/configure-esw-services.md): How to configure the ESW services - [Add Cartridge to SFCC](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide/add-cartridge-to-sfcc.md): How to add the ESW cartridge to SFCC - [Enable and Configure ESW Module](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide/enable-and-configure-esw-module.md): How to enable and configure the ESW module in SFCC - [Run Initial Data Population Jobs](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide/run-initial-data-population-jobs.md): How to run initial data population jobs in SFCC - [Shipping Methods Integration](https://developer.esw.com/shopify/salesforce-commerce-cloud/getting-started-guide/shipping-methods-integration.md): How to integrate shipping methods in SFCC - [Cartridge Installation](https://developer.esw.com/shopify/salesforce-commerce-cloud/cartridge-installation.md): Install the ESW SFCC cartridge. Choose steps for SFRA, Composable, OCAPI, or SiteGenesis. - [SiteGenesis](https://developer.esw.com/shopify/salesforce-commerce-cloud/cartridge-installation/sitegenesis.md): Install the ESW SFCC cartridge for a SiteGenesis storefront, including cartridge paths and site data import. - [Composable Storefront](https://developer.esw.com/shopify/salesforce-commerce-cloud/cartridge-installation/composable-storefront.md): Install the ESW PWA cartridge for SFCC Composable Storefront (PWA Kit), including site data, cartridge paths, and SCAPI setup. - [Storefront Reference Architecture](https://developer.esw.com/shopify/salesforce-commerce-cloud/cartridge-installation/storefront-reference-architecture.md): Install the ESW SFCC cartridge for an SFRA storefront, including site data import and site/Business Manager cartridge paths. - [Headless (OCAPI) Architecture](https://developer.esw.com/shopify/salesforce-commerce-cloud/cartridge-installation/headless-ocapi-architecture.md): Install the ESW headless cartridge for SFCC and configure OCAPI settings for ESW integration. - [Cartridge Setup](https://developer.esw.com/shopify/salesforce-commerce-cloud/cartridge-setup.md): Choose your storefront architecture and follow ESW cartridge setup steps for SiteGenesis, SFRA, or Headless (OCAPI). - [Sitegenesis](https://developer.esw.com/shopify/salesforce-commerce-cloud/cartridge-setup/sitegenesis.md) - [SFRA](https://developer.esw.com/shopify/salesforce-commerce-cloud/cartridge-setup/sfra.md): Reference of ESW SFRA customization touchpoints with file paths for templates, controllers, models, hooks, and client scripts. - [Headless (OCAPI) Architecture](https://developer.esw.com/shopify/salesforce-commerce-cloud/cartridge-setup/headless-ocapi-architecture.md): Configure SFCC OCAPI Shop API resources and ESW headless hooks for pricing, baskets, orders, checkout redirect, and web endpoints. - [Composable Storefront Setup with SCAPI and PWA](https://developer.esw.com/shopify/salesforce-commerce-cloud/cartridge-setup/composable-storefront-setup-with-scapi-and-pwa.md) - [Pricing Models](https://developer.esw.com/shopify/salesforce-commerce-cloud/pricing-models.md) - [Calculated Pricing](https://developer.esw.com/shopify/salesforce-commerce-cloud/pricing-models/calculated-pricing.md): Convert price book values into localized shopper prices using uplift, duty, tax, FX, and rounding rules, with test steps for storefront and Business Manager. - [Fixed Pricing](https://developer.esw.com/shopify/salesforce-commerce-cloud/pricing-models/fixed-pricing.md) ## Salesforce Commerce Cloud - [SFCC Integration](https://developer.esw.com/salesforce-commerce-cloud/sfcc-integration.md): Start here for ESW Salesforce Commerce Cloud integration guides, including installation, setup, and onboarding resources - [Get Started](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started.md): Install and configure the ESW cartridge in Salesforce Commerce Cloud (SFCC), including prerequisites and initial setup steps - [Prerequisites](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/prerequisites.md): Installing and configuring the ESW cartridge in Salesforce Commerce Cloud (SFCC) - [Download ESW Cartridge](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/download-esw-cartridge.md): You can download the ESW cartridge package from the AppExchange listing - [Import Metadata](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/import-metadata.md): Import essential metadata files into Salesforce Commerce Cloud (SFCC) - [Upload metadata XML files](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/upload-metadata-xml-files.md): How to import metadata using the Business Manager - [Import Jobs and Services](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/import-jobs-and-services.md): How to import job and service configuration files using the Business Manager - [Configure Content Slots and Payment Methods](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/configure-content-slots-and-payment-methods.md): How to configure content slots and payment methods - [Configure ESW Services](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/configure-esw-services.md): How to configure the ESW services - [Add Cartridge to SFCC](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/add-cartridge-to-sfcc.md): How to add the ESW cartridge to SFCC - [Enable and Configure ESW Module](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/enable-and-configure-esw-module.md): How to enable and configure the ESW module in SFCC - [Run Initial Data Population Jobs](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/run-initial-data-population-jobs.md): How to run initial data population jobs in SFCC - [Shipping Methods Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/get-started/shipping-methods-integration.md): How to integrate shipping methods in SFCC - [Cartridge Installation](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/cartridge-installation.md): Install the ESW SFCC cartridge. Choose steps for SFRA, Composable, OCAPI, or SiteGenesis - [SiteGenesis](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/cartridge-installation/sitegenesis.md): Install the ESW SFCC cartridge for a SiteGenesis storefront, including cartridge paths and site data import. - [Composable Storefront](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/cartridge-installation/composable-storefront.md): Install the ESW PWA cartridge for SFCC Composable Storefront (PWA Kit), including site data, cartridge paths, and SCAPI setup. - [Storefront Reference Architecture](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/cartridge-installation/storefront-reference-architecture.md): Install the ESW SFCC cartridge for an SFRA storefront, including site data import and site/Business Manager cartridge paths. - [Headless (OCAPI) Architecture](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/cartridge-installation/headless-ocapi-architecture.md): Install the ESW headless cartridge for SFCC and configure OCAPI settings for ESW integration. - [Cartridge Setup](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/cartridge-setup.md): Choose your storefront architecture and follow ESW cartridge setup steps for SiteGenesis, SFRA, or Headless (OCAPI). - [Sitegenesis](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/cartridge-setup/sitegenesis.md) - [SFRA](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/cartridge-setup/sfra.md): Reference of ESW SFRA customization touchpoints with file paths for templates, controllers, models, hooks, and client scripts. - [Headless Architecture (OCAPI/SCAPI/PWA)](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/cartridge-setup/headless-architecture-ocapi-scapi-pwa.md): Set up ESW headless integration for SFCC across OCAPI, SCAPI, and PWA Kit, including configuration, hooks, request parameters, mappings, and checkout flows. - [Composable Storefront Setup with SCAPI and PWA](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/cartridge-setup/composable-storefront-setup-with-scapi-and-pwa.md): Apply ESW overrides to SFCC Composable Storefront (PWA Kit), including Business Manager setup, locale configuration, and storefront customizations. - [Pricing](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing.md) - [Pricing Models](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/pricing-models.md): Choose how ESW prices products in SFCC—calculated, fixed, or hybrid. - [Calculated Pricing](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/pricing-models/calculated-pricing.md): Convert price book values into localized shopper prices using uplift, duty, tax, FX, and rounding rules, with test steps for storefront and Business Manager. - [Fixed Pricing](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/pricing-models/fixed-pricing.md) - [Hybrid Pricing](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/pricing-models/hybrid-pricing.md): Combine a base fixed price with calculated adjustments (FX, uplift, duties, taxes), with test steps for storefront and Business Manager. - [Core Price Construction](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/core-price-construction.md) - [Rounding Rules](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/core-price-construction/rounding-rules.md) - [Multiple FX Rates Pricing](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/core-price-construction/multiple-fx-rates-pricing.md): Configure country-specific base currencies so ESW applies the correct FX rate. - [Pricebooks](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/pricebooks.md) - [Localized Pricebooks](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/pricebooks/localized-pricebooks.md) - [Promotional Pricebooks](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/pricebooks/promotional-pricebooks.md) - [Localization and Display](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/localization-and-display.md) - [Localized Promotions](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/localization-and-display/localized-promotions.md) - [Localized Pricing and Front-End Display](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/localization-and-display/localized-pricing-and-front-end-display.md) - [Advanced Pricing](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/advanced-pricing.md) - [Spark Pricing Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/pricing/advanced-pricing/spark-pricing-integration.md) - [Promotions](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/promotions.md) - [Promotions Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/promotions/promotions-integration.md) - [ESW Promotions Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/promotions/esw-promotions-integration.md) - [Localized Promotions](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/promotions/localized-promotions.md) - [Promotional Pricebooks](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/promotions/promotional-pricebooks.md) - [Promotion Rules](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/promotions/promotion-rules.md) - [Catalog and Product Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/catalog-and-product-integration.md) - [Catalog Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/catalog-and-product-integration/catalog-integration.md) - [Global Product Restriction](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/catalog-and-product-integration/global-product-restriction.md) - [Global Product Returns Prohibition](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/catalog-and-product-integration/global-product-returns-prohibition.md) - [Localized Shopping Feed Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/catalog-and-product-integration/localized-shopping-feed-integration.md) - [Checkout Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration.md) - [Overview](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/overview.md) - [Checkout Metadata Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/checkout-metadata-integration.md): Add customer and shopper experience level metadata - [Checkout Shopper Registration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/checkout-shopper-registration.md) - [Inventory Check Validation](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/inventory-check-validation.md) - [Split Payment Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/split-payment-integration.md) - [Over-The-Counter Payment Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/over-the-counter-payment-integration.md) - [Stored Payment Cards Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/stored-payment-cards-integration.md) - [Customer Account Order History Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/customer-account-order-history-integration.md) - [Order Confirmation Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/order-confirmation-integration.md) - [Order Cancellation Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/order-cancellation-integration.md) - [Order Payment Status Updates (ESW to SFCC)](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/order-payment-status-updates-esw-to-sfcc.md) - [ABTasty Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/abtasty-integration.md): Run A/A, A/B and other tests on the storefront - [ESW marketing opt in](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/esw-marketing-opt-in.md) - [Embedded Checkout](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/embedded-checkout.md) - [Self Hosted Order Confirmation Page](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/checkout-integration/self-hosted-order-confirmation-page.md) - [Shipping and Fulfilment](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/shipping-and-fulfilment.md) - [Shipping Methods Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/shipping-and-fulfilment/shipping-methods-integration.md) - [Package Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/shipping-and-fulfilment/package-integration.md) - [Multiple Shipments Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/shipping-and-fulfilment/multiple-shipments-integration.md) - [Address Book Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/shipping-and-fulfilment/address-book-integration.md): Enable and test saved shopper addresses in ESW Checkout with SFCC address book support. - [Multi-Origin Fulfillment](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/shipping-and-fulfilment/multi-origin-fulfillment.md) - [Shipping Methods Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/shipping-and-fulfilment/shipping-methods-integration-1.md) - [Order Management](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/order-management.md) - [Order Confirmation](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/order-management/order-confirmation.md): Sync successful ESW orders into SFCC, validate inventory, and display the order confirmation page. - [Order Cancellation](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/order-management/order-cancellation.md): Sync order cancellations from ESW to SFCC using webhooks, metadata, and the retailer order status job. - [Order Appeasement](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/order-management/order-appeasement.md): Sync appeased orders from ESW to SFCC using a webhook and order custom attributes. - [Order Payment Status Sync](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/order-management/order-payment-status-sync.md): Sync ESW payment status updates to SFCC order payment, confirmation, and export statuses. - [Returns and Refunds](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/returns-and-refunds.md) - [Return Merchandise Authorization](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/returns-and-refunds/return-merchandise-authorization.md) - [Global Returns Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/returns-and-refunds/global-returns-integration.md) - [Business Manager Configuration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration.md) - [Merchant Tools](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools.md): Configure ESW content, site preferences, custom objects, monitoring, and package settings in Business Manager. - [Content Slots](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/content-slots.md): Verify imported ESW content slots and update Geo IP, welcome, and landing page content. - [Site Preferences](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/site-preferences.md): Manage ESW site preferences for general, pricing, checkout, catalog, privacy, and order settings. - [General and Display Preferences](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/site-preferences/general-and-display-preferences.md): Configure core ESW site settings and storefront display behavior. - [Pricing Preferences](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/site-preferences/pricing-preferences.md): Configure ESW pricing patterns, localized pricing, promotions, and price feed behavior. - [Checkout Preferences](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/site-preferences/checkout-preferences.md): Configure checkout service, redirect behavior, metadata, shipping overrides, and checkout feature toggles. - [Catalog Preferences](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/site-preferences/catalog-preferences.md): Configure catalog feed paths, services, field mapping, and validation. - [Advanced Preferences](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/site-preferences/advanced-preferences.md): Configure PWA, returns, SPARK, multi-origin, and headless integration preferences. - [Privacy Settings](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/site-preferences/privacy-settings.md): Configure storefront tracking behavior for ESW integrations. - [Order Settings](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/site-preferences/order-settings.md): Configure storefront order access and failed order retention. - [Custom Objects](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/custom-objects.md): Reference ESW custom objects used for pricing, countries, currencies, monitoring, and JWKS. - [Integration Monitoring](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/integration-monitoring.md): View and export the ESW integration monitoring report in Business Manager. - [Package Configuration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/merchant-tools/package-configuration.md): Configure the package synchronization model in Business Manager. - [Administration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/business-manager-configuration/administration.md): Manage ESW system object settings, jobs, and services in Business Manager. - [Additional Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/additional-integration.md) - [Page Designer Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/additional-integration/page-designer-integration.md) - [JWKS Authentication Integration](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/additional-integration/jwks-authentication-integration.md) - [Testing and Launch](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/testing-and-launch.md) - [Going Live](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/testing-and-launch/going-live.md) - [Go-Live Readiness](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/testing-and-launch/going-live/go-live-readiness.md): Validate production configuration, replication, and storefront readiness before launch. - [Checklist](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/testing-and-launch/going-live/checklist.md): Verify staging, replication, production setup, and post-deployment validation for rollout. - [Testing Guide](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/testing-and-launch/testing-guide.md): Validate storefront pricing, checkout routing, and order behavior across ESW and native flows. - [Troubleshooting](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/troubleshooting.md) - [Sharing Service/Webhook Logs on Retailer Platform](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/troubleshooting/sharing-service-webhook-logs-on-retailer-platform.md): Configure diagnostic logging so ESW can review service and webhook failures from the retailer platform. - [FAQs](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/troubleshooting/faqs.md): Find quick answers to common SFCC cartridge setup, pricing, checkout, and storefront questions. - [Reference](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/reference.md) - [ESW APIs](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/reference/esw-apis.md): ESW APIs used by the SFCC cartridge for authentication, pricing, checkout, and package updates. - [Add a New ESW-Supported Country](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/reference/add-a-new-esw-supported-country.md): Enable a new ESW-supported country in SFCC, sync country and currency data, and verify storefront behavior. - [ESW Order and Line Item Attribute Reference](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/reference/esw-order-and-line-item-attribute-reference.md): Reference the ESW order and line item attributes stored in SFCC for order confirmation, cancellation, returns, appeasement, package, and OTC flows. - [Headless (OCAPI) Attributes Mapping with Cart](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/reference/headless-ocapi-attributes-mapping-with-cart.md): Reference the OCAPI basket and product line item attributes used to render ESW pricing on the headless cart page. - [Upgrading the ESW SFCC Cartridge](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/reference/upgrading-the-esw-sfcc-cartridge.md): Upgrade the ESW SFCC cartridge with a full version replacement and validate configuration changes before go-live. - [Storefront Components](https://developer.esw.com/salesforce-commerce-cloud/salesforce-commerce-cloud/reference/storefront-components.md): Configure ESW storefront selectors, welcome mat behavior, URL-based country selection, and order detail display. - [What's new](https://developer.esw.com/salesforce-commerce-cloud/sfcc-release-notes/whats-new.md): Browse ESW SFCC cartridge release notes, including new features, improvements, and configuration changes by version - [v4.8.0](https://developer.esw.com/salesforce-commerce-cloud/sfcc-release-notes/v4.8.0.md) ## Adobe Commerce (Magento) - [Adobe Commerce Extension Integration](https://developer.esw.com/adobe-commerce-magento/adobe-commerce-extension-integration.md): Integrate the ESW Adobe Commerce extension to deliver localized pricing, checkout, payments, shipping, and cross-border order management. - [Getting Started](https://developer.esw.com/adobe-commerce-magento/adobe-commerce-extension-integration/getting-started.md) - [Installation and Update](https://developer.esw.com/adobe-commerce-magento/adobe-commerce-extension-integration/getting-started/installation-and-update.md): Install ESW Shopify apps - [Security Token Service](https://developer.esw.com/adobe-commerce-magento/adobe-commerce-extension-integration/getting-started/security-token-service.md) - [General Setup](https://developer.esw.com/adobe-commerce-magento/adobe-commerce-extension-integration/getting-started/general-setup.md) - [Pricing Model](https://developer.esw.com/adobe-commerce-magento/adobe-commerce-extension-integration/getting-started/pricing-model.md) - [Order Creation](https://developer.esw.com/adobe-commerce-magento/adobe-commerce-extension-integration/getting-started/order-creation.md) - [FAQs](https://developer.esw.com/adobe-commerce-magento/adobe-commerce-extension-integration/getting-started/faqs.md) - [ESW Adobe Extension Features](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features.md) - [Catalog](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/catalog.md) - [Order Fulfillment (Package/ASN)](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/order-fulfillment-package-asn.md) - [Synchronize Adobe Commerce Shipment with ESW](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/order-fulfillment-package-asn/synchronize-adobe-commerce-shipment-with-esw.md) - [Synchronize ESW Package with Adobe Commerce](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/order-fulfillment-package-asn/synchronize-esw-package-with-adobe-commerce.md) - [Order Fulfillment (Returns)](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/order-fulfillment-returns.md) - [Appeasements.](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/appeasements..md) - [Cancellations.](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/cancellations..md) - [Additional Features](https://developer.esw.com/adobe-commerce-magento/additional-features.md) - [Shipping Methods](https://developer.esw.com/adobe-commerce-magento/additional-features/shipping-methods.md) - [Enable Free Shipping Promotion](https://developer.esw.com/adobe-commerce-magento/additional-features/shipping-methods/enable-free-shipping-promotion.md) - [Email Marketing Opt-in](https://developer.esw.com/adobe-commerce-magento/additional-features/email-marketing-opt-in.md) - [Checkout Shopper Registration](https://developer.esw.com/adobe-commerce-magento/additional-features/checkout-shopper-registration.md) - [Country-Specific Localized Content](https://developer.esw.com/adobe-commerce-magento/additional-features/country-specific-localized-content.md) - [Global Product Restriction](https://developer.esw.com/adobe-commerce-magento/additional-features/global-product-restriction.md) - [Stored Cards](https://developer.esw.com/adobe-commerce-magento/additional-features/stored-cards.md) - [Checkout Disclaimer Messaging](https://developer.esw.com/adobe-commerce-magento/additional-features/checkout-disclaimer-messaging.md) - [XFeed Product Feeds](https://developer.esw.com/adobe-commerce-magento/additional-features/xfeed-product-feeds.md) - [Return Prohibited](https://developer.esw.com/adobe-commerce-magento/additional-features/return-prohibited.md) - [Inventory Check Override](https://developer.esw.com/adobe-commerce-magento/additional-features/inventory-check-override.md) - [Webhook JWT Authentication](https://developer.esw.com/adobe-commerce-magento/additional-features/webhook-jwt-authentication.md) - [Embedded Checkout](https://developer.esw.com/adobe-commerce-magento/additional-features/embedded-checkout.md) - [AB Tasty Integration](https://developer.esw.com/adobe-commerce-magento/additional-features/ab-tasty-integration.md) - [Mixed Cart Support](https://developer.esw.com/adobe-commerce-magento/additional-features/mixed-cart-support.md) - [Self-Hosted Checkout Success Page](https://developer.esw.com/adobe-commerce-magento/additional-features/self-hosted-checkout-success-page.md) - [Checkout Session Timeout](https://developer.esw.com/adobe-commerce-magento/additional-features/checkout-session-timeout.md) - [Integration](https://developer.esw.com/adobe-commerce-magento/integration.md) - [Webhook Integration](https://developer.esw.com/adobe-commerce-magento/integration/webhook-integration.md) - [Asynchronous Integration](https://developer.esw.com/adobe-commerce-magento/integration/asynchronous-integration.md) - [Calculated Pricing Cache Setup](https://developer.esw.com/adobe-commerce-magento/integration/calculated-pricing-cache-setup.md) - [Location Parameter Support](https://developer.esw.com/adobe-commerce-magento/integration/location-parameter-support.md) - [Headless Integration](https://developer.esw.com/adobe-commerce-magento/integration/headless-integration.md) - [ESW Storefront Cookies](https://developer.esw.com/adobe-commerce-magento/integration/esw-storefront-cookies.md) - [Product Restriction Frontend Customization](https://developer.esw.com/adobe-commerce-magento/integration/product-restriction-frontend-customization.md) - [Retrieve ESW Order Data](https://developer.esw.com/adobe-commerce-magento/integration/retrieve-esw-order-data.md) - [Retrieve Calculated Prices Programmatically](https://developer.esw.com/adobe-commerce-magento/integration/retrieve-calculated-prices-programmatically.md) - [Additional Config](https://developer.esw.com/adobe-commerce-magento/integration/additional-config.md) - [Performance](https://developer.esw.com/adobe-commerce-magento/integration/performance.md) - [Release Notes](https://developer.esw.com/adobe-commerce-magento/release-notes.md) ## Light Touch Integration - [Light Touch Integration](https://developer.esw.com/light-touch-integration/readme.md) - [Features](https://developer.esw.com/light-touch-integration/features.md) - [Country Selector](https://developer.esw.com/light-touch-integration/features/country-selector.md) - [Technical Details](https://developer.esw.com/light-touch-integration/features/country-selector/technical-details.md) - [Dynamic Pricing](https://developer.esw.com/light-touch-integration/features/dynamic-pricing.md) - [Technical Details](https://developer.esw.com/light-touch-integration/features/dynamic-pricing/technical-details.md) - [Fixed Pricing](https://developer.esw.com/light-touch-integration/features/fixed-pricing.md) - [Checkout](https://developer.esw.com/light-touch-integration/features/checkout.md) - [User Data Sent to Checkout](https://developer.esw.com/light-touch-integration/features/checkout/user-data-sent-to-checkout.md) - [Stored Cards in Checkout](https://developer.esw.com/light-touch-integration/features/checkout/stored-cards-in-checkout.md) - [Technical Details](https://developer.esw.com/light-touch-integration/features/checkout/technical-details.md) - [Returns Integration](https://developer.esw.com/light-touch-integration/features/returns-integration.md) - [Technical Details](https://developer.esw.com/light-touch-integration/features/returns-integration/technical-details.md) - [Order Status Synchronization](https://developer.esw.com/light-touch-integration/features/order-status-synchronization.md) - [Integrate with LTI](https://developer.esw.com/light-touch-integration/integrate-with-lti.md) - [BigCommerce](https://developer.esw.com/light-touch-integration/integrate-with-lti/bigcommerce.md) - [WooCommerce](https://developer.esw.com/light-touch-integration/integrate-with-lti/woocommerce.md) - [Commerce Tools](https://developer.esw.com/light-touch-integration/integrate-with-lti/commerce-tools.md) - [Web Platform](https://developer.esw.com/light-touch-integration/integrate-with-lti/web-platform.md) - [Callback API](https://developer.esw.com/light-touch-integration/integrate-with-lti/callback-api.md) - [FAQs](https://developer.esw.com/light-touch-integration/faqs.md) ## TikTok Shop - [Coming soon](https://developer.esw.com/tiktok-shop/coming-soon.md) ## Customs Catalog - [Overview](https://developer.esw.com/customs-catalog-api/customs-catalog-api/overview.md): Share product catalog data with ESW to calculate duties and taxes at checkout and support customs compliance. - [How it Works](https://developer.esw.com/customs-catalog-api/customs-catalog-api/how-it-works.md): Follow the end-to-end catalog flow from upload and validation through classification, duty and VAT enrichment, invalid product handling, and product retrieval. - [Cookbook](https://developer.esw.com/customs-catalog-api/customs-catalog-api/how-it-works/cookbook.md) - [Core Concepts](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts.md) - [Brand and Tenant Configuration](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/brand-and-tenant-configuration.md) - [Product](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/product.md) - [HS Code & Classification](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/hs-code-and-classification.md): Understand HS code structure, browse the classification hierarchy, and interpret product classification states and regional duty rates. - [Async Processing](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/async-processing.md) - [VAT and Duty Rules](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/vat-and-duty-rules.md) - [Pagination Patterns](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/pagination-patterns.md): Reference for pagination strategies used across the Customs Catalog API - [Decision Matrices](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/decision-matrices.md) - [API Methods](https://developer.esw.com/customs-catalog-api/customs-catalog-api/api-methods.md): Send product catalog data to ESW and choose the right upload flow for onboarding, new products, or product updates. - [Upload Full Catalog](https://developer.esw.com/customs-catalog-api/customs-catalog-api/api-methods/upload-full-catalog.md): Send your full product catalog during onboarding, including the extra fields ESW needs for validation and customs clearance. - [Add New Products to Existing Catalog](https://developer.esw.com/customs-catalog-api/customs-catalog-api/api-methods/add-new-products-to-existing-catalog.md): Send only new catalog items after onboarding when ESW already has your catalog, without re-uploading existing products. - [Update Existing Catalog Products](https://developer.esw.com/customs-catalog-api/customs-catalog-api/api-methods/update-existing-catalog-products.md): Update existing catalog items by resubmitting the full product record, which overwrites the previously stored product data. - [Use Cases](https://developer.esw.com/customs-catalog-api/customs-catalog-api/use-cases.md) - [Copy of Use Cases](https://developer.esw.com/customs-catalog-api/customs-catalog-api/copy-of-use-cases.md) - [Code Samples](https://developer.esw.com/customs-catalog-api/customs-catalog-api/code-samples.md): Example requests and inspect sample responses for Customs Catalog API endpoints. - [Error Handling](https://developer.esw.com/customs-catalog-api/customs-catalog-api/error-handling.md) - [Error Response Structure](https://developer.esw.com/customs-catalog-api/customs-catalog-api/error-handling/error-response-structure.md): Understand the shared API error schema, response fields, example payloads, and HTTP status codes used across the Customs Catalog API. - [Authentication & Authorization Errors](https://developer.esw.com/customs-catalog-api/customs-catalog-api/error-handling/authentication-and-authorization-errors.md): Learn how the API handles missing, expired, malformed, or under-scoped JWT bearer tokens, with expected status codes and retry guidance. - [400, 404, and 412 Errors](https://developer.esw.com/customs-catalog-api/customs-catalog-api/error-handling/400-404-and-412-errors.md): Diagnose common client and precondition errors, including validation failures, missing resources, and retry considerations for 400, 404, and 412 responses. - [429 and 500 Errors](https://developer.esw.com/customs-catalog-api/customs-catalog-api/error-handling/429-and-500-errors.md): Handle rate limiting and server failures with Retry-After guidance, backoff strategies, and clear escalation criteria for persistent 429 and 500 responses. - [Async Responses and Pagination Errors](https://developer.esw.com/customs-catalog-api/customs-catalog-api/error-handling/async-responses-and-pagination-errors.md): Handle 202 Accepted async workflows and prevent pagination-related 400 errors with polling strategies, required query parameters, and safe paging patterns. - [Retry Strategy and Checklist](https://developer.esw.com/customs-catalog-api/customs-catalog-api/error-handling/retry-strategy-and-checklist.md): Apply the right retry behavior for each HTTP error code and verify your integration with a practical checklist for requests, responses, resilience, and observability - [FAQs](https://developer.esw.com/customs-catalog-api/customs-catalog-api/error-handling/faqs.md) - [Workflows](https://developer.esw.com/customs-catalog-api/customs-catalog-api/workflows.md) - [HTTP Status Codes](https://developer.esw.com/customs-catalog-api/customs-catalog-api/http-status-codes.md) - [Retailer Catalog Onboarding](https://developer.esw.com/customs-catalog-api/resources/retailer-catalog-onboarding.md) - [First Successful Requests](https://developer.esw.com/customs-catalog-api/resources/first-successful-requests.md): Verify how your brand is wired up. - [Customs and Trade Compliance](https://developer.esw.com/customs-catalog-api/resources/first-successful-requests/customs-and-trade-compliance.md) - [Duty and Tax Rules Manager](https://developer.esw.com/customs-catalog-api/resources/first-successful-requests/duty-and-tax-rules-manager.md) - [Catalog Exception Analyst](https://developer.esw.com/customs-catalog-api/resources/first-successful-requests/catalog-exception-analyst.md) - [Tutorials](https://developer.esw.com/customs-catalog-api/resources/tutorials.md) - [Uploading a Catalog](https://developer.esw.com/customs-catalog-api/resources/tutorials/uploading-a-catalog.md): Prepare product data, upload your catalog, validate results, and reprocess products that fail checks. - [Managing Invalid Products](https://developer.esw.com/customs-catalog-api/resources/tutorials/managing-invalid-products.md) - [Classifying Products](https://developer.esw.com/customs-catalog-api/resources/tutorials/classifying-products.md) - [Managing Duty Rules](https://developer.esw.com/customs-catalog-api/resources/tutorials/managing-duty-rules.md) - [Postman Collection](https://developer.esw.com/customs-catalog-api/resources/postman-collection.md) - [Catalog Onboarding Pipeline](https://developer.esw.com/customs-catalog-api/resources/postman-collection/catalog-onboarding-pipeline.md) - [Invalid Product Remediation](https://developer.esw.com/customs-catalog-api/resources/postman-collection/invalid-product-remediation.md) - [Request Builder](https://developer.esw.com/customs-catalog-api/resources/request-builder.md) - [Self-Service Catalog Management](https://developer.esw.com/customs-catalog-api/resources/self-service-catalog-management.md) - [Page 1](https://developer.esw.com/customs-catalog-api/resources/page-1.md) - [Overview](https://developer.esw.com/customs-catalog-api/fulfillment-api/overview.md) - [Core Concepts](https://developer.esw.com/customs-catalog-api/fulfillment-api/core-concepts.md) - [Inventory](https://developer.esw.com/customs-catalog-api/fulfillment-api/core-concepts/inventory.md) - [Pick and Pack](https://developer.esw.com/customs-catalog-api/fulfillment-api/core-concepts/pick-and-pack.md) - [Advanced Shipping Notice (ASN)](https://developer.esw.com/customs-catalog-api/fulfillment-api/core-concepts/advanced-shipping-notice-asn.md) - [Use Cases](https://developer.esw.com/customs-catalog-api/fulfillment-api/use-cases.md) - [API Methods](https://developer.esw.com/customs-catalog-api/fulfillment-api/api-methods.md) - [Sync Inventory](https://developer.esw.com/customs-catalog-api/fulfillment-api/api-methods/sync-inventory.md) - [Submit Advanced Shipping Notice (ASN)](https://developer.esw.com/customs-catalog-api/fulfillment-api/api-methods/submit-advanced-shipping-notice-asn.md) - [Confirm a Pick & Pack Operation](https://developer.esw.com/customs-catalog-api/fulfillment-api/api-methods/confirm-a-pick-and-pack-operation.md) - [fulfilment api usecases](https://developer.esw.com/customs-catalog-api/fulfillment-api/fulfilment-api-usecases.md) - [Pagination Patterns](https://developer.esw.com/customs-catalog-api/pagination-patterns.md) ## Pricing Advisor - [Overview](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/overview.md): Learn what the Pricing Advisor API returns, how it supports market-specific pricing, and how versions v2.0, v3.0, and v4.0 differ. - [How it Works](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/how-it-works.md) - [Core Concepts](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts.md) - [Rounding](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/rounding.md) - [Rounding Models](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/rounding-models.md): Learn how Fixed, Multiple, and None rounding models work, how model strings are structured, and how whole-number and decimal targets affect final prices. - [Multiplier Pricing](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/multiplier-pricing.md) - [Standard Pricing](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/standard-pricing.md) - [FX Rates & Models](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/fx-rates-and-models.md) - [Currency Display](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/currency-display.md) - [Decision Tables](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/decision-tables.md): Decision Tables for Choosing Pricing Advice and Interpreting Responses - [API Methods](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods.md) - [Standard Advice](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/standard-advice.md) - [Get Latest Advice for a Country](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/standard-advice/get-latest-advice-for-a-country.md) - [Get All Advice for a Brand](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/standard-advice/get-all-advice-for-a-brand.md) - [Get Archived Advice by ID](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/standard-advice/get-archived-advice-by-id.md) - [Multiplier Advice](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/multiplier-advice.md) - [Get Latest Multiplier for a Country](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/multiplier-advice/get-latest-multiplier-for-a-country.md) - [Get All Multipliers for a Brand](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/multiplier-advice/get-all-multipliers-for-a-brand.md) - [Get Archived Multiplier by ID](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/multiplier-advice/get-archived-multiplier-by-id.md) - [Use Cases](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/use-cases.md) - [Use Cases](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/use-cases-1.md) - [Code Samples](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/code-samples.md) - [Response Codes](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/response-codes.md) - [Error Handling](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling.md) - [HTTP Response Codes](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/http-response-codes.md) - [Error Response Structure](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/error-response-structure.md): Learn the RFC 7807 ProblemDetails error schema, nullable fields, and safe parsing patterns for Pricing Advisor API responses. - [Authentication & Authorization Errors](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/authentication-and-authorization-errors.md): Learn when Pricing Advisor API returns 401 and 403 errors, which StandardAdvice endpoints are affected, and how to handle token refresh and permission failures. - [Error Responses](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/error-responses.md): Learn how Pricing Advisor API returns 400, 401, 403, and 404 errors, which endpoints are affected, and when to retry, refresh tokens, or fix request parameters. - [Advice Types](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/advice-types.md): Compare MultiplierAdvice and StandardAdvice error behavior, response payloads, and auth requirements so you can build a unified Pricing Advisor API error handler. - [Retry Strategy](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/retry-strategy.md): Learn which Pricing Advisor API errors are retryable, when to refresh tokens, and how to poll safely for country-level advice that is still generating. - [Error Handling Checklist](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/error-handling-checklist.md): Use this pre-ship checklist to verify Pricing Advisor API error handling for validation, auth, retries, null-safe parsing, and observability. - [FAQs](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/faqs.md) - [Use Cases](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/use-cases-2.md) - [Workflows](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/workflows.md) - [First Successful Requests](https://developer.esw.com/pricing-advisor-api/resources/first-successful-requests.md) - [Storefront Pricing Engineer](https://developer.esw.com/pricing-advisor-api/resources/first-successful-requests/storefront-pricing-engineer.md) - [Forward-Pricing / Multiplier Engineer](https://developer.esw.com/pricing-advisor-api/resources/first-successful-requests/forward-pricing-multiplier-engineer.md) - [Tutorials](https://developer.esw.com/pricing-advisor-api/resources/tutorials.md) - [Standard Pricing Advice](https://developer.esw.com/pricing-advisor-api/resources/tutorials/standard-pricing-advice.md): Fetching & Interpreting Standard Pricing Advice - [Multiplier Pricing Advice](https://developer.esw.com/pricing-advisor-api/resources/tutorials/multiplier-pricing-advice.md) - [Calculating a Localized Price](https://developer.esw.com/pricing-advisor-api/resources/tutorials/calculating-a-localized-price.md) - [Currency Display & Rounding](https://developer.esw.com/pricing-advisor-api/resources/tutorials/currency-display-and-rounding.md) - [Postman Collection](https://developer.esw.com/pricing-advisor-api/resources/postman-collection.md) - [Pricing Advisor](https://developer.esw.com/pricing-advisor-api/resources/postman-collection/pricing-advisor.md) - [Calculate Final Prices](https://developer.esw.com/pricing-advisor-api/resources/calculate-final-prices.md): Calculate final product prices from Pricing Advisor responses across API v4.0, v3.0, and v2.0, including estimated price formulas and rounding rules - [Request Builder](https://developer.esw.com/pricing-advisor-api/resources/request-builder.md) ## Checkout - [Overview](https://developer.esw.com/checkout-api/checkout-api/overview.md): Checkout flow, request payload essentials, redirect behavior, and common capabilities. - [How it Works](https://developer.esw.com/checkout-api/checkout-api/how-it-works.md) - [Core Concepts](https://developer.esw.com/checkout-api/checkout-api/core-concepts.md) - [Order Confirmation Model](https://developer.esw.com/checkout-api/checkout-api/core-concepts/order-confirmation-model.md) - [cartType](https://developer.esw.com/checkout-api/checkout-api/core-concepts/carttype.md) - [Zero-Value Orders](https://developer.esw.com/checkout-api/checkout-api/core-concepts/zero-value-orders.md) - [Delivery Options](https://developer.esw.com/checkout-api/checkout-api/core-concepts/delivery-options.md) - [Multi-Origin Delivery](https://developer.esw.com/checkout-api/checkout-api/core-concepts/multi-origin-delivery.md) - [Charge Breakdown](https://developer.esw.com/checkout-api/checkout-api/core-concepts/charge-breakdown.md) - [Contact Details](https://developer.esw.com/checkout-api/checkout-api/core-concepts/contact-details.md) - [Payment Details](https://developer.esw.com/checkout-api/checkout-api/core-concepts/payment-details.md) - [Shopper Experience](https://developer.esw.com/checkout-api/checkout-api/core-concepts/shopper-experience.md) - [Dual-Currency Amounts](https://developer.esw.com/checkout-api/checkout-api/core-concepts/dual-currency-amounts.md) - [Decision Tables](https://developer.esw.com/checkout-api/checkout-api/core-concepts/decision-tables.md) - [API Methods](https://developer.esw.com/checkout-api/checkout-api/api-methods.md): Reference for ESW PreOrder and retailer order-confirmation APIs, including request fields, responses, validation codes, and examples. - [Response Status Codes (Validation)](https://developer.esw.com/checkout-api/checkout-api/api-methods/response-status-codes-validation.md) - [Use Cases](https://developer.esw.com/checkout-api/checkout-api/use-cases.md) - [Error Handling](https://developer.esw.com/checkout-api/checkout-api/error-handling.md) - [Response Pattern and Status Codes](https://developer.esw.com/checkout-api/checkout-api/error-handling/response-pattern-and-status-codes.md) - [Authentication Errors](https://developer.esw.com/checkout-api/checkout-api/error-handling/authentication-errors.md) - [400 Bad Request](https://developer.esw.com/checkout-api/checkout-api/error-handling/400-bad-request.md) - [404, 405, and 409 Errors](https://developer.esw.com/checkout-api/checkout-api/error-handling/404-405-and-409-errors.md) - [Field Constraints and Enums](https://developer.esw.com/checkout-api/checkout-api/error-handling/field-constraints-and-enums.md) - [Validation and Special Field Behaviours](https://developer.esw.com/checkout-api/checkout-api/error-handling/validation-and-special-field-behaviours.md) - [Retry Strategy and Checklist](https://developer.esw.com/checkout-api/checkout-api/error-handling/retry-strategy-and-checklist.md) - [FAQs](https://developer.esw.com/checkout-api/checkout-api/error-handling/faqs.md) - [Tutorials](https://developer.esw.com/checkout-api/resources/tutorials.md) - [Standard Order Confirmation](https://developer.esw.com/checkout-api/resources/tutorials/standard-order-confirmation.md) - [Complex Order Confirmation](https://developer.esw.com/checkout-api/resources/tutorials/complex-order-confirmation.md) - [Delivery Options](https://developer.esw.com/checkout-api/resources/tutorials/delivery-options.md) - [Order Confirmation Webhook](https://developer.esw.com/checkout-api/resources/order-confirmation-webhook.md): Webhook versions, response handling, processing modes, and delivery examples. - [Order Confirmation Sample Integrations](https://developer.esw.com/checkout-api/resources/order-confirmation-webhook/order-confirmation-sample-integrations.md) - [Checkout UI Metadata](https://developer.esw.com/checkout-api/resources/checkout-ui-metadata.md) - [Sending Checkout UI Metadata](https://developer.esw.com/checkout-api/resources/checkout-ui-metadata/sending-checkout-ui-metadata.md) - [Sales Assisted Checkout Tracking](https://developer.esw.com/checkout-api/resources/sales-assisted-checkout-tracking.md) ## Order - [Overview](https://developer.esw.com/order-api/order-api/order-api.md): Overview of the Order API for creating, managing, fulfilling, cancelling, replacing, and tracking cross-border orders and transactions - [How it Works](https://developer.esw.com/order-api/order-api/how-it-works.md) - [Core Concepts](https://developer.esw.com/order-api/order-api/core-concepts.md) - [Order](https://developer.esw.com/order-api/order-api/core-concepts/order.md) - [Products and Pricing](https://developer.esw.com/order-api/order-api/core-concepts/products-and-pricing.md) - [Contact Details](https://developer.esw.com/order-api/order-api/core-concepts/contact-details.md) - [Delivery and Origin](https://developer.esw.com/order-api/order-api/core-concepts/delivery-and-origin.md) - [Transactions](https://developer.esw.com/order-api/order-api/core-concepts/transactions.md) - [Fulfilment and Allocation](https://developer.esw.com/order-api/order-api/core-concepts/fulfilment-and-allocation.md) - [Replacements and Cancellations](https://developer.esw.com/order-api/order-api/core-concepts/replacements-and-cancellations.md) - [Appeasements](https://developer.esw.com/order-api/order-api/core-concepts/appeasements.md) - [Charges and Balances](https://developer.esw.com/order-api/order-api/core-concepts/charges-and-balances.md) - [Decision Tables](https://developer.esw.com/order-api/order-api/core-concepts/decision-tables.md): Decision Tables for Order Lifecycle, Appeasements, and Contacts - [API Methods](https://developer.esw.com/order-api/order-api/api-methods.md) - [Cancel Entire Order](https://developer.esw.com/order-api/order-api/api-methods/cancel-entire-order.md) - [Cancel Or Fulfil A Line Item Within An Order](https://developer.esw.com/order-api/order-api/api-methods/cancel-or-fulfil-a-line-item-within-an-order.md) - [Issue Replacements (Full Or Partial)](https://developer.esw.com/order-api/order-api/api-methods/issue-replacements-full-or-partial.md) - [Issue Order Appeasements (Full Or Partial)](https://developer.esw.com/order-api/order-api/api-methods/issue-order-appeasements-full-or-partial.md) - [Issue Line Item Appeasements (Full Or Partial)](https://developer.esw.com/order-api/order-api/api-methods/issue-line-item-appeasements-full-or-partial.md) - [Retrieve A Specific Transaction For An Order](https://developer.esw.com/order-api/order-api/api-methods/retrieve-a-specific-transaction-for-an-order.md) - [Update Contact Details On The Order](https://developer.esw.com/order-api/order-api/api-methods/update-contact-details-on-the-order.md) - [Update Line Item Within An Order](https://developer.esw.com/order-api/order-api/api-methods/update-line-item-within-an-order.md) - [Multiple Line Item Replacement](https://developer.esw.com/order-api/order-api/api-methods/multiple-line-item-replacement.md) - [Allocate or Cancel Items Within an Order](https://developer.esw.com/order-api/order-api/api-methods/allocate-or-cancel-items-within-an-order.md) - [Use cases](https://developer.esw.com/order-api/order-api/use-cases.md): End-to-end Order API scenarios for order creation, fulfilment, cancellations, replacements, appeasements, and finance ops. - [Code Samples](https://developer.esw.com/order-api/order-api/code-samples.md) - [Error Handling](https://developer.esw.com/order-api/order-api/error-handling.md) - [Response schemas and status codes](https://developer.esw.com/order-api/order-api/error-handling/response-schemas-and-status-codes.md) - [Request validation](https://developer.esw.com/order-api/order-api/error-handling/request-validation.md) - [Not found, server errors, and async processing](https://developer.esw.com/order-api/order-api/error-handling/not-found-server-errors-and-async-processing.md) - [FAQs](https://developer.esw.com/order-api/order-api/error-handling/faqs.md) - [First Successful Requests](https://developer.esw.com/order-api/resources/first-successful-requests.md) - [Tutorials](https://developer.esw.com/order-api/resources/tutorials.md) - [Creating an Order](https://developer.esw.com/order-api/resources/tutorials/creating-an-order.md) - [Cancelling an Order](https://developer.esw.com/order-api/resources/tutorials/cancelling-an-order.md) - [Postman Collection](https://developer.esw.com/order-api/resources/postman-collection.md) - [Order Lifecycle](https://developer.esw.com/order-api/resources/postman-collection/order-lifecycle.md) - [Order Allocation Event](https://developer.esw.com/order-api/resources/order-allocation-event.md) - [Return Order Integration Event](https://developer.esw.com/order-api/resources/return-order-integration-event.md) - [Request Builder](https://developer.esw.com/order-api/resources/request-builder.md) ## Package - [Overview](https://developer.esw.com/package-api/package-api/overview.md): Learn what the Package API supports, including package lifecycle operations, labels, manifests, returns, and Ship-From-Anywhere workflows - [core-concepts](https://developer.esw.com/package-api/package-api/core-concepts.md) - [Package](https://developer.esw.com/package-api/package-api/core-concepts/package.md) - [Order Types](https://developer.esw.com/package-api/package-api/core-concepts/order-types.md) - [Package Status](https://developer.esw.com/package-api/package-api/core-concepts/package-status.md) - [Labels & Documents](https://developer.esw.com/package-api/package-api/core-concepts/labels-and-documents.md) - [Ship-From-Anywhere](https://developer.esw.com/package-api/package-api/core-concepts/ship-from-anywhere.md) - [Manifests](https://developer.esw.com/package-api/package-api/core-concepts/manifests.md) - [Decision Tables](https://developer.esw.com/package-api/package-api/core-concepts/decision-tables.md) - [API Methods](https://developer.esw.com/package-api/package-api/api-methods.md) - [Retrieve Packages](https://developer.esw.com/package-api/package-api/api-methods/retrieve-packages.md) - [Create New Packages](https://developer.esw.com/package-api/package-api/api-methods/create-new-packages.md) - [Update Package Details](https://developer.esw.com/package-api/package-api/api-methods/update-package-details.md) - [Delete Packages](https://developer.esw.com/package-api/package-api/api-methods/delete-packages.md) - [Use Cases](https://developer.esw.com/package-api/package-api/use-cases.md) - [Code Samples](https://developer.esw.com/package-api/package-api/code-samples.md) - [Copy of Code Samples](https://developer.esw.com/package-api/package-api/copy-of-code-samples.md) - [Error Handling](https://developer.esw.com/package-api/package-api/error-handling.md) - [HTTP Status Codes](https://developer.esw.com/package-api/package-api/error-handling/http-status-codes.md) - [Error schemas and status codes](https://developer.esw.com/package-api/package-api/error-handling/error-schemas-and-status-codes.md) - [Authentication and request errors](https://developer.esw.com/package-api/package-api/error-handling/authentication-and-request-errors.md) - [Success codes and reference data](https://developer.esw.com/package-api/package-api/error-handling/success-codes-and-reference-data.md) - [Retry strategy and checklist](https://developer.esw.com/package-api/package-api/error-handling/retry-strategy-and-checklist.md) - [FAQs](https://developer.esw.com/package-api/package-api/error-handling/faqs.md) - [First Successful Requests](https://developer.esw.com/package-api/resources/first-successful-requests.md) - [Tutorials](https://developer.esw.com/package-api/resources/tutorials.md) - [Creating a Package](https://developer.esw.com/package-api/resources/tutorials/creating-a-package.md) - [Copy of Creating a Package](https://developer.esw.com/package-api/resources/tutorials/copy-of-creating-a-package.md) - [Postman Collection](https://developer.esw.com/package-api/resources/postman-collection.md) - [Manifest & Shipment](https://developer.esw.com/package-api/resources/postman-collection/manifest-and-shipment.md) - [Sample Integration](https://developer.esw.com/package-api/resources/sample-integration.md) - [Additional Information](https://developer.esw.com/package-api/resources/additional-information.md) - [Copy of Additional Information](https://developer.esw.com/package-api/resources/copy-of-additional-information.md) - [Request Builder](https://developer.esw.com/package-api/resources/request-builder.md) - [Workflow](https://developer.esw.com/package-api/resources/workflow.md) - [Workflows](https://developer.esw.com/package-api/resources/workflows.md) ## Fulfillment - [Overview](https://developer.esw.com/fulfillment-api/fulfillment-api/overview.md): High-level introduction to the Fulfillment API, its EDI-aligned data flows, and the core inventory, order, and shipment interactions it supports. - [How It Works](https://developer.esw.com/fulfillment-api/fulfillment-api/how-it-works.md) - [Authentication](https://developer.esw.com/fulfillment-api/fulfillment-api/authentication.md): OAuth token endpoint URLs, request parameters, and sample access token responses for each environment. - [Core Concepts](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts.md) - [Inventory](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts/inventory.md) - [Advanced Shipping Notice (ASN)](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts/advanced-shipping-notice-asn.md) - [Pick and Park Confirmation](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts/pick-and-park-confirmation.md) - [Response Status and Failure Reasons](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts/response-status-and-failure-reasons.md): Order-level and item-level PickPack failure reasons, statuses, and retry guidance. - [Decision Tables](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts/decision-tables.md) - [API Methods](https://developer.esw.com/fulfillment-api/fulfillment-api/api-methods.md) - [Sync Inventory](https://developer.esw.com/fulfillment-api/fulfillment-api/api-methods/sync-inventory.md) - [Confirm a Pick and Pack](https://developer.esw.com/fulfillment-api/fulfillment-api/api-methods/confirm-a-pick-and-pack.md) - [Submit Advanced Shipping Notice](https://developer.esw.com/fulfillment-api/fulfillment-api/api-methods/submit-advanced-shipping-notice.md) - [Use Cases](https://developer.esw.com/fulfillment-api/fulfillment-api/use-cases.md) - [Error Handling](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling.md) - [Response schemas](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/response-schemas.md) - [Endpoint validation and processing](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/endpoint-validation-and-processing.md) - [Retry strategy](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/retry-strategy.md) - [HTTP Status Codes](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/http-status-codes.md) - [Test Cases](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/test-cases.md): Endpoint-scoped test cases for the ESW Fulfillment API. - [FAQs](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/faqs.md) - [First Successful Requests](https://developer.esw.com/fulfillment-api/resources/first-successful-requests.md) - [Retailer Inventory](https://developer.esw.com/fulfillment-api/resources/first-successful-requests/retailer-inventory.md) - [3PL Inventory](https://developer.esw.com/fulfillment-api/resources/first-successful-requests/3pl-inventory.md) - [3PL warehouse / WMS](https://developer.esw.com/fulfillment-api/resources/first-successful-requests/3pl-warehouse-wms.md) - [Shipping / Dispatch](https://developer.esw.com/fulfillment-api/resources/first-successful-requests/shipping-dispatch.md) - [Tutorials](https://developer.esw.com/fulfillment-api/resources/tutorials.md) - [Synchronizing Inventory](https://developer.esw.com/fulfillment-api/resources/tutorials/synchronizing-inventory.md) - [Confirming Pick & Pack](https://developer.esw.com/fulfillment-api/resources/tutorials/confirming-pick-and-pack.md) - [Submitting an Advanced Shipping Notice](https://developer.esw.com/fulfillment-api/resources/tutorials/submitting-an-advanced-shipping-notice.md) - [Pick Pack Response Taxonomy](https://developer.esw.com/fulfillment-api/resources/tutorials/pick-pack-response-taxonomy.md) - [Postman Collection](https://developer.esw.com/fulfillment-api/resources/postman-collection.md) - [3PL Fulfilment Flow](https://developer.esw.com/fulfillment-api/resources/postman-collection/3pl-fulfilment-flow.md) - [Request Builder](https://developer.esw.com/fulfillment-api/resources/request-builder.md) ## Returns - [Overview](https://developer.esw.com/returns-api/grp-returns-api/overview.md): Overview of the GRP Returns API, including core cross-border returns capabilities and available API versions - [Core Concepts](https://developer.esw.com/returns-api/grp-returns-api/core-concepts.md) - [Ingestion](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/ingestion.md) - [Return Order](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/return-order.md) - [Return Methods](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/return-methods.md) - [Documents and Labels](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/documents-and-labels.md) - [Tracking and Updates](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/tracking-and-updates.md) - [Decision Tables](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/decision-tables.md) - [API Methods](https://developer.esw.com/returns-api/grp-returns-api/api-methods.md) - [Use Cases](https://developer.esw.com/returns-api/grp-returns-api/use-cases.md) - [Virtual Events](https://developer.esw.com/returns-api/grp-returns-api/virtual-events.md) - [Code Samples](https://developer.esw.com/returns-api/grp-returns-api/code-samples.md) - [Error Handling](https://developer.esw.com/returns-api/grp-returns-api/error-handling.md) - [Standard Response Codes](https://developer.esw.com/returns-api/grp-returns-api/error-handling/standard-response-codes.md) - [API Specific Error Codes](https://developer.esw.com/returns-api/grp-returns-api/error-handling/api-specific-error-codes.md) - [Error Schemas](https://developer.esw.com/returns-api/grp-returns-api/error-handling/error-schemas.md) - [Errors and Common Causes](https://developer.esw.com/returns-api/grp-returns-api/error-handling/errors-and-common-causes.md) - [Enum Reference](https://developer.esw.com/returns-api/grp-returns-api/error-handling/enum-reference.md) - [FAQs](https://developer.esw.com/returns-api/grp-returns-api/error-handling/faqs.md) - [First Successful Requests](https://developer.esw.com/returns-api/resources/first-successful-requests.md) - [Tutorials](https://developer.esw.com/returns-api/resources/tutorials.md) - [Creating a Return Order](https://developer.esw.com/returns-api/resources/tutorials/creating-a-return-order.md) - [Retrieving and Listing Return Orders](https://developer.esw.com/returns-api/resources/tutorials/retrieving-and-listing-return-orders.md) - [Updating a Return Order](https://developer.esw.com/returns-api/resources/tutorials/updating-a-return-order.md) - [Postman Collection](https://developer.esw.com/returns-api/resources/postman-collection.md) - [Shopper Return Journey](https://developer.esw.com/returns-api/resources/postman-collection/shopper-return-journey.md) - [Request Builder](https://developer.esw.com/returns-api/resources/request-builder.md) - [Methods](https://developer.esw.com/returns-api/returns-api-v3.0/methods.md) - [Ingestion Methods](https://developer.esw.com/returns-api/returns-api-v3.0/methods/ingestion-methods.md) - [Order Method](https://developer.esw.com/returns-api/returns-api-v3.0/methods/order-method.md): Returns API endpoint to retrieve an ingested order, its items, and associated return orders. - [Return Methods](https://developer.esw.com/returns-api/returns-api-v3.0/methods/return-methods.md): Return API endpoints to retrieve, search, create, update return orders, and fetch documents. - [Configuration Methods](https://developer.esw.com/returns-api/returns-api-v3.0/methods/configuration-methods.md): Get country-level returns configuration for a retailer brand, including portal settings, return reasons, and locales. - [Location Methods](https://developer.esw.com/returns-api/returns-api-v3.0/methods/location-methods.md): Returns API endpoint to list PUDO drop-off locations for a carrier, based on shopper postcode and optional distance/limit filters. - [Methods](https://developer.esw.com/returns-api/returns-api-v2.1/methods.md) - [Retrieve Existing Orders](https://developer.esw.com/returns-api/returns-api-v2.1/methods/retrieve-existing-orders.md) - [Retrieve Return Orders Within A Date Range](https://developer.esw.com/returns-api/returns-api-v2.1/methods/retrieve-return-orders-within-a-date-range.md) - [Create Return Orders](https://developer.esw.com/returns-api/returns-api-v2.1/methods/create-return-orders.md) - [Update An Existing Return Order](https://developer.esw.com/returns-api/returns-api-v2.1/methods/update-an-existing-return-order.md) - [Create An Undeliverable Return Order](https://developer.esw.com/returns-api/returns-api-v2.1/methods/create-an-undeliverable-return-order.md) - [Additional Information](https://developer.esw.com/returns-api/returns-api-v2.1/additional-information.md) - [Methods](https://developer.esw.com/returns-api/returns-api-2.0/methods.md) - [Retrieve Existing Orders](https://developer.esw.com/returns-api/returns-api-2.0/methods/retrieve-existing-orders.md) - [Retrieve A Single Return Order](https://developer.esw.com/returns-api/returns-api-2.0/methods/retrieve-a-single-return-order.md) - [Retrieve Return Orders Within A Date Range](https://developer.esw.com/returns-api/returns-api-2.0/methods/retrieve-return-orders-within-a-date-range.md) - [Create A Return Order](https://developer.esw.com/returns-api/returns-api-2.0/methods/create-a-return-order.md) - [Update An Existing Return Order](https://developer.esw.com/returns-api/returns-api-2.0/methods/update-an-existing-return-order.md) - [Create An Undeliverable Return Order](https://developer.esw.com/returns-api/returns-api-2.0/methods/create-an-undeliverable-return-order.md) - [Additional Information](https://developer.esw.com/returns-api/returns-api-2.0/additional-information.md) ## Callback - [Overview](https://developer.esw.com/callback-api/callback-api/overview.md): Learn what the ESW Light Touch Integration Callback API does, which shopper flows it supports, and the core setup steps to launch it. - [Storing A Cart Identifier In Cookies](https://developer.esw.com/callback-api/callback-api/storing-a-cart-identifier-in-cookies.md) - [Enabling Fixed Pricing In Callback API](https://developer.esw.com/callback-api/callback-api/enabling-fixed-pricing-in-callback-api.md) - [Implementing Callback API Endpoints](https://developer.esw.com/callback-api/callback-api/implementing-callback-api-endpoints.md) - [Retrieve Cart Using Callback API](https://developer.esw.com/callback-api/callback-api/implementing-callback-api-endpoints/retrieve-cart-using-callback-api.md) - [Delete Cart Using Callback API](https://developer.esw.com/callback-api/callback-api/implementing-callback-api-endpoints/delete-cart-using-callback-api.md) - [Create Paid Order Using Callback API](https://developer.esw.com/callback-api/callback-api/implementing-callback-api-endpoints/create-paid-order-using-callback-api.md) - [Update Order Fields Using Callback API](https://developer.esw.com/callback-api/callback-api/implementing-callback-api-endpoints/update-order-fields-using-callback-api.md) - [Providing Callback API Endpoint Credentials To ESW](https://developer.esw.com/callback-api/callback-api/providing-callback-api-endpoint-credentials-to-esw.md) - [Adding JavaScript To Page Headers](https://developer.esw.com/callback-api/callback-api/adding-javascript-to-page-headers.md) - [Callback API Supporting Information](https://developer.esw.com/callback-api/callback-api/callback-api-supporting-information.md) ## API References - [Standard HTTP Response Codes](https://developer.esw.com/api-reference/standard-http-response-codes.md) - [Customs Catalog API](https://developer.esw.com/api-reference/customs-catalog-api.md): Reference for the Customs Catalog API, including endpoints, request formats, and response schemas. - [Brand Config](https://developer.esw.com/api-reference/customs-catalog-api/brand-config.md) - [Classifications](https://developer.esw.com/api-reference/customs-catalog-api/classifications.md) - [Default Classified Product](https://developer.esw.com/api-reference/customs-catalog-api/default-classified-product.md) - [Duty Rule](https://developer.esw.com/api-reference/customs-catalog-api/duty-rule.md) - [Home](https://developer.esw.com/api-reference/customs-catalog-api/home.md) - [Invalid Products](https://developer.esw.com/api-reference/customs-catalog-api/invalid-products.md) - [Logs](https://developer.esw.com/api-reference/customs-catalog-api/logs.md) - [Master Catalog](https://developer.esw.com/api-reference/customs-catalog-api/master-catalog.md) - [Products](https://developer.esw.com/api-reference/customs-catalog-api/products.md) - [Retailer Catalog](https://developer.esw.com/api-reference/customs-catalog-api/retailer-catalog.md) - [Scheduler Jobs](https://developer.esw.com/api-reference/customs-catalog-api/scheduler-jobs.md) - [Vat](https://developer.esw.com/api-reference/customs-catalog-api/vat.md) - [Vat Band Config](https://developer.esw.com/api-reference/customs-catalog-api/vat-band-config.md) - [Models](https://developer.esw.com/api-reference/customs-catalog-api/models.md) - [Pricing Advisor API](https://developer.esw.com/api-reference/pricing-advisor-api.md): Reference for the Pricing Advisor API, including endpoints, request formats, and response schemas. - [Tax And Duty Rates](https://developer.esw.com/api-reference/pricing-advisor-api/tax-and-duty-rates.md) - [Standard Advice](https://developer.esw.com/api-reference/pricing-advisor-api/standard-advice.md) - [Multiplier Advice](https://developer.esw.com/api-reference/pricing-advisor-api/multiplier-advice.md) - [Models](https://developer.esw.com/api-reference/pricing-advisor-api/models.md) - [Checkout API](https://developer.esw.com/api-reference/checkout-api.md): Reference for the Checkout API, including endpoints, request formats, and response schemas. - [Retailer](https://developer.esw.com/api-reference/checkout-api/retailer.md) - [Models](https://developer.esw.com/api-reference/checkout-api/models.md) - [Order API](https://developer.esw.com/api-reference/order-api.md): Reference for the Order API, including endpoints, request formats, and response schemas. - [Order](https://developer.esw.com/api-reference/order-api/order.md) - [Models](https://developer.esw.com/api-reference/order-api/models.md) - [Package API](https://developer.esw.com/api-reference/package-api.md): Reference for the Package API, including endpoints, request formats, and response schemas. - [Label Config](https://developer.esw.com/api-reference/package-api/label-config.md) - [GetLabelConfigExcelAsync](https://developer.esw.com/api-reference/package-api/label-config/getlabelconfigexcelasync.md) - [PostLabelConfigExcel](https://developer.esw.com/api-reference/package-api/label-config/postlabelconfigexcel.md) - [Gets label config history by Tenant code](https://developer.esw.com/api-reference/package-api/label-config/gets-label-config-history-by-tenant-code.md) - [Gets the Excel file by history Id.](https://developer.esw.com/api-reference/package-api/label-config/gets-the-excel-file-by-history-id.md) - [Manifest](https://developer.esw.com/api-reference/package-api/manifest.md) - [Manifest information update](https://developer.esw.com/api-reference/package-api/manifest/manifest-information-update.md) - [Package](https://developer.esw.com/api-reference/package-api/package.md) - [Get packages information by request.](https://developer.esw.com/api-reference/package-api/package/get-packages-information-by-request.md) - [Posts the order information to create a package.](https://developer.esw.com/api-reference/package-api/package/posts-the-order-information-to-create-a-package.md) - [Update an existing package's information.](https://developer.esw.com/api-reference/package-api/package/update-an-existing-packages-information.md) - [Deletes the requested package.](https://developer.esw.com/api-reference/package-api/package/deletes-the-requested-package.md) - [Populate Blacklist](https://developer.esw.com/api-reference/package-api/package/populate-blacklist.md) - [Package Async](https://developer.esw.com/api-reference/package-api/package-async.md) - [Gets the shipping label documentation using a token](https://developer.esw.com/api-reference/package-api/package-async/gets-the-shipping-label-documentation-using-a-token.md) - [Package Dimension](https://developer.esw.com/api-reference/package-api/package-dimension.md) - [GetMasterPackageDimensions - Get MasterPackageDimension by BrandCode](https://developer.esw.com/api-reference/package-api/package-dimension/getmasterpackagedimensions-get-masterpackagedimension-by-brandcode.md) - [Package Dimensions V4](https://developer.esw.com/api-reference/package-api/package-dimension/package-dimensions-v4.md) - [delete package dimension](https://developer.esw.com/api-reference/package-api/package-dimension/delete-package-dimension.md) - [Sfa Config](https://developer.esw.com/api-reference/package-api/sfa-config.md) - [GetSfaConfig by brand code](https://developer.esw.com/api-reference/package-api/sfa-config/getsfaconfig-by-brand-code.md) - [Create SfaConfig for a specific brand](https://developer.esw.com/api-reference/package-api/sfa-config/create-sfaconfig-for-a-specific-brand.md) - [Create SfaConfig for a specific brand](https://developer.esw.com/api-reference/package-api/sfa-config/create-sfaconfig-for-a-specific-brand-1.md) - [delete SfaConfig dimension](https://developer.esw.com/api-reference/package-api/sfa-config/delete-sfaconfig-dimension.md) - [Create SfaConfig from current front end json file](https://developer.esw.com/api-reference/package-api/sfa-config/create-sfaconfig-from-current-front-end-json-file.md) - [Models](https://developer.esw.com/api-reference/package-api/models.md) - [Fulfillment API](https://developer.esw.com/api-reference/fulfillment-api.md): Reference for the Fulfillment API, including endpoints, request formats, and response schemas. - [Inventory](https://developer.esw.com/api-reference/fulfillment-api/inventory.md) - [ASN](https://developer.esw.com/api-reference/fulfillment-api/asn.md) - [PickPack](https://developer.esw.com/api-reference/fulfillment-api/pickpack.md) - [Models](https://developer.esw.com/api-reference/fulfillment-api/models.md) - [Returns API](https://developer.esw.com/api-reference/returns-api.md): Reference for the Returns API, including endpoints, request formats, and response schemas. - [Ingestion](https://developer.esw.com/api-reference/returns-api/ingestion.md) - [Label](https://developer.esw.com/api-reference/returns-api/label.md) - [Orders](https://developer.esw.com/api-reference/returns-api/orders.md) - [Returns](https://developer.esw.com/api-reference/returns-api/returns.md) - [Configuration](https://developer.esw.com/api-reference/returns-api/configuration.md) - [Location](https://developer.esw.com/api-reference/returns-api/location.md) - [Models](https://developer.esw.com/api-reference/returns-api/models.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://developer.esw.com/readme.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.