Условия использования API К-247

1. Термины

1. 1.1. Площадка — интернет-сервис К-247 (биржа автозапчастей, интернет-магазин и кабинеты участников) и его оператор. Реквизиты оператора — в разделе 12.
2. 1.2. Компания — юридическое лицо или индивидуальный предприниматель, зарегистрированные на площадке и принявшие её оферту и правила.
3. 1.3. API — программный интерфейс площадки версии 1: адреса вида /api/v1/…, описанные на странице «Как подключиться» и в файле /api/openapi.json (дальше — документация).
4. 1.4. Ключ — секретная строка, по которой API узнаёт компанию. Тестовый ключ начинается с k247_test_, боевой — с k247_live_.
5. 1.5. Кабинет — личный кабинет компании на площадке. Ключи, источники прайсов, часы работы и журнал запросов находятся в разделе «Прайс и подключение».
6. 1.6. Витрина — поиск и предложения, которые видят покупатели площадки в кабинете и через API.
7. 1.7. Биржа — раздел площадки, где покупатель размещает заявку (что нужно, на какую машину и к какому сроку), а продавцы отвечают коммерческими предложениями (дальше — КП). В API заявка — exchange_request, КП — proposal. Заказ, оформленный по принятому КП, отмечен признаком source: exchange.
8. 1.8. Покупатель-организация — компания (юридическое лицо или индивидуальный предприниматель) в роли покупателя. Заказы и заявки на бирже через API доступны только таким компаниям; для кабинета частного покупателя (автовладельца) эти методы закрыты.
9. 1.9. Условия дополняют оферту и правила площадки. Расчёты, комиссия, возвраты, ответственность сторон и порядок споров регулируются офертой. В вопросах работы с API при расхождении действуют эти условия. Тексты документов — в разделе 12: правила площадки, договор с продавцом, пользовательское соглашение и политика обработки персональных данных.

2. Принятие условий

1. 2.1. Условия принимает сотрудник компании в кабинете перед выпуском первого боевого ключа. Площадка записывает версию условий, дату и время принятия, сотрудника и IP-адрес его сессии.
2. 2.2. Принимая условия, сотрудник подтверждает, что вправе действовать от имени компании. Принятие распространяется на компанию и все её ключи, в том числе выпущенные позже другими сотрудниками.
3. 2.3. Тестовый ключ выпускается без принятия условий, но пользоваться им можно только с соблюдением разделов 3, 5 и 6.
4. 2.4. Через API работают обе стороны площадки. Компания-продавец размещает прайсы и предложения, получает заказы, отвечает КП на заявки биржи. Покупатель-организация ищет позиции, перепроверяет условия, оформляет заказы, размещает заявки на бирже и принимает КП. Одна и та же компания может делать и то, и другое — как в кабинете с переключателем «покупаю / продаю».
5. 2.5. Пока администратор компании не принял в кабинете документы площадки (правила, договор с продавцом или пользовательское соглашение, политика обработки персональных данных), боевой ключ не может загружать прайс, отправлять КП, создавать заявки и оформлять заказы: ответ — 403 LEGAL_NEEDS, а список недостающих документов приходит в ping. Исполнение уже оформленного — подтверждение, отказ, отгрузка, снятие КП и заявки — не блокируется.

3. Ключи и их хранение

1. 3.1. Ключ выпускает сотрудник компании в кабинете. Число действующих ключей ограничено: не больше 5 тестовых и столько же боевых.
2. 3.2. Ключу выдаются права: offers — прайсы, предложения, склады и загрузки; orders — заказы; exchange — биржа: заявки, КП и заказы по принятым КП. Компания выдаёт ключу только те права, которые нужны её программе. У ключа с правом «Биржа» указывается, заявки какого региона он видит: своего (как лента сотрудника в кабинете) или всей России.
3. 3.3. Ключ показывается один раз — при выпуске. Площадка хранит не сам ключ, а его отпечаток, поэтому показать или восстановить ключ нельзя: потерянный ключ отзывают и выпускают новый.
4. 3.4. Ключ передаётся только в заголовке Authorization: Bearer по HTTPS. Ключ в адресе запроса, его параметрах или теле не принимается.
5. 3.5. Компания хранит ключ в тайне: в хранилище секретов или настройках сервера, доступных только ответственным сотрудникам. Нельзя передавать ключ третьим лицам, публиковать его в открытых репозиториях, переписке и заявках в поддержку, встраивать в страницы сайта, мобильные приложения и другие программы, которые попадают к посторонним.
6. 3.6. Любой запрос по ключу считается действием компании. Компания отвечает за действия по ключу до его отзыва.
7. 3.7. О выпуске и отзыве ключа площадка сообщает в кабинете всем сотрудникам компании.
8. 3.8. Если ключ мог попасть к посторонним или уволился сотрудник, у которого был доступ к ключу, компания сразу отзывает ключ в кабинете и выпускает новый. Если по ключу могли пройти чужие запросы, компания сообщает об этом площадке (раздел 12).
9. 3.9. Ключ действует, пока действует выпустивший его сотрудник. Если сотрудника отключили в кабинете, запросы по его ключам отклоняются с кодом KEY_OWNER_INACTIVE, а сотрудники компании получают уведомление. Ключи снова работают, если сотрудника включат; иначе компания выпускает новые.

