Update MCS sales channel details

Updates MCS sales channel details for existing sales channel which includes the sales channel name, ship from, and return address information for a given partner ID.

This page describes an example using only the required parameters and inputs for updating WFS order channel details. For a full list of customization options and additional capabilities, refer to the Walmart WFS API Reference .

Endpoint

PUT /v3/fulfillment/orders-fulfillments/channel-details

Sample request

This sample request updates fulfillment order channel details for a Walmart Marketplace partner. It specifies the partner ID, channel name, shipping methods, and return address information to be updated.

curl --location --request PUT 'https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/channel-details' \
--header 'loggedInUser: User name' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'martId: 202' \
--header 'WMSEC.ACCESSTOKEN: <youraccesstoken>' \
--header 'WMQOS.CORRELATIONID: Test Seller 105' \
--header 'WM_SVC.NAME: Walmart Marketplace' \
--data-raw '{ "header": { "headerAttributes": { "martId": "202", "buId": "0" } }, "payload": { "partnerId": "10900075044", "mcsDetails": [ { "boxCatalogType": "multichannel", "orderChannelName": "External Shopify Channel", "shippping": "FedX 2 Business Days and FedX Ground", "returnAddress": { "firstName": "Jomashop", "line1": "JOMASHOP", "line2": "140A 58TH ST UNIT 6N", "line3": "6TH FLOOR", "city": "BROOKLYN", "state": "NY", "country": "USA", "zip": "11220-2516", "addressType": "COMMERCIAL" } } ] }
}'

import requests url = "https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/channel-details"
headers = { "loggedInUser": "User name", "Accept": "application/json", "Content-Type": "application/json", "martId": "202", "WMSEC.ACCESSTOKEN": "<youraccesstoken>", #Replace with your actual token "WMQOS.CORRELATIONID": "Test Seller 105", "WMSVC.NAME": "Walmart Marketplace"
}
body = { "header": { "headerAttributes": { "martId": "202", "buId": "0" } }, "payload": { "partnerId": "10900075044", "mcsDetails": [ { "boxCatalogType": "multichannel", "orderChannelName": "External Shopify Channel", "shippping": "FedX 2 Business Days and FedX Ground", "returnAddress": { "firstName": "Jomashop", "line1": "JOMASHOP", "line2": "140A 58TH ST UNIT 6N", "line3": "6TH FLOOR", "city": "BROOKLYN", "state": "NY", "country": "USA", "zip": "11220-2516", "addressType": "COMMERCIAL" } } ] }
} response = requests.put(url, headers=headers, json=body)
print(response.statuscode)
print(response.json())

Modify your code

Replace WMSEC.ACCESSTOKEN with your actual access token
Use your unique WM_QOS.CORRELATION_ID for each request.
Use the unique partnerId that is assigned to the partner when making the request.

Sample response

This response indicates that the fulfillment order channel details were successfully updated.

{ "status": "OK", "header": { "headerAttributes": {} }, "errors": [], "payload": [ { "orderChannelId": "A1B2C3D4E5F6G7H8I9J0", "boxCatalogType": "multichannel", "shippping": "FedX 2 Business Days and FedX Ground", "returnAddress": { "firstName": "Jomashop", "line1": "JOMASHOP", "line2": "140A 58TH ST UNIT 6N", "line3": "6TH FLOOR", "city": "BROOKLYN", "state": "NY", "country": "USA", "zip": "11220-2516", "addressType": "COMMERCIAL" }, "active": "Y", "sellerId": "10900075044", "sellerName": "Jomashop", "createdDate": "2024-06-01T12:00:00.000+00:00", "orderChannelName": "External Shopify Channel", "martId": "202" } ]
}

Result

If successful, the API returns an HTTP status 200 OK with a JSON response. The response includes details of the updated fulfillment order channel, such as the channel ID, shipping options, return address, seller information, and activation status.

Updated about 1 hour ago