Надсилайте свій прайс до ADAM

Налаштування → Інтеграції → Підключити. Секрет показується один раз при створенні й зберігається лише як хеш — тримайте його там, де його читає ваша ERP. Надсилайте як Authorization: Bearer ….

curl -X POST https://ingest.adam.ua/v1/products \
  -H "Authorization: Bearer adam_live_…" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"sku":"KRB-46","name":"Карбамід 46% гранульований","brand":"Sumykhimprom","category":"Добрива","unit":"кг","price":12.5,"stock":1000,"warehouse":"Київський склад","moq":100,"updated_at":"2026-08-24T14:02:31Z"}]}'

202, бо рядки прийняті в обробку, а зіставлення й перевірка ще попереду. Відхилення називають ваш власний індекс позиції, тому вивантаження, яке ви правите поетапно, сходиться.

{
  "request_id": "8f14e45f-ceea-467a-9c4c-1b0f0e5c9e2a",
  "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "accepted": 1198,
  "rejected": [
    {
      "index": 42,
      "sku": "XYZ-1",
      "reason": "category_unresolved",
      "detail": "«Хімія» matches no category"
    },
    {
      "index": 87,
      "sku": "KRB-99",
      "reason": "required_field_missing",
      "field": "brand"
    }
  ],
  "rejected_total": 2
}

Коли позицію зв’язано, PATCH /v1/offers змінює її ціну й залишок без перевірки та без участі людини. Ви надсилаєте той самий артикул, що вже надсилали у вивантаження товарів, а ми змінюємо пропозицію за ним. Це той виклик, який ваша ERP робить за розкладом.

curl -X PATCH https://ingest.adam.ua/v1/offers \
  -H "Authorization: Bearer adam_live_…" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"sku":"KRB-46","price":12.9,"stock":840,"updated_at":"2026-08-25T09:00:00Z"},{"sku":"KAS-32","stock":0},{"sku":"OLD-01","discontinued":true}]}'

Позиція потребує sku і щонайменше одного з price, stock, moq, discontinued. Усе, що ви не надіслали, залишається як є — тому прохід лише по залишках жодного разу не торкнеться ціни. Один sku відхиляється, а не рахується як застосований.

Надсилайте updated_at — і повтори перестають бути небезпечними: позиція, чий час старіший за останній застосований, нічого не змінює й повертається як stale_update. Не надсилайте — переможе останній запит, що надійшов: для одного планового завдання це нормально, для двох — ні.

unchanged — це позиції, у яких пропозиція вже мала надіслані значення. Нічого не записано і нічого не зламано: нічне вивантаження, що надсилає все, отримує applied за те, що змінилося, і unchanged за решту, а не тисячі помилок. Той самий updated_at із тими самими значеннями теж потрапляє сюди; із іншими значеннями це equal_timestamp_conflict, бо однаковий час не може сказати, яка версія актуальна.

Зняття з продажу й повернення не симетричні, і краще знати чому, ніж з’ясувати це на практиці. discontinued: true проходить завжди — прибрати власну пропозицію не потребує нічийого дозволу. discontinued: false повертає її лише якщо пропозиція повна й ваш акаунт має право публікувати; інакше рядок повертається як relist_blocked із причиною в detail.

not_published — кількість застосованих рядків на пропозиціях, яких фермер не бачить: чернетка, призупинена пропозиція. Ціна справді змінилася, але на неї ніхто не дивиться. Патч ніколи не публікує замість вас, тому цей показник — те, як ви про це дізнаєтеся, а не гадаєте, чому нічого не зрушило.

{
  "request_id": "1c9d4b7e-3f60-4a21-8de5-7a2b6c0f9e11",
  "applied": 1198,
  "unchanged": 613,
  "not_published": 42,
  "rejected": [
    {
      "index": 17,
      "sku": "ZIR-20",
      "reason": "sku_ambiguous",
      "detail": "7 of your offers carry this code: Зірочка Z-20, Зірочка Z-22, …"
    },
    {
      "index": 63,
      "sku": "KRB-46",
      "reason": "stale_update",
      "detail": "last applied 2026-08-25T09:00:00+00"
    }
  ],
  "rejected_total": 2
}

Той самий контракт, що в PATCH /v1/offers — та сама структура запиту, ті самі поля позиції, ті самі коди причин, той самий результат. Різниця лише в напрямку: не ваша система звертається до нас, а ми раз на добу звертаємося до URL на вашому боці. Більше в конвеєрі не змінюється нічого. Налаштовується в Налаштування → Інтеграції.

Створювати товари воно не може. Артикул, якого ми не знаємо, відхиляється як sku_unknown. Нові позиції так само йдуть через POST /v1/products і його чергу перевірки; автооновлення змінює ціну й залишок на вже зв’язаних позиціях — і більше нічого.

Тіло — те саме, що ви вже надсилаєте в PATCH /v1/offers: масив items, об’єкти якого несуть sku плюс price, stock, moq, discontinued і updated_at. Щонайменше одне з price, stock, moq, discontinued на позицію, інакше позиція відхиляється як no_change_requested. Нерозпізнане поле відхиляє весь запит як unknown_field — свідомо, а не тихим відкиданням. Максимум 5000 позицій (too_many_items), а одна партія понад 16 MiB JSON — це payload_too_large.