4. Тестовое и боевое окружение

1. 4.1. Оба окружения работают по одному адресу, окружение определяет ключ. Метод ping показывает окружение и права ключа.
2. 4.2. Тестовый ключ (песочница) можно выпустить сразу после регистрации, до проверки реквизитов. Загрузки прайсов и пакеты предложений по нему проверяются и возвращают отчёт, но на витрине не публикуются. Заказы по тестовому ключу только тестовые: они создаются на собственные опубликованные позиции компании, не попадают в общий список заказов и не меняют остатки, резервы, балансы и долю отказов. Лимиты тестового ключа — пятая часть боевых.
3. 4.3. Боевой ключ публикует данные на витрине и работает с настоящими заказами покупателей. Он выпускается после того, как площадка проверила реквизиты компании, а сотрудник принял эти условия.
4. 4.4. Если площадка снимает отметку о проверке реквизитов, запросы по боевым ключам отклоняются с кодом COMPANY_NOT_VERIFIED, пока проверка не будет восстановлена. Ключи при этом не отзываются.
5. 4.5. Интеграцию отлаживают тестовым ключом. Публиковать боевым ключом вымышленные или проверочные позиции запрещено.
6. 4.6. Биржа тоже отлаживается в песочнице. Тестовым ключом продавец получает заявки робота-покупателя, а покупатель — КП роботов-продавцов; сценарий задаётся в запросе. Тестовые заявки, КП и заказы не видны другим участникам, не двигают деньги, остатки, рейтинг и долю отказов, нумеруются отдельно и удаляются через 7 дней после закрытия. Отвечать боевым ключом на тестовые заявки и наоборот нельзя: чужое окружение отвечает «не найдено».

5. Лимиты и честное использование

1. 5.1. Частота запросов ограничена для каждого ключа и для компании в целом: все ключи компании вместе получают не больше двойного лимита одного ключа. Действующие значения для боевого ключа, у тестового ключа — пятая часть каждого значения. Тестовые заказы покупателя тестовый ключ отправляет в пределах лимита методов общего назначения:

1. 5.2. В пакете предложений — до 1 000 строк, файл прайса — до 100 МБ и 500 000 строк.
2. 5.3. При превышении лимита API отвечает кодом 429 с заголовком Retry-After. Программа компании ждёт указанное время и повторяет запрос с тем же Idempotency-Key; повторять запросы без паузы нельзя. Неудачные попытки авторизации ограничены отдельно: не больше 30 в минуту с одного IP-адреса.
3. 5.4. Лимиты публикуются в документации и в заголовках X-RateLimit-* каждого ответа. Площадка может менять лимиты; о снижении она заранее сообщает в кабинете, кроме случаев защиты от атаки или перегрузки.
4. 5.5. Запрещено:
   • массово выгружать витрину и справочники, сохранять чужие предложения в собственную базу, передавать или продавать выдачу К-247 третьим лицам, публиковать её на других площадках;
   • обходить лимиты несколькими ключами или компаниями, подбирать идентификаторы, пытаться получить данные других участников;
   • проводить нагрузочные проверки и поиск уязвимостей без письменного согласования с площадкой;
   • загружать файлы с вредоносным содержимым и указывать в источниках прайса адреса внутренних сетей;
   • выполнять через API действия, которые компания не вправе выполнить в кабинете.
