Интеграция ADP 101: Какая система ADP у вас на самом деле?

На прошлой неделе клиент позвонил мне в панике. Они потратили 3 дня, пытаясь интегрироваться с 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
Задержка запуска: Бесценно

Все из-за того, что никто не проверил длину кода компании.

Временная шкала ошибки интеграции ADP, показывающая разбивку затрат на 6-недельную разработку общей суммой $64,000

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

Функция	Обычный Workforce Now (3 символа)	Next Gen (4 символа)
Код компании	"ABC"	"ABCD"
Базовый URL API	`/hr/v2`	`/wfn/v1`
Поле ID сотрудника	`employeeID`	`worker.workerID.idValue`
Аутентификация	OAuth 2.0	OAuth 2.0 + Сертификаты
Документация	Устаревшая, но стабильная	Новее, но часто меняется
Лимиты скорости	100/минуту	60/минуту

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

Как фактически проверить вашу систему

Вариант 1: Спросите вашего администратора ADP (Быстрее всего)

Отправьте вашему администратору ADP это точное сообщение:

Тема: Быстрый вопрос по ADP

Привет [Имя],

Можете ли вы проверить код нашей компании ADP для меня?
Мне нужно знать, он состоит из 3 или 4 символов.

Вы можете найти это в: Компания > Настройки компании > Код компании

Спасибо!

Вариант 2: Проверьте сами

Войдите в ADP Workforce Now
Нажмите на название вашей компании (верхний правый угол)
Перейдите в Компания > Настройки компании
Найдите Код компании

Что делать дальше

Как только вы узнаете вашу систему:

Если у вас обычный Workforce Now (3 символа):

Используйте документацию HR API v2
Ожидайте более простые, плоские структуры данных
Планируйте лимит скорости 100 запросов/минуту

Если у вас Next Gen (4 символа):

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

Дерево принятия решений для идентификации системы ADP для различения 3 против 4 символьных кодов компании

Суть

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

Проверьте. Длину. Кода. Вашей. Компании.

Это занимает 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. Мы точно знаем, какая у вас система и как интегрироваться с ней эффективно.