ApiShip и Woove Site: тридцать служб доставки одной настройкой

Расчёт по тарифам всех подключённых перевозчиков в корзине, пункты выдачи на карте и отправление после оплаты

Интеграция ApiShip с магазином на Woove Site — это стоимость доставки сразу по всем службам, с которыми у вас заключён договор внутри ApiShip, показанная покупателю в корзине, и отправление, которое уходит перевозчику после оплаты. Вместо отдельной интеграции на каждую службу у вас один договор и одна настройка.

Что даёт интеграция

ApiShip — посредник между магазином и перевозчиками. Договор с самими службами заключается в кабинете ApiShip, туда же приходят акты. Мы обращаемся к его API вашим логином и паролем.

• Расчёт доставки в корзине — Покупатель вводит город или индекс — в корзине появляются варианты всех подключённых служб с ценой и сроком, отсортированные от дешёвого к дорогому; для доставки до пункта он выбирает пункт на карте.
• Оплаченный заказ — После оплаты в ApiShip создаётся заказ на выбранную службу и тариф; номер у перевозчика и ссылка на отслеживание попадают в заказ, статус обновляется сам.

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

1. Зарегистрируйтесь на apiship.ru — аккаунт заводится сам, без заявки
2. Подключите в кабинете ApiShip договоры с теми службами, которыми возите: расчёт показывает только их
3. Логин и пароль от кабинета и есть доступ к API, отдельный ключ выпускать не нужно
4. Для проб выберите тестовый контур: у него свой кабинет и свой пароль, заказы оттуда перевозчику не уходят
5. Адрес склада пишется одной строкой, как в почтовом адресе: г Москва, ул Машкова, д 21

Настройка в Woove Site

1. Откройте сайт → «Настройки» → «Интеграции» → «Доставка» и найдите карточку «ApiShip».
2. Включите переключатель и заполните поля из таблицы ниже.
3. Отметьте, какие события отправлять, и нажмите «Проверить доступ». Сервис должен ответить, что ключ подходит.
4. Нажмите «Тестовая заявка» и убедитесь, что в сервисе появилась проверочная запись.
5. Дальше события сайта уходят без вашего участия. Отправки видны в «Журнале» карточки.

• Логин — Почта, на которую заведён кабинет ApiShip.
• Пароль — Хранится скрыто, после сохранения показывается точками.
• Контур — Варианты: боевой / тестовый. По умолчанию: тестовый.
• Город отправителя — Например Москва.
• Адрес склада — Одной строкой: г Москва, ул Машкова, д 21.
• Отправитель — Заполняется по подписи поля.
• Телефон отправителя — Заполняется по подписи поля.
• Службы доставки — Коды через запятую: cdek, dpd, pochta. Пусто — все, с кем у вас договор в ApiShip.
• Служба для пунктов выдачи — Один код. Пункты на карте показываем только этой службы; пусто — вариантов «до пункта» не будет.
• Способы получения — Варианты: курьер и пункты выдачи / только курьер / только пункты выдачи. По умолчанию: курьер и пункты выдачи.
• Вес единицы, г — Если у товара он не задан. По умолчанию: 500.
• Наценка, ₽ — Упаковка и обработка; можно 0. По умолчанию: 0.

Что попадает в ApiShip

В корзине покупатель заполняет город, индекс и адрес и нажимает «Рассчитать доставку». ApiShip считает тарифы всех подключённых служб одним запросом, мы показываем их списком «Служба: тариф» с ценой и сроком, от дешёвого к дорогому, не больше сорока вариантов. К цене перевозчика прибавляется наценка из настройки. Для вариантов «до пункта» появляется кнопка выбора пункта: пункты и постаматы города с адресом, часами работы и картой. Пункты показываются только одной службы — той, что указана в настройке «Служба для пунктов выдачи», иначе покупатель выбрал бы пункт чужого перевозчика и отправление не создалось бы. Цену при оформлении пересчитывает сервер. После оплаты в ApiShip создаётся заказ: получатель, состав с артикулами, вес по настройке, выбранный пункт или адрес. Номер у перевозчика и ссылка на отслеживание сохраняются в заказе. Статусы ApiShip приводит к общему словарю для всех служб, поэтому «Вручён» выглядит одинаково и у СДЭК, и у Почты: заказ переходит в «Отправлен», затем в «Выполнен», покупателю уходит письмо с треком.

«Проверить доступ» входит в кабинет и считает доступные службы: в ответе будет их число. Для расчёта откройте свой сайт, положите товар в корзину и рассчитайте доставку до другого города.

Если не работает