# Sears Holdings / Transformco — Sears Marketplace Seller API

> Sears Holdings Corporation was the American holding company behind the Sears and Kmart
> department store chains. It filed for Chapter 11 in October 2018 and its retail operations were
> acquired in 2019 by Transform Holdco LLC, trading as Transformco (Transform SR Brands LLC),
> which operates Sears.com, Kmart.com and ShopYourWay.com today. The one live developer surface
> carried forward from that estate is the Sears Marketplace Seller API.

This file was GENERATED by API Evangelist from the provider's public documentation and from the
33 XML Schema Definitions the provider serves. Sears Marketplace does not publish an llms.txt of
its own — /llms.txt returns 404 on marketplace.sears.com and returns a single-page-app HTML shell
(not a document) on www.sears.com and www.kmart.com.

## What the API is

A versioned XML-over-HTTPS integration for third-party sellers. GET calls export documents from
Seller Portal; PUT calls import documents into it. There is no OpenAPI, no GraphQL, no MCP server
and no A2A agent card. The machine-readable contract is XSD.

- Base URL: https://seller.marketplace.sears.com/SellerPortal/api
- Sandbox base URL: https://sellersandbox.sears.com/SellerPortal/api
- Schema root: https://seller.marketplace.sears.com/SellerPortal/s/schema/
- Media type: application/xml

## Things an agent must know before calling

- **A 200 OK on a PUT does not mean the write succeeded.** It means the file was accepted. Take
  the `document-id` from the `<api-response>` body and GET the Processing Report to learn whether
  records were accepted, warned or rejected.
- **Errors come back with HTTP 200.** Application failures are carried in an `<error-detail>`
  element, not signalled by the status line. An unauthenticated call returns 200 with
  "Missing Authorization header in request".
- **There is no idempotency key.** Retrying a timed-out PUT is not safe; poll first.
- **There are no rate-limit response headers.** The published budgets are the only budget: 500
  requests per minute per IP (15-minute throttle on breach) and per-hour file caps by type
  (catalog 600, inventory 360, ASN 300, order updates 200, pricing 120, prep time 100, manual
  invoice 20). Exhaustion returns HTTP 403 with "rate limited".
- **Orders are keyed by po-number AND po-date together.** Storing only the number makes the refund
  status lookup impossible.
- **A refund cannot be reversed, and an order already marked returned will silently reject further
  adjustments** — Seller Portal accepts the file with a 200 and the order management system
  rejects it downstream. Always confirm with the refund status lookup.

## Documentation

- API Guide (hub): https://marketplace.sears.com/docs/api-guide/
- API Guide PDF: https://marketplace.sears.com/wp-content/uploads/MP_API_Guide.pdf
- Credentials and authentication: https://marketplace.sears.com/docs/api-guide/using-sear-marketplace-apis-for-xml-integration/credentials-and-authentication/
- API limits: https://marketplace.sears.com/docs/api-guide/using-sear-marketplace-apis-for-xml-integration/api-limits/
- General error handling: https://marketplace.sears.com/docs/api-guide/using-sear-marketplace-apis-for-xml-integration/general-error-handling/
- Current API versions: https://marketplace.sears.com/docs/api-guide/current-api-versions/
- Sandbox: https://marketplace.sears.com/docs/api-guide/sandbox-environment/
- Error message reference: https://marketplace.sears.com/seller-support/error-messages/
- Seller support knowledge base: https://marketplace.sears.com/seller-support/
- Integration partners: https://marketplace.sears.com/integration-partners/

## Authentication

HMAC-SHA256 request signing. No OAuth, no API key header, no bearer token.

- Header: `Authorization: HMAC-SHA256 emailaddress=<email>,timestamp=<timestamp>,signature=<sig>`
- String to sign: `<sellerId>:<emailaddress>:<currentTimestamp>`
- Timestamp: UTC, `yyyy-MM-dd'T'HH:mm:ss'Z'`, valid 30 minutes
- Signature encoding: hexadecimal
- Secret: base64 seller key, self-generated in Seller Portal under Account Info
- Email/password in the URL was removed on 2016-03-31 and such calls are now rejected