Раз на добу. Ви обираєте годину, від 00 до 23, і часовий пояс, у якому вона рахується — тому 03:00 означає 03:00 там, де працює ваша система, а перехід на літній час і назад ми враховуємо самі. Наступний запуск показано на картці. Обирайте годину, до якої ваше вивантаження вже записано, а не годину, коли воно починається.

Автентифікація необов’язкова: або нічого, або один заголовок Authorization: Bearer <token>, який ви задаєте в Налаштування → Інтеграції. Токен зберігається зашифрованим, надсилається на ваш сервер при кожному зверненні й ніколи не потрапляє ні в лог, ні в аргументи процесу. 401 або 403 від вас — це feed_http_error із цим статусом, а не наш код автентифікації.

Лише https:// — звичайний HTTP відхиляється до того, як буде встановлено з’єднання. Порт 443 або без порта взагалі: ми закріплюємо адресу, у яку розв’язалося ваше доменне ім’я, через curl --resolve host:443:<address>, і це закріплення діє на пару (хост, порт) — тому URL на іншому порті пішов би у звичайний DNS у момент звернення й повністю скасував би закріплення. Указуйте доменне ім’я, а не адресу — жодних IP-літералів і жодної їхньої шістнадцяткової, вісімкової чи цілочислової форми (https://0x7f000001/ відхиляється), бо клієнт вважає їх адресою й не розв’язує їх узагалі.

Дійсний TLS-сертифікат, що відповідає цьому доменному імені. Ми перевіряємо суб’єкт сертифіката, а не лише його ланцюжок і термін дії — сертифікат, дійсний для іншого імені, буде відхилено. І жодних перенаправлень: ми надсилаємо --max-redirs 0, тому 3xx повертається вам як feed_http_error із його статусом. Віддавайте файл за тим URL, який ви нам дали.

Звичайний GET — ми не надсилаємо ні тіла, ні власних параметрів запиту. Відповідь має бути коректним UTF-8; усе інше — це bad_encoding, а Windows-1251 — типова помилка вивантажень з українських і російських облікових систем. Межа — 16 MiB: вище неї завантаження припиняється і ви отримуєте too_large. На відповідь у вас 20 секунд; на розв’язання вашого доменного імені перед цим відведено окремі шість секунд. Не кешуйте вивантаження надовго за CDN — ми забираємо його раз на добу, тому Cache-Control із max-age на години чи дні означає, що ми читаємо вчорашній файл, а ваші ціни виглядають застиглими. Ставте короткий max-age або не ставте його взагалі.

Коли ви зберігаєте вивантаження, ми розв’язуємо ваше доменне ім’я й записуємо адресу. При кожному наступному зверненні ми розв’язуємо його знову і з’єднуємося лише з тією адресою, яку ваш власний DNS публікує для цього імені зараз, віддаючи перевагу записаній, поки вона серед них. Два наслідки, які варто назвати: переїзд хостингу не потребує від вас жодних дій, якщо DNS оновлено, і ми ніколи не з’єднаємося з адресою, якої ваш DNS зараз не називає. Якщо всі адреси, які він публікує, приватні, loopback, carrier-NAT, link-local або з зарезервованого простору, запуск припиняється з host_not_routable; якщо він не публікує жодної — pin_unresolvable.

Кожен запуск залишає рядок у журналі запитів на екрані інтеграцій, позначений як такий, що прийшов з автооновлення, з підрахунками й відхиленнями. Помилка, з якою ви можете щось зробити, додатково надсилає вам повідомлення в застосунку.

Збої на нашому боці — втрачена оренда запуску, наша база даних — свідомо не надсилають повідомлення й позначені як наші, бо це не те, що ви можете виправити, а наступний запланований запуск повторює спробу сам.

• seedsНасіння

  Hybrids · Seed · seeds · Sowing material · Гибриды · Гібриди · Кукурудза · Кукуруза · Насіннєвий матеріал · Насіння · Насіння кукурудзи · Насіння рапсу · Насіння сої · Насіння соняшника · Посевной материал · Посівний матеріал · Пшеница · Пшениця · Рапс · Семена · Семена кукурузы · Семена подсолнечника · Семена подсолнуха · Семена рапса · Семена сои · Семенной материал · Соняшник · Соя · Ячмень · Ячмінь

• fertilizersДобрива

  Fertiliser · Fertilizer · fertilizers · Growth stimulants · Micro fertilizers · Агрохимия · Агрохімія · Добрива · Микроудобрения · Микроудобрения и стимуляторы роста · Минеральные удобрения · Мікродобрива · Мікродобрива та стимулятори росту · Мінеральні добрива · Органические удобрения · Органічні добрива · Стимулятори росту · Стимуляторы роста · Удобрения

