← Back to Blog
Быстрый старт с API поставщика: создание, обновление, удаление товаров и выполнение заказов

Быстрый старт с API поставщика: создание, обновление, удаление товаров и выполнение заказов

Sophia Martinez By Sophia Martinez
Август 12, 2026 API 👁 91 views

Командам поставщиков, которые синхронизируют каталоги в Accplanet, нужен понятный цикл: создавать или обновлять товары, поддерживать честные остатки, выполнять заказы и обрабатывать возвраты или тикеты, когда что-то идет не так. Это краткое руководство проведет вас по этому циклу с использованием актуальной документации Supplier API.

Accplanet — это агрегационная маркетплейс-платформа для поставщиков. Вы выполняете заказы по остаткам; платформа берет на себя поиск покупателей, оформление заказов, отслеживание и инструменты поддержки. Используйте эти эндпоинты только для легитимных операций с каталогом и заказами — не для обхода правил или небезопасной автоматизации.

Кратко

  • Аутентификация с помощью X-API-Key, Authorization: Bearer, тела key/apikey или активной сессии в дашборде поставщика.
  • Товары: загрузить изображение → создать → список/обновить → добавить аккаунты автодоставки → удалять только когда правила позволяют.
  • Заказы: список → получить → обновить информацию о доставке / вложение → изменить статус → вернуть средства при необходимости.
  • Новые объявления могут требовать одобрения администратора перед публикацией.
  • Держите официальную документацию открытой для точных путей и таблиц параметров во время написания кода.

Аутентификация

Используйте свой API-ключ поставщика из профиля. JSON-запросы товаров/заказов обычно отправляют:

X-API-Key: YOUR_API_KEY
Content-Type: application/json

Аутентификация через сессию браузера также работает, когда вы вошли в дашборд поставщика — удобно с панелью Test API в документации.

Жизненный цикл Supplier API: загрузка, создание, обновление, пул доставки, выполнение заказов
Основной цикл поставщика от синхронизации каталога до выполнения заказов.

Жизненный цикл товара

1 · Сначала

Загрузить изображение

POST /products/api/supplier/upload-image/ с multipart-файлом изображения. Сохраните возвращенный image_path для массива images при создании/обновлении.

2 · Создать

Создать товар (или обновить по URL источника)

POST /products/api/supplier/create/ требует category_id, title, description, price. Необязательно: stock, min_quantity, images, source_product_id, source_product_url, warranty_period_days, status и пулы автодоставки через accounts или accounts_text.

Если source_product_url совпадает с более старым товаром в вашем аккаунте, API может обновить этот товар вместо создания дубликата (флаги created/updated в ответе). Следите за approval_status.

3 · Поддержка

Список, поиск, обновление

  • GET /products/api/supplier/products/ — постраничный список с фильтрами по поиску, категории, статусу, цене.
  • GET /products/api/supplier/products/by-source-id/<source_product_id>/ — быстрый путь для горячей синхронизации по ID источника.
  • POST /products/api/supplier/products/<product_id>/update/ — обновление названия, цены, остатков, изображений, полей источника, статуса или полей пула доставки.

Идентифицируйте товары по числовому ID каталога или product_id из ответов списка. Покупатели позже видят ID каталога как значения Customer API service при назначении.

4 · Пул доставки

Добавить аккаунты автодоставки

POST .../products/<product_id>/accounts/ добавляет учетные данные в пул автоматической доставки без изменения объявленных остатков. Используйте структурированные объекты accounts или строки accounts_text (user:pass / user|pass). Обращайтесь с возвращенным accounts_imported осторожно — это секретные данные.

5 · Удаление

Удаление, когда разрешено

POST .../products/<product_id>/delete/ навсегда удаляет товар без завершенных продаж. Предпочитайте изменение статуса, когда нужно просто остановить продажи.

