Інтеграція ADP 101: Яка система ADP у вас насправді?

Торік клієнт дзвонить у паніці. Три дні бились з інтеграцією ADP, нічого не йде. Кожен API виклик - 404.

В чому була справа? Юзали доки для Workforce Now, а в них Next Gen система.

Ось як не попастися на цю граблю за 2 хвилини. (А якщо шукаєте готове рішення для інтеграції, глянь наші проєкти - там купа успішних ADP інтеграцій.)

30-секундна перевірка, яка врятує ваш розум 🎯

Швидка перевірка: Подивіться на код вашої компанії в ADP

• 3 символи (наприклад "ABC") → Звичайний Workforce Now
• 4 символи (наприклад "ABCD") → Workforce Now Next Generation

Ось і все. Серйозно.

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

Чому це важливіше, ніж ви думаєте

Ось що ніхто не каже: це не просто різні версії. Це зовсім різні системи.

API URL різні

// Звичайний Workforce Now
const API_BASE = 'https://api.adp.com/hr/v2';

// Next Generation
const API_BASE = 'https://api.adp.com/wfn/v1';

Структури даних різні

// Звичайний Workforce Now ID співробітника
{
  "employeeID": "123456",
  "firstName": "John",
  "lastName": "Doe"
}

// Next Gen ID співробітника (зверніть увагу на вкладену структуру)
{
  "worker": {
    "workerID": {
      "idValue": "123456"
    },
    "person": {
      "legalName": {
        "givenName": "John",
        "familyName": "Doe"
      }
    }
  }
}

Дізнався це о 23:00 в ніч деплою. Весело було 😅

Тому наша команда завжди спочатку з'ясовує, яка система, а потім вже лізе в код.

Реальний приклад: Помилка на $50K

Реальна історія: Fortune 500 компанія найняла консультантів для ADP інтеграції. Ті 6 тижнів кодили під звичайний Workforce Now.

Тут плот твіст: у них був Next Gen.

Вартість помилки:

• 6 тижнів часу консультантів: ~$48,000
• 2 тижні на перебудову: ~$16,000
• Затримка запуску: Безцінно

Все через те, що ніхто не глянув на довжину коду компанії.

Повна шпаргалка

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

Як фактично перевірити вашу систему

Варіант 1: Запитайте вашого адміністратора ADP (Найшвидше)

Надішліть вашому адміністратору ADP це точне повідомлення:

Тема: Швидке питання по ADP