## Operations

Order management
- GET /oms/purchaseorder/v19?sellerId={} — retrieve purchase orders
- PUT /oms/asn/v7?sellerId={} — advance ship notice, closes order lines
- PUT /oms/order/cancel/v1?sellerId={} — cancel order lines
- GET /oms/cancellationrequest/v1?sellerId={}&status={}&fromdate={}&todate={} — customer cancellation requests
- PUT /oms/order/adjustment/v5?sellerId={} — refunds and returns
- GET /oms/orderadjustment/v3?sellerId={}&ponumber={}&podate={} — refund status lookup
- GET /oms/returnsrequest/v1?sellerId={} — customer return requests
- PUT /oms/returnsresponse/v1?sellerId={} — respond to a return request
- GET /oms/shipping-carrier/v1?sellerId={} — carrier and shipping method list
- GET /oms/remittance/v9?sellerId={} — remittance report

Catalog, inventory and pricing
- PUT /catalog/fbm/v25?sellerId={} — create or update items
- PUT /catalog/skinny-fbm/v1?sellerId={} — contentless offers on existing Sears catalog items
- PUT /catalog/service-item/v1?sellerId={} — delivery and installation service options
- GET /itemclasses/v2?sellerId={} — item class library
- GET /attributes/v4/?itemClassId={} — attribute library for an item class
- PUT /inventory/fbm/v7?sellerId={} — bulk inventory update
- PUT /inventory/1x1/fbm/v1?sellerId={} — single-item inventory update
- GET /inventory/v5?sellerId={} — inventory export
- PUT /pricing/fbm/v6?sellerId={} — price update
- PUT /sopt/import/v3?sellerId={} — order prep / lead time

Reports
- GET /reports/v1/processing-report/{document-id}?sellerId={} — did my PUT actually work
- GET /reports/removedItems/v1?sellerId={} — items Sears removed
- GET /reports/contentMatch/v1?sellerId={} — content match results

## Commercials

- Program fee: USD 39.99 per month, charged once monthly gross sales reach USD 400
- Commission: 8%–20% by category, applied to both product price and shipping price
  (Gaming Consoles 8%, Consumables 9%, Automotive 12%, most categories 15%, Seasonal 17%,
  Jewelry 20%). Per-subcategory rates are published only inside Seller Portal.
- Pricing page: https://marketplace.sears.com/sell-on-sears/program-fees/
- Apply: https://marketplace.sears.com/sell-on-sears/
- Terms: https://marketplace.sears.com/terms-of-use/

## Artifacts in this profile

- xsd/_index.yml — 33 provider-published XML Schema Definitions, fetched verbatim
- examples/_index.yml — 25 provider-published sample XML documents
- authentication/sears-holdings-authentication.yml
- conventions/sears-holdings-conventions.yml — write model, versioning, reversibility
- errors/sears-holdings-problem-types.yml — 29 documented errors and both error envelopes
- data-model/sears-holdings-data-model.yml — 25 entities, 22 relationships
- lifecycle/sears-holdings-lifecycle.yml — per-API versions and deprecation posture
- changelog/sears-holdings-changelog.yml — dated releases, latest 2022-12-15
- rate-limits/sears-holdings-rate-limits.yml
- plans/sears-holdings-plans-pricing.yml
- sandbox/sears-holdings-sandbox.yml
- conformance/sears-holdings-conformance.yml — including GS1 GTIN/UPC in-contract signature
- security/sears-holdings-domain-security.yml
- well-known/sears-holdings-well-known.yml — a recorded absence, every path probed
- mcp/sears-holdings-mcp.yml — candidate tool surface only; no server exists
- skills/ — packaged agent skills for the three marquee seller flows

## What does not exist

No OpenAPI. No GraphQL. No WSDL. No protobuf. No AsyncAPI, webhooks or event stream. No MCP
server. No A2A agent card. No /.well-known/ document of any kind on any host. No status page. No
published SLA. No first-party SDK in any language. No trust center or published certifications.