Фокус эндпоинта Метод и путь (хост accplanet.com) Типичное использование
Загрузка изображения POST /products/api/supplier/upload-image/ Получить image_path
Создание POST /products/api/supplier/create/ Новое объявление / обновление по URL источника
Список GET /products/api/supplier/products/ Синхронизация состояния
По ID источника GET .../by-source-id/<id>/ Горячая синхронизация
Обновление POST .../products/<id>/update/ Цена, остатки, описание
Добавление аккаунтов POST .../products/<id>/accounts/ Пул автодоставки
Удаление POST .../products/<id>/delete/ Удаление неиспользуемого SKU

Жизненный цикл заказа

После покупок покупателей выполняйте заказы через Orders API:

  1. Список — GET /orders/api/supplier/orders/ с необязательными status, search, пагинацией.
  2. Получить — GET /orders/api/<order_id>/, когда нужен снимок одного заказа.
  3. Доставка — POST .../orders/<order_id>/delivered/ с delivered_info (обычный текст или строка JSON-массива). Установите append_delivered_info=true для добавления строк. Или загрузите файл через .../delivery-attachment/ (multipart file, ≤10MB).
  4. Статус — POST .../orders/<order_id>/status/ с допустимыми значениями, такими как pending_order, running_order, completed_order, refunded_order. receipt_confirmed_order нельзя установить через API.
  5. Возврат — POST .../orders/<order_id>/refund/ для полного возврата средств, когда ваш процесс требует этого.

Отслеживайте delivered_units, remaining_to_deliver и платежные поля из ответов списка/получения, чтобы логика вашего склада совпадала с дашбордом.

Пул автодоставки

Предзагрузите аккаунты на товар; Accplanet может поставить задачи доставки в очередь.

Ручная delivered_info

Отправляйте учетные данные или ключи по каждому заказу при ручном выполнении.

Вложение

Загрузите один файл выполнения, когда текстовых полей недостаточно.

Тикеты, платежи, баланс

  • Тикеты — список, получение, создание (order_id + название + описание), обновление статуса/ответа через /orders/api/supplier/tickets/.
  • Платежи — GET /orders/api/supplier/payments/ для записей платежей по вашим заказам.
  • Баланс — GET /users/api/balance/ возвращает балансы кошельков покупателя и поставщика для аутентифицированного аккаунта.

Статус одобрения, остатки и состояния заказов следуют актуальным правилам платформы. Подтверждайте поведение по текущей документации Supplier API при запуске продакшн-синхронизации.

Чек-лист поставщика

  • [ ] API-ключ поставщика хранится на сервере
  • [ ] category_id сопоставлен с категориями Accplanet (листовая подкатегория, если требуется)
  • [ ] Путь создания/обновления протестирован сначала с непродакшн-названием
  • [ ] Обновления остатков и цены идемпотентны в вашей задаче синхронизации
  • [ ] Пул доставки или ручной путь delivered_info проверен на тестовом заказе
  • [ ] Переходы статусов заказов соответствуют допустимым значениям дашборда
  • [ ] Пути тикетов и возвратов задокументированы для вашей команды поддержки

Следующий шаг: откройте документацию Supplier API, аутентифицируйтесь через Test API, создайте один черновой товар, затем потренируйте список → доставку → статус на заказе в песочнице. Покупателям, интегрирующим покупки, следует использовать краткое руководство Customer API в блоге Accplanet.

FAQ

Почему мой новый товар не виден покупателям?

Объявления могут требовать одобрения администратора (approval_status). Держите товар active только когда готовы продавать, и подтверждайте одобрение в ответе или дашборде.

В чем разница между product_id и business_id?

product_id — это системный идентификатор, используемый в путях поставщика. business

Похожие записи

Быстрый старт Customer API: интеграция Accplanet /api/v2 в одном цикле

Быстрый старт Customer API: интеграция Accplanet /api/v2 в одном цикле

Авг 12, 2026
Telegram