{"id":15562072,"url":"https://github.com/hakanensari/mws-orders","last_synced_at":"2025-04-23T22:53:07.701Z","repository":{"id":9942180,"uuid":"11959052","full_name":"hakanensari/mws-orders","owner":"hakanensari","description":"A Ruby interface to the Amazon MWS Orders API","archived":false,"fork":false,"pushed_at":"2020-06-04T14:06:08.000Z","size":154,"stargazers_count":15,"open_issues_count":0,"forks_count":12,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-23T22:52:58.513Z","etag":null,"topics":["amazon","ecommerce","ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hakanensari.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-08-07T19:50:58.000Z","updated_at":"2023-01-18T18:10:50.000Z","dependencies_parsed_at":"2022-08-26T21:40:08.244Z","dependency_job_id":null,"html_url":"https://github.com/hakanensari/mws-orders","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hakanensari%2Fmws-orders","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hakanensari%2Fmws-orders/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hakanensari%2Fmws-orders/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hakanensari%2Fmws-orders/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hakanensari","download_url":"https://codeload.github.com/hakanensari/mws-orders/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250528698,"owners_count":21445511,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon","ecommerce","ruby"],"created_at":"2024-10-02T16:11:20.369Z","updated_at":"2025-04-23T22:53:07.686Z","avatar_url":"https://github.com/hakanensari.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MWS Orders\n\n[![Build](https://github.com/hakanensari/mws-orders/workflows/build/badge.svg)](https://github.com/hakanensari/mws-orders/actions)\n\n**MWS Orders** is a full-featured Ruby interface to the [Amazon Marketplace Web Service (MWS) Orders API](https://docs.developer.amazonservices.com/en_UK/orders-2013-09-01/). With the MWS Orders API, you can list orders created or updated during a time frame you specify or retrieve information about specific orders.\n\nTo use Amazon MWS, you must have an eligible seller account.\n\n## Usage\n\nCreate a client:\n\n```ruby\nrequire 'mws/orders/parser'\nclient = MWS.orders(marketplace: 'ATVPDKIKX0DER',\n                    merchant_id: '123')\n```\n\nSet up credentials [when instantiating or with environment variables](https://github.com/hakanensari/peddler#usage).\n\n### Orders\n\nList orders created or updated during a time frame you specify:\n\n```ruby\nresponse = client.list_orders('ATVPDKIKX0DER', created_after: 1.month.ago)\norders = response.parse\nputs orders.count # =\u003e 100\norders.first.inspect # =\u003e #\u003cMWS::Orders::Order 902-3159896-1390916\u003e\n```\n\nList the next page of orders:\n\n```ruby\nclient.list_orders_by_next_token(orders.next_token).parse\n```\n\nGet one or more orders based on their order numbers:\n\n```ruby\nresponse = client.get_order('902-3159896-1390916')\norders = response.parse\norders.first.inspect # =\u003e #\u003cMWS::Orders::Order 902-3159896-1390916\u003e\n```\n\n### Order Items\n\nList order items:\n\n```ruby\nresponse = client.list_order_items('902-3159896-1390916')\norder_items = response.parse\n```\n\nList the next page of order items:\n\n```ruby\nclient.list_order_items_by_next_token.parse\n```\n\nOrders and order items are represented by POROs that map one on one to the attributes returned by the API.\n\n### Service Status\n\nCheck the operational status of the API:\n\n```ruby\nclient.get_service_status.parse\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhakanensari%2Fmws-orders","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhakanensari%2Fmws-orders","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhakanensari%2Fmws-orders/lists"}