Привіт [Ім'я],

Чи можете ви перевірити код нашої компанії ADP для мене?
Мені потрібно знати, чи він складається з 3 або 4 символів.

Ви можете знайти це в: Компанія > Налаштування компанії > Код компанії

Дякую!

Варіант 2: Перевірте самі

1. Увійдіть в ADP Workforce Now
2. Натисніть на назву вашої компанії (верхній правий кут)
3. Перейдіть до Компанія > Налаштування компанії
4. Знайдіть Код компанії

Що робити далі

Як тільки ви дізнаєтеся вашу систему:

Якщо у вас звичайний Workforce Now (3 символи):

• Використовуйте документацію HR API v2
• Очікуйте простіші, плоскі структури даних
• Плануйте ліміт швидкості 100 запитів/хвилину

Якщо у вас Next Gen (4 символи):

• Використовуйте документацію WFN API v1
• Приготуйтеся до вкладених JSON структур
• Плануйте ліміт швидкості 60 запитів/хвилину
• Вам знадобляться SSL сертифікати для автентифікації

Суть

Перш ніж писати код, читати доки або планувати інтеграцію:

Глянь. Довжину. Коду. Компанії.

Це займає 30 секунд і економить тижні болю.

Повірте мені на слово. Бував з обох боків цієї помилки, і ніколи не весело пояснювати босу, чому "проста" інтеграція запізнюється на 3 тижні.

Часті запитання

Як знайти код моєї компанії ADP?

Увійдіть в ADP Workforce Now, натисніть на назву вашої компанії (верхній правий кут), перейдіть до Компанія > Налаштування компанії та знайдіть Код компанії. Підрахуйте символи - якщо це 3 символи (наприклад "ABC"), у вас звичайний Workforce Now, якщо 4 символи (наприклад "ABCD"), у вас Next Generation.

Чи можу я використовувати один API для обох систем ADP?

Ні, абсолютно ні. Звичайний Workforce Now використовує кінцеві точки API /hr/v2, тоді як Next Gen використовує /wfn/v1. У них абсолютно різні структури кінцевих точок, методи автентифікації та формати даних. Використання неправильного API призведе до помилок 404 для кожного виклику.

Що станеться, якщо я використаю неправильну версію API?

Ви отримаєте помилки 404 для всіх викликів API, тому що кінцеві точки буквально не існують у неправильній системі. Наприклад, спроба викликати https://api.adp.com/hr/v2/workers у системі Next Gen не вдасться, тому що Next Gen відповідає лише на https://api.adp.com/wfn/v1/workers.

Яка система ADP краща для інтеграції?

У обох є плюси і мінуси:

• Звичайний Workforce Now: Простіші, плоскі структури даних та вищі ліміти швидкості (100/хв), але старіша документація
• Next Gen: Сучасніші функції та краща документація, але потребує SSL сертифікати та має складні вкладені JSON структури з нижчими лімітами швидкості (60/хв)

Скільки коштує перемикання між системами ADP?

Перемикання між звичайним Workforce Now та Next Gen не є простим оновленням - це повний проєкт міграції. Вам потрібно буде працювати з вашим представником ADP, оскільки це включає міграцію даних, перенавчання та потенційно зміни контракту. Більшість компаній повідомляють про витрати між $10,000-$50,000 залежно від розміру компанії.

Чи можу я визначити, яка у мене система, за URL входу в ADP?

Не надійно. Обидві системи часто використовують схожі URL входу. Єдиний гарантований спосіб дізнатися - перевірити довжину коду вашої компанії в налаштуваннях системи.

Що якщо код моєї компанії містить цифри?

Це нормально! Важлива кількість символів. "AB12" це 4 символи (Next Gen), тоді як "A12" це 3 символи (Звичайний). Наявність цифр або літер не впливає на те, яка у вас система.

Чи підтримують обидві системи однакові функції?

Ні, є значні відмінності у функціях. Next Gen зазвичай має сучасніші функції, такі як синхронізація в реальному часі та розширена звітність, тоді як звичайний Workforce Now має деякі застарілі функції, які ще не перенесені в Next Gen. Перевірте з ADP для конкретної відповідності функцій вашим потребам.

Потрібна допомога з інтеграцією?

Якщо ви маєте труднощі з інтеграцією ADP або хочете уникнути цих поширених пасток, наша досвідчена команда успішно реалізувала десятки інтеграцій ADP. Ми точно знаємо, яка у вас система і як інтегруватися з нею ефективно.

Рекомендований партнер з інтеграції

Для бізнесу, що шукає швидку реалізацію ADP, ми рекомендуємо TheyMakeIt - вони спеціалізуються на інтеграціях ADP з підтримкою ШІ та можуть завершити реалізації всього за 1 місяць (проти галузевого стандарту в 3-6 місяців). Вони підтримують як ADP Workforce Now, так і ADP Lyric HCM з функціями, такими як:

• Розумне картування даних
• Оптимізація розкладу
• Передбачувальна аналітика
• Автоматизований моніторинг відповідності

Їх експертиза в обробці складнощів, згаданих у цій статті, робить їх відмінним вибором для середніх підприємств у Сполучених Штатах.

---

Далі: Автентифікація ADP: Пояснення танцю OAuth токенів - Як тільки ви дізнаєтеся, яка у вас система, давайте підключимо вас.