订单和退货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

发放退款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

HEADER PARAMETERS

REQUEST BODY SCHEMA: 

application/json

File fields

Responses

200 

Successful Operation

RESPONSE SCHEMA: 

application/json

{
  "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"
                }
              }
            ]
          }
        }
      ]
    }
  }
}