Интеграция Яндекс Форм и ApiShip

В ApiShip создаётся заказ на доставку: получатель с именем, телефоном и почтой, город и адрес из полей формы.

Из настройки интеграции: order.clientNumber, order.providerKey, order.pickupType, order.deliveryType, order.tariffId, order.weight.

Запрос в ApiShip: POST https://api.dev.apiship.ru/v1/orders.

{
  "answer": {
    "data": {
      "answer_short_text_58101": {
        "value": "Юлия Ковалёва",
        "question": {
          "label": {
            "ru": "Имя"
          }
        }
      },
      "answer_short_text_58102": {
        "value": "+7 950 614-29-87",
        "question": {
          "label": {
            "ru": "Телефон"
          }
        }
      },
      "answer_short_text_58103": {
        "value": "yu.kovaleva@example.ru",
        "question": {
          "label": {
            "ru": "Почта"
          }
        }
      },
      "answer_long_text_58104": {
        "value": "Позвоните перед доставкой",
        "question": {
          "label": {
            "ru": "Комментарий"
          }
        }
      },
      "answer_short_text_58105": {
        "value": "Екатеринбург",
        "question": {
          "label": {
            "ru": "Город"
          }
        }
      },
      "answer_short_text_58106": {
        "value": "ул. Малышева, 51, кв. 12",
        "question": {
          "label": {
            "ru": "Адрес"
          }
        }
      }
    }
  }
}

1. Доступ в ApiShip

   Логин и пароль кабинета ApiShip, код службы и номер тарифа.

   • Зарегистрируйтесь на apiship.ru, аккаунт заводится сам
   • Логин и пароль от кабинета и есть доступ к API: токен мы получаем сами при каждой отправке
   • Код службы доставки берётся из списка перевозчиков в кабинете, например cdek или dpd
   • Номер тарифа даёт расчёт стоимости: сделайте его в кабинете и запишите tariffId нужного варианта
   • Для проб есть тестовый контур с отдельным адресом, заказы в нём не уходят перевозчику

   Где взять доступ к ApiShip

2. Интеграция в кабинете

   В кабинете откройте «Connect» и подключите ApiShip. На вкладке «Настройка» в поле «Источник заявок» выберите «Яндекс Формы» и нажмите «Скопировать». Там же заполните блок «Доступ».

3. Отправка из Яндекс Форм

   • Откройте форму → Интеграции → «Отправить в вебхук» (или «HTTP-запрос»).
   • Адрес вебхука из кабинета, метод POST, тело — JSON с ответами.
   • Заполните форму для проверки: ответы придут по подписям вопросов.

   Яндекс Формы присылают ответы объектом: у каждого вопроса есть идентификатор, подпись и значение. Именем поля становится подпись вопроса. Если у вопроса задан короткий идентификатор, поле придёт и под ним, и под подписью. Ответы с несколькими вариантами склеиваются в одну строку через запятую. Одинаковые подписи у разных вопросов перезаписывают друг друга. Дайте вопросам разные подписи.

   Для ApiShip добавьте в форму:

   • вопрос «Город»
   • вопрос «Адрес»

4. Поля формы

   Назовите вопросы «Имя», «Телефон», «Почта», тогда сопоставление не понадобится.

   На вкладке «Настройка» в блоке «Поля формы» впишите:

   • «Город»: Город
   • «Адрес доставки»: Адрес

5. Проверка

   Заполните форму. На вкладке «Заявки» у неё будет статус «Черновик» и то, что уйдёт в ApiShip. Затем выключите «Черновой режим» на вкладке «Настройка».

   Яндекс Формы и Woove Connect: заявки с форм в CRM и мессенджеры