REST API and tokens

REST API is needed to integrate its system with the site: pick up goods, follow orders, change statuses, download catalog updates.

REST API is included in the tariff "Growth and higher." ?Seller's fare and subscription fee). At the lower rate, requests to it are answered 403eh Exchange with 1C works on any tariff - the same token (Exchange with 1C).

Access.

1. Cabinet Data exchange "Create a token." The token is shown once - save it.
2. Give it the title: Authorization: Bearer <токен>.
3. Requests are executed on behalf current the owner of the token, the role is the owner or manager. If you need to work from another company, switch it to the office.Cabinet, companies and roles).

Basic address. https://kup2b.ru/api/v1.

Basic methods

• GET /products - list of goods: q (Search by article and title), status. page. per_page (up to 200).
• GET /products/{id} - a product card with prices, balances and properties.
• GET /products/export?format=csv|xlsx|json - unloading the catalog in a stream.
• POST /products/import Upload the update file; the launch ID comes back. The rules are the same as the import file, including the zero price – it is written.Import of prices, balances and catalog).
• GET /imports/{id} Startup status: processed rows and journal; log entry level - error (line not loaded) or warning (not fully loaded).
• GET /orders - Orders: status. since (changed after date to ISO 8601), page.
• GET /orders/{id} - order in full with positions.
• POST /orders/{id}/status - change of status: {"status": "confirmed", "comment": "…"}; allowable transitions are the same as in the office (Orders: statuses and work with them).

Limitations and advice

• The frequency of requests is limited; if exceeding it comes 429 - Say it again later.
• For regular synchronization use since instead of overkill.
• To find out about events immediately, rather than by polling, subscribe to webhooks.webhooks).
• Full description of methods and schemes - interactive documentation /api/v1/docs (Available to site administrators; if you need access, write in support).