• pesticidesЗасоби захисту рослин

  Agrochemicals · CPP · Crop Protection · Fungicide · Fungicides · Herbicide · Herbicides · Insecticide · Insecticides · Pesticide · pesticides · Plant protection · Агрохимикаты · Агрохімікати · Адъюванты · Адьюванти · Акарициди · Акарициды · Гербицид · Гербициды · Гербіцид · Гербіциди · Десиканти · Десиканты · Засоби захисту · Засоби захисту рослин · ЗЗР · Инсектицид · Инсектициды · Інсектицид · Інсектициди · Пестициди · Пестициди та агрохімікати · Пестициды · Пестициды и агрохимикаты · Прилипатели · Прилипачі · Прилипачі (пав) · Протравители · Протруйник · Протруйники · Родентициди · Родентициды · СЗР · Средства защиты · Средства защиты растений · Фунгицид · Фунгициды · Фунгіцид · Фунгіциди

• fuel-lubricantsПально-мастильні матеріали

  Diesel · Fuel · fuel-lubricants · Grease · Lubricants · Oils · Антифриз · Бензин · Горюче-смазочные материалы · ГСМ · Дизельне пальне · Дизельное топливо · ДТ · Масла · Мастила · Пальне · Пально-мастильні матеріали · ПММ · Смазки · Топливо

• machineryТехніка

  Combines · Equipment · Implements · machinery · Tractors · Комбайни · Комбайны · Обладнання · Оборудование · Прицепы · Причепи · Сельхозтехника · Сільгосптехніка · Техника · Техніка · Трактори · Тракторы

• spare-partsЗапчастини

  Bearings · Belts · Filters · Parts · spare-parts · Детали · Деталі · Запчасти · Запчастини · Ножи · Ножі · Підшипники · Подшипники · Ремені · Ремни · Фильтры · Фільтри

• tires-wheelsШини та диски

  Rims · Tires · tires-wheels · Tyres · Wheels · Диски · Колеса · Колёса · Покришки · Покрышки · Шини · Шини та диски · Шины · Шины и диски

• suppliesВитратні матеріали

  supplies · Витратні матеріали · Расходные материалы · Спецодежда · Спецодяг · Тара · Упаковка

• servicesПослуги

  services · Послуги · Сервис · Сервіс · Услуги

• livestockТваринництво

  livestock · Ветпрепарати · Ветпрепараты · Животноводство · Корма · Корми · Тваринництво

• energy-systemsЕнергосистеми

  energy-systems · Генератори · Генераторы · Енергосистеми · Солнечные панели · Сонячні панелі · Энергосистемы

• piece

  шт · штука · штук · штуки · од · одиниця · pcs · pc · piece · unit

• kg

  кг · кілограм · килограмм · кілограмів · kg

• ton

  т · t · тонна · тонн · тонни · ton · tonne

• liter

  л · l · літр · литр · літрів · liter · litre

• bag

  мішок · мешок · мішків · bag

• pack

  уп · пак · пачка · упаковка · паковання · pack

• canister

  каністра · канистра · кан · canister

• bottle

  пляшка · бутылка · флакон · bottle

• set

  набір · набор · set

• hectare

  га · гектар · гектарів · ha · hectare

• POST /v1/products — 5000 × 10 min · 30 req / 10 min
• PATCH /v1/offers — 5000 × 60 s · 30 req / 60 s
• 20000 unresolved rows · 10 open jobs

Надсилайте Idempotency-Key на кожному справжньому виклику. Повтор із тим самим ключем повертає збережений результат — те саме завдання, ті самі відхилення — і нічого не створює, тож таймаут на вашій стороні ніколи не стає другим прайсом. Повтор несе перші 20 відхилень і rejected_total; решту беріть з ендпоїнта відхилень.

Контракт вище також опублікований як документ OpenAPI 3.1, згенерований з того самого джерела — тож він не може розійтися з цією сторінкою. Наведіть на нього будь-який клієнт і отримаєте конструктор запитів, валідацію та консоль Try it, якої ми не пишемо самі.

https://adam.ua/docs/api/openapi.json
https://adam.ua/docs/api.md

• Postman · Insomnia · Bruno — Import → Link, вставте URL
• Swagger Editor — File → Import URL
• Генератори клієнтів — openapi-generator, oazapfts, openapi-typescript

Щоб надіслати справжній запит, потрібен робочий ключ. Робіть це в Налаштування → Інтеграції → Пісочниця, де ключ залишається у вашій сесії, а не на сторінці, яку може відкрити будь-хто.

Прийняті рядки зіставляються з нашим каталогом і потрапляють на ваш екран перевірки. Позицію, яку ми розпізнали, ви підтверджуєте там; ту, яку не розпізнали, стає заявкою на новий товар каталогу. Перевірка — крок людини, і він не миттєвий: плануйте перше вивантаження із цим на увазі. Це також одноразово: коли позицію зв’язано, її ціна й залишок ідуть через PATCH /v1/offers і більше ніколи не стають у чергу на перевірку.

currency, vat_rate і lead_time_days не читаються на жодному з ендпоїнтів, тому їх надсилання — помилка, а не тихе відкидання. Сходинки ціни за кількістю через API теж не редагуються: пропозиція зі сходинками відхиляє фіксовану price як price_tiered.