naftiko: 1.0.0-alpha2
info:
  label: Walmart DSV Order Management — DSV Orders
  description: 'Walmart DSV Order Management — DSV Orders. 6 operations. Lead operation: Walmart Retrieve All Orders. Self-contained
    Naftiko capability covering one Walmart business surface.'
  tags:
  - Walmart
  - DSV Orders
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WALMART_API_KEY: WALMART_API_KEY
capability:
  consumes:
  - type: http
    namespace: dropship-vendor-orders-dsv-orders
    baseUri: https://api-gateway.walmart.com
    description: Walmart DSV Order Management — DSV Orders business capability. Self-contained, no shared references.
    resources:
    - name: v3-orders
      path: /v3/orders
      operations:
      - name: getallorders
        method: GET
        description: Walmart Retrieve All Orders
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shipNode
          in: query
          type: string
          description: Specifies the distribution facility distributor identifier.
          required: true
        - name: limit
          in: query
          type: string
          description: 'Specifies the number of orders to be returned. '
        - name: sku
          in: query
          type: string
          description: Specifies the stock keeping unit (SKU) item identifier.
        - name: customerOrderId
          in: query
          type: string
          description: Specifies an identifier associated with the sales orders to retrieve or filter the orders.
        - name: purchaseOrderId
          in: query
          type: string
          description: 'Specifies an identifier associated with the purchase order. '
        - name: status
          in: query
          type: string
          description: 'Specifies the status of the purchase order line. '
        - name: createdStartDate
          in: query
          type: string
          description: 'Specifies the created start date for the query. '
        - name: createdEndDate
          in: query
          type: string
          description: 'Specifies the created end date for the query. '
        - name: fromExpectedShipDate
          in: query
          type: string
          description: 'Specifies the "from" expected ship date for the query. '
        - name: toExpectedShipDate
          in: query
          type: string
          description: 'Specifies the "to" expected ship date for the query. '
        - name: productInfo
          in: query
          type: string
          description: Specifies the image URL and product weight in the response, if available.
        - name: Accept
          in: header
          type: string
          description: Specifies the data type expected in a response sent from the server.
        - name: WM_CONSUMER.CHANNEL.TYPE
          in: header
          type: string
          description: Specifies an identifier that tracks the consumer request by channel.
        - name: WM_QOS.CORRELATION_ID
          in: header
          type: string
          description: Specifies an identifier for each API call and is used to track and debug issues.
          required: true
        - name: WM_SEC.ACCESS_TOKEN
          in: header
          type: string
          description: Specifies the access token retrieved in the <a href="https://developer.walmart.com/api/us/supplier/auth#operation/dsvTokenAPI">Create
            Access Token</a> request.
          required: true
    - name: v3-orders-released
      path: /v3/orders/released
      operations:
      - name: getallreleasedorders
        method: GET
        description: Walmart Retrieve All Released Orders
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: shipNode
          in: query
          type: string
          description: Specifies the distribution facility distributor identifier.
          required: true
        - name: limit
          in: query
          type: string
          description: 'Specifies the number of orders to be returned. '
        - name: sku
          in: query
          type: string
          description: Specifies the stock keeping unit (SKU) item identifier.
        - name: customerOrderId
          in: query
          type: string
          description: Specifies an identifier associated with the sales orders to retrieve or filter the orders.
        - name: purchaseOrderId
          in: query
          type: string
          description: 'Specifies an identifier associated with the purchase order. '
        - name: createdStartDate
          in: query
          type: string
          description: 'Specifies the created start date for the query. '
        - name: createdEndDate
          in: query
          type: string
          description: 'Specifies the created end date for the query. '
        - name: fromExpectedShipDate
          in: query
          type: string
          description: 'Specifies the "from" expected ship date for the query. '
        - name: toExpectedShipDate
          in: query
          type: string
          description: 'Specifies the "to" expected ship date for the query. '
        - name: productInfo
          in: query
          type: string
          description: Specifies the image URL and product weight in the response, if available.
        - name: Accept
          in: header
          type: string
          description: Specifies the data type expected in a response sent from the server.
        - name: WM_CONSUMER.CHANNEL.TYPE
          in: header
          type: string
          description: Specifies an identifier that tracks the consumer request by channel.
        - name: WM_QOS.CORRELATION_ID
          in: header
          type: string
          description: Specifies an identifier for each API call and is used to track and debug issues.
          required: true
        - name: WM_SEC.ACCESS_TOKEN
          in: header
          type: string
          description: Specifies the access token retrieved in the <a href="https://developer.walmart.com/api/us/supplier/auth#operation/dsvTokenAPI">Create
            Access Token</a> request.
          required: true
    - name: v3-orders-purchaseOrderId
      path: /v3/orders/{purchaseOrderId}
      operations:
      - name: getanorder
        method: GET
        description: Walmart Retrieve a Single Order
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: purchaseOrderId
          in: path
          type: string
          description: Specifies an identifier associated with the purchase order.
          required: true
        - name: shipNode
          in: query
          type: string
          description: Specifies the distribution facility distributor identifier.
          required: true
        - name: productInfo
          in: query
          type: string
          description: Specifies the image URL and product weight in the response, if available.
        - name: Accept
          in: header
          type: string
          description: Specifies the data type expected in a response sent from the server.
        - name: WM_CONSUMER.CHANNEL.TYPE
          in: header
          type: string
          description: Specifies an identifier that tracks the consumer request by channel.
        - name: WM_QOS.CORRELATION_ID
          in: header
          type: string
          description: Specifies an identifier for each API call and is used to track and debug issues.
          required: true
        - name: WM_SEC.ACCESS_TOKEN
          in: header
          type: string
          description: Specifies the access token retrieved in the <a href="https://developer.walmart.com/api/us/supplier/auth#operation/dsvTokenAPI">Create
            Access Token</a> request.
          required: true
    - name: v3-orders-purchaseOrderId-acknowledge
      path: /v3/orders/{purchaseOrderId}/acknowledge
      operations:
      - name: postacknowledgeorders
        method: POST
        description: Walmart Acknowledge Orders
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: purchaseOrderId
          in: path
          type: string
          description: Specifies an identifier associated with the purchase order.
          required: true
        - name: shipNode
          in: query
          type: string
          description: Specifies the distribution facility distributor identifier.
          required: true
        - name: Accept
          in: header
          type: string
          description: Specifies the data type expected in a response sent from the server.
        - name: WM_CONSUMER.CHANNEL.TYPE
          in: header
          type: string
          description: Specifies an identifier that tracks the consumer request by channel.
        - name: WM_QOS.CORRELATION_ID
          in: header
          type: string
          description: Specifies an identifier for each API call and is used to track and debug issues.
          required: true
        - name: WM_SEC.ACCESS_TOKEN
          in: header
          type: string
          description: Specifies the access token retrieved in the <a href="https://developer.walmart.com/api/us/supplier/auth#operation/dsvTokenAPI">Create
            Access Token</a> request.
          required: true
        - name: Content-Type
          in: header
          type: string
          description: 'Specifies the format of request and response body data. '
          required: true
    - name: v3-orders-purchaseOrderId-cancel
      path: /v3/orders/{purchaseOrderId}/cancel
      operations:
      - name: postcancelorderlines
        method: POST
        description: Walmart Cancel Order Lines
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: purchaseOrderId
          in: path
          type: string
          description: Specifies an identifier associated with the purchase order.
          required: true
        - name: shipNode
          in: query
          type: string
          description: Specifies the distribution facility distributor identifier.
          required: true
        - name: Accept
          in: header
          type: string
          description: Specifies the data type expected in a response sent from the server.
        - name: WM_CONSUMER.CHANNEL.TYPE
          in: header
          type: string
          description: Specifies an identifier that tracks the consumer request by channel.
        - name: WM_QOS.CORRELATION_ID
          in: header
          type: string
          description: Specifies an identifier for each API call and is used to track and debug issues.
          required: true
        - name: WM_SEC.ACCESS_TOKEN
          in: header
          type: string
          description: Specifies the access token retrieved in the <a href="https://developer.walmart.com/api/us/supplier/auth#operation/dsvTokenAPI">Create
            Access Token</a> request.
          required: true
        - name: Content-Type
          in: header
          type: string
          description: 'Specifies the format of request and response body data. '
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v3-orders-purchaseOrderId-shipping
      path: /v3/orders/{purchaseOrderId}/shipping
      operations:
      - name: postshiporderlines
        method: POST
        description: Walmart Ship One or More Purchase Order Lines
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: purchaseOrderId
          in: path
          type: string
          description: Specifies an identifier associated with the purchase order.
          required: true
        - name: shipNode
          in: query
          type: string
          description: Specifies the distribution facility distributor identifier.
          required: true
        - name: Accept
          in: header
          type: string
          description: Specifies the data type expected in a response sent from the server.
        - name: WM_CONSUMER.CHANNEL.TYPE
          in: header
          type: string
          description: Specifies an identifier that tracks the consumer request by channel.
        - name: WM_QOS.CORRELATION_ID
          in: header
          type: string
          description: Specifies an identifier for each API call and is used to track and debug issues.
          required: true
        - name: WM_SEC.ACCESS_TOKEN
          in: header
          type: string
          description: Specifies the access token retrieved in the <a href="https://developer.walmart.com/api/us/supplier/auth#operation/dsvTokenAPI">Create
            Access Token</a> request.
          required: true
        - name: Content-Type
          in: header
          type: string
          description: 'Specifies the format of request and response body data. '
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
  exposes:
  - type: rest
    namespace: dropship-vendor-orders-dsv-orders-rest
    port: 8080
    description: REST adapter for Walmart DSV Order Management — DSV 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 Retrieve All Orders
        call: dropship-vendor-orders-dsv-orders.getallorders
        with:
          shipNode: rest.shipNode
          limit: rest.limit
          sku: rest.sku
          customerOrderId: rest.customerOrderId
          purchaseOrderId: rest.purchaseOrderId
          status: rest.status
          createdStartDate: rest.createdStartDate
          createdEndDate: rest.createdEndDate
          fromExpectedShipDate: rest.fromExpectedShipDate
          toExpectedShipDate: rest.toExpectedShipDate
          productInfo: rest.productInfo
          Accept: rest.Accept
          WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE
          WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID
          WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN
        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 Retrieve All Released Orders
        call: dropship-vendor-orders-dsv-orders.getallreleasedorders
        with:
          shipNode: rest.shipNode
          limit: rest.limit
          sku: rest.sku
          customerOrderId: rest.customerOrderId
          purchaseOrderId: rest.purchaseOrderId
          createdStartDate: rest.createdStartDate
          createdEndDate: rest.createdEndDate
          fromExpectedShipDate: rest.fromExpectedShipDate
          toExpectedShipDate: rest.toExpectedShipDate
          productInfo: rest.productInfo
          Accept: rest.Accept
          WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE
          WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID
          WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN
        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 Retrieve a Single Order
        call: dropship-vendor-orders-dsv-orders.getanorder
        with:
          purchaseOrderId: rest.purchaseOrderId
          shipNode: rest.shipNode
          productInfo: rest.productInfo
          Accept: rest.Accept
          WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE
          WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID
          WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN
        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: postacknowledgeorders
        description: Walmart Acknowledge Orders
        call: dropship-vendor-orders-dsv-orders.postacknowledgeorders
        with:
          purchaseOrderId: rest.purchaseOrderId
          shipNode: rest.shipNode
          Accept: rest.Accept
          WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE
          WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID
          WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN
          Content-Type: rest.Content-Type
        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: postcancelorderlines
        description: Walmart Cancel Order Lines
        call: dropship-vendor-orders-dsv-orders.postcancelorderlines
        with:
          purchaseOrderId: rest.purchaseOrderId
          shipNode: rest.shipNode
          Accept: rest.Accept
          WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE
          WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID
          WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN
          Content-Type: rest.Content-Type
          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: postshiporderlines
        description: Walmart Ship One or More Purchase Order Lines
        call: dropship-vendor-orders-dsv-orders.postshiporderlines
        with:
          purchaseOrderId: rest.purchaseOrderId
          shipNode: rest.shipNode
          Accept: rest.Accept
          WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE
          WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID
          WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN
          Content-Type: rest.Content-Type
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: dropship-vendor-orders-dsv-orders-mcp
    port: 9090
    transport: http
    description: MCP adapter for Walmart DSV Order Management — DSV Orders. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: walmart-retrieve-all-orders
      description: Walmart Retrieve All Orders
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dropship-vendor-orders-dsv-orders.getallorders
      with:
        shipNode: tools.shipNode
        limit: tools.limit
        sku: tools.sku
        customerOrderId: tools.customerOrderId
        purchaseOrderId: tools.purchaseOrderId
        status: tools.status
        createdStartDate: tools.createdStartDate
        createdEndDate: tools.createdEndDate
        fromExpectedShipDate: tools.fromExpectedShipDate
        toExpectedShipDate: tools.toExpectedShipDate
        productInfo: tools.productInfo
        Accept: tools.Accept
        WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE
        WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID
        WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN
      outputParameters:
      - type: object
        mapping: $.
    - name: walmart-retrieve-all-released-orders
      description: Walmart Retrieve All Released Orders
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dropship-vendor-orders-dsv-orders.getallreleasedorders
      with:
        shipNode: tools.shipNode
        limit: tools.limit
        sku: tools.sku
        customerOrderId: tools.customerOrderId
        purchaseOrderId: tools.purchaseOrderId
        createdStartDate: tools.createdStartDate
        createdEndDate: tools.createdEndDate
        fromExpectedShipDate: tools.fromExpectedShipDate
        toExpectedShipDate: tools.toExpectedShipDate
        productInfo: tools.productInfo
        Accept: tools.Accept
        WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE
        WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID
        WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN
      outputParameters:
      - type: object
        mapping: $.
    - name: walmart-retrieve-single-order
      description: Walmart Retrieve a Single Order
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: dropship-vendor-orders-dsv-orders.getanorder
      with:
        purchaseOrderId: tools.purchaseOrderId
        shipNode: tools.shipNode
        productInfo: tools.productInfo
        Accept: tools.Accept
        WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE
        WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID
        WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN
      outputParameters:
      - type: object
        mapping: $.
    - name: walmart-acknowledge-orders
      description: Walmart Acknowledge Orders
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: dropship-vendor-orders-dsv-orders.postacknowledgeorders
      with:
        purchaseOrderId: tools.purchaseOrderId
        shipNode: tools.shipNode
        Accept: tools.Accept
        WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE
        WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID
        WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN
        Content-Type: tools.Content-Type
      outputParameters:
      - type: object
        mapping: $.
    - name: walmart-cancel-order-lines
      description: Walmart Cancel Order Lines
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: dropship-vendor-orders-dsv-orders.postcancelorderlines
      with:
        purchaseOrderId: tools.purchaseOrderId
        shipNode: tools.shipNode
        Accept: tools.Accept
        WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE
        WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID
        WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN
        Content-Type: tools.Content-Type
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: walmart-ship-one-more-purchase
      description: Walmart Ship One or More Purchase Order Lines
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: dropship-vendor-orders-dsv-orders.postshiporderlines
      with:
        purchaseOrderId: tools.purchaseOrderId
        shipNode: tools.shipNode
        Accept: tools.Accept
        WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE
        WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID
        WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN
        Content-Type: tools.Content-Type
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.