{"files":{"SKILL.md":"---\nname: returns-management\ndescription: \"Returns Management API skill. Use when working with Returns Management for returns, feeds. Covers 3 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Returns Management\n\n## Auth\nApiKey WM_SEC.ACCESS_TOKEN in header\n\n## Base URL\nhttps://marketplace.walmartapis.com\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /v3/returns -- returns\n3. POST /v3/returns/{returnOrderId}/refund -- create first refund\n\n## Endpoints\n3 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### Returns\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /v3/returns/{returnOrderId}/refund | Issue refund |\n| GET | /v3/returns | Returns |\n\n### Feeds\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /v3/feeds | Return Item Overrides |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a refund?\" -> POST /v3/returns/{returnOrderId}/refund\n- \"Create a feed?\" -> POST /v3/feeds\n- \"List all returns?\" -> GET /v3/returns\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Paginated endpoints accept limit/offset or cursor parameters\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Returns Management\n@base https://marketplace.walmartapis.com\n@auth ApiKey WM_SEC.ACCESS_TOKEN in header\n@endpoints 3\n@toc returns(2), feeds(1)\n\n@group returns\n@endpoint POST /v3/returns/{returnOrderId}/refund\n@desc Issue refund\n@required {returnOrderId: str # The return order ID, WM_SEC.ACCESS_TOKEN: str # The access token retrieved in the Token API call, WM_QOS.CORRELATION_ID: str # 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: str # Walmart Service Name, customerOrderId: str # A unique ID associated with the sales order for specified customer, refundLines: [map{returnOrderLineNumber!: int(int64), quantity: map}] # Array of refund lines.}\n@optional {WM_CONSUMER.CHANNEL.TYPE: str # A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding}\n@returns(200) {returnOrderId: str, customerOrderId: str, refundLines: [map]} # Successful Operation\n@example_request {\"customerOrderId\":\"1535274411287\",\"refundLines\":[{\"returnOrderLineNumber\":1,\"quantity\":{\"unitOfMeasure\":\"EA\",\"measurementValue\":2}}]}\n\n@endgroup\n\n@group feeds\n@endpoint POST /v3/feeds\n@desc Return Item Overrides\n@required {feedType: str=RETURNS_OVERRIDES # Feed Type, WM_SEC.ACCESS_TOKEN: str # The access token retrieved in the Token API call, WM_QOS.CORRELATION_ID: str # 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: str # Walmart Service Name}\n@optional {WM_CONSUMER.CHANNEL.TYPE: str # A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding}\n@returns(200) {feedId: str} # Successful Operation\n\n@endgroup\n\n@group returns\n@endpoint GET /v3/returns\n@desc Returns\n@required {WM_SEC.ACCESS_TOKEN: str # The access token retrieved in the Token API call, WM_QOS.CORRELATION_ID: str # 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: str # Walmart Service Name}\n@optional {returnOrderId: str # Return order identifier of the return order object as part of array. This is the same as RMA number., customerOrderId: str # A unique ID associated with the sales order for specified customer, status: str # Status may be specified to query the returns with specific status.Valid statuses are: INITIATED, DELIVERED, COMPLETED, replacementInfo: str # Provides additional attributes - replacementCustomerOrderID, returnType, rechargeReason, returnCancellationReason - related to Replacement return order, in response, if available. Allowed values are true or false., returnType: str # Specifies if the return order is a replacement return or a regular (refund) return. Possible values are REPLACEMENT or REFUND., returnCreationStartDate: str(date-time) # Start Date for querying all return orders that were created after that date. Use one of the following formats, based on UTC, ISO 8601. Date example: '2013-08-16' Timestamp example: '2013-08-16T10:30:15Z', returnCreationEndDate: str(date-time) # Limits the query to the return orders that were created before this returnCreationEndDate. Use one of the following formats, based on ISO 8601, are allowed: UTC date or timestamp. Examples: '2016-08-16T10:30:30.155Z' or '2016-08-16', returnLastModifiedStartDate: str(date-time) # Start Date for querying all return orders that were modified after that date. Use one of the following formats, based on UTC, ISO 8601. Date example: '2013-08-16' Timestamp example: '2013-08-16T10:30:15Z'.In case of dates with timezone, use format '2020-04-17T10:42:41.000+0000' and follow encode '+' with %20, returnLastModifiedEndDate: str(date-time) # Limits the query to the return orders that were modified before this date. Use one of the following formats, based on UTC, ISO 8601. Date example: '2013-08-16' Timestamp example: '2013-08-18T10:30:15Z'.In case of dates with timezone, use format '2020-04-18T10:42:41.000+0000' and follow encode '+' with %20, limit: str=10 # The number of orders to be returned. Cannot be larger than 200, WM_CONSUMER.CHANNEL.TYPE: str # A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding}\n@returns(200) {meta: map{totalCount: int(int64), limit: int(int64), nextCursor: str}, returnOrders: [map]} # Successful Operation\n\n@endgroup\n\n@end\n"}}