### Example API Request for Get Item Setup Requirements Source: https://developer.walmart.com/us-marketplace/docs/get-item-setup-requirements Use this cURL command to request item setup requirements. Ensure you provide the correct feedType, version, and productTypes in the request body. ```curl curl --request POST \ --url https://marketplace.walmartapis.com/v3/items/spec \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data \ '{ "feedType": "MP_WFS_ITEM", "version": "5.0.20240517-04_08_27-api", "productTypes": [ "Baby Blankets” ] }' ``` -------------------------------- ### Get Claim Details - Example Request Source: https://developer.walmart.com/us-marketplace/reference/getclaimdetails This example demonstrates how to make a GET request to retrieve claim details. Ensure you include the necessary authentication and correlation ID headers. ```shell curl -X GET \ 'https://marketplace.walmartapis.com/v3/claims/shipment-protection/claim/1000004' \ -H 'WM_SEC.ACCESS_TOKEN: YOUR_ACCESS_TOKEN' \ -H 'WM_CONSUMER.CHANNEL.TYPE: YOUR_CHANNEL_TYPE' \ -H 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \ -H 'WM_SVC.NAME: Walmart Service Name' ``` -------------------------------- ### Product Data Example Source: https://developer.walmart.com/us-marketplace/reference/convertitemforwfs This example shows the structure of product data, including state restrictions, brand, product name, start date, and trade item details like country of origin, inner pack dimensions, and GTINs. ```json { "stateRestrictions": [ { "stateRestrictionsText": "None" } ], "brand": "Goodlife", "productName": "Goodlife Corona_merge_split_19", "startDate": "2020-06-15T00:00:00.000Z" }, "TradeItem": { "countryOfOriginAssembly": [ "US - United States" ], "innerPack": { "innerPackWidth": 2, "innerPackHeight": 3, "qtySellableItemsInnerPack": 1, "innerPackGTIN": "05923239836453", "innerPackWeight": 2, "innerPackDepth": 1 }, "sku": "05923239836453", "orderableGTIN": "05923239836453" } } ``` -------------------------------- ### Product Types in Get Taxonomy Response Source: https://developer.walmart.com/us-marketplace/reference/gettaxonomyresponse This JSON snippet shows a list of product types, each with a 'productTypeName' and 'description'. ```json { "productTypeName": "Audio Sequencers", "description": "Audio Sequencers" } ``` ```json { "productTypeName": "Drum Machines", "description": "Drum Machines" } ``` ```json { "productTypeName": "Keyboard Synthesizers", "description": "Keyboard Synthesizers" } ``` ```json { "productTypeName": "Modular Synthesizers", "description": "Modular Synthesizers" } ``` ```json { "productTypeName": "Audio Mixers", "description": "Audio Mixers" } ``` ```json { "productTypeName": "Sound Diffusors", "description": "Sound Diffusors" } ``` ```json { "productTypeName": "Acoustic Dampers", "description": "Acoustic Dampers" } ``` ```json { "productTypeName": "Acoustic Reflectors", "description": "Acoustic Reflectors" } ``` ```json { "productTypeName": "Audio Channel Strips", "description": "Audio Channel Strips" } ``` ```json { "productTypeName": "Audio Compressors & Limiters", "description": "Audio Compressors & Limiters" } ``` ```json { "productTypeName": "Audio Crossovers", "description": "Audio Crossovers" } ``` ```json { "productTypeName": "Audio Dimmer Switches", "description": "Audio Dimmer Switches" } ``` ```json { "productTypeName": "Audio Direct Boxes", "description": "Audio Direct Boxes" } ``` ```json { "productTypeName": "Audio Feedback Suppressors", "description": "Audio Feedback Suppressors" } ``` ```json { "productTypeName": "Audio Loop Controllers", "description": "Audio Loop Controllers" } ``` ```json { "productTypeName": "Audio Samplers", "description": "Audio Samplers" } ``` ```json { "productTypeName": "Crossfaders", "description": "Crossfaders" } ``` ```json { "productTypeName": "Patch Bays", "description": "Patch Bays" } ``` ```json { "productTypeName": "Sound Pressure Level Meters", "description": "Sound Pressure Level Meters" } ``` ```json { "productTypeName": "Audio Compressors", "description": "Audio Compressors" } ``` -------------------------------- ### Get Taxonomy Source: https://developer.walmart.com/us-marketplace/reference/gettaxonomyresponse Retrieves Walmart's Product Type (PT) taxonomy. You can optionally specify a version to get the current PT taxonomy or omit it for the legacy category-based taxonomy. Authentication is required using an access token. ```APIDOC ## GET /v3/items/taxonomy ### Description Retrieves Walmart's Product Type (PT) taxonomy, which classifies items into structured groups. Each Product Type belongs to a Product Type Group (PTG), and PTGs are organized into broader categories. * To retrieve the current PT taxonomy, include the `version` parameter. * To use the legacy category-based taxonomy, exclude the `version` parameter. ### Method GET ### Endpoint /v3/items/taxonomy ### Parameters #### Query Parameters - **version** (string) - Optional - This is an enum value. If `ProductType` hierarchy data is needed, the `version` attribute should be included in the request. The currently supported value for this attribute is 5.0. Example: `4.5, 5.0, 5.0.20250121-19_24_23-api` - **feedType** (string) - Optional - The type of feed specifies the nature of the update. Select an option from the drop-down list based on the type of update you need to perform. Example: MP_WFS_ITEM indicates the new WFS Item set up. Supported values: `MP_ITEM`, `MP_MAINTENANCE`, `MP_WFS_ITEM`, `OMNI_WFS` #### Header Parameters - **WM_SEC.ACCESS_TOKEN** (string) - Required - Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs. Example: `eyJraWQiOiIxNWNhNGIyYi0yODVjLTQ0ZDUtYmExNC05ZDk1NTlkZmUwNjgiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiZGlyIn0.....` - **WM_CONSUMER.CHANNEL.TYPE** (string) - Optional - A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding. - **WM_QOS.CORRELATION_ID** (string) - Required - A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID. Example: `b3261d2d-028a-4ef7-8602-633c23200af6` - **WM_SVC.NAME** (string) - Required - Specifies the name of the Walmart service being called. Example: `Walmart Marketplace` ### Response #### Success Response (200) - **itemTaxonomy** (object) - Description: Contains the taxonomy data. - **category** (string) - Description: The name of the Product Category. - **description** (string) - Description: The description of the Category. - **productTypeGroup** (array) - Description: List of Product Type Groups in a Category. ``` -------------------------------- ### Departments in Get Taxonomy Response Source: https://developer.walmart.com/us-marketplace/reference/gettaxonomyresponse This JSON snippet shows a list of departments, each with a 'departmentName' and 'departmentNumber'. ```json { "departmentName": "TOYS", "departmentNumber": "7" } ``` ```json { "departmentName": "ELECTRONICS", "departmentNumber": "72" } ``` -------------------------------- ### OpenAPI Category and Subcategory Structure Source: https://developer.walmart.com/us-marketplace/reference/gettaxonomyresponse-1 This JSON snippet defines a hierarchical structure for product categories and subcategories within an OpenAPI specification. It includes example data for 'Animal Other' and 'Art & Craft'. ```json { "subCategoryName": "Animal Other", "subCategoryId": "56f2eb66208f9a06158f1748" } ] }, { "category": "Art & Craft", "subcategory": [ { "subCategoryName": "Art & Craft", "subCategoryId": "571fdff7208f9a0cdb760a7f" } ] } ] } } } } } } } } } } } ``` -------------------------------- ### Product Type Group in Get Taxonomy Response Source: https://developer.walmart.com/us-marketplace/reference/gettaxonomyresponse This JSON snippet shows a product type group with its name. ```json { "productTypeGroupName": "Microphones & Accessories" } ``` -------------------------------- ### OpenAPI Example for Seller Onboarding Response Source: https://developer.walmart.com/us-marketplace/reference/mcsselleronboarding This example demonstrates a successful response structure for seller onboarding, including order details and return address information. ```json { "status": "OK", "errors": [ { "code": "ERR001", "field": "field1", "description": "Error description", "info": "Additional info", "severity": "ERROR", "category": "APPLICATION", "causes": [ { "code": "CAUSE001", "field": "field1", "type": "type1", "description": "Cause description" } ] } ], "payload": { "key1": [ { "orderChannelId": "12345", "boxCatalogType": "typeA", "shipping": "Standard", "returnAddress": { "firstName": "John", "line1": "1234 Elm St", "line2": "Apt 567", "line3": "Floor 3", "city": "Springfield", "state": "IL", "country": "USA", "zip": "62704", "addressType": "Residential" }, "active": "true", "sellerId": "seller123", "sellerName": "Seller Name", "createdDate": "2023-01-01T03:27:51.176Z", "modifiedDate": "2023-01-02T21:21:22.000Z", "orderChannelName": "Channel Name", "partialFulfillment": "true", "martId": "202", "rapResponse": { "response1": {}, "response2": {} } } ] } } ``` -------------------------------- ### Get Spec API Request Source: https://developer.walmart.com/us-marketplace/docs/get-item-setup-requirements This example demonstrates how to call the Get Spec API to retrieve item setup requirements for a given feed type, version, and product type. ```APIDOC ## POST /v3/items/spec ### Description Retrieves item setup requirements for specified product types and versions. ### Method POST ### Endpoint https://marketplace.walmartapis.com/v3/items/spec ### Query Parameters - **feedType** (string) - Required - The Feed Type of the Item Setup data model. - **version** (string) - Required - The specific version of the spec. - **productTypes** (array of strings) - Required - Up to 20 product types. ### Request Body ```json { "feedType": "MP_WFS_ITEM", "version": "5.0.20240517-04_08_27-api", "productTypes": [ "Baby Blankets" ] } ``` ### Response #### Success Response (200) - **spec** (object) - The item setup specification schema. #### Response Example ```json { "spec": { ... } } ``` ``` -------------------------------- ### All Item Recommendations Example Source: https://developer.walmart.com/us-marketplace/reference/getassortmentrecommendations-1 This example shows how to request all item recommendations with a limit of 2. ```json { "recommendationType": "ITEM", "meta": { "limit": 2 } } ``` -------------------------------- ### Get Carriers API Example Response Source: https://developer.walmart.com/us-marketplace/reference/getcarriers This is an example of a successful response from the Get Carriers API, listing available carriers with their IDs and names. ```json { "carriers": [ { "carrierId": "1000", "shortName": "FedEx", "carrierName": "FedEx" } ] } ``` -------------------------------- ### Seller Onboarding Response Example Source: https://developer.walmart.com/us-marketplace/reference/updatemcsselleronboarding This example demonstrates a typical successful response for seller onboarding, illustrating the structure and data types defined in the schema. It includes sample error and payload data. ```json { "status": "OK", "errors": [ { "code": "ERR001", "field": "field1", "description": "Error description", "info": "Additional info", "severity": "ERROR", "category": "APPLICATION", "causes": [ { "code": "CAUSE001", "field": "field1", "type": "type1", "description": "Cause description" } ] } ], "payload": { "key1": [ { "orderChannelId": "12345", "boxCatalogType": "typeA", "shipping": "Standard", "returnAddress": { "firstName": "John", "line1": "1234 Elm St", "line2": "Apt 567", "line3": "Floor 3", "city": "Springfield", "state": "IL", "country": "USA", "zip": "62704", "addressType": "Residential" }, "active": "true", "sellerId": "seller123", "sellerName": "Seller Name", "createdDate": "2023-01-01T03:27:51.176Z", "modifiedDate": "2023-01-02T21:21:22.000Z", "orderChannelName": "Channel Name", "partialFulfillment": "true", "martId": "202", "rapResponse": { "response1": {}, "response2": {} } } ] } } ``` -------------------------------- ### Get Spec API Request Body Example Source: https://developer.walmart.com/us-marketplace/reference/getspec This example demonstrates the structure of the request body for the Get Spec API, including feedType, version, and productTypes. ```json { "feedType": "MP_WFS_ITEM", "version": "5.0.20250121-19_24_23-api", "productTypes": [ "Baby Blankets" ] } ``` -------------------------------- ### Get All Orders Request Example Source: https://developer.walmart.com/us-marketplace/reference/getallorders This example demonstrates how to make a request to the Get All Orders API to retrieve a list of orders. It includes common parameters for filtering and pagination. ```curl curl -X GET \ 'https://marketplace.walmartapis.com/v3/orders?limit=10&nextCursor=null&shipDateEnd=2024-05-27T23:59:59Z&shipDateStart=2024-05-27T00:00:00Z' \ -H 'WM_SVC.NAME: Walmart-Marketplace' \ -H 'WM_QOS.CORRELATION_ID: some_guid' \ -H 'Accept: application/json' \ -H 'Authorization: Basic ' ``` -------------------------------- ### Bulk Item Setup (Multiple) Source: https://developer.walmart.com/us-marketplace/reference/itembulkuploads Use this API for initial item setup and maintenance. This API updates items in bulk, allowing you to update up to 10,000 items at once. Updates with more than 10,000 items are not supported. To ensure optimal feed processing time, keep feed sizes below 25 MB, except for FITMENT_ACES and FITMENT_PIES feeds, which support files up to 50 MB. The Bulk Item Setup API supports requests in two formats: file as an attachment or provide the JSON payload directly in the request body. The API supports all feed types and spec versions identified in the Item spec: Versioning and diff reporting article. Make sure to include the correct feed type as a query parameter in your request. ```APIDOC ## POST /v3/feeds ### Description Use this API for initial item setup and maintenance. This API updates items in bulk, allowing you to update up to 10,000 items at once. Updates with more than 10,000 items are not supported. To ensure optimal feed processing time, keep feed sizes below 25 MB, except for FITMENT_ACES and FITMENT_PIES feeds, which support files up to 50 MB. The Bulk Item Setup API supports requests in two formats: file as an attachment or provide the JSON payload directly in the request body. The API supports all feed types and spec versions identified in the Item spec: Versioning and diff reporting article. Make sure to include the correct feed type as a query parameter in your request. Available feed types: * MP_ITEM: Set up a new seller fulfilled item. * MP_WFS_ITEM: Set up a new Walmart fulfilled item. * MP_MAINTENANCE: Update existing items in your catalog. * MP_ITEM_MATCH: Use item setup info from an existing Walmart catalog item to set up your own offer. * OMNI_WFS: Convert a seller fulfilled item to Walmart fulfilled item. * FITMENT_ACES/FITMENT_PIES: For automotive fitment items. Requires a zip file in the request body. * DELETE_ITEM: Delete seller-fulfilled items from your catalog. Download and review the request body samples for guidance on formatting the updated feed file before uploading it for processing. ### Method POST ### Endpoint /v3/feeds ### Parameters #### Query Parameters - **feedType** (string) - Required - The type of feed specifies the nature of the update. Select an option from the drop-down list based on the item specification version and the type of update you need to perform. Example: MP_WFS_ITEM indicates the new WFS Item set up. Available feed types: * RETIRE_ITEM * MP_ITEM * MP_WFS_ITEM * MP_ITEM_MATCH * MP_MAINTENANCE * SKU_TEMPLATE_MAP * SHIPPING_OVERRIDES * OMNI_WFS * FITMENT_ACES * FITMENT_PIES * SPLIT_AND_MERGE * DELETE_ITEM #### Headers - **Content-Type** (string) - Required - The feed payload can be submitted either as a file attachment or as a JSON payload in the request body. When the payload is sent as a file attachment, the Content-Type must be 'multipart/form-data'. When the payload is provided as a JSON payload in the request body, the Content-Type must be 'application/json' - **WM_SEC.ACCESS_TOKEN** (string) - Required - Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs. - **WM_CONSUMER.CHANNEL.TYPE** (string) - Optional - A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding. - **WM_QOS.CORRELATION_ID** (string) - Optional - A unique ID to track the request across multiple services. ### Request Example ```json { "example": "request body" } ``` ### Response #### Success Response (200) - **field1** (type) - Description #### Response Example ```json { "example": "response body" } ``` ``` -------------------------------- ### Get Shipping Estimate Request Example Source: https://developer.walmart.com/us-marketplace/reference/getshippingestimate This example demonstrates a typical request payload for the Get Shipping Estimate API. It includes details about the package, order, and addresses. ```json { "packageType": "CUSTOM_PACKAGE", "purchaseOrderId": "91088062299813853", "boxItems": [ { "lineNumber": 1, "sku": "sku-1NMeZnK1B1MNJdXde5771022", "quantity": 1 } ], "boxDimensions": { "boxWeightUnit": "LB", "boxWeight": 0.8, "boxLength": 6, "boxWidth": 6, "boxHeight": 6, "boxDimensionUnit": "IN" }, "shipByDate": "2023-06-05T08:00:00.611Z", "deliverByDate": "2023-06-07T23:00:00.611Z", "carriers": [ "FEDEX" ], "fromAddress": { "postalCode": "91776", "countryCode": "US", "addressLines": [ "311 E VALLEY BLVD STE 112 PMB 271as" ], "city": "SAN GABRIEL1as", "state": "CA" }, "toAddress": { "postalCode": "94085", "countryCode": "US", "addressLines": [ "748 N Mathilda Ave", "Room # 224" ], "city": "SUNNYVALE", "state": "CA" }, "includeServicesNotMeetingDeliveryPromise": true } ``` -------------------------------- ### Example URI for Initiating Seller Connection Source: https://developer.walmart.com/us-marketplace/docs/sandbox-testing-for-marketplace-partners This URI is used to initiate the simulated seller connection workflow by redirecting the seller to the approved Solution Provider's app login URL. ```shell https://[App Log-in URL]?walmartCallbackUri=[https://login.sandbox.account.wal-mart.com/authorize&clientType=seller](https://login.sandbox.account.wal-mart.com/authorize&clientType=seller ``` -------------------------------- ### Get Label API Example Response Source: https://developer.walmart.com/us-marketplace/reference/getlabel This example demonstrates a successful response from the Get Label API, showing shipment details including purchase order ID, tracking number, box items, carrier information, and tracking URL. ```json { "data": [ { "purchaseOrderId": "65108826634074798", "trackingNo": "14300153617516", "boxItems": [ { "sku": "06068906426236Test", "quantity": 1, "lineNumber": "1" } ], "carrierName": "FedEx", "carrierFullName": "FedEx", "carrierServiceType": "FedEx 2Day", "trackingUrl": "https://www.fedex.com/apps/fedextrack/?action=track&tracknumbers=14300153617516&locale=en_US&cntry_code=us" } ] } ``` -------------------------------- ### Sample Account Level Settings Configuration Source: https://developer.walmart.com/us-marketplace/reference/createaccountlevelsettings This example demonstrates a sample configuration for account-level settings, including the carrier's weekend calendar and additional days off. Use this structure when defining or updating these settings. ```json { "calendarDayConfiguration": { "carrierWeekendCalendar": { "saturday": { "workingDay": true }, "sunday": { "workingDay": false } }, "additionalDaysOff": [ "2030-03-10", "2030-04-10" ] } } ``` -------------------------------- ### Example Search Response with Variant Information Source: https://developer.walmart.com/us-marketplace/reference/getcatalogsearch This example demonstrates a response that includes detailed variant information for a product, such as GTIN, WPID, lifecycle status, pricing, and specific variant attributes. ```json { "status": "Success", "payload": [ { "gtin": "05420529997042", "wpid": "5DTSM799JCUI", "lifecycleStatus": "RETIRED", "mart": "WALMART_US", "publishedStatus": { "reasons": [ "END_DATE" ], "status": "UNPUBLISHED" }, "productName": "Electronic Cables", "manufacturer": "ECManu", "shelf": "[\"UNNAV\"]", "itemId": "562433848", "price": { "amount": 70, "unit": "USD" }, "variantGroupInfo": { "groupingAttributes": [ { "name": "actual_color", "value": "1234567890" } ], "isPrimary": "true" }, "variantGroupId": "Toysgroup0101", "sku": "88nZ6RR82XghDkd", "brand": "ECB brand", "productType": "default" }, { "itemId": "458505242", "gtin": "05828079255702", "wpid": "3SNE69WWZOWX", "lifecycleStatus": "ACTIVE", "mart": "WALMART_US", "publishedStatus": { "status": "PUBLISHED" }, "price": { "amount": 325, "unit": "USD" }, "sku": "SDdk1BnxmLdKlqR" } ] } ``` -------------------------------- ### Get Feed Item Status Example Source: https://developer.walmart.com/us-marketplace/reference/getfeeditemstatus This example demonstrates how to retrieve the status of items within a feed. It shows the structure of the response, including overall feed status and item-specific details. ```APIDOC ## Get Feed Item Status ### Description Retrieves the ingestion status for items within a specified feed. ### Method GET ### Endpoint /v3/feeds/{feedId}/items/status ### Parameters #### Query Parameters - **limit** (integer) - Optional - Maximum number of items to return. - **offset** (integer) - Optional - Starting index for the items to return. ### Response #### Success Response (200) - **feedId** (string) - The unique identifier for the feed. - **feedStatus** (string) - The overall status of the feed (e.g., PROCESSED, PROCESSING). - **feedSubmissionDate** (integer) - Timestamp of when the feed was submitted. - **itemsReceived** (integer) - The total number of items received in the feed. - **itemsSucceeded** (integer) - The number of items that were successfully processed. - **itemsFailed** (integer) - The number of items that failed processing. - **itemsProcessing** (integer) - The number of items currently being processed. - **offset** (integer) - The offset used for pagination. - **limit** (integer) - The limit used for pagination. - **itemDetails** (object) - Contains details about individual item statuses. - **itemIngestionStatus** (array) - A list of item ingestion status objects. - **martId** (integer) - The mart ID associated with the item. - **sku** (string) - The Stock Keeping Unit of the item. - **wpid** (string) - The Walmart Product ID. - **index** (integer) - The index of the item in the feed. - **itemid** (string) - The item ID. - **productIdentifiers** (object) - Identifiers for the product. - **productIdentifier** (array) - List of product identifiers. - **productIdType** (string) - The type of product identifier (e.g., GTIN, UPC). - **productId** (string) - The product identifier value. - **ingestionStatus** (string) - The ingestion status of the item (e.g., INPROGRESS, SUCCESS, DATA_ERROR, SYSTEM_ERROR, TIMEOUT_ERROR). - **ingestionErrors** (object) - Contains details about ingestion errors for the item. - **ingestionError** (array) - A list of ingestion error objects. - **type** (string) - The type of error (e.g., DATA_ERROR, SYSTEM_ERROR, TIMEOUT_ERROR). - **code** (string) - The error code. - **description** (string) - A description of the error. #### Response Example { "feedId": "F129C19240844B97A3C6AD8F1A2C4997@AU8BAQA", "feedStatus": "PROCESSED", "feedSubmissionDate": 1568310803059, "itemsReceived": 1, "itemsSucceeded": 1, "itemsFailed": 0, "itemsProcessing": 0, "offset": 0, "limit": 20, "itemDetails": { "itemIngestionStatus": [ { "martId": 0, "sku": "0960B3B82687490FA5E51CB0801478A4@AU8BAgA", "wpid": "71ZLHHMKNS6G", "index": 0, "itemid": "51681142", "productIdentifiers": { "productIdentifier": [ { "productIdType": "GTIN", "productId": "00363824587165" }, { "productIdType": "UPC", "productId": "363824587165" } ] }, "ingestionStatus": "SUCCESS" } ] } } ``` -------------------------------- ### Get Fulfillment Order Status - Success Response Source: https://developer.walmart.com/us-marketplace/docs/order-tracking-apis Example of a successful response (200 OK) from the Get Fulfillment Order Status API, detailing order information and shipment events. ```JSON { "status": "OK", "header": null, "payload": { "orderNumber": "SO123", "orderChannelId": "ORDER_CHANNEL_ID", "orderPlacedTime": "2025-10-15T12:34:56Z", "orderStatus": "SHIPPED", "orderItems": [ { "sellerLineId": "1", "sku": "SKU-1", "qty": { "unitOfMeasure": "EACH", "measurementValue": 1 }, "lineStatus": "SHIPPED" } ], "shipments": [ { "shipmentId": "SHIP123", "carrier": "CarrierName", "trackNumber": "1Z9999999999999999", "events": [ { "eventTime": "2025-10-16T08:00:00Z", "status": "OUT_FOR_DELIVERY" }, { "eventTime": "2025-10-16T15:30:00Z", "status": "DELIVERED" } ] } ] }, "errors": [] } ``` -------------------------------- ### Item Recommendations with Filters Example Source: https://developer.walmart.com/us-marketplace/reference/getassortmentrecommendations-1 This example demonstrates how to request item recommendations with multiple filter criteria, including multi-value filters, enum filters, and range filters. It also shows how to filter for top go-get items and new recommendations. ```json { "recommendationType": "ITEM", "meta": { "limit": 4, "nextCursor": "AoRYPgVANXFt6AeR8QUAAAAAAAAAADkxMDEwMDMwNTZBTkRBTkRCMDg3WVYxOU05" }, "filterCriteria": { "searchText": "and", "multiValueFilter": [ { "parameter": "BRAND", "values": [ "Disney", "NINTENDO" ] }, { "parameter": "CATEGORY", "values": [ "Toys" ] }, { "parameter": "PRODUCT_TYPE", "values": [ "Action Figure Sets", "Power Tool Batteries", "Action Figures" ] } ], "enumFilter": [ { "parameter": "ITEM_AVAILABILITY_STATUS", "values": [ "NEW_TO_WALMART", "EXISTING_IN_WALMART" ] }, { "parameter": "SHOPPING_TRENDS", "values": [ "MOST_SEARCHED_FOR", "BEST_SELLERS", "DEAL_ITEMS" ] }, { "parameter": "DEMAND_SALES_TRENDS", "values": [ "DEC", "APR", "NOV", "MAR" ] } ], "rangeFilter": [ { "parameter": "PRICE", "from": "1.0", "to": "3.5" } ], "isTopGoGetItem": true, "isNewRecommendation": true } } ``` -------------------------------- ### Fulfillment Center Creation Example Source: https://developer.walmart.com/us-marketplace/reference/createfulfillmentcenter This example demonstrates the structure for creating a new fulfillment center, including its name, status, timezone, supported services, custom ID, postal address, and shipping details. ```json { "shipNodeHeader": { "version": "1.2" }, "shipNode": [ { "shipNodeName": "my distrubutor786", "status": "ACTIVE", "timeZone": "PST", "distributorSupportedServices": [ "TWO_DAY_DELIVERY" ], "customNodeId": "92hb1234", "postalAddress": { "addressLine1": "36 CALIFORNIA SAA233", "city": "SC GABRIEL22", "state": "CA", "country": "USA", "postalCode": "90100" }, "shippingDetails": [ { "twoDayShipping": [ { "carrierMethodName": "FEDEX", "carrierMethodType": "GROUND" } ] } ] } ] } ``` -------------------------------- ### Taxonomy API Source: https://developer.walmart.com/us-marketplace/docs/item-management-available-requests Get the hierarchy of Product Types needed for Item Setup and Maintenance. This is a synchronous call. ```APIDOC ## Taxonomy API ### Description Get hierarchy of Product Types needed for Item Setup and Maintenance. ### Method GET ### Endpoint /us-marketplace/reference/gettaxonomyresponse ### Call Type Sync ``` -------------------------------- ### Get Spec API Source: https://developer.walmart.com/us-marketplace/docs/item-management-available-requests Request item setup requirements for up to 20 product types. This is a synchronous call. ```APIDOC ## Get Spec API ### Description Request item setup requirements for up to 20 product types. ### Method POST ### Endpoint /us-marketplace/reference/getspec ### Call Type Sync ``` -------------------------------- ### Create Working Directory Source: https://developer.walmart.com/us-marketplace/reference/multichannel-solutions-java-openapi-client-integration-guide Creates a new directory for the integration and navigates into it. ```bash mkdir walmart-mcs-integration cd walmart-mcs-integration ```