@86d-app/walmart

The Modern Foundation for Commerce

X · LinkedIn

This project is under active development and is not ready for production use.

Walmart Module

Documentation: 86d.app/docs/modules/walmart

Integrates your 86d store with Walmart Marketplace for item management, feed submissions, order fulfillment, and inventory tracking. Supports both seller-fulfilled and Walmart Fulfillment Services (WFS) items.

Installation

npm install @86d-app/walmart

Usage

import walmart from "@86d-app/walmart";

const module = walmart({
  clientId: "your-client-id",
  clientSecret: "your-client-secret",
  partnerId: "your-partner-id",
});

Configuration

Option	Type	Default	Description
clientId	string	-	Walmart API client ID
clientSecret	string	-	Walmart API client secret
partnerId	string	-	Walmart partner ID

Admin Endpoints

Method	Path	Description
GET	/admin/walmart/items	List items with optional status, fulfillment type, page, and limit filters
POST	/admin/walmart/items/create	Create a new marketplace item
GET	/admin/walmart/items/health	Get item health breakdown by status and fulfillment type
GET	/admin/walmart/items/:id	Get a single item by ID
PUT	/admin/walmart/items/:id/update	Update item fields
PUT	/admin/walmart/items/:id/retire	Retire an item (sets status to retired, lifecycle to archived)
GET	/admin/walmart/orders	List orders with optional status, page, and limit filters
PUT	/admin/walmart/orders/:id/acknowledge	Acknowledge an order
PUT	/admin/walmart/orders/:id/ship	Ship an order with tracking number and carrier
PUT	/admin/walmart/orders/:id/cancel	Cancel an order
GET	/admin/walmart/feeds	List feed submissions with optional type and status filters
POST	/admin/walmart/feeds/submit	Submit a feed (item, inventory, price, or order)
GET	/admin/walmart/stats	Get channel statistics

Store Endpoints

Method	Path	Description
POST	/walmart/webhooks	Receive Walmart webhook events

Controller API

interface WalmartController extends ModuleController {
  createItem(params: { localProductId: string; sku: string; title: string; price: number; ... }): Promise<WalmartItem>;
  updateItem(id: string, params: Partial<WalmartItem>): Promise<WalmartItem | null>;
  retireItem(id: string): Promise<WalmartItem | null>;
  getItem(id: string): Promise<WalmartItem | null>;
  getItemByProduct(productId: string): Promise<WalmartItem | null>;
  listItems(params?: { status?; fulfillmentType?; take?; skip? }): Promise<WalmartItem[]>;
  submitFeed(feedType: FeedType): Promise<FeedSubmission>;
  getLastFeed(feedType: FeedType): Promise<FeedSubmission | null>;
  listFeeds(params?: { feedType?; status?; take?; skip? }): Promise<FeedSubmission[]>;
  receiveOrder(params: { purchaseOrderId: string; items: unknown[]; ... }): Promise<WalmartOrder>;
  acknowledgeOrder(id: string): Promise<WalmartOrder | null>;
  shipOrder(id: string, trackingNumber: string, carrier: string): Promise<WalmartOrder | null>;
  cancelOrder(id: string): Promise<WalmartOrder | null>;
  listOrders(params?: { status?; take?; skip? }): Promise<WalmartOrder[]>;
  getChannelStats(): Promise<ChannelStats>;
  getItemHealth(): Promise<ItemHealth>;
}

Types

• WalmartItem -- Marketplace item with SKU, UPC/GTIN identifiers, pricing, inventory quantity, and fulfillment type (seller vs WFS)
• WalmartOrder -- Purchase order with Walmart-specific fee breakdown (orderTotal, shippingTotal, walmartFee, tax) and shipping tracking
• FeedSubmission -- Feed job record for item/inventory/price/order feed types with success/error item counts
• ItemHealth -- Health breakdown by status (published, unpublished, retired, system-error) and fulfillment type

Notes

• Item statuses: published, unpublished, retired, system-error
• Lifecycle statuses: active, archived
• Fulfillment types: seller (merchant-fulfilled), wfs (Walmart Fulfillment Services)
• Order flow: created -> acknowledged -> shipped -> delivered
• Feed types: item, inventory, price, order
• retireItem() archives the item (sets status to retired, lifecycle to archived)
• Admin page appears under the Sales group with the Store icon
• Admin and store endpoints are fully wired via createAdminEndpoint and createStoreEndpoint