walmart 2024年的api 更新 订单和退货API更新–必需！)必须在2024年4月30日前更新订单和退货API

订单和退货API更新–必需！

 2023年6月20日

沃尔玛推出了一项新功能，使市场卖家能够接收和管理多数量订单，以帮助节省时间和减少订单管理的模糊性。

注意:API用户(卖家和渠道合作伙伴)必须在2024年4月30日前更新订单和退货API。未能在2024年4月30日前更新您的API可能会影响您履行和管理多数量订单的能力。 

有什么新鲜事？ 

订单API 

1. 转至发运订单行:添加新块:当前跟踪信息(可选)
2. 货件完成后，如果您需要在一个有多个货件的订单中更新跟踪编号，您必须在currentTrackingInfo字段中传递要更新的跟踪编号，以更新跟踪详细信息。
   注意:订单标记为已发货后，您可以在4小时内多次更新跟踪编号。
3. 如需详细资讯，请参阅装运订单行引用中的API。
4. 在订单请求和响应有效负载中，字段“数量”可以大于1。以前，它总是等于1。
   注意:请更新您的系统以确保金额未设置为始终等于1。这将影响您接收和履行多数量订单的能力

退货API 

1. 去…Returns -> returnOrders数组-> returnOrderLine。添加新对象:
2. currentTrackingStatuses–订单中已退回的所有数量的当前状态(如已启动、已退款等)。)
3. 退款渠道——与订单中退回的所有分位数相关的退款渠道(如商店、网上等。)
4. 如需详细资讯，请参阅退货API在参考文献中。
   注:退货API中的以下现有字段将于4月30日弃用泰国(Thailand), 2024.更新您的API以添加新字段，从而确保不会影响您的退货管理
5. t

6. Existing Fields	New Fields in Multi Line Multi Quantity
   returnOrders[].returnOrderLines[].status	returnOrders[].returnOrderLines[].currentTrackingStatuses[].status
   returnOrders[].returnOrderLines[].statusTime	returnOrders[].returnOrderLines[].currentTrackingStatuses[].statusTime
   returnOrders[].returnOrderLines[].currentRefundStatus	returnOrders[].returnOrderLines[].currentTrackingStatuses[].currentRefundStatus
   returnOrders[].returnOrderLines[].quantity	returnOrders[].returnOrderLines[].currentTrackingStatuses[].quantity

   Existing Fields	New Fields in Multi Line Multi Quantity
   returnOrders[].returnOrderLines[].refundChannel	returnOrders[].returnOrderLines[].refundChannels[].refundChannelName returnOrders[].returnOrderLines[].refundChannels[].quantity

现有字段	多行多数量中的新字段
returnOrders[]。returnOrderLines[]。状态	returnOrders[]。returnOrderLines[]。当前跟踪状态[]。状态
returnOrders[]。returnOrderLines[]。状态时间	returnOrders[]。returnOrderLines[]。当前跟踪状态[]。状态时间
returnOrders[]。returnOrderLines[]。currentRefundStatus	returnOrders[]。returnOrderLines[]。当前跟踪状态[]。currentRefundStatus
returnOrders[]。returnOrderLines[]。量	returnOrders[]。returnOrderLines[]。当前跟踪状态[]。量

现有字段	多行多数量中的新字段
returnOrders[]。returnOrderLines[]。退款渠道	returnOrders[]。returnOrderLines[]。退款渠道[]。refundChannelNamereturnOrders[]。returnOrderLines[]。退款渠道[]。量

发放退款API 

1. 去…发行退款->退款行:添加新字段:数量。使用数量提供退货单中要退款的总数量。
2. 如需详细资讯，请参阅发放退款API在参考文献中。

========================订单 - 运输接口==============================

Order Management

The Walmart Order Management APIs help Sellers to manage customer’s Sales Orders and to stay up-to-date on orders fulfillment, which orders to fulfill, and when to fulfill them.

Orders

Ship Order Lines

POST/v3/orders/{purchaseOrderId}/shipping

Updates the status of order lines to Shipped and trigger the charge to the customer. The response to a successful call contains the order with the shipped line items.

AUTHORIZATIONS:

