{"id":19215487,"url":"https://github.com/michabbb/sdk-ebay-rest-negotiation","last_synced_at":"2025-08-20T09:24:48.791Z","repository":{"id":176568973,"uuid":"659194291","full_name":"michabbb/sdk-ebay-rest-negotiation","owner":"michabbb","description":"A PHP SDK for the eBay Negotiation REST API","archived":false,"fork":false,"pushed_at":"2023-06-27T14:59:33.000Z","size":64,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-12-14T23:16:22.394Z","etag":null,"topics":["api","ebay","negotiation","rest-api","sdk"],"latest_commit_sha":null,"homepage":"https://developer.ebay.com/api-docs/sell/negotiation/overview.html","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/michabbb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-27T10:19:01.000Z","updated_at":"2023-06-27T10:20:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"ab20ea26-13da-4f8b-97f4-f4bb7b70efa7","html_url":"https://github.com/michabbb/sdk-ebay-rest-negotiation","commit_stats":null,"previous_names":["michabbb/sdk-ebay-rest-negotiation"],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michabbb%2Fsdk-ebay-rest-negotiation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michabbb%2Fsdk-ebay-rest-negotiation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michabbb%2Fsdk-ebay-rest-negotiation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michabbb%2Fsdk-ebay-rest-negotiation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/michabbb","download_url":"https://codeload.github.com/michabbb/sdk-ebay-rest-negotiation/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240289994,"owners_count":19777986,"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":["api","ebay","negotiation","rest-api","sdk"],"created_at":"2024-11-09T14:13:49.334Z","updated_at":"2025-02-23T08:27:27.566Z","avatar_url":"https://github.com/michabbb.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sdk-ebay-rest-negotiation\n\nThe \u003cb\u003eNegotiations API\u003c/b\u003e gives sellers the ability to proactively send discount offers to buyers who have shown an \\\"interest\\\" in their listings.  \u003cbr\u003e\u003cbr\u003eBy sending buyers discount offers on listings where they have shown an interest, sellers can increase the velocity of their sales.  \u003cbr\u003e\u003cbr\u003eThere are various ways for a buyer to show \u003ci\u003einterest \u003c/i\u003e in a listing. For example, if a buyer adds the listing to their \u003cb\u003eWatch\u003c/b\u003e list, or if they add the listing to their shopping cart and later abandon the cart, they are deemed to have shown an interest in the listing.  \u003cbr\u003e\u003cbr\u003eIn the offers that sellers send, they can discount their listings by either a percentage off the listing price, or they can set a new discounted price that is lower than the original listing price.  \u003cbr\u003e\u003cbr\u003eFor details about how seller offers work, see \u003ca href=\\\"/api-docs/sell/static/marketing/offers-to-buyers.html\\\" title=\\\"Selling Integration Guide\\\"\u003eSending offers to buyers\u003c/a\u003e.\n\n## Created via\n\n```bash\ndocker run --rm -v ${PWD}:/app -w /app openapitools/openapi-generator-cli:v6.6.0 generate -i /app/sell_negotiation_v1_oas3.yaml -g php -o /app --config /app/openapi-config.php.ebay.negotiation.json\n```\n\n## Installation \u0026 Usage\n\n### Requirements\n\nPHP 7.4 and later.\nShould also work with PHP 8.0.\n\n### Composer\n\nTo install the bindings via [Composer](https://getcomposer.org/), add the following to `composer.json`:\n\n```json\n{\n  \"repositories\": [\n    {\n      \"type\": \"vcs\",\n      \"url\": \"https://github.com/macropage/sdk-ebay-rest-negotiation.git\"\n    }\n  ],\n  \"require\": {\n    \"macropage/sdk-ebay-rest-negotiation\": \"*@dev\"\n  }\n}\n```\n\nThen run `composer install`\n\n### Manual Installation\n\nDownload the files and include `autoload.php`:\n\n```php\n\u003c?php\nrequire_once('/path/to/sdk-ebay-rest-negotiation/vendor/autoload.php');\n```\n\n## Getting Started\n\nPlease follow the [installation procedure](#installation--usage) and then run the following:\n\n```php\n\u003c?php\nrequire_once(__DIR__ . '/vendor/autoload.php');\n\n\n\n// Configure OAuth2 access token for authorization: api_auth\n$config = macropage\\SDKs\\ebay\\rest\\negotiation\\Configuration::getDefaultConfiguration()-\u003esetAccessToken('YOUR_ACCESS_TOKEN');\n\n\n$apiInstance = new macropage\\SDKs\\ebay\\rest\\negotiation\\Api\\OfferApi(\n    // If you want use custom http client, pass your client which implements `GuzzleHttp\\ClientInterface`.\n    // This is optional, `GuzzleHttp\\Client` will be used as default.\n    new GuzzleHttp\\Client(),\n    $config\n);\n$xEBAYCMARKETPLACEID = 'xEBAYCMARKETPLACEID_example'; // string | The eBay marketplace on which you want to search for eligible listings. \u003cbr\u003e\u003cbr\u003eFor a complete list of supported marketplaces, see \u003ca href=\\\"/api-docs/sell/negotiation/overview.html#requirements\\\" title=\\\"Negotiation API Overview\\\"\u003eNegotiation API requirements and restrictions\u003c/a\u003e.\n$limit = 'limit_example'; // string | This query parameter specifies the maximum number of items to return from the result set on a page in the paginated response. \u003cp\u003e\u003cb\u003eMinimum:\u003c/b\u003e 1 \u0026nbsp; \u0026nbsp;\u003cb\u003eMaximum:\u003c/b\u003e 200 \u003cbr\u003e\u003cb\u003eDefault: \u003c/b\u003e10\u003c/p\u003e\n$offset = 'offset_example'; // string | This query parameter specifies the number of results to skip in the result set before returning the first result in the paginated response.  \u003cbr\u003e\u003cbr\u003eCombine \u003cb\u003eoffset\u003c/b\u003e with the \u003cb\u003elimit\u003c/b\u003e query parameter to control the items returned in the response. For example, if you supply an \u003cb\u003eoffset\u003c/b\u003e of \u003ccode\u003e0\u003c/code\u003e and a \u003cb\u003elimit\u003c/b\u003e of \u003ccode\u003e10\u003c/code\u003e, the first page of the response contains the first 10 results from the complete list of items retrieved by the call. If \u003cb\u003eoffset\u003c/b\u003e is \u003ccode\u003e10\u003c/code\u003e and \u003cb\u003elimit\u003c/b\u003e is \u003ccode\u003e20\u003c/code\u003e, the first page of the response contains items 11-30 from the complete result set. \u003cbr\u003e\u003cbr\u003e\u003cb\u003eDefault:\u003c/b\u003e 0\n\ntry {\n    $result = $apiInstance-\u003efindEligibleItems($xEBAYCMARKETPLACEID, $limit, $offset);\n    print_r($result);\n} catch (Exception $e) {\n    echo 'Exception when calling OfferApi-\u003efindEligibleItems: ', $e-\u003egetMessage(), PHP_EOL;\n}\n\n```\n\n## API Endpoints\n\nAll URIs are relative to *https://api.ebay.com/sell/negotiation/v1*\n\nClass | Method | HTTP request | Description\n------------ | ------------- | ------------- | -------------\n*OfferApi* | [**findEligibleItems**](docs/Api/OfferApi.md#findeligibleitems) | **GET** /find_eligible_items | \n*OfferApi* | [**sendOfferToInterestedBuyers**](docs/Api/OfferApi.md#sendoffertointerestedbuyers) | **POST** /send_offer_to_interested_buyers | \n\n## Models\n\n- [Amount](docs/Model/Amount.md)\n- [CreateOffersRequest](docs/Model/CreateOffersRequest.md)\n- [EligibleItem](docs/Model/EligibleItem.md)\n- [Error](docs/Model/Error.md)\n- [ErrorParameter](docs/Model/ErrorParameter.md)\n- [Offer](docs/Model/Offer.md)\n- [OfferedItem](docs/Model/OfferedItem.md)\n- [PagedEligibleItemCollection](docs/Model/PagedEligibleItemCollection.md)\n- [SendOfferToInterestedBuyersCollectionResponse](docs/Model/SendOfferToInterestedBuyersCollectionResponse.md)\n- [TimeDuration](docs/Model/TimeDuration.md)\n- [User](docs/Model/User.md)\n\n## Authorization\n\nAuthentication schemes defined for the API:\n### api_auth\n\n- **Type**: `OAuth`\n- **Flow**: `accessCode`\n- **Authorization URL**: `https://auth.ebay.com/oauth2/authorize`\n- **Scopes**: \n    - **https://api.ebay.com/oauth/api_scope/sell.inventory**: View and manage your inventory and offers\n    - **https://api.ebay.com/oauth/api_scope/sell.inventory.readonly**: View your inventory and offers\n\n## Tests\n\nTo run the tests, use:\n\n```bash\ncomposer install\nvendor/bin/phpunit\n```\n\n## Author\n\n\n\n## About this package\n\nThis PHP package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:\n\n- API version: `v1.1.0`\n    - Package version: `1.9.0`\n- Build package: `org.openapitools.codegen.languages.PhpClientCodegen`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichabbb%2Fsdk-ebay-rest-negotiation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichabbb%2Fsdk-ebay-rest-negotiation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichabbb%2Fsdk-ebay-rest-negotiation/lists"}