Marketplace and fulfilment integration

Connect Amazon demand without confusing marketplace and FBA scope.

In qualification

XMS Cloud implements Amazon Selling Partner API order pull plus inventory, price, and fulfilment feeds. Its current connector defaults to the North America endpoint, so regional endpoint, authorization, marketplace, feed-result, and live-account qualification are required for European production.

Two connected scopes

Marketplace synchronization and FBA preparation are not the same interface.

SELLING PARTNER API

Orders and channel updates

Pull orders and lines, resolve participating marketplaces, then publish inventory, pricing, and fulfilment feeds.

FBA PREPARATION

Product and inbound readiness

Map merchant and canonical SKUs, packaging, lot/serial/expiry rules, cartons, pallets, labels, booking, documents, and discrepancies.

BOUNDARY

No unsupported Seller Central promise

FBA shipment-plan, placement, appointment, compliance, and Amazon-native label APIs require explicit contract evidence before being claimed.

Implemented exchange

Keep feeds and physical work on one order context.

DirectionDataCurrent implementation
Amazon → XMSMarketplace participation, orders, buyer reference, shipping address, items, quantity, price, currencyCreatedAfter order pull with separate order-item retrieval and bounded parsing
XMS → AmazonInventory availabilityFeeds API document creation, pre-signed upload, and inventory-availability feed submission
XMS → AmazonProduct pricingPricing XML feed through feed-document upload and POST_PRODUCT_PRICING_DATA submission
XMS → AmazonFulfilment statusOrder-fulfilment XML feed with carrier/tracking context from the canonical shipment

Prerequisites and limits

Qualify region, authorization, and feed outcome.

REGION

Endpoint must match marketplaces

The coded default is the North America Selling Partner endpoint. EU and other regions require explicit endpoint configuration and regression.

AUTHORIZATION

Seller and SP-API access

Seller identity, app registration, access token, marketplace participation, roles, scopes, rotation, and revocation must be configured.

FEEDS

Submission is not acceptance

A successful feed POST is not proof that Amazon processed every record; processing reports and reconciliation must close the loop.

IDENTITY

SKU and packaging governance

Amazon SKU, merchant SKU, ASIN/FNSKU where used, barcode, canonical product, packaging, and prep rules need an approved crosswalk.

Client-owned preparation

Prepare stock before it reaches the warehouse.

The merchant workspace lets clients maintain catalog mappings and versioned inbound plans while warehouse receipt, quality, location, and discrepancy truth remain operator-owned.

  • Canonical and merchant identity before label or receipt.
  • Versioned cartons, pallets, documents, and expected arrival.
  • Visible mapping issues, receiving state, and discrepancies.
Client inbound plans showing booking, transit, receiving, accuracy, discrepancies, and next actions
Plan, label, book, receive, and reconcile without silent plan overwrite.

Compatibility review

Bring the seller region, marketplaces, authorization, product identity, and FBA workflow.

Separate covered SP-API objects from FBA preparation and define feed-result reconciliation before production.