# 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. - [Quick Start Guide](https://developer.esw.com/getting-started/get-started-with-esw/quick-start-guide.md): Step-by-step quick starts for the ESW APIs: authenticate, then run the core flows for Checkout, Order, Pricing Advisor, Customs Catalog, Package, Fulfillment, and Returns in sandbox. - [Authentication](https://developer.esw.com/getting-started/get-started-with-esw/quick-start-guide/authentication.md): Request an OAuth 2.0 access token from ESW STS, make your first authenticated call, and cache tokens correctly. About 10 minutes in sandbox. - [Customs Catalog](https://developer.esw.com/getting-started/get-started-with-esw/quick-start-guide/customs-catalog.md): Upload your product catalog to ESW with the Customs Catalog API so duties and taxes can be calculated at checkout. About 15 minutes in sandbox. - [Pricing Advisor](https://developer.esw.com/getting-started/get-started-with-esw/quick-start-guide/pricing-advisor.md): Retrieve Pricing Advisor v4.0 multipliers for a country and use them to calculate shopper prices in local currency. - [Checkout](https://developer.esw.com/getting-started/get-started-with-esw/quick-start-guide/checkout.md): Send your first PreOrder, redirect a shopper to ESW Checkout, and handle the Order Confirmation webhook in sandbox. - [Order](https://developer.esw.com/getting-started/get-started-with-esw/quick-start-guide/order.md): Create an order, confirm it, then fulfill or cancel line items with the Order API. Includes the rules that cause the most first-call errors. - [Package](https://developer.esw.com/getting-started/get-started-with-esw/quick-start-guide/package.md): Create a package for an order with the Package API v4.0, handle the label outcome, then retrieve and update it. About 20 minutes in sandbox. - [Fulfillment](https://developer.esw.com/getting-started/get-started-with-esw/quick-start-guide/fulfillment.md): Report pick and pack outcomes from your 3PL warehouse system to ESW with the Fulfillment API. About 20 minutes in sandbox. - [Returns](https://developer.esw.com/getting-started/get-started-with-esw/quick-start-guide/returns.md): Use the GRP Returns API to register an order, confirm return eligibility, and create a return order in the sandbox. About 30 minutes. - [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. - [EU Customs Duty Exemption](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/eu-customs-duty-exemption.md): How the EU’s 1 July 2026 duty changes affect low-value imports and your ESW pricing. - [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 - [Core Integrations](https://developer.esw.com/integrations/integrations/core-integrations.md): What you integrate for an end-to-end ESW implementation: Catalog, Checkout, and Package. - [API Integration](https://developer.esw.com/integrations/integrations/core-integrations/api-integration.md): Integration Summary - [API Summary](https://developer.esw.com/integrations/integrations/core-integrations/api-summary.md) - [Catalog File Integration](https://developer.esw.com/integrations/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/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/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/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/integrations/package-file-integration/tracking-xml-file-spec.md): Schema and delivery rules for ESW tracking outbound XML files. - [Light Touch Integration](https://developer.esw.com/integrations/integrations/light-touch-integration.md): Connect your storefront to ESW services with minimal implementation effort. - [Embedded Checkout](https://developer.esw.com/integrations/integrations/embedded-checkout.md): Keep shoppers on your storefront with ESW iFrame Checkout and Light Touch Integration features for localization, payments, and consent. - [Direct Integration](https://developer.esw.com/integrations/integrations/embedded-checkout/direct-integration.md): Embed ESW Checkout in a dedicated storefront iframe using event-based communication, PreOrder URLs, and domain masking. - [iFrame Integration](https://developer.esw.com/integrations/integrations/embedded-checkout/iframe-integration.md) ## Agentic Commerce - [Merchant Centre Integrations](https://developer.esw.com/agentic-commerce/agentic-commerce-overview/merchant-centre-integrations.md): Overview of Microsoft and Google Merchant Centre setup for ESW Agentic Discovery. - [Microsoft Merchant Centre Setup](https://developer.esw.com/agentic-commerce/agentic-commerce-overview/merchant-centre-integrations/microsoft-merchant-centre-setup.md): Configure Microsoft Merchant Center feeds for ESW Agentic Discovery. - [Google Merchant Centre Setup](https://developer.esw.com/agentic-commerce/agentic-commerce-overview/merchant-centre-integrations/google-merchant-centre-setup.md): Configure Google Merchant Center data sources for ESW Agentic Discovery. - [ESW Agentic Discovery](https://developer.esw.com/agentic-commerce/esw-agentic-discovery.md): Let's Get Started. - [Merchant Center and Catalog Preparation](https://developer.esw.com/agentic-commerce/esw-agentic-discovery/merchant-center-and-catalog-preparation.md): Prepare catalog data for agentic product discovery. - [Manage Catalog Uploads](https://developer.esw.com/agentic-commerce/esw-agentic-discovery/manage-catalog-uploads.md): Upload and maintain market-specific product catalogs through SFTP. - [Product Catalog Specification](https://developer.esw.com/agentic-commerce/esw-agentic-discovery/product-catalog-specification.md): Field requirements for product catalog CSV files. - [FAQs](https://developer.esw.com/agentic-commerce/esw-agentic-discovery/faqs.md): Resolve common catalog upload, Merchant Centre setup, and product discovery questions. - [ESW Agentic Checkout](https://developer.esw.com/agentic-commerce/esw-agentic-checkout.md): Enable secure, agent-led checkout through ESW. - [UCP Profile Setup](https://developer.esw.com/agentic-commerce/esw-agentic-checkout/ucp-profile-setup.md) - [Checkout, Testing, and Errors](https://developer.esw.com/agentic-commerce/esw-agentic-checkout/checkout-testing-and-errors.md): Understand payment handling, validation, and shopper error recovery. - [ESW Agentic Hub and Agents](https://developer.esw.com/agentic-commerce/esw-agentic-hub-and-agents.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). ## 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) - [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): Configure and export Adobe Commerce catalog data to ESW for checkout and customs calculations. - [Order Fulfillment (Package/ASN)](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/order-fulfillment-package-asn.md): Configure package synchronization for ESW fulfillment with Adobe Commerce and downstream systems. - [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): Send Adobe Commerce shipment data to ESW, including package references, synchronization statuses, and tracking updates. - [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): Synchronize ESW package data as Adobe Commerce shipments, including custom shipment-item data. - [Order Fulfillment (Returns)](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/order-fulfillment-returns.md): Synchronize ESW returns to Adobe Commerce as credit memos or return merchandise authorizations. - [Appeasements](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/appeasements.md): Create ESW order, shipping, and item appeasements, then synchronize refunds as Adobe Commerce credit memos. - [Cancellations](https://developer.esw.com/adobe-commerce-magento/esw-adobe-extension-features/cancellations.md): Cancel full or line-item ESW orders and synchronize refunds as Adobe Commerce credit memos. - [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): Configure ESW checkout shipping overrides, conditions, and free-shipping rules in Adobe Commerce. - [Enable Free Shipping Promotion](https://developer.esw.com/adobe-commerce-magento/additional-features/shipping-methods/enable-free-shipping-promotion.md): Create Adobe Commerce cart price rules that make eligible ESW shipping methods free. - [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): Validate cart inventory before payment and redirect shoppers when unavailable items block checkout. - [Webhook JWT Authentication](https://developer.esw.com/adobe-commerce-magento/additional-features/webhook-jwt-authentication.md): Secure ESW Adobe Commerce webhooks with JWT validation, JWKS key refresh, and optional Basic Auth fallback. - [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) - [ESW Checkout Metadata](https://developer.esw.com/adobe-commerce-magento/additional-features/esw-checkout-metadata.md): Configure Magento data mappings that send cart, product, customer, and cookie metadata to ESW Checkout. - [Estimated Delivery Date Override](https://developer.esw.com/adobe-commerce-magento/additional-features/estimated-delivery-date-override.md) - [Integration](https://developer.esw.com/adobe-commerce-magento/integration.md) - [Webhook Integration](https://developer.esw.com/adobe-commerce-magento/integration/webhook-integration.md): Configure ESW webhooks in Adobe Commerce, including authentication, endpoint access, and supported events. - [Asynchronous Integration](https://developer.esw.com/adobe-commerce-magento/integration/asynchronous-integration.md): Configure ESW queue consumers for background catalog exports, webhooks, and other asynchronous Adobe Commerce tasks. - [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) - [FAQs](https://developer.esw.com/adobe-commerce-magento/faqs.md) - [Release Notes](https://developer.esw.com/adobe-commerce-magento/release-notes.md): Track Magento extension releases, including new features, fixes, and compatibility updates. ## TikTok Shop - [Coming soon](https://developer.esw.com/tiktok-shop/coming-soon.md) ## Light Touch Integration - [Light Touch Integration](https://developer.esw.com/light-touch-integration/readme.md): Connect your storefront to ESW with minimal effort using localized pricing, checkout, returns, and order status synchronization. - [Features](https://developer.esw.com/light-touch-integration/features.md): Compare Light Touch Integration features across supported platforms, including pricing, checkout, returns, and order status synchronization. - [Country Selector](https://developer.esw.com/light-touch-integration/features/country-selector.md): Configure country and currency selection in Light Touch Integration, including geolocation, ESW countries, custom countries, and redirects. - [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): Localize storefront prices for ESW countries using Pricing Advisor currency conversion, pricing rules, duties, taxes, and rounding. - [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): Set country-specific storefront prices in Light Touch Integration while ESW checkout calculates shipping, duties, and taxes. - [Checkout](https://developer.esw.com/light-touch-integration/features/checkout.md): Use ESW Checkout for localized payments and order creation, with platform support and Web Platform PreOrder requirements. - [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): Route shoppers to ESW or retailer-managed returns flows by country, with Callback API support for non-returnable products. - [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): Integrate ESW Light Touch Integration with BigCommerce, WooCommerce, commercetools, or a custom web platform. - [BigCommerce](https://developer.esw.com/light-touch-integration/integrate-with-lti/bigcommerce.md): Connect ESW Light Touch Integration to BigCommerce using API credentials and a storefront script. - [WooCommerce](https://developer.esw.com/light-touch-integration/integrate-with-lti/woocommerce.md): Connect ESW Light Touch Integration to WooCommerce using REST API keys, plugins, and a storefront script. - [Commerce Tools](https://developer.esw.com/light-touch-integration/integrate-with-lti/commerce-tools.md): Connect ESW Light Touch Integration to Commerce Tools using API credentials, a storefront script, and cart ID handoff. - [Web Platform](https://developer.esw.com/light-touch-integration/integrate-with-lti/web-platform.md): Connect ESW Light Touch Integration to a custom web storefront using the ESW-hosted JavaScript script. - [Callback API](https://developer.esw.com/light-touch-integration/integrate-with-lti/callback-api.md): Implement ESW Light Touch Integration with Callback API endpoints for cart retrieval, order creation, and checkout flows. - [FAQs](https://developer.esw.com/light-touch-integration/faqs.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. - [Brand and Tenant Configuration](https://developer.esw.com/customs-catalog-api/customs-catalog-api/brand-and-tenant-configuration.md) - [Concepts](https://developer.esw.com/customs-catalog-api/customs-catalog-api/concepts.md) - [Product](https://developer.esw.com/customs-catalog-api/customs-catalog-api/concepts/product.md) - [HS Code & Classification](https://developer.esw.com/customs-catalog-api/customs-catalog-api/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/concepts/async-processing.md) - [VAT and Duty Rules](https://developer.esw.com/customs-catalog-api/customs-catalog-api/concepts/vat-and-duty-rules.md) - [Pagination Patterns](https://developer.esw.com/customs-catalog-api/customs-catalog-api/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/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) - [Code Samples](https://developer.esw.com/customs-catalog-api/customs-catalog-api/code-samples.md): Example requests and inspect sample responses for RetailerCatalog 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 - [HTTP Status Codes](https://developer.esw.com/customs-catalog-api/customs-catalog-api/http-status-codes.md) - [FAQs](https://developer.esw.com/customs-catalog-api/customs-catalog-api/faqs.md) - [Workflows](https://developer.esw.com/customs-catalog-api/customs-catalog-api/workflows.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. - [Request Builder](https://developer.esw.com/customs-catalog-api/resources/tutorials/request-builder.md) - [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) - [Self-Service Catalog Management](https://developer.esw.com/customs-catalog-api/resources/self-service-catalog-management.md) ## Inventory - [Inventory API](https://developer.esw.com/inventory/inventory-api.md) - [Overview](https://developer.esw.com/inventory/inventory-api/overview.md): Inventory API and the two Available-to-Sell (ATS) endpoints that return SKU-level inventory availability. - [Authentication](https://developer.esw.com/inventory/inventory-api/authentication.md): How to authenticate Inventory API requests with a Bearer JWT and how to request an access token. - [Concepts](https://developer.esw.com/inventory/inventory-api/concepts.md): Core concepts for the Inventory API: Available-to-Sell quantities, delivery-country availability, and choosing between GET and POST. - [Available-to-Sell (ATS)](https://developer.esw.com/inventory/inventory-api/concepts/available-to-sell-ats.md): What Available-to-Sell (ATS) means, which inventory controls affect it, and how it differs from physical On Hand stock. - [Delivery-Country Availability](https://developer.esw.com/inventory/inventory-api/concepts/delivery-country-availability.md): How supplying a delivery country on the POST endpoint determines the inventory applicable to a shopper's market. - [Decision Tables](https://developer.esw.com/inventory/inventory-api/concepts/decision-tables.md): Decision tables for choosing between the GET and POST Inventory Availability endpoints. - [API Methods](https://developer.esw.com/inventory/inventory-api/api-methods.md): Reference for the two Inventory API methods: GET and POST Inventory Availability. - [Get Inventory Availability](https://developer.esw.com/inventory/inventory-api/api-methods/get-inventory-availability.md): Retrieve current Available-to-Sell (ATS) quantities for all applicable SKUs. - [Get Inventory Availability for SKUs](https://developer.esw.com/inventory/inventory-api/api-methods/get-inventory-availability-for-skus.md): Retrieve Available-to-Sell (ATS) quantities for a specified list of SKUs, optionally for a shopper's delivery country. - [Use Cases](https://developer.esw.com/inventory/inventory-api/use-cases.md): Four end-to-end scenarios showing how to use the Inventory API to keep availability in sync, check selected SKUs for a delivery market, and handle failures safely. - [Response Codes](https://developer.esw.com/inventory/inventory-api/response-codes.md): HTTP response codes returned by the Inventory API, the error body schemas, and how to handle each response. - [FAQs](https://developer.esw.com/inventory/inventory-api/faqs.md): Answers to common questions about the Inventory API, Available-to-Sell quantities, delivery-country behavior, and error handling. - [Resources](https://developer.esw.com/inventory/resources.md) - [First Successful Requests](https://developer.esw.com/inventory/resources/first-successful-requests.md): Make your first successful Inventory API requests: get a token, check selected SKUs for a delivery country, and retrieve the full availability set. - [Tutorials](https://developer.esw.com/inventory/resources/tutorials.md): Step-by-step tutorials for retrieving Available-to-Sell inventory with the Inventory API. - [Retrieving All ATS Inventory](https://developer.esw.com/inventory/resources/tutorials/retrieving-all-ats-inventory.md): Retrieve the complete Available-to-Sell (ATS) inventory feed for all applicable SKUs and apply it to a local availability store. - [Retrieving ATS for Specific SKUs](https://developer.esw.com/inventory/resources/tutorials/retrieving-ats-for-specific-skus.md): Retrieve Available-to-Sell (ATS) quantities for a list of SKUs, optionally for a shopper's delivery country. ## Pricing Advisor - [Overview](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/overview.md): Retrieve Pricing Advisor v4.0 data, including currency displays and rounding models. - [How it Works](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/how-it-works.md) - [Concepts](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/concepts.md) - [Rounding](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/concepts/rounding.md) - [Rounding Models](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/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/concepts/multiplier-pricing.md) - [Standard Pricing](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/concepts/standard-pricing.md) - [FX Rates & Models](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/concepts/fx-rates-and-models.md) - [Currency Display](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/concepts/currency-display.md) - [Decision Tables](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/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/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): Retrieve a country-specific multiplier combining FX, estimated duties, taxes, and retailer adjustments. - [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) - [Calculate Final Prices](https://developer.esw.com/pricing-advisor-api/resources/tutorials/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/tutorials/request-builder.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) ## Checkout - [Overview](https://developer.esw.com/checkout-api/checkout-api/overview.md): Checkout flow, request payload essentials, redirect behavior, and common capabilities. - [Concepts](https://developer.esw.com/checkout-api/checkout-api/concepts.md): Learn Checkout API concepts for registered shoppers, shipping overrides, zero-value orders, and promotional codes. - [Registered Shopper](https://developer.esw.com/checkout-api/checkout-api/concepts/registered-shopper.md): Prepopulate checkout shipping and billing details for registered shoppers and prompt guest shoppers to register after purchase. - [Gift Card](https://developer.esw.com/checkout-api/checkout-api/concepts/gift-card.md): Record gift card payments in Order Confirmation, including split payments, full-order totals, and reconciliation requirements. - [Zero Value Order](https://developer.esw.com/checkout-api/checkout-api/concepts/zero-value-order.md) - [Shipping Override](https://developer.esw.com/checkout-api/checkout-api/concepts/shipping-override.md): Override checkout shipping prices and delivery estimates for ESW-fulfilled or retailer-fulfilled promotion options. - [Stored Card](https://developer.esw.com/checkout-api/checkout-api/concepts/stored-card.md): Enable registered shoppers to securely save payment cards for faster checkout. - [Promotional Code](https://developer.esw.com/checkout-api/checkout-api/concepts/promotional-code.md): Display retailer-cart promo codes and discount details during ESW checkout in their intended application order. - [Use Cases](https://developer.esw.com/checkout-api/checkout-api/use-cases.md): Checkout API examples for free samples, full carts, and digital or mixed goods. - [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. - [PreOrder](https://developer.esw.com/checkout-api/checkout-api/api-methods/preorder.md): Send cart and shopper details to ESW and receive a checkout redirect URL. - [Order Confirmation](https://developer.esw.com/checkout-api/checkout-api/api-methods/order-confirmation.md): Confirm receipt of completed ESW checkout orders, return your order number, and report any ingestion errors. - [Response Status Codes (Validation)](https://developer.esw.com/checkout-api/checkout-api/response-status-codes-validation.md): Reference PreOrder validation status codes for successful requests, required fields, invalid values, duplicate carts, and internal errors. - [Domain Masking](https://developer.esw.com/checkout-api/checkout-api/domain-masking.md): Use your own subdomain for ESW Checkout URLs, including redirect behavior, response examples, and CNAME setup. - [FAQs](https://developer.esw.com/checkout-api/checkout-api/faqs.md): Answers to common checkout, preorder, and order confirmation integration questions. - [Sending PreOrder](https://developer.esw.com/checkout-api/resources/sending-preorder.md): Send a PreOrder request to ESW, redirect shoppers to checkout, and configure checkout details. - [Order Confirmation Webhook](https://developer.esw.com/checkout-api/resources/order-confirmation-webhook.md): Configure ESW Order Confirmation webhooks, including payload fields, responses, processing modes, and delivery headers. - [Order Confirmation Sample Integration](https://developer.esw.com/checkout-api/resources/order-confirmation-webhook/order-confirmation-sample-integration.md): Review an Order Confirmation v3.0 webhook payload example, including order, payment, pricing, delivery, and contact data. - [Checkout UI Metadata](https://developer.esw.com/checkout-api/resources/checkout-ui-metadata.md): Configure cart metadata for checkout UI, analytics, messaging, pricing, kits, registration, and PUDO locations. - [Sending Checkout UI Metadata](https://developer.esw.com/checkout-api/resources/checkout-ui-metadata/sending-checkout-ui-metadata.md): Send item-level and order-level checkout metadata to the ESW dataLayer for analytics. - [Sales Assisted Checkout Tracking](https://developer.esw.com/checkout-api/resources/sales-assisted-checkout-tracking.md): Track assisted checkout sales with sales-assistant metadata, optional shopper registration, and extended session timeouts. - [Abandon Cart & Marketing Consent](https://developer.esw.com/checkout-api/resources/abandon-cart-and-marketing-consent.md) - [Request Builder](https://developer.esw.com/checkout-api/resources/request-builder.md) - [Preorder](https://developer.esw.com/checkout-api/resources/request-builder/preorder.md) - [Order Confirmation](https://developer.esw.com/checkout-api/resources/request-builder/order-confirmation.md) - [Onsite Payment Message](https://developer.esw.com/checkout-api/resources/onsite-payment-message.md): Add dynamic PayPal and Klarna payment messages to product and cart pages. ## 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 - [Concepts](https://developer.esw.com/order-api/order-api/concepts.md) - [Order](https://developer.esw.com/order-api/order-api/concepts/order.md) - [Products and Pricing](https://developer.esw.com/order-api/order-api/concepts/products-and-pricing.md) - [Contact Details](https://developer.esw.com/order-api/order-api/concepts/contact-details.md) - [Delivery and Origin](https://developer.esw.com/order-api/order-api/concepts/delivery-and-origin.md) - [Transactions](https://developer.esw.com/order-api/order-api/concepts/transactions.md) - [Fulfilment and Allocation](https://developer.esw.com/order-api/order-api/concepts/fulfilment-and-allocation.md) - [Replacements and Cancellations](https://developer.esw.com/order-api/order-api/concepts/replacements-and-cancellations.md) - [Appeasements](https://developer.esw.com/order-api/order-api/concepts/appeasements.md) - [Charges and Balances](https://developer.esw.com/order-api/order-api/concepts/charges-and-balances.md) - [Decision Tables](https://developer.esw.com/order-api/order-api/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) - [Create an Order](https://developer.esw.com/order-api/order-api/api-methods/create-an-order.md): Create a new order using the Order API. - [Update Line Item Within An Order](https://developer.esw.com/order-api/order-api/api-methods/update-line-item-within-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) - [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) - [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): Allocate or cancel order line items across one or more fulfillment centers. - [Order Events](https://developer.esw.com/order-api/order-api/order-events.md) - [Order Cancellation Event](https://developer.esw.com/order-api/order-api/order-events/order-cancellation-event.md) - [Line Item Cancellation Event](https://developer.esw.com/order-api/order-api/order-events/line-item-cancellation-event.md) - [Line Item Fulfilment Event](https://developer.esw.com/order-api/order-api/order-events/line-item-fulfilment-event.md) - [Replacement Event](https://developer.esw.com/order-api/order-api/order-events/replacement-event.md) - [Order Appeasement Event](https://developer.esw.com/order-api/order-api/order-events/order-appeasement-event.md) - [Line Item Appeasement Event](https://developer.esw.com/order-api/order-api/order-events/line-item-appeasement-event.md) - [Multiple Line Item Replacement Event](https://developer.esw.com/order-api/order-api/order-events/multiple-line-item-replacement-event.md) - [Allocate Event](https://developer.esw.com/order-api/order-api/order-events/allocate-event.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) - [FAQs](https://developer.esw.com/order-api/order-api/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): Create orders in ESW, including required request fields, validation, and response handling. - [Cancelling an Order](https://developer.esw.com/order-api/resources/tutorials/cancelling-an-order.md): Cancel entire orders or individual line items, including fulfilment and partial quantities. - [Request Builder](https://developer.esw.com/order-api/resources/tutorials/request-builder.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) ## 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. - [Concepts](https://developer.esw.com/package-api/package-api/concepts.md) - [Package](https://developer.esw.com/package-api/package-api/concepts/package.md) - [Order Types](https://developer.esw.com/package-api/package-api/concepts/order-types.md) - [Package Status](https://developer.esw.com/package-api/package-api/concepts/package-status.md) - [Labels & Documents](https://developer.esw.com/package-api/package-api/concepts/labels-and-documents.md) - [Ship-From-Anywhere](https://developer.esw.com/package-api/package-api/concepts/ship-from-anywhere.md) - [Manifests](https://developer.esw.com/package-api/package-api/concepts/manifests.md) - [Decision Tables](https://developer.esw.com/package-api/package-api/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) - [HTTP Status Codes](https://developer.esw.com/package-api/package-api/http-status-codes.md) - [Copy of Code Samples](https://developer.esw.com/package-api/package-api/copy-of-code-samples.md) - [FAQs](https://developer.esw.com/package-api/package-api/faqs.md): Answers to common ESW Package API questions about payloads, labels, required fields, and package actions. - [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): Create valid Package API requests for every order type, including required fields, shipping options, and examples. - [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) ## Package Management - [Overview](https://developer.esw.com/package-management/package-management-api/overview.md): Manage packages for existing orders and retrieve shipping documentation. - [core concepts](https://developer.esw.com/package-management/package-management-api/core-concepts.md) - [Package](https://developer.esw.com/package-management/package-management-api/core-concepts/package.md): Create packages with parcel references, weights, and optional shipping details. - [Consignee](https://developer.esw.com/package-management/package-management-api/core-concepts/consignee.md): Provide recipient and delivery-address details for a package. - [Dangerous goods](https://developer.esw.com/package-management/package-management-api/core-concepts/dangerous-goods.md): Declare dangerous goods at package level and identify affected items. - [Measurement and pricing](https://developer.esw.com/package-management/package-management-api/core-concepts/measurement-and-pricing.md): Send parcel dimensions, weights, shipping charges, and insurance values. - [Package items and customs](https://developer.esw.com/package-management/package-management-api/core-concepts/package-items-and-customs.md): Describe package contents, item values, and customs information. - [Package status](https://developer.esw.com/package-management/package-management-api/core-concepts/package-status.md): Interpret shipping, hold-release, and package operation statuses. - [API Methods](https://developer.esw.com/package-management/package-management-api/api-methods.md) - [Create a New Package](https://developer.esw.com/package-management/package-management-api/api-methods/create-a-new-package.md): Create packages for checkout orders using the ESW Package Management API. - [Update a Package](https://developer.esw.com/package-management/package-management-api/api-methods/update-a-package.md): Update shipping and delivery details for a pending package. - [Retrieve a Package](https://developer.esw.com/package-management/package-management-api/api-methods/retrieve-a-package.md): Retrieve details for an existing package in an order. - [Delete a Package](https://developer.esw.com/package-management/package-management-api/api-methods/delete-a-package.md) - [Use Cases](https://developer.esw.com/package-management/package-management-api/use-cases.md) - [Code Samples](https://developer.esw.com/package-management/package-management-api/code-samples.md) - [FAQs](https://developer.esw.com/package-management/package-management-api/faqs.md): Answers to common ESW Package API questions about payloads, labels, required fields, and package actions. - [First Successful Requests](https://developer.esw.com/package-management/resources/first-successful-requests.md) - [Tutorials](https://developer.esw.com/package-management/resources/tutorials.md) - [Creating a Package](https://developer.esw.com/package-management/resources/tutorials/creating-a-package.md) - [Request Builder](https://developer.esw.com/package-management/resources/tutorials/request-builder.md) - [Postman Collection](https://developer.esw.com/package-management/resources/postman-collection.md) - [Manifest & Shipment](https://developer.esw.com/package-management/resources/postman-collection/manifest-and-shipment.md) - [Additional Information](https://developer.esw.com/package-management/resources/additional-information.md) - [Copy of Additional Information](https://developer.esw.com/package-management/resources/copy-of-additional-information.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. - [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. - [Concepts](https://developer.esw.com/fulfillment-api/fulfillment-api/concepts.md) - [Inventory](https://developer.esw.com/fulfillment-api/fulfillment-api/concepts/inventory.md) - [Advanced Shipping Notice (ASN)](https://developer.esw.com/fulfillment-api/fulfillment-api/concepts/advanced-shipping-notice-asn.md) - [Pick and Park Confirmation](https://developer.esw.com/fulfillment-api/fulfillment-api/concepts/pick-and-park-confirmation.md) - [Response Status and Failure Reasons](https://developer.esw.com/fulfillment-api/fulfillment-api/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/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) - [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): Sync warehouse inventory quantities and article statuses with ESW's fulfilment system. - [Confirming Pick & Pack](https://developer.esw.com/fulfillment-api/resources/tutorials/confirming-pick-and-pack.md): Report pick and pack outcomes to ESW before carrier collection. - [Submitting an Advanced Shipping Notice](https://developer.esw.com/fulfillment-api/resources/tutorials/submitting-an-advanced-shipping-notice.md): Submit Advanced Shipping Notices with carrier, package, and partial shipment details. - [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 - [Concepts](https://developer.esw.com/returns-api/grp-returns-api/concepts.md) - [Ingestion](https://developer.esw.com/returns-api/grp-returns-api/concepts/ingestion.md) - [Return Order](https://developer.esw.com/returns-api/grp-returns-api/concepts/return-order.md) - [Return Methods](https://developer.esw.com/returns-api/grp-returns-api/concepts/return-methods.md) - [Documents and Labels](https://developer.esw.com/returns-api/grp-returns-api/concepts/documents-and-labels.md) - [Tracking and Updates](https://developer.esw.com/returns-api/grp-returns-api/concepts/tracking-and-updates.md) - [Decision Tables](https://developer.esw.com/returns-api/grp-returns-api/concepts/decision-tables.md) - [Use Cases](https://developer.esw.com/returns-api/grp-returns-api/use-cases.md) - [API Methods](https://developer.esw.com/returns-api/grp-returns-api/api-methods.md) - [Ingestion Methods](https://developer.esw.com/returns-api/grp-returns-api/api-methods/ingestion-methods.md): Create, update, and submit outbound orders and shipments for returns processing. - [Order Methods](https://developer.esw.com/returns-api/grp-returns-api/api-methods/order-methods.md): Retrieve ingested orders from the returns platform. - [Return Methods](https://developer.esw.com/returns-api/grp-returns-api/api-methods/return-methods.md): Create and update return orders, then retrieve their shipping documents. - [Configuration Methods](https://developer.esw.com/returns-api/grp-returns-api/api-methods/configuration-methods.md) - [Location Methods](https://developer.esw.com/returns-api/grp-returns-api/api-methods/location-methods.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) - [Response Codes](https://developer.esw.com/returns-api/grp-returns-api/response-codes.md): HTTP response codes and endpoint-specific error codes for the ESW Returns API. - [FAQs](https://developer.esw.com/returns-api/grp-returns-api/faqs.md): Answers to common questions about ESW Returns API capabilities, return models, versions, and eligibility. - [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) - [Updating a Return Order](https://developer.esw.com/returns-api/resources/tutorials/updating-a-return-order.md) - [Request Builder](https://developer.esw.com/returns-api/resources/tutorials/request-builder.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) ## 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 Status - [Custom Catalog API](https://developer.esw.com/api-status/custom-catalog-api.md) - [Pricing Advisor API](https://developer.esw.com/api-status/pricing-advisor-api.md) - [Checkout API](https://developer.esw.com/api-status/checkout-api.md) - [Order API](https://developer.esw.com/api-status/order-api.md) - [Package API](https://developer.esw.com/api-status/package-api.md) - [Fulfillment API](https://developer.esw.com/api-status/fulfillment-api.md) - [Returns API](https://developer.esw.com/api-status/returns-api.md) ## API Reference - [Standard HTTP Response Codes](https://developer.esw.com/api-references/standard-http-response-codes.md) - [Inventory API](https://developer.esw.com/api-references/inventory-api.md) - [Availability](https://developer.esw.com/api-references/inventory-api/availability.md) - [Models](https://developer.esw.com/api-references/inventory-api/models.md) - [Customs Catalog API](https://developer.esw.com/api-references/customs-catalog-api.md): Reference for the Customs Catalog API, including endpoints, request formats, and response schemas. - [Retailer Catalog](https://developer.esw.com/api-references/customs-catalog-api/retailer-catalog.md) - [Models](https://developer.esw.com/api-references/customs-catalog-api/models.md) - [API Status](https://developer.esw.com/api-references/customs-catalog-api/api-status.md) - [Pricing Advisor API](https://developer.esw.com/api-references/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-references/pricing-advisor-api/tax-and-duty-rates.md) - [Standard Advice](https://developer.esw.com/api-references/pricing-advisor-api/standard-advice.md) - [Multiplier Advice](https://developer.esw.com/api-references/pricing-advisor-api/multiplier-advice.md) - [Models](https://developer.esw.com/api-references/pricing-advisor-api/models.md) - [API Status](https://developer.esw.com/api-references/pricing-advisor-api/api-status.md) - [Checkout API](https://developer.esw.com/api-references/checkout-api.md): Reference for the Checkout API, including endpoints, request formats, and response schemas. - [Pre Order](https://developer.esw.com/api-references/checkout-api/pre-order.md) - [Models](https://developer.esw.com/api-references/checkout-api/models.md) - [Retailer](https://developer.esw.com/api-references/checkout-api/retailer.md) - [Models](https://developer.esw.com/api-references/checkout-api/models-1.md) - [API Status](https://developer.esw.com/api-references/checkout-api/api-status.md) - [Order API](https://developer.esw.com/api-references/order-api.md): Reference for the Order API, including endpoints, request formats, and response schemas. - [Order](https://developer.esw.com/api-references/order-api/order.md) - [Models](https://developer.esw.com/api-references/order-api/models.md) - [Package API](https://developer.esw.com/api-references/package-api.md) - [Package](https://developer.esw.com/api-references/package-api/package.md) - [Get packages information by request.](https://developer.esw.com/api-references/package-api/package/get-packages-information-by-request.md) - [Posts the order information to create a package.](https://developer.esw.com/api-references/package-api/package/posts-the-order-information-to-create-a-package.md) - [Update an existing package's information.](https://developer.esw.com/api-references/package-api/package/update-an-existing-packages-information.md) - [Deletes the requested package.](https://developer.esw.com/api-references/package-api/package/deletes-the-requested-package.md) - [Populate Blacklist](https://developer.esw.com/api-references/package-api/package/populate-blacklist.md) - [Models](https://developer.esw.com/api-references/package-api/models.md) - [Package Management API](https://developer.esw.com/api-references/package-management-api.md): Reference for the Package API, including endpoints, request formats, and response schemas. - [Package](https://developer.esw.com/api-references/package-management-api/package.md) - [Gets a package for a specified tenant code, order reference and package reference.](https://developer.esw.com/api-references/package-management-api/package/gets-a-package-for-a-specified-tenant-code-order-reference-and-package-reference.md) - [Updates certain fields of a package for a specified tenant, order reference and package reference.](https://developer.esw.com/api-references/package-management-api/package/updates-certain-fields-of-a-package-for-a-specified-tenant-order-reference-and-package-reference.md) - [Deletes a package for a specified tenant code, order reference and package reference.](https://developer.esw.com/api-references/package-management-api/package/deletes-a-package-for-a-specified-tenant-code-order-reference-and-package-reference.md) - [Creates a new package for a specified tenant and order reference.](https://developer.esw.com/api-references/package-management-api/package/creates-a-new-package-for-a-specified-tenant-and-order-reference.md) - [Documentation](https://developer.esw.com/api-references/package-management-api/documentation.md) - [Retrieves the documentation information for a package by tenant code, eShop package reference, and documentation type.](https://developer.esw.com/api-references/package-management-api/documentation/retrieves-the-documentation-information-for-a-package-by-tenant-code-eshop-package-reference-and-doc.md) - [Models](https://developer.esw.com/api-references/package-management-api/models.md) - [Fulfillment API](https://developer.esw.com/api-references/fulfillment-api.md): Reference for the Fulfillment API, including endpoints, request formats, and response schemas. - [Inventory](https://developer.esw.com/api-references/fulfillment-api/inventory.md) - [ASN](https://developer.esw.com/api-references/fulfillment-api/asn.md) - [Pick Pack](https://developer.esw.com/api-references/fulfillment-api/pick-pack.md) - [Models](https://developer.esw.com/api-references/fulfillment-api/models.md) - [Returns API](https://developer.esw.com/api-references/returns-api.md): Reference for the Returns API, including endpoints, request formats, and response schemas. - [Ingestion](https://developer.esw.com/api-references/returns-api/ingestion.md) - [Label](https://developer.esw.com/api-references/returns-api/label.md) - [Orders](https://developer.esw.com/api-references/returns-api/orders.md) - [Returns](https://developer.esw.com/api-references/returns-api/returns.md) - [Configuration](https://developer.esw.com/api-references/returns-api/configuration.md) - [Location](https://developer.esw.com/api-references/returns-api/location.md) - [Swagger Definitions](https://developer.esw.com/api-references/swagger-definitions.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 This site has an agentic ask interface you may use to query the documentation dynamically by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://developer.esw.com/index.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.