PATH PARAMETERS

purchaseOrderId required

string purchaseOrderId

HEADER PARAMETERS

WM_SEC.ACCESS_TOKEN required	string Example: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM..... The access token retrieved in the Token API call
WM_CONSUMER.CHANNEL.TYPE	string A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding
WM_QOS.CORRELATION_ID required	string Example: b3261d2d-028a-4ef7-8602-633c23200af6 A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID
WM_SVC.NAME required	string Example: Walmart Service Name Walmart Service Name

REQUEST BODY SCHEMA: 

application/json

File fields

orderShipment	object Information about a shipment
processMode string Optional. Use this parameter only to update tracking information after order is shipped. Use 'PARTIAL_UPDATE' as value. Here PARTIAL_UPDATE will indicate that post shipment tracking information needs to be updated orderLines required object List of orderLines in the shipment

Responses

200 

Successful Operation

RESPONSE SCHEMA: 

application/json

order

object Information about the purchase order

purchaseOrderId required string A unique ID associated with the seller's purchase order customerOrderId required string A unique ID associated with the sales order for specified customer customerEmailId required string The email address of the customer for the sales order orderType string Specifies if the order is a regular order or replacement order. Possible values are REGULAR or REPLACEMENT. Provided in response only if query parameter replacementInfo=true. originalCustomerOrderID string customer order ID of the original customer order on which the replacement is created. orderDate required integer <int64> The date the customer submitted the sales order buyerId string <uuid> Unique ID associated with the specified buyer mart string Mart information isGuest boolean Indicates a guest customer shippingInfo required object The shipping information provided by the customer to the seller phone required string The customer's phone number estimatedDeliveryDate required integer <int64> The estimated time and date for the delivery of the item. Format: yyyy-MM-ddThh:MM:ssZ Example: '2020-06-15T06:00:00Z' estimatedShipDate required integer <int64> The estimated time and date when the item will be shipped. Format: yyyy-MM-ddThh:MM:ssZ Example: '2020-06-15T06:00:00Z' methodCode required string Enum: "Standard" "Express" "OneDay" "Freight" "WhiteGlove" "Value" The shipping method. Can be one of the following: Standard, Express, OneDay, WhiteGlove, Value or Freight postalAddress required object Elements of the customer's postal address name required string The name for the person/place of shipping address address1 required string The first line of the shipping address address2 string The second line of the shipping address city required string The city of the shipping address state required string The state of the shipping address postalCode required string The zip code of the shipping address country required string The country of the shipping address addressType string The address type, example: 'RESIDENTIAL' orderLines required object A list of order lines in the order orderLine Array of objects A list of order lines in the order Array () lineNumber required string The line number associated with the details for each individual item in the purchase order item required object The information for the item on the orderLine charges required object Information relating to the charge for the orderLine orderLineQuantity required object Details about the status update statusDate required integer <int64> The date shown on the recent order status orderLineStatuses required object A list of statuses for the Order Line returnOrderId string Id of the return order created in case of a full refund refund object Details about any partial refund on the order originalCarrierMethod string Ship method stamped at order line level when order is placed referenceLineId string Reference line Id fulfillment object fulfillment information serialNumbers Array of strings Unique identifier assigned by a manufacturer to an individual item, to uniquely identify it. This number helps with record-keeping, accuracy and compliance intentToCancel string configId string Sets ConfigID for Personalised orders sellerOrderId string A unique ID associated with the sales order for specified Seller; gives Sellers the ability to print their own custom order ID on the return label; limit of 30 characters paymentTypes Array of strings Payment Types orderSummary object Order Summary totalAmount object currencyAmount required number currencyUnit required string Enum: "AED" "AFN" "ALL" "AMD" "ANG" "AOA" "ARS" "AUD" "AWG" "AZN" "BAM" "BBD" "BDT" "BGN" "BHD" "BIF" "BMD" "BND" "BOB" "BRL" "BSD" "BTN" "BWP" "BYR" "BZD" "CAD" "CDF" "CHF" "CLP" "CNY" "COP" "CRC" "CUP" "CVE" "CZK" "DJF" "DKK" "DOP" "DZD" "EGP" "ERN" "ETB" "EUR" "FJD" "FKP" "GBP" "GEL" "GHS" "GIP" "GMD" "GNF" "GTQ" "GYD" "HKD" "HNL" "HRK" "HTG" "HUF" "IDR" "ILS" "INR" "IQD" "IRR" "ISK" "JMD" "JOD" "JPY" "KES" "KGS" "KHR" "KMF" "KPW" "KRW" "KWD" "KYD" "KZT" "LAK" "LBP" "LKR" "LRD" "LSL" "LTL" "LVL" "LYD" "MAD" "MDL" "MGA" "MKD" "MMK" "MNT" "MOP" "MRO" "MUR" "MVR" "MWK" "MXN" "MYR" "MZN" "NAD" "NGN" "NIO" "NOK" "NPR" "NZD" "OMR" "PAB" "PEN" "PGK" "PHP" "PKR" "PLN" "PYG" "QAR" "RON" "RSD" "RUB" "RUR" "RWF" "SAR" "SBD" "SCR" "SDG" "SEK" "SGD" "SHP" "SLL" "SOS" "SRD" "STD" "SYP" "SZL" "THB" "TJS" "TMT" "TND" "TOP" "TRY" "TTD" "TWD" "TZS" "UAH" "UGX" "USD" "UYU" "UZS" "VEF" "VND" "VUV" "WST" "XAF" "XAG" "XAU" "XBA" "XBB" "XBC" "XBD" "XCD" "XDR" "XFU" "XOF" "XPD" "XPF" "XPT" "XTS" "XXX" "YER" "ZAR" "ZMK" "ZWL" orderSubTotals Array of objects Array () subTotalType string totalAmount object pickupPersons Array of objects List of pickup persons Array () name object phone object shipNode object Specifies the type of shipNode type string Specifies the type of shipNode. Allowed values are SellerFulfilled, WFSFulfilled and 3PLFulfilled. name string id string

