naftiko: 1.0.0-alpha2 info: label: Walmart Order Management — Orders description: 'Walmart Order Management — Orders. 7 operations. Lead operation: Walmart All Orders. Self-contained Naftiko capability covering one Walmart business surface.' tags: - Walmart - Orders created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: WALMART_API_KEY: WALMART_API_KEY capability: consumes: - type: http namespace: marketplace-orders-orders baseUri: https://marketplace.walmartapis.com description: Walmart Order Management — Orders business capability. Self-contained, no shared references. resources: - name: v3-orders path: /v3/orders operations: - name: getallorders method: GET description: Walmart All Orders outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: sku in: query type: string description: A seller-provided Product ID - name: customerOrderId in: query type: string description: The customer order ID - name: purchaseOrderId in: query type: string description: The purchase order ID. One customer may have multiple purchase orders. - name: status in: query type: string description: 'Status of purchase order line. Valid statuses are: Created, Acknowledged, Shipped, Delivered and Cancelled.' - name: createdStartDate in: query type: string description: 'Fetches all purchase orders that were created after this date. Default is current date - 7 days. Use either UTC or ISO 8601 formats. Date example: ''2020-03-16''(' - name: createdEndDate in: query type: string description: 'Fetches all purchase orders that were created before this date. Default is current date. Use either UTC or ISO 8601 formats. Date example: ''2020-03-16''(yyyy-MM-' - name: fromExpectedShipDate in: query type: string description: 'Fetches all purchase orders that have order lines with an expected ship date after this date. Use either UTC or ISO 8601 formats. Date example: ''2020-03-16''(yyy' - name: toExpectedShipDate in: query type: string description: 'Fetches all purchase orders that have order lines with an expected ship date before this date. Use either UTC or ISO 8601 formats. Date example: ''2020-03-16''(yy' - name: lastModifiedStartDate in: query type: string description: 'Fetches all purchase orders that were modified after this date. Use either UTC or ISO 8601 formats. Date example: ''2020-03-16''(yyyy-MM-dd). Date with Timestamp ' - name: lastModifiedEndDate in: query type: string description: 'Fetches all purchase orders that were modified before this date. Use either UTC or ISO 8601 formats. Date example: ''2020-03-16''(yyyy-MM-dd). Date with Timestamp' - name: limit in: query type: string description: The number of orders to be returned. Cannot be larger than 200. - name: productInfo in: query type: string description: Provides the image URL and product weight in response, if available. Allowed values are true or false. - name: shipNodeType in: query type: string description: Specifies the type of shipNode. Allowed values are SellerFulfilled(Default), WFSFulfilled and 3PLFulfilled. - name: shippingProgramType in: query type: string description: Specifies the type of program. Allowed value is TWO_DAY, ONE_DAY. - name: replacementInfo in: query type: string description: Provides additional attributes - originalCustomerOrderID, orderType - related to Replacement order, in response, if available. Allowed values are true or false. - name: orderType in: query type: string description: Specifies if the order is a regular order or replacement order. Possible values are REGULAR or REPLACEMENT. Provided in response only if query parameter replace - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: v3-orders-released path: /v3/orders/released operations: - name: getallreleasedorders method: GET description: Walmart All Released Orders outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: createdStartDate in: query type: string description: 'Fetches all purchase orders that were created after this date. Default is current date - 7 days. Use either UTC or ISO 8601 formats. Date example: ''2020-03-16''(' - name: createdEndDate in: query type: string description: 'Fetches all purchase orders that were created before this date. Default is current date. Use either UTC or ISO 8601 formats. Date example: ''2020-03-16''(yyyy-MM-' - name: limit in: query type: string description: The number of orders to be returned. Cannot be larger than 200. - name: productInfo in: query type: string description: Provides the image URL and product weight in response, if available. Allowed values are true or false. - name: shipNodeType in: query type: string description: Specifies the type of shipNode. Allowed values are SellerFulfilled(Default), WFSFulfilled and 3PLFulfilled. - name: sku in: query type: string description: A seller-provided Product ID - name: customerOrderId in: query type: string description: The customer order ID - name: purchaseOrderId in: query type: string description: The purchase order ID. One customer may have multiple purchase orders. - name: fromExpectedShipDate in: query type: string description: 'Fetches all purchase orders that have order lines with an expected ship date after this date. Use either UTC or ISO 8601 formats. Date example: ''2020-03-16''(yyy' - name: toExpectedShipDate in: query type: string description: 'Fetches all purchase orders that have order lines with an expected ship date before this date. Use either UTC or ISO 8601 formats. Date example: ''2020-03-16''(yy' - name: shippingProgramType in: query type: string description: Specifies the type of program. Allowed value is TWO_DAY, ONE_DAY. - name: replacementInfo in: query type: string description: Provides additional attributes - originalCustomerOrderID, orderType - related to Replacement order, in response, if available. Allowed values are true or false. - name: orderType in: query type: string description: Specifies if the order is a regular order or replacement order. Possible values are REGULAR or REPLACEMENT. Provided in response only if query parameter replace - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: v3-orders-purchaseOrderId path: /v3/orders/{purchaseOrderId} operations: - name: getanorder method: GET description: Walmart an Order outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: purchaseOrderId in: path type: string description: purchaseOrderId required: true - name: productInfo in: query type: string description: Provides the image URL and product weight in response, if available. Allowed values are true or false. - name: replacementInfo in: query type: string description: Provides additional attributes - originalCustomerOrderID, orderType - related to Replacement order, in response, if available. Allowed values are true or false. - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: v3-orders-purchaseOrderId-acknowledge path: /v3/orders/{purchaseOrderId}/acknowledge operations: - name: acknowledgeorders method: POST description: Walmart Acknowledge Orders outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: purchaseOrderId in: path type: string description: purchaseOrderId required: true - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: v3-orders-purchaseOrderId-cancel path: /v3/orders/{purchaseOrderId}/cancel operations: - name: cancelorderlines method: POST description: Walmart Cancel Order Lines outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: purchaseOrderId in: path type: string description: purchaseOrderId required: true - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: v3-orders-purchaseOrderId-refund path: /v3/orders/{purchaseOrderId}/refund operations: - name: refundorderlines method: POST description: Walmart Refund Order Lines outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: purchaseOrderId in: path type: string description: purchaseOrderId required: true - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: v3-orders-purchaseOrderId-shipping path: /v3/orders/{purchaseOrderId}/shipping operations: - name: shippingupdates method: POST description: Walmart Ship Order Lines outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: purchaseOrderId in: path type: string description: purchaseOrderId required: true - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: body in: body type: object description: Request body (JSON). required: true exposes: - type: rest namespace: marketplace-orders-orders-rest port: 8080 description: REST adapter for Walmart Order Management — Orders. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/v3/orders name: v3-orders description: REST surface for v3-orders. operations: - method: GET name: getallorders description: Walmart All Orders call: marketplace-orders-orders.getallorders with: sku: rest.sku customerOrderId: rest.customerOrderId purchaseOrderId: rest.purchaseOrderId status: rest.status createdStartDate: rest.createdStartDate createdEndDate: rest.createdEndDate fromExpectedShipDate: rest.fromExpectedShipDate toExpectedShipDate: rest.toExpectedShipDate lastModifiedStartDate: rest.lastModifiedStartDate lastModifiedEndDate: rest.lastModifiedEndDate limit: rest.limit productInfo: rest.productInfo shipNodeType: rest.shipNodeType shippingProgramType: rest.shippingProgramType replacementInfo: rest.replacementInfo orderType: rest.orderType WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - path: /v1/v3/orders/released name: v3-orders-released description: REST surface for v3-orders-released. operations: - method: GET name: getallreleasedorders description: Walmart All Released Orders call: marketplace-orders-orders.getallreleasedorders with: createdStartDate: rest.createdStartDate createdEndDate: rest.createdEndDate limit: rest.limit productInfo: rest.productInfo shipNodeType: rest.shipNodeType sku: rest.sku customerOrderId: rest.customerOrderId purchaseOrderId: rest.purchaseOrderId fromExpectedShipDate: rest.fromExpectedShipDate toExpectedShipDate: rest.toExpectedShipDate shippingProgramType: rest.shippingProgramType replacementInfo: rest.replacementInfo orderType: rest.orderType WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - path: /v1/v3/orders/{purchaseorderid} name: v3-orders-purchaseorderid description: REST surface for v3-orders-purchaseOrderId. operations: - method: GET name: getanorder description: Walmart an Order call: marketplace-orders-orders.getanorder with: purchaseOrderId: rest.purchaseOrderId productInfo: rest.productInfo replacementInfo: rest.replacementInfo WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - path: /v1/v3/orders/{purchaseorderid}/acknowledge name: v3-orders-purchaseorderid-acknowledge description: REST surface for v3-orders-purchaseOrderId-acknowledge. operations: - method: POST name: acknowledgeorders description: Walmart Acknowledge Orders call: marketplace-orders-orders.acknowledgeorders with: purchaseOrderId: rest.purchaseOrderId WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - path: /v1/v3/orders/{purchaseorderid}/cancel name: v3-orders-purchaseorderid-cancel description: REST surface for v3-orders-purchaseOrderId-cancel. operations: - method: POST name: cancelorderlines description: Walmart Cancel Order Lines call: marketplace-orders-orders.cancelorderlines with: purchaseOrderId: rest.purchaseOrderId WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v3/orders/{purchaseorderid}/refund name: v3-orders-purchaseorderid-refund description: REST surface for v3-orders-purchaseOrderId-refund. operations: - method: POST name: refundorderlines description: Walmart Refund Order Lines call: marketplace-orders-orders.refundorderlines with: purchaseOrderId: rest.purchaseOrderId WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v3/orders/{purchaseorderid}/shipping name: v3-orders-purchaseorderid-shipping description: REST surface for v3-orders-purchaseOrderId-shipping. operations: - method: POST name: shippingupdates description: Walmart Ship Order Lines call: marketplace-orders-orders.shippingupdates with: purchaseOrderId: rest.purchaseOrderId WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME body: rest.body outputParameters: - type: object mapping: $. - type: mcp namespace: marketplace-orders-orders-mcp port: 9090 transport: http description: MCP adapter for Walmart Order Management — Orders. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: walmart-all-orders description: Walmart All Orders hints: readOnly: true destructive: false idempotent: true call: marketplace-orders-orders.getallorders with: sku: tools.sku customerOrderId: tools.customerOrderId purchaseOrderId: tools.purchaseOrderId status: tools.status createdStartDate: tools.createdStartDate createdEndDate: tools.createdEndDate fromExpectedShipDate: tools.fromExpectedShipDate toExpectedShipDate: tools.toExpectedShipDate lastModifiedStartDate: tools.lastModifiedStartDate lastModifiedEndDate: tools.lastModifiedEndDate limit: tools.limit productInfo: tools.productInfo shipNodeType: tools.shipNodeType shippingProgramType: tools.shippingProgramType replacementInfo: tools.replacementInfo orderType: tools.orderType WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $. - name: walmart-all-released-orders description: Walmart All Released Orders hints: readOnly: true destructive: false idempotent: true call: marketplace-orders-orders.getallreleasedorders with: createdStartDate: tools.createdStartDate createdEndDate: tools.createdEndDate limit: tools.limit productInfo: tools.productInfo shipNodeType: tools.shipNodeType sku: tools.sku customerOrderId: tools.customerOrderId purchaseOrderId: tools.purchaseOrderId fromExpectedShipDate: tools.fromExpectedShipDate toExpectedShipDate: tools.toExpectedShipDate shippingProgramType: tools.shippingProgramType replacementInfo: tools.replacementInfo orderType: tools.orderType WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $. - name: walmart-order description: Walmart an Order hints: readOnly: true destructive: false idempotent: true call: marketplace-orders-orders.getanorder with: purchaseOrderId: tools.purchaseOrderId productInfo: tools.productInfo replacementInfo: tools.replacementInfo WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $. - name: walmart-acknowledge-orders description: Walmart Acknowledge Orders hints: readOnly: false destructive: false idempotent: false call: marketplace-orders-orders.acknowledgeorders with: purchaseOrderId: tools.purchaseOrderId WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $. - name: walmart-cancel-order-lines description: Walmart Cancel Order Lines hints: readOnly: false destructive: false idempotent: false call: marketplace-orders-orders.cancelorderlines with: purchaseOrderId: tools.purchaseOrderId WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME body: tools.body outputParameters: - type: object mapping: $. - name: walmart-refund-order-lines description: Walmart Refund Order Lines hints: readOnly: false destructive: false idempotent: false call: marketplace-orders-orders.refundorderlines with: purchaseOrderId: tools.purchaseOrderId WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME body: tools.body outputParameters: - type: object mapping: $. - name: walmart-ship-order-lines description: Walmart Ship Order Lines hints: readOnly: false destructive: false idempotent: false call: marketplace-orders-orders.shippingupdates with: purchaseOrderId: tools.purchaseOrderId WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME body: tools.body outputParameters: - type: object mapping: $.