Retrieve ship-from location accuracy report
Market availability: US Only
Call this endpoint to track the percentage of Simplified Shipping Settings orders that shipped from the same location configured in your Simplified Shipping Settings. This endpoint uses metrics like cumulative trends, shipping methods, and number of orders that didn’t use the configured ship-from locations to calculate ship-from location accuracy metric. For more details about performance standards, refer to Seller Performance Standards.
You can download the simplified shipping settings (SSS) ship-from location accuracy report as a Microsoft Excel (.xlsx) file. Use this report to review orders that negatively impacted your SSS ship-from location accuracy over a specified time window (default 30 days).
Note: This page describes an example using only the required parameters and inputs to retrieve ship-from location accuracy report for SSS orders. For a full list of customization options and additional capabilities, refer to the Marketplace Insights API Reference.
Endpoint
GET https://marketplace.walmartapis.com/v3/insights/performance/sss/sfla/report
The cumulativeRateTrend response parameter uses the statuses in the table below to explain if a trend is a positive or negative change.
| Color | Description |
|---|---|
| GREEN GREEN_UP GREEN_DOWN | A positive change. The seller demonstrates strong performance and has a clear understanding of how to excel in this aspect of customer experience. |
| YELLOW YELLOW_UP YELLOW_DOWN | A negative change. The seller should monitor the metrics and improve their customers’ experiences. |
| RED RED_UP RED_DOWN | A critical change. It is urgent and needs to be resolved. The seller may face repercussions from the Marketplace team. |
Sample request
This sample request demonstrates how to retrieve metrics for orders from the past 30 days.
curl -X GET "https://marketplace.walmartapis.com/v3/insights/performance/sss/sfla/report?reportDuration=30" \ -H "Authorization: Basic ${BASIC_AUTH_B64}" \ -H "WM_SEC.ACCESS_TOKEN: ${ACCESS_TOKEN}" \ -H "WM_CONSUMER.CHANNEL.TYPE: ${CHANNEL_ID}" \ -H "WM_QOS.CORRELATION_ID: 9f5e7f67-dc5b-4c1f-9d3f-1a9a2bbf1a12" \ -H "WM_SVC.NAME: Walmart Marketplace" \ -H "Accept: application/octet-stream" \ --output sss-sfla-report.xlsx
import requests url = "https://marketplace.walmartapis.com/v3/insights/performance/sss/sfla/report" headers = { "Authorization": "Basic <BASIC_AUTH_B64>", "WM_SEC.ACCESS_TOKEN": "<ACCESS_TOKEN>", "WM_CONSUMER.CHANNEL.TYPE": "<CHANNEL_ID>", "WM_QOS.CORRELATION_ID": "9f5e7f67-dc5b-4c1f-9d3f-1a9a2bbf1a12", "WM_SVC.NAME": "Walmart Marketplace", "Accept": "application/octet-stream",
} params = {"reportDuration": 30} response = requests.get(url, headers=headers, params=params)
print(response.status_code) with open("sss-sfla-report.xlsx", "wb") as f: f.write(response.content)
Modify your code
- Use a unique
WM_QOS.CORRELATION_IDfor each request. - Replace
WM_SEC.ACCESS_TOKENwith your valid access token obtained through authentication. - Replace
reportDurationwith the number of days used to calculate the metric. The default value is 30.
Sample response
The following sample response shows the message displayed on successful file download.
string
Result
This call returns 200 OK with Excel file in body of the response.
Rate limits
If you submit too many feeds in a short period of time, you may exceed Walmart’s rate limits and receive HTTP 429 (Too Many Requests) responses. For more details on throttling and best practices, refer to the Rate Limiting Guide.
Updated about 14 hours ago
