@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Returns Management
@base https://marketplace.walmartapis.com
@auth ApiKey WM_SEC.ACCESS_TOKEN in header
@endpoints 3
@toc returns(2), feeds(1)

@group returns
@endpoint POST /v3/returns/{returnOrderId}/refund
@required {returnOrderId: str, WM_SEC.ACCESS_TOKEN: str, WM_QOS.CORRELATION_ID: str, WM_SVC.NAME: str, customerOrderId: str, refundLines: [map{returnOrderLineNumber!: int(int64), quantity: map}]}
@optional {WM_CONSUMER.CHANNEL.TYPE: str}
@returns(200) {returnOrderId: str, customerOrderId: str, refundLines: [map]}

@endgroup

@group feeds
@endpoint POST /v3/feeds
@required {feedType: str=RETURNS_OVERRIDES, WM_SEC.ACCESS_TOKEN: str, WM_QOS.CORRELATION_ID: str, WM_SVC.NAME: str}
@optional {WM_CONSUMER.CHANNEL.TYPE: str}
@returns(200) {feedId: str}

@endgroup

@group returns
@endpoint GET /v3/returns
@required {WM_SEC.ACCESS_TOKEN: str, WM_QOS.CORRELATION_ID: str, WM_SVC.NAME: str}
@optional {returnOrderId: str, customerOrderId: str, status: str, replacementInfo: str, returnType: str, returnCreationStartDate: str(date-time), returnCreationEndDate: str(date-time), returnLastModifiedStartDate: str(date-time), returnLastModifiedEndDate: str(date-time), limit: str=10, WM_CONSUMER.CHANNEL.TYPE: str}
@returns(200) {meta: map{totalCount: int(int64), limit: int(int64), nextCursor: str}, returnOrders: [map]}

@endgroup

@end