# ESW ## Home - [ESW Developer Platform](https://developer.esw.com/readme.md): ESW developer documentation for APIs, integrations, authentication, checkout, orders, webhooks, setup guides, and technical references. ## Get Started with ESW - [Overview](https://developer.esw.com/getting-started/get-started-with-esw/readme.md): Start here to explore ESW APIs and jump to the main service areas, including customs, pricing, checkout, orders, returns, callbacks, and fulfillment. - [Authentication](https://developer.esw.com/getting-started/get-started-with-esw/readme/quickstart.md): Learn how ESW STS authentication works, how to request OAuth 2.0 access tokens with client credentials, and how to send Bearer tokens on API requests. - [Access Tokens](https://developer.esw.com/getting-started/get-started-with-esw/readme/publish-your-docs.md): Request OAuth 2.0 access tokens from ESW STS using client credentials. Includes required parameters, token endpoint, and code examples - [Postman Collection](https://developer.esw.com/getting-started/get-started-with-esw/readme/postman-collection.md): Download and import the ESW Postman collection + environment to run the sandbox flow (token → PreOrder → redirect). - [Test Cards](https://developer.esw.com/getting-started/get-started-with-esw/readme/test-cards.md): Test card numbers for validating ESW Checkout payments, including non-3DS and 3DS scenarios (Adyen and Computop) with OTP notes. - [Finance and Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement.md): Making worldwide commerce simple - [Settlement and Billing](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing.md) - [Reconciliation Process](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/reconciliation-process.md): Reconciliation process for settlements and billing - [Sales](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/sales.md): Sales process for settlements and billing - [Returns](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/returns.md): Returns process for settlements and billing - [Refunds](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/refunds.md) - [Reconciliation Report](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/reconciliation-report.md): Reconciliation process for settlements and billing - [Pricing](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/pricing.md) - [Pricing Advisor Example to Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/pricing/pricing-advisor-example-to-settlement.md): Follow a worked example from Pricing Advisor output to final ESW settlement, including uplift, blended duty and VAT, FX conversion, rounding, and retailer payout. - [Order Flow from Confirmation to Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/order-flow-from-confirmation-to-settlement.md) - [Flow to Order Confirmation & Payloads](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/order-flow-from-confirmation-to-settlement/flow-to-order-confirmation-and-payloads.md) - [Order Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/order-flow-from-confirmation-to-settlement/order-settlement.md) - [Invoicing, Tax and Duties Payment](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment.md) - [Fully Trade Compliant](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment/fully-trade-compliant.md) - [Trade Compliance Flow](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment/trade-compliance-flow.md): Follow the six-step trade compliance flow from product normalization and pricing through customs checks, documentation, and compliant invoicing. - [Invoicing requirements](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment/invoicing-requirements.md): ESW invoice and credit note requirements by region, including EU, US, rest-of-world, and domestic VAT treatment. - [Payment Terms](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/payment-terms.md): How ESW settlement payments work, including payout cadence, net settlement components, and how duties, taxes, sales, and returns are treated. - [FAQs and Customization](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/faqs-and-customization.md): Find answers to common questions about ESW’s merchant-of-record model, reporting, settlement options, and key operational definitions. - [Best Practices](https://developer.esw.com/getting-started/get-started-with-esw/best-practices.md): This section describes the best practices and ESW recommendations that you can follow to ensure the smooth flow of data between your servers and ESW servers. - [APIs](https://developer.esw.com/getting-started/get-started-with-esw/best-practices/apis.md): Best practices for endpoints ESW calls: authenticate requests, return correct status codes, handle retries and bursts, and acknowledge quickly. - [Webhooks](https://developer.esw.com/getting-started/get-started-with-esw/best-practices/webhooks.md): Best practices for ESW webhooks: HTTPS and domain requirements, validate event type/version, respond within 3 seconds, and design for async delivery. - [FAQs](https://developer.esw.com/getting-started/get-started-with-esw/faqs.md): Some frequently asked questions. - [Glossary](https://developer.esw.com/getting-started/get-started-with-esw/glossary.md): Definitions of key ESW terms across checkout, payments, logistics, and reporting. - [Copy of Overview](https://developer.esw.com/getting-started/get-started-with-esw/readme-1.md): Start here to explore ESW APIs and jump to the main service areas, including customs, pricing, checkout, orders, returns, callbacks, and fulfillment. - [Authentication](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/quickstart.md): Learn how ESW STS authentication works, how to request OAuth 2.0 access tokens with client credentials, and how to send Bearer tokens on API requests. - [Access Tokens](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/publish-your-docs.md): Request OAuth 2.0 access tokens from ESW STS using client credentials. Includes required parameters, token endpoint, and code examples. - [Postman Collection](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/postman-collection.md): Download and import the ESW Postman collection + environment to run the sandbox flow (token → PreOrder → redirect). - [Test Cards](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/test-cards.md): Test card numbers for validating ESW Checkout payments, including non-3DS and 3DS scenarios (Adyen and Computop) with OTP notes. ## Integrations - [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. - [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. - [Features](https://developer.esw.com/integrations/integrations/light-touch-integration/features.md) - [Country Selector](https://developer.esw.com/integrations/integrations/light-touch-integration/features/country-selector.md) - [Technical Details](https://developer.esw.com/integrations/integrations/light-touch-integration/features/country-selector/technical-details.md) - [Dynamic Pricing](https://developer.esw.com/integrations/integrations/light-touch-integration/features/dynamic-pricing.md) - [Technical Details](https://developer.esw.com/integrations/integrations/light-touch-integration/features/dynamic-pricing/technical-details.md) - [Fixed Pricing](https://developer.esw.com/integrations/integrations/light-touch-integration/features/fixed-pricing.md) - [Checkout](https://developer.esw.com/integrations/integrations/light-touch-integration/features/checkout.md) - [User Data Sent to Checkout](https://developer.esw.com/integrations/integrations/light-touch-integration/features/checkout/user-data-sent-to-checkout.md) - [Stored Cards in Checkout](https://developer.esw.com/integrations/integrations/light-touch-integration/features/checkout/stored-cards-in-checkout.md) - [Technical Details](https://developer.esw.com/integrations/integrations/light-touch-integration/features/checkout/technical-details.md) - [Returns Integration](https://developer.esw.com/integrations/integrations/light-touch-integration/features/returns-integration.md) - [Technical Details](https://developer.esw.com/integrations/integrations/light-touch-integration/features/returns-integration/technical-details.md) - [Order Status Synchronization](https://developer.esw.com/integrations/integrations/light-touch-integration/features/order-status-synchronization.md) - [Integrate with LTI](https://developer.esw.com/integrations/integrations/light-touch-integration/integrate-with-lti.md) - [BigCommerce](https://developer.esw.com/integrations/integrations/light-touch-integration/integrate-with-lti/bigcommerce.md) - [WooCommerce](https://developer.esw.com/integrations/integrations/light-touch-integration/integrate-with-lti/woocommerce.md) - [Commerce Tools](https://developer.esw.com/integrations/integrations/light-touch-integration/integrate-with-lti/commerce-tools.md) - [Web Platform](https://developer.esw.com/integrations/integrations/light-touch-integration/integrate-with-lti/web-platform.md) - [Callback API](https://developer.esw.com/integrations/integrations/light-touch-integration/integrate-with-lti/callback-api.md) - [FAQs](https://developer.esw.com/integrations/integrations/light-touch-integration/faqs.md) ## Agentic Commerce - [Coming Soon](https://developer.esw.com/agentic-commerce/coming-soon.md) - [Model Context Protocol (MCP)](https://developer.esw.com/agentic-commerce/model-context-protocol-mcp.md): Connect AI clients to the ESW MCP server, configure OAuth or service tokens, and use approved ESW knowledge tools. ## Global Checkout - [Embedded Checkout](https://developer.esw.com/global-checkout/embedded-checkout.md) - [Direct Integration](https://developer.esw.com/global-checkout/embedded-checkout/direct-integration.md) - [iFrame Integration](https://developer.esw.com/global-checkout/embedded-checkout/iframe-integration.md): Enabling iFrame on ESP using Light Touch Integration (LTI) - [Iframe Integration Steps](https://developer.esw.com/global-checkout/embedded-checkout/iframe-integration-steps.md) - [Domain Masking](https://developer.esw.com/global-checkout/domain-masking.md) ## Shopify - [Shopify Native](https://developer.esw.com/shopify/shopify-native.md): ESW integration leverages Shopify's native checkout to handle shopper's purchase flow. - [Quick Start Guide](https://developer.esw.com/shopify/shopify-native/quick-start-guide.md): Install and configure the ESW Shopify apps, coordinate ESW onboarding provisioning, and prepare for testing and go-live. - [Install ESW Shopify Apps](https://developer.esw.com/shopify/shopify-native/quick-start-guide/install-esw-shopify-apps.md): Install ESW Shopify apps - [Install Returns and Exchanges App](https://developer.esw.com/shopify/shopify-native/quick-start-guide/install-returns-and-exchanges-app.md): Install the ESW Returns and Exchanges app in Shopify, then contact ESW to provision and configure your tenant. - [Supported Countries](https://developer.esw.com/shopify/shopify-native/quick-start-guide/supported-countries.md): Reference list of ESW-supported countries for Shopify, with ISO 3166-1 alpha-2 codes. - [Test Cards](https://developer.esw.com/shopify/shopify-native/quick-start-guide/test-cards.md): Supported test cards - [Configuration](https://developer.esw.com/shopify/shopify-native/configuration.md): Configure markets, pricing, languages, redirection, and shipping for ESW on Shopify. - [Create a New Market](https://developer.esw.com/shopify/shopify-native/configuration/create-a-new-market.md): Create a Shopify market, set customer conditions, and inherit or customize settings for a new region. - [Add Legal Messaging](https://developer.esw.com/shopify/shopify-native/configuration/add-legal-messaging.md): Add the ESW Privacy Notice block to Shopify checkout to meet legal requirements before go-live. - [Product Pricing](https://developer.esw.com/shopify/shopify-native/configuration/product-pricing.md): Choose a pricing approach and manage exchange rates per market in Shopify. - [Languages & Domains](https://developer.esw.com/shopify/shopify-native/configuration/languages-and-domains.md): Add storefront languages and assign languages and domains per market in Shopify. - [Setup Automatic Country and Language Redirection](https://developer.esw.com/shopify/shopify-native/configuration/setup-automatic-country-and-language-redirection.md): Automatically route shoppers to the right market and language using location and browser settings. - [Shipping Methods, Rates, EDD for New Markets](https://developer.esw.com/shopify/shopify-native/configuration/shipping-methods-rates-edd-for-new-markets.md): Set up fulfillment locations and shipping rates, including transit times for estimated delivery dates (EDD). - [Integration](https://developer.esw.com/shopify/shopify-native/integration.md): Connect Shopify and ESW using webhooks and ESW APIs for catalog, pricing, and order lifecycle sync. - [Integration Overview](https://developer.esw.com/shopify/shopify-native/integration/integration-overview.md): How Shopify checkout, webhooks, and ESW order import fit together. - [Product Catalog Sync](https://developer.esw.com/shopify/shopify-native/integration/product-catalog-sync.md): Sync Shopify product and variant updates to ESW using webhooks and the ESW Catalog API. - [Pricing Import](https://developer.esw.com/shopify/shopify-native/integration/pricing-import.md): Calculate localized prices with ESW Pricing Advisor and import fixed prices into Shopify markets. - [Order Management](https://developer.esw.com/shopify/shopify-native/integration/order-management.md) - [Shipping Address Update](https://developer.esw.com/shopify/shopify-native/integration/shipping-address-update.md): Capture post-purchase shipping address changes in Shopify and sync them to ESW. - [Order and Item-Level Cancellations](https://developer.esw.com/shopify/shopify-native/integration/order-and-item-level-cancellations.md): Keep cancellation state in sync between Shopify and ESW, including partial (item-level) cancels. - [Appeasements](https://developer.esw.com/shopify/shopify-native/integration/appeasements.md): Reflect ESW-initiated appeasements (refunds or compensation) back into Shopify. - [Integration Workflow](https://developer.esw.com/shopify/shopify-native/integration-workflow.md): Overview of the ESW-managed Shopify integration workflow across catalog sync, pricing import, order ingestion, address updates, fulfilment, and cancellations. - [Product Catalog Integration](https://developer.esw.com/shopify/shopify-native/integration-workflow/product-catalog-integration.md): The app syncs Shopify product changes to ESW using Shopify webhooks and the ESW Catalog API. - [Pricing Import](https://developer.esw.com/shopify/shopify-native/integration-workflow/pricing-import.md): Fetch pricing rules from ESW Pricing Advisor and write fixed prices to Shopify markets. - [Order Ingestion](https://developer.esw.com/shopify/shopify-native/integration-workflow/order-ingestion.md) - [Address Update](https://developer.esw.com/shopify/shopify-native/integration-workflow/address-update.md): Capture post-purchase shipping address changes in Shopify and sync them to ESW. - [Fulfilment and Shipping](https://developer.esw.com/shopify/shopify-native/integration-workflow/fulfilment-and-shipping.md): Sync ESW shipment and tracking updates back into Shopify fulfillments. - [Cancellations](https://developer.esw.com/shopify/shopify-native/integration-workflow/cancellations.md): Keep cancellation state in sync between Shopify and ESW (full and item-level). ## 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) - [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) ## Customs Catalog - [Overview](https://developer.esw.com/customs-catalog-api/customs-catalog-api/overview.md): Share product catalog data with ESW to calculate duties and taxes at checkout and support customs compliance. - [How it Works](https://developer.esw.com/customs-catalog-api/customs-catalog-api/how-it-works.md): Follow the end-to-end catalog flow from upload and validation through classification, duty and VAT enrichment, invalid product handling, and product retrieval. - [Cookbook](https://developer.esw.com/customs-catalog-api/customs-catalog-api/how-it-works/cookbook.md) - [Brand and Tenant Configuration](https://developer.esw.com/customs-catalog-api/customs-catalog-api/brand-and-tenant-configuration.md) - [Core Concepts](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts.md) - [Product](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/product.md) - [HS Code & Classification](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/hs-code-and-classification.md): Understand HS code structure, browse the classification hierarchy, and interpret product classification states and regional duty rates. - [Async Processing](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/async-processing.md) - [VAT and Duty Rules](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/vat-and-duty-rules.md) - [Pagination Patterns](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/pagination-patterns.md): Reference for pagination strategies used across the Customs Catalog API - [Decision Matrices](https://developer.esw.com/customs-catalog-api/customs-catalog-api/core-concepts/decision-matrices.md) - [API Methods](https://developer.esw.com/customs-catalog-api/customs-catalog-api/api-methods.md): Send product catalog data to ESW and choose the right upload flow for onboarding, new products, or product updates. - [Upload Full Catalog](https://developer.esw.com/customs-catalog-api/customs-catalog-api/api-methods/upload-full-catalog.md): Send your full product catalog during onboarding, including the extra fields ESW needs for validation and customs clearance. - [Add New Products to Existing Catalog](https://developer.esw.com/customs-catalog-api/customs-catalog-api/api-methods/add-new-products-to-existing-catalog.md): Send only new catalog items after onboarding when ESW already has your catalog, without re-uploading existing products. - [Update Existing Catalog Products](https://developer.esw.com/customs-catalog-api/customs-catalog-api/api-methods/update-existing-catalog-products.md): Update existing catalog items by resubmitting the full product record, which overwrites the previously stored product data. - [Use Cases](https://developer.esw.com/customs-catalog-api/customs-catalog-api/use-cases.md) - [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) ## 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) - [Core Concepts](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts.md) - [Rounding](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/rounding.md) - [Rounding Models](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/rounding-models.md): Learn how Fixed, Multiple, and None rounding models work, how model strings are structured, and how whole-number and decimal targets affect final prices. - [Multiplier Pricing](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/multiplier-pricing.md) - [Standard Pricing](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/standard-pricing.md) - [FX Rates & Models](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/fx-rates-and-models.md) - [Currency Display](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/currency-display.md) - [Decision Tables](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/core-concepts/decision-tables.md): Decision Tables for Choosing Pricing Advice and Interpreting Responses - [API Methods](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods.md) - [Standard Advice](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/standard-advice.md) - [Get Latest Advice for a Country](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/standard-advice/get-latest-advice-for-a-country.md) - [Get All Advice for a Brand](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/standard-advice/get-all-advice-for-a-brand.md) - [Get Archived Advice by ID](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/standard-advice/get-archived-advice-by-id.md) - [Multiplier Advice](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/multiplier-advice.md) - [Get Latest Multiplier for a Country](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/multiplier-advice/get-latest-multiplier-for-a-country.md) - [Get All Multipliers for a Brand](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/multiplier-advice/get-all-multipliers-for-a-brand.md) - [Get Archived Multiplier by ID](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/api-methods/multiplier-advice/get-archived-multiplier-by-id.md) - [Use Cases](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/use-cases.md) - [Use Cases](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/use-cases-1.md) - [Code Samples](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/code-samples.md) - [Response Codes](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/response-codes.md) - [Error Handling](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling.md) - [HTTP Response Codes](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/http-response-codes.md) - [Error Response Structure](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/error-response-structure.md): Learn the RFC 7807 ProblemDetails error schema, nullable fields, and safe parsing patterns for Pricing Advisor API responses. - [Authentication & Authorization Errors](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/authentication-and-authorization-errors.md): Learn when Pricing Advisor API returns 401 and 403 errors, which StandardAdvice endpoints are affected, and how to handle token refresh and permission failures. - [Error Responses](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/error-responses.md): Learn how Pricing Advisor API returns 400, 401, 403, and 404 errors, which endpoints are affected, and when to retry, refresh tokens, or fix request parameters. - [Advice Types](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/advice-types.md): Compare MultiplierAdvice and StandardAdvice error behavior, response payloads, and auth requirements so you can build a unified Pricing Advisor API error handler. - [Retry Strategy](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/retry-strategy.md): Learn which Pricing Advisor API errors are retryable, when to refresh tokens, and how to poll safely for country-level advice that is still generating. - [Error Handling Checklist](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/error-handling/error-handling-checklist.md): Use this pre-ship checklist to verify Pricing Advisor API error handling for validation, auth, retries, null-safe parsing, and observability. - [FAQs](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/faqs.md) - [Use Cases](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/use-cases-2.md) - [Workflows](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/workflows.md) - [First Successful Requests](https://developer.esw.com/pricing-advisor-api/resources/first-successful-requests.md) - [Storefront Pricing Engineer](https://developer.esw.com/pricing-advisor-api/resources/first-successful-requests/storefront-pricing-engineer.md) - [Forward-Pricing / Multiplier Engineer](https://developer.esw.com/pricing-advisor-api/resources/first-successful-requests/forward-pricing-multiplier-engineer.md) - [Tutorials](https://developer.esw.com/pricing-advisor-api/resources/tutorials.md) - [Standard Pricing Advice](https://developer.esw.com/pricing-advisor-api/resources/tutorials/standard-pricing-advice.md): Fetching & Interpreting Standard Pricing Advice - [Multiplier Pricing Advice](https://developer.esw.com/pricing-advisor-api/resources/tutorials/multiplier-pricing-advice.md) - [Calculating a Localized Price](https://developer.esw.com/pricing-advisor-api/resources/tutorials/calculating-a-localized-price.md) - [Currency Display & Rounding](https://developer.esw.com/pricing-advisor-api/resources/tutorials/currency-display-and-rounding.md) - [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. - [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. - [Zero-Value Order](https://developer.esw.com/checkout-api/checkout-api/concepts/zero-value-order.md) - [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. - [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. - [Use Cases](https://developer.esw.com/checkout-api/checkout-api/use-cases.md) - [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 Integrations](https://developer.esw.com/checkout-api/resources/order-confirmation-webhook/order-confirmation-sample-integrations.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. - [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) ## Order - [Overview](https://developer.esw.com/order-api/order-api/order-api.md): Overview of the Order API for creating, managing, fulfilling, cancelling, replacing, and tracking cross-border orders and transactions - [How it Works](https://developer.esw.com/order-api/order-api/how-it-works.md) - [Core Concepts](https://developer.esw.com/order-api/order-api/core-concepts.md) - [Order](https://developer.esw.com/order-api/order-api/core-concepts/order.md) - [Products and Pricing](https://developer.esw.com/order-api/order-api/core-concepts/products-and-pricing.md) - [Contact Details](https://developer.esw.com/order-api/order-api/core-concepts/contact-details.md) - [Delivery and Origin](https://developer.esw.com/order-api/order-api/core-concepts/delivery-and-origin.md) - [Transactions](https://developer.esw.com/order-api/order-api/core-concepts/transactions.md) - [Fulfilment and Allocation](https://developer.esw.com/order-api/order-api/core-concepts/fulfilment-and-allocation.md) - [Replacements and Cancellations](https://developer.esw.com/order-api/order-api/core-concepts/replacements-and-cancellations.md) - [Appeasements](https://developer.esw.com/order-api/order-api/core-concepts/appeasements.md) - [Charges and Balances](https://developer.esw.com/order-api/order-api/core-concepts/charges-and-balances.md) - [Decision Tables](https://developer.esw.com/order-api/order-api/core-concepts/decision-tables.md): Decision Tables for Order Lifecycle, Appeasements, and Contacts - [API Methods](https://developer.esw.com/order-api/order-api/api-methods.md) - [Cancel Entire Order](https://developer.esw.com/order-api/order-api/api-methods/cancel-entire-order.md) - [Cancel Or Fulfil A Line Item Within An Order](https://developer.esw.com/order-api/order-api/api-methods/cancel-or-fulfil-a-line-item-within-an-order.md) - [Issue Replacements (Full Or Partial)](https://developer.esw.com/order-api/order-api/api-methods/issue-replacements-full-or-partial.md) - [Issue Order Appeasements (Full Or Partial)](https://developer.esw.com/order-api/order-api/api-methods/issue-order-appeasements-full-or-partial.md) - [Issue Line Item Appeasements (Full Or Partial)](https://developer.esw.com/order-api/order-api/api-methods/issue-line-item-appeasements-full-or-partial.md) - [Retrieve A Specific Transaction For An Order](https://developer.esw.com/order-api/order-api/api-methods/retrieve-a-specific-transaction-for-an-order.md) - [Update Contact Details On The Order](https://developer.esw.com/order-api/order-api/api-methods/update-contact-details-on-the-order.md) - [Update Line Item Within An Order](https://developer.esw.com/order-api/order-api/api-methods/update-line-item-within-an-order.md) - [Multiple Line Item Replacement](https://developer.esw.com/order-api/order-api/api-methods/multiple-line-item-replacement.md) - [Allocate or Cancel Items Within an Order](https://developer.esw.com/order-api/order-api/api-methods/allocate-or-cancel-items-within-an-order.md) - [Use cases](https://developer.esw.com/order-api/order-api/use-cases.md): End-to-end Order API scenarios for order creation, fulfilment, cancellations, replacements, appeasements, and finance ops. - [Code Samples](https://developer.esw.com/order-api/order-api/code-samples.md) - [Error Handling](https://developer.esw.com/order-api/order-api/error-handling.md) - [Response schemas and status codes](https://developer.esw.com/order-api/order-api/error-handling/response-schemas-and-status-codes.md) - [Request validation](https://developer.esw.com/order-api/order-api/error-handling/request-validation.md) - [Not found, server errors, and async processing](https://developer.esw.com/order-api/order-api/error-handling/not-found-server-errors-and-async-processing.md) - [FAQs](https://developer.esw.com/order-api/order-api/faqs.md) - [First Successful Requests](https://developer.esw.com/order-api/resources/first-successful-requests.md) - [Tutorials](https://developer.esw.com/order-api/resources/tutorials.md) - [Creating an Order](https://developer.esw.com/order-api/resources/tutorials/creating-an-order.md) - [Cancelling an Order](https://developer.esw.com/order-api/resources/tutorials/cancelling-an-order.md) - [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. - [core-concepts](https://developer.esw.com/package-api/package-api/core-concepts.md) - [Package](https://developer.esw.com/package-api/package-api/core-concepts/package.md) - [Order Types](https://developer.esw.com/package-api/package-api/core-concepts/order-types.md) - [Package Status](https://developer.esw.com/package-api/package-api/core-concepts/package-status.md) - [Labels & Documents](https://developer.esw.com/package-api/package-api/core-concepts/labels-and-documents.md) - [Ship-From-Anywhere](https://developer.esw.com/package-api/package-api/core-concepts/ship-from-anywhere.md) - [Manifests](https://developer.esw.com/package-api/package-api/core-concepts/manifests.md) - [Decision Tables](https://developer.esw.com/package-api/package-api/core-concepts/decision-tables.md) - [API Methods](https://developer.esw.com/package-api/package-api/api-methods.md) - [Retrieve Packages](https://developer.esw.com/package-api/package-api/api-methods/retrieve-packages.md) - [Create New Packages](https://developer.esw.com/package-api/package-api/api-methods/create-new-packages.md) - [Update Package Details](https://developer.esw.com/package-api/package-api/api-methods/update-package-details.md) - [Delete Packages](https://developer.esw.com/package-api/package-api/api-methods/delete-packages.md) - [Use Cases](https://developer.esw.com/package-api/package-api/use-cases.md) - [Code Samples](https://developer.esw.com/package-api/package-api/code-samples.md) - [Copy of Code Samples](https://developer.esw.com/package-api/package-api/copy-of-code-samples.md) - [Error Handling](https://developer.esw.com/package-api/package-api/error-handling.md) - [HTTP Status Codes](https://developer.esw.com/package-api/package-api/error-handling/http-status-codes.md) - [Error schemas and status codes](https://developer.esw.com/package-api/package-api/error-handling/error-schemas-and-status-codes.md) - [Authentication and request errors](https://developer.esw.com/package-api/package-api/error-handling/authentication-and-request-errors.md) - [Success codes and reference data](https://developer.esw.com/package-api/package-api/error-handling/success-codes-and-reference-data.md) - [Retry strategy and checklist](https://developer.esw.com/package-api/package-api/error-handling/retry-strategy-and-checklist.md) - [FAQs](https://developer.esw.com/package-api/package-api/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. - [How It Works](https://developer.esw.com/fulfillment-api/fulfillment-api/how-it-works.md) - [Authentication](https://developer.esw.com/fulfillment-api/fulfillment-api/authentication.md): OAuth token endpoint URLs, request parameters, and sample access token responses for each environment. - [Core Concepts](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts.md) - [Inventory](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts/inventory.md) - [Advanced Shipping Notice (ASN)](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts/advanced-shipping-notice-asn.md) - [Pick and Park Confirmation](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts/pick-and-park-confirmation.md) - [Response Status and Failure Reasons](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts/response-status-and-failure-reasons.md): Order-level and item-level PickPack failure reasons, statuses, and retry guidance. - [Decision Tables](https://developer.esw.com/fulfillment-api/fulfillment-api/core-concepts/decision-tables.md) - [API Methods](https://developer.esw.com/fulfillment-api/fulfillment-api/api-methods.md) - [Sync Inventory](https://developer.esw.com/fulfillment-api/fulfillment-api/api-methods/sync-inventory.md) - [Confirm a Pick and Pack](https://developer.esw.com/fulfillment-api/fulfillment-api/api-methods/confirm-a-pick-and-pack.md) - [Submit Advanced Shipping Notice](https://developer.esw.com/fulfillment-api/fulfillment-api/api-methods/submit-advanced-shipping-notice.md) - [Use Cases](https://developer.esw.com/fulfillment-api/fulfillment-api/use-cases.md) - [Error Handling](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling.md) - [Response schemas](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/response-schemas.md) - [Endpoint validation and processing](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/endpoint-validation-and-processing.md) - [Retry strategy](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/retry-strategy.md) - [HTTP Status Codes](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/http-status-codes.md) - [Test Cases](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/test-cases.md): Endpoint-scoped test cases for the ESW Fulfillment API. - [FAQs](https://developer.esw.com/fulfillment-api/fulfillment-api/error-handling/faqs.md) - [First Successful Requests](https://developer.esw.com/fulfillment-api/resources/first-successful-requests.md) - [Retailer Inventory](https://developer.esw.com/fulfillment-api/resources/first-successful-requests/retailer-inventory.md) - [3PL Inventory](https://developer.esw.com/fulfillment-api/resources/first-successful-requests/3pl-inventory.md) - [3PL warehouse / WMS](https://developer.esw.com/fulfillment-api/resources/first-successful-requests/3pl-warehouse-wms.md) - [Shipping / Dispatch](https://developer.esw.com/fulfillment-api/resources/first-successful-requests/shipping-dispatch.md) - [Tutorials](https://developer.esw.com/fulfillment-api/resources/tutorials.md) - [Synchronizing Inventory](https://developer.esw.com/fulfillment-api/resources/tutorials/synchronizing-inventory.md) - [Confirming Pick & Pack](https://developer.esw.com/fulfillment-api/resources/tutorials/confirming-pick-and-pack.md) - [Submitting an Advanced Shipping Notice](https://developer.esw.com/fulfillment-api/resources/tutorials/submitting-an-advanced-shipping-notice.md) - [Pick Pack Response Taxonomy](https://developer.esw.com/fulfillment-api/resources/tutorials/pick-pack-response-taxonomy.md) - [Postman Collection](https://developer.esw.com/fulfillment-api/resources/postman-collection.md) - [3PL Fulfilment Flow](https://developer.esw.com/fulfillment-api/resources/postman-collection/3pl-fulfilment-flow.md) - [Request Builder](https://developer.esw.com/fulfillment-api/resources/request-builder.md) ## Returns - [Overview](https://developer.esw.com/returns-api/grp-returns-api/overview.md): Overview of the GRP Returns API, including core cross-border returns capabilities and available API versions - [Core Concepts](https://developer.esw.com/returns-api/grp-returns-api/core-concepts.md) - [Ingestion](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/ingestion.md) - [Return Order](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/return-order.md) - [Return Methods](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/return-methods.md) - [Documents and Labels](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/documents-and-labels.md) - [Tracking and Updates](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/tracking-and-updates.md) - [Decision Tables](https://developer.esw.com/returns-api/grp-returns-api/core-concepts/decision-tables.md) - [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. - [Error Handling](https://developer.esw.com/returns-api/grp-returns-api/error-handling.md) - [API Specific Error Codes](https://developer.esw.com/returns-api/grp-returns-api/error-handling/api-specific-error-codes.md) - [Error Schemas](https://developer.esw.com/returns-api/grp-returns-api/error-handling/error-schemas.md) - [Errors and Common Causes](https://developer.esw.com/returns-api/grp-returns-api/error-handling/errors-and-common-causes.md) - [Enum Reference](https://developer.esw.com/returns-api/grp-returns-api/error-handling/enum-reference.md) - [FAQs](https://developer.esw.com/returns-api/grp-returns-api/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 References - [Standard HTTP Response Codes](https://developer.esw.com/api-reference/standard-http-response-codes.md) - [Customs Catalog API](https://developer.esw.com/api-reference/customs-catalog-api.md): Reference for the Customs Catalog API, including endpoints, request formats, and response schemas. - [Retailer Catalog](https://developer.esw.com/api-reference/customs-catalog-api/retailer-catalog.md) - [Models](https://developer.esw.com/api-reference/customs-catalog-api/models.md) - [Pricing Advisor API](https://developer.esw.com/api-reference/pricing-advisor-api.md): Reference for the Pricing Advisor API, including endpoints, request formats, and response schemas. - [Tax And Duty Rates](https://developer.esw.com/api-reference/pricing-advisor-api/tax-and-duty-rates.md) - [Standard Advice](https://developer.esw.com/api-reference/pricing-advisor-api/standard-advice.md) - [Multiplier Advice](https://developer.esw.com/api-reference/pricing-advisor-api/multiplier-advice.md) - [Models](https://developer.esw.com/api-reference/pricing-advisor-api/models.md) - [Checkout API](https://developer.esw.com/api-reference/checkout-api.md): Reference for the Checkout API, including endpoints, request formats, and response schemas. - [Pre Order](https://developer.esw.com/api-reference/checkout-api/pre-order.md) - [Models](https://developer.esw.com/api-reference/checkout-api/models.md) - [Retailer](https://developer.esw.com/api-reference/checkout-api/retailer.md) - [Models](https://developer.esw.com/api-reference/checkout-api/models-1.md) - [Order API](https://developer.esw.com/api-reference/order-api.md): Reference for the Order API, including endpoints, request formats, and response schemas. - [Order](https://developer.esw.com/api-reference/order-api/order.md) - [Models](https://developer.esw.com/api-reference/order-api/models.md) - [Package API](https://developer.esw.com/api-reference/package-api.md) - [Package](https://developer.esw.com/api-reference/package-api/package.md) - [Get packages information by request.](https://developer.esw.com/api-reference/package-api/package/get-packages-information-by-request.md) - [Posts the order information to create a package.](https://developer.esw.com/api-reference/package-api/package/posts-the-order-information-to-create-a-package.md) - [Update an existing package's information.](https://developer.esw.com/api-reference/package-api/package/update-an-existing-packages-information.md) - [Deletes the requested package.](https://developer.esw.com/api-reference/package-api/package/deletes-the-requested-package.md) - [Populate Blacklist](https://developer.esw.com/api-reference/package-api/package/populate-blacklist.md) - [Models](https://developer.esw.com/api-reference/package-api/models.md) - [Package Management API](https://developer.esw.com/api-reference/package-management-api.md): Reference for the Package API, including endpoints, request formats, and response schemas. - [Package](https://developer.esw.com/api-reference/package-management-api/package.md) - [Gets a package for a specified tenant code, order reference and package reference.](https://developer.esw.com/api-reference/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-reference/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-reference/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-reference/package-management-api/package/creates-a-new-package-for-a-specified-tenant-and-order-reference.md) - [Documentation](https://developer.esw.com/api-reference/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-reference/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-reference/package-management-api/models.md) - [Fulfillment API](https://developer.esw.com/api-reference/fulfillment-api.md): Reference for the Fulfillment API, including endpoints, request formats, and response schemas. - [Inventory](https://developer.esw.com/api-reference/fulfillment-api/inventory.md) - [ASN](https://developer.esw.com/api-reference/fulfillment-api/asn.md) - [PickPack](https://developer.esw.com/api-reference/fulfillment-api/pickpack.md) - [Models](https://developer.esw.com/api-reference/fulfillment-api/models.md) - [Returns API](https://developer.esw.com/api-reference/returns-api.md): Reference for the Returns API, including endpoints, request formats, and response schemas. - [Ingestion](https://developer.esw.com/api-reference/returns-api/ingestion.md) - [Label](https://developer.esw.com/api-reference/returns-api/label.md) - [Orders](https://developer.esw.com/api-reference/returns-api/orders.md) - [Returns](https://developer.esw.com/api-reference/returns-api/returns.md) - [Configuration](https://developer.esw.com/api-reference/returns-api/configuration.md) - [Location](https://developer.esw.com/api-reference/returns-api/location.md) - [Models](https://developer.esw.com/api-reference/returns-api/models.md) - [Swagger Definitions](https://developer.esw.com/api-reference/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 If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://developer.esw.com/readme.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.