{
  "orderShipment": {
    "orderLines": {
      "orderLine": [
        {
          "lineNumber": "1",
          "intentToCancelOverride": false,
          "sellerOrderId": "92344",
          "orderLineStatuses": {
            "orderLineStatus": [
              {
                "status": "Shipped",
                "statusQuantity": {
                  "unitOfMeasurement": "EACH",
                  "amount": "1"
                },
                "trackingInfo": {
                  "shipDateTime": 1580821866000,
                  "carrierName": {
                    "carrier": "UPS"
                  },
                  "methodCode": "Standard",
                  "trackingNumber": "22344",
                  "trackingURL": "http://walmart/tracking/ups?&type=MP&seller_id=12345&promise_date=03/02/2020&dzip=92840&tracking_numbers=92345"
                },
                "returnCenterAddress": {
                  "name": "walmart",
                  "address1": "walmart store 2",
                  "city": "Huntsville",
                  "state": "AL",
                  "postalCode": "35805",
                  "country": "USA",
                  "dayPhone": "12344",
                  "emailId": "walmart@walmart.com"
                }
              }
            ]
          }
        },
        {
          "lineNumber": "2",
          "sellerOrderId": "92344",
          "orderLineStatuses": {
            "orderLineStatus": [
              {
                "status": "Shipped",
                "statusQuantity": {
                  "unitOfMeasurement": "EACH",
                  "amount": "1"
                },
                "trackingInfo": {
                  "shipDateTime": 1580821866000,
                  "carrierName": {
                    "carrier": "FedEx"
                  },
                  "methodCode": "Express",
                  "trackingNumber": "22344",
                  "trackingURL": "http://walmart/tracking/fedEx?&type=MP&seller_id=12345&promise_date=03/02/2020&dzip=92840&tracking_numbers=92344"
                },
                "returnCenterAddress": {
                  "name": "walmart",
                  "address1": "walmart store 2",
                  "city": "Huntsville",
                  "state": "AL",
                  "postalCode": "35805",
                  "country": "USA",
                  "dayPhone": "12344",
                  "emailId": "walmart@walmart.com"
                }
              }
            ]
          }
        }
      ]
    }
  }
}