Где взять доступ к ApiShip
Путь по меню, нужные поля и что делать, если ApiShip отвечает ошибкой
Где взять доступ в ApiShip
- Зарегистрируйтесь на apiship.ru, аккаунт заводится сам
- Логин и пароль от кабинета и есть доступ к API: токен мы получаем сами при каждой отправке
- Код службы доставки берётся из списка перевозчиков в кабинете, например cdek или dpd
- Номер тарифа даёт расчёт стоимости: сделайте его в кабинете и запишите tariffId нужного варианта
- Для проб есть тестовый контур с отдельным адресом, заказы в нём не уходят перевозчику
Код службы и номер тарифа задают, кто и по какому тарифу везёт. Адрес отправителя и телефон обязательны: без них перевозчик не примет заявку. Вес и габариты берутся из настройки, если в заявке их нет.
Что заполнить в кабинете
Доступ
- Логин — —
- Пароль — —
- Контур — боевой, тестовый
Отправление
- Код службы доставки — например cdek, dpd, pochta
- Номер тарифа — —
- Номер договора со службой — если договоров с этой службой несколько
- Как забирают груз — курьер забирает у вас, вы сдаёте на ПВЗ
- Куда везут — курьером получателю, на ПВЗ
- Вес места, граммы — —
- Длина, см — —
- Ширина, см — —
- Высота, см — —
- Оценочная стоимость, рубли — —
- Название вложения — —
Отправитель
- Контактное лицо — —
- Телефон — —
- Город — —
- Адрес одной строкой — например: г Москва, ул Машкова, д 21
Что появится в ApiShip
В ApiShip создаётся заказ на доставку: получатель с именем, телефоном и почтой, город и адрес из полей формы, отправитель из настройки. Служба, тариф, тип забора и тип доставки тоже из настройки — ими вы и выбираете перевозчика. Вес, габариты и оценочная стоимость идут одним местом с одной позицией. Номер заказа в вашей системе генерируем сами, комментарий клиента передаём как есть. В ответ приходит номер заказа ApiShip — по нему заявка ищется в кабинете.
Как проверить
Отправьте пробную заявку со своего сайта и откройте её в кабинете: там видно, что прислала форма, что ушло в ApiShip и что он ответил. Пока включён черновой режим, наружу ничего не уходит.
Про эту интеграцию · Как подключить с нуля
Если не работает
ApiShip отвечает «Некорректный логин или пароль»
Проверьте контур: у боевого и тестового кабинеты разные, и пароль от одного в другом не работает.
Отвечает «тариф не найден» или «нет подключения к СД»
Тариф принадлежит конкретной службе. Сделайте расчёт в кабинете для своего направления и возьмите tariffId из ответа, а код службы поставьте тот же.
Заявка уходит, но перевозчик её не видит
Значит нет договора с этой службой внутри ApiShip. Договоры подключаются в кабинете ApiShip, а не у нас.
Несколько договоров с одной службой
Заполните «Номер договора со службой»: без него ApiShip не знает, каким из них отправлять.