5. 5.6. Найденную уязвимость компания не использует и сообщает о ней площадке.
6. 5.7. У биржи есть отдельные технические пределы: не больше 60 заявок в час на компанию и 300 одновременно действующих заявок, созданных программой; замена отправленного КП — не чаще раза в 5 минут и не больше 10 раз по одной заявке. Пределы защищают торг от программ, которые работают быстрее людей: они не меняют правил биржи и не действуют в кабинете. Подбирать цену соперника перебором замен запрещено (пункт 5.5).
7. 5.8. Заявка на бирже — обращение к живым продавцам. Компания не создаёт заявок, по которым не собирается покупать, не дублирует одну потребность несколькими заявками ради сбора цен и снимает заявку, когда потребность отпала.

6. Данные и обезличивание

1. 6.1. Компания сохраняет права на свои прайсы и данные о складах и разрешает площадке хранить их, приводить к единому виду (бренды, артикулы, сроки, склады), связывать с каталогом и аналогами и показывать покупателям на витрине и в API, пока позиции размещены.
2. 6.2. До оформления заказа покупатель видит продавца обезличенно: код продавца (например, ТТ-014), город склада, цену, остаток, срок поставки и рейтинг, в API — также долю отказов. Название, контакты и адрес компании до заказа не показываются. Фото по ссылкам из прайса показываются только с адресов, разрешённых площадкой, чтобы продавца нельзя было узнать по сайту.
3. 6.3. После оформления заказа покупатель, который его оформил, видит в карточке заказа, счёте и УПД название, ИНН, адрес и телефон продавца: эти сведения нужны для исполнения заказа и закрывающих документов. Другим покупателям они по-прежнему не показываются.
4. 6.4. По заказу компания получает сведения, нужные для сборки и отгрузки: код или название покупателя, город, способ и адрес доставки, в кабинете — контактный телефон. Эти сведения, в том числе персональные данные частных покупателей, компания использует только для исполнения заказа: не делает по ним рассылок, не передаёт третьим лицам, кроме служб доставки, и защищает в соответствии с Федеральным законом № 152-ФЗ «О персональных данных».
5. 6.5. Площадка ведёт журнал обращений к API: время, метод, код ответа, длительность, число строк, идентификатор запроса и IP-адрес. Тела запросов и ответов и сами ключи в журнал не пишутся. Журнал компании доступен ей в кабинете. По умолчанию журнал хранится 30 дней, файлы прайсов — 30 дней, отчёты загрузок — 90 дней.
6. 6.6. Пароли и токены авторизации, которые компания указывает для скачивания прайса по ссылке, площадка хранит в зашифрованном виде.
7. 6.7. Компания может в любой момент снять позиции с витрины: обнулить остаток, удалить предложение через API или загрузить прайс в режиме «Файл — это весь мой склад».
8. 6.8. На бирже покупатель для программы продавца обезличен. Программа получает марку, модель, год и VIN машины — без них деталь не подобрать — и постоянный псевдоним покупателя вида «П-7F3A9C», одинаковый во всех его заявках и заказах у этого продавца. Названия компании, публичного кода, телефона, государственного регистрационного знака автомобиля и адреса получения в API нет — ни в заявке, ни в заказе по принятому КП. Покупателю площадка не раскрывает название продавца и внутренние коды его позиций.
9. 6.9. Телефоны, адреса электронной почты, ссылки, адреса сайтов и имена пользователей в мессенджерах в заявках и КП передавать нельзя: такой текст отклоняется с кодом CONTACTS_FORBIDDEN, а в записях, сделанных раньше, закрывается пометкой «[скрыто]». Договариваются стороны через площадку. Фото детали передаётся отдельным полем строки КП и только ссылкой на публичный фотохостинг из списка площадки: ссылка на свой сайт — это контакт.

7. Корректность прайсов

1. 7.1. Компания отвечает за достоверность данных, которые передаёт через API, файлы, ссылки и почту: бренд, артикул, наименование, цену, остаток, срок поставки и склад.
2. 7.2. Цена в прайсе — цена продажи покупателю площадки. Остаток — количество, которое компания действительно готова продать. Товар, которого нет, публикуется с нулевым остатком или снимается с витрины.
3. 7.3. Компания обновляет прайс не реже чем раз в 72 ч. Позиции из более старого прайса показываются покупателям с пометкой «под заказ», а заказы на них компания обрабатывает на общих условиях.
4. 7.4. Площадка вправе не публиковать строки с ошибками. Строки с неизвестным площадке брендом появляются на витрине после проверки менеджером.
5. 7.5. Если новая загрузка сильно отличается от предыдущей (например, пропала заметная доля позиций или резко изменились цены), публикация останавливается до решения компании или менеджера площадки. Остановленная загрузка, по которой не принято решение, со временем отклоняется.
6. 7.6. Отказ от заказа из-за ошибки в прайсе, изменившейся цены или отсутствия товара засчитывается в долю отказов (раздел 8). Подтверждённая позиция исполняется по цене заказа.
7. 7.7. Компания не загружает данные, на публикацию которых у неё нет прав: чужие прайсы, фотографии и описания. Претензии покупателей и третьих лиц, связанные с недостоверными или неправомерно размещёнными данными компании, компания урегулирует самостоятельно.

8. Подтверждение заказов

1. 8.1. Подтверждение заказов включается автоматически, когда компания подключает прайс по ссылке или почте либо выпускает боевой ключ. Переключатель «Подтверждать заказы перед сборкой» и часы работы — в разделе «Прайс и подключение».
2. 8.2. Каждую позицию заказа нужно подтвердить — полностью или частично — либо отклонить с указанием причины в течение 2 ч. Срок считается только в часы работы компании, указанные в кабинете, а если они не указаны — с понедельника по пятницу, 09:00–19:00 по московскому времени.
3. 8.3. Когда срок подтверждения прошёл, площадка напоминает о заказе в кабинете. Позиции, не разобранные за 4 ч рабочего времени, отменяются автоматически. Если покупатель оплатил заказ с баланса площадки, деньги за отменённые позиции возвращаются ему на баланс.
4. 8.4. Подтверждая позицию, компания обязуется передать товар в подтверждённом количестве, по цене заказа и в срок, указанный в предложении или при подтверждении. Отказаться от подтверждённой позиции можно до отгрузки, такой отказ учитывается в доле отказов так же, как отказ до подтверждения.
5. 8.5. Причина отказа указывается правдиво. Список причин и признак, засчитывается ли причина в долю отказов, публикуются в справочнике GET /api/v1/dictionary/statuses. Сейчас засчитываются: «нет в наличии», «цена изменилась», «ошибка в прайсе», частичное подтверждение (по неподтверждённому количеству) и автоотмена. Не засчитываются отмены покупателем и менеджером площадки, дубль заказа и автоотмена, срок которой пришёлся на нерабочее время компании.
6. 8.6. Доля отказов считается за последние 90 дней, если решённых позиций не меньше десяти (значения площадки по умолчанию). Её видят компания в кабинете, менеджеры площадки и покупатели в выдаче API. Если доля отказов выше 20 %, площадка вправе связаться с компанией и принять меры из раздела 9.
7. 8.7. О новом заказе площадка сообщает в кабинете и по каналам уведомлений, которые компания включила в кабинете. Программа компании узнаёт об изменениях заказов опросом GET /api/v1/seller/orders с параметром since_seq. Компания сама следит за заказами в часы работы: задержка уведомлений, сбой её программ или отсутствие сотрудников срок подтверждения не продлевают.
8. 8.8. Отгрузку компания отмечает после фактической передачи товара покупателю или службе доставки.
9. 8.9. Расчёты по заказам, комиссия площадки и возвраты — по оферте.
10. 8.10. Условия возврата и гарантии, которые покупатель принимает при оформлении заказа, общие для всех продавцов: это документ площадки «Условия возврата и гарантии» (ссылка — в конце страницы). Собственные условия возврата и текст условий гарантии компании покупателю не показываются. Покупателю показывается срок гарантии позиции — в колонке «Гарантия» кабинета и в выдаче API: срок в месяцах и признак «гарантия изготовителя», которые компания указывает в прайсе (warranty_months и warranty_manufacturer в API, колонки «Гарантия» и «Гарантия изготовителя» в файле). Если срок не указан или он меньше срока площадки, покупателю показывается и действует срок площадки: 6 месяцев с получения, а для б/у товара у покупателя — организации или ИП — 14 дней. Срок, с которым оформлен заказ, после оформления не меняется. Заявку на возврат площадка принимает после отгрузки, в сроки из условий площадки: товар, который не подошёл, организации и ИП возвращают в течение 14 дней с получения и только по возвратным позициям; покупателю — физическому лицу сроки и права возврата даёт закон о защите прав потребителей, признак возвратности их не ограничивает; требования по недостатку принимаются в течение гарантийного срока позиции, а от физического лица — и после него, в пределах двух лет с получения. Позиции, которые компания не принимает к возврату, она отмечает в прайсе: returnable: false в API или «нет» в колонке «Возврат» файла. Если условия возврата или гарантии компании отличаются от условий площадки, компания сообщает об этом площадке до начала продаж.
11. 8.11. Отправленное КП — обязательство продавца продать перечисленные позиции по указанной цене, пока КП действует. Поэтому заказ по принятому КП не подтверждается и не отклоняется: методы подтверждения и отказа отвечают кодом EXCHANGE_ORDER, компании остаётся собрать и отгрузить заказ. Если товара не стало, компания обращается к менеджеру площадки. Пока по КП ничего не куплено, его можно снять или заменить новым — в кабинете и через API.
12. 8.12. Покупатель-организация, оформляя заказ или принимая КП через API, подтверждает ознакомление с условиями возврата (поле accept_terms). Площадка записывает это в журнал согласий компании. Принятие КП и оформление заказа — такие же действия компании, как в кабинете, и отвечает за них компания, чьим ключом они сделаны (пункт 3.6).

9. Приостановка доступа

1. 9.1. Площадка вправе без предварительного уведомления ограничить запросы, отозвать ключ или выключить источник прайса, если ключ, по всем признакам, попал к посторонним, запросы угрожают работе площадки или данным других участников либо компания нарушает раздел 5.
2. 9.2. Площадка вправе, предупредив компанию в кабинете, приостановить работу боевых ключей или показ предложений компании, если компания систематически публикует недостоверные данные, долго держит долю отказов выше порога из пункта 8.6 или нарушает другие положения условий или оферты.
3. 9.3. Об отзыве ключа площадкой сообщается в кабинете всем сотрудникам компании. После устранения причины компания выпускает новый ключ.
4. 9.4. Компания может прекратить работу через API в любой момент: отозвать ключи и выключить источники в кабинете. Размещённые позиции остаются на витрине, пока компания их не снимет (пункт 6.7).

10. Работа и версии API

1. 10.1. API предоставляется в том виде, в каком работает. Площадка стремится к бесперебойной работе, но возможны перерывы на обслуживание и сбои. О плановых работах площадка по возможности сообщает заранее.
2. 10.2. Новые необязательные поля и значения появляются без смены версии. Программа компании должна пропускать неизвестные поля и значения.
3. 10.3. Несовместимые изменения выходят только в новой версии с другим адресом, например /api/v2. О них площадка предупреждает не менее чем за 30 дней. Журнал изменений — в разделе «Изменения» документации.
4. 10.4. Загрузки прайсов, пакеты предложений, отправка КП по заявке биржи, заявки покупателя на бирже, принятие КП, заказы покупателя, тестовые заказы и тестовые заявки песочницы принимаются только с заголовком Idempotency-Key: повтор запроса с тем же ключом после сетевого сбоя не создаёт дубль. Ключ действует сутки: по истечении срока тот же ключ считается новым запросом. Отказ по существу запроса (ответ 4xx, кроме 429) закрепляется за ключом: исправленный запрос отправляется с новым ключом.

11. Изменение условий

1. 11.1. Площадка может изменять условия. Новая редакция публикуется на этой странице с новой датой и номером версии, о ней сообщается в кабинете.
2. 11.2. Новая редакция вступает в силу через 30 дней после публикации, если в ней не указан более поздний срок. Изменения, которых требует закон, могут вступать в силу раньше.
3. 11.3. Перед выпуском следующего боевого ключа сотрудник принимает действующую редакцию. Продолжая пользоваться API после вступления редакции в силу, компания соглашается с ней. Если компания не согласна, она прекращает работу через API (пункт 9.4).

12. Контакты и реквизиты

1. 12.1. Вопросы по подключению — в разделе «Прайс и подключение» кабинета и по контактам площадки на главной странице.
2. 12.2. Об утечке ключа, найденной уязвимости или сбое, из-за которого не получается подтвердить заказы, компания сообщает площадке сразу, по телефону или электронной почте площадки.
3. 12.3. Сообщения по этим условиям площадка направляет компании в кабинет и по контактам, которые компания указала на площадке.

Реквизиты оператора площадки указаны в оферте К-247.

• Открыть правила площадки
• Открыть договор с продавцом
• Открыть пользовательское соглашение
• Открыть условия возврата и гарантии
• Открыть политику обработки персональных данных
• Открыть документацию для подключения
• Открыть описание API в формате OpenAPI
• Перейти на главную страницу К-247
• Вернуться в кабинет