[!WARNING] This project is under active development and is not ready for production use.

Walmart Module

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