0
点赞
收藏
分享

微信扫一扫

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

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

orderLines

required

object

A list of order lines in the order

paymentTypes

Array of strings

Payment Types

orderSummary

object

Order Summary

pickupPersons

Array of objects

List of pickup persons

Array ()

nameobjectphoneobject

shipNode

object

Specifies the type of shipNode

typestringSpecifies the type of shipNode. Allowed values are SellerFulfilled, WFSFulfilled and 3PLFulfilled.namestringidstring

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

举报

相关推荐

0 条评论