# ApiShip

### Что такое ApiShip?

ApiShip - это универсальное интеграционное решение для подключения ко всем службам доставки в режиме "единого окна" (единый формат). Одна интеграция - все службы доставки в одном месте.

Преимущества:

* ApiShip позволяет собрать все необходимые вам способы доставки в рамках одного сервиса.
* Вы можете легко добавлять и удалять способы доставки в любое время, не меняя текущий API-ключ. 
* ApiShip автоматически рассчитывает стоимость доставки.
* Заказы клиентов автоматически попадают в ваш личный кабинет настроенной службы доставки, а клиент автоматически получает уведомление с трэк-номером в Telegram и на почту для отслеживания доставки заказа. 

С помощью ApiShip вы можете:

* Обеспечить своим покупателям широкий выбор способов доставки: СДЭК, Я.Доставка, Почта РФ и еще 40+ служб доставки 
* Улучшить свой сервис и повысить лояльность клиентов.

### Видео-инструкция подключения интеграции с ApiShip

{% embed url="<https://rutube.ru/video/41e1f69d0e61259a6a011f22007bbdef/>" %}
Видео-инструкция подключения служб доставок через ApiShip на примере Boxberry
{% endembed %}

### Подключение способ доставки ApiShip&#x20;

{% hint style="info" %}
**Важно!** Перед подключением ApiShip к магазину настройте способы доставки в панели управления ApiShip.
{% endhint %}

Для подключения способа доставки ApiShip, вам нужно [выполнить регистрацию](https://a.apiship.ru/#/signup) / выпустить Api Token в личном кабинете: <https://a.apiship.ru/#/dashboard>

### Как подключить службы доставки в ApiShip?

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FtZj5EpJByh7g8EuWwsPo%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-04-23%20%D0%B2%2021.32.46.png?alt=media&#x26;token=87a1c93f-8353-4df8-86d0-003577b76567" alt=""><figcaption><p>Раздел "службы доставки" </p></figcaption></figure>

**Выбор служб доставки:**&#x20;

* Перейдите в панель управления ApiShip:  <https://a.apiship.ru/#/providers/list>
* Выберите из списка доступных служб доставки те, которые вам нужны.
* Для каждого выбранного сервиса вы получите ссылку на страницу с инструкциями по подключению, следуйте им что бы настроить способ доставки.

\
**Регистрация и подключение способа доставки:**

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

Таким образом вы можете собрать все необходимые способы доставки в одном сервисе.

### Подключение ApiShip к TGShop

Скопируйте токен из панели управления в ApiShip&#x20;

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FWGaXnfW8JrYz4EDPmvLA%2FFrame%201000001202%20(2).webp?alt=media&#x26;token=4521725d-de92-48dd-8f74-ec6669bfa0f9" alt=""><figcaption><p>Панель управления ApiShip </p></figcaption></figure>

Перейдите в панель управления TGShop -> Настройки -> Доставка и выберите способ доставки ApiShip и заполните все поля

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FFwmkMuRUqwMybGVBugyO%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-05-01%20%D0%B2%2019.59.29%20(1)%20(1).png?alt=media&#x26;token=8469e901-caff-4851-be07-4457ef01f8bd" alt=""><figcaption><p>Заполнение полей для настройки интеграции с ApiShip </p></figcaption></figure>

1 - Токен - вставьте скопированный токен из панели управления ApiShip

2 - Контактный телефон - укажите контактный телефон как в договоре со службами доставки&#x20;

3 - ФИО контактного лица - укажите ФИО контактного лица как в договоре со службами доставке&#x20;

4 - Адрес склада - укажите адрес склада указанный в договоре со службами доставки, если вы не планируете настраивать способ забора груза товара с вашего склада - укажите любой адрес.&#x20;

5 - Тип габаритов - выберите из списка габариты вашего товара или укажите свои&#x20;

6 - Вес товара, гр - укажите приблизительный вес товаров&#x20;

{% hint style="info" %}
Настройки габаритов буду применяться по умолчанию для всех товаров в каталоге, если вы не задали для каждого товара свои габариты и вес. Если габариты и вес были указаны при добавлении товаров или при импорте, то для калькуляции стоимости доставки будут использоваться заданные вами данные, а не усредненные настройки габаритов товара.&#x20;
{% endhint %}

После добавления токена из ApiShip у вас отобразятся все подключенные к ApiShip службы доставки

Для каждой службы доставки необходимо настроить тип забора груза: от двери (служба доставки забирает заказ с вашего склада) или Со склада СД (вы привозите заказ на склад СД)

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FBLgocpaikyTs1Ia9ERCi%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-05-01%20%D0%B2%2020.22.51.png?alt=media&#x26;token=d3f87573-3b03-494a-9dcf-436b45d500f3" alt=""><figcaption><p>Настройки служб доставок в TGShop </p></figcaption></figure>

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2F4qonbHslCAnxArcAtnrc%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-05-01%20%D0%B2%2020.23.08.png?alt=media&#x26;token=cbfded61-cf09-48b7-acb5-e41f72c87407" alt=""><figcaption><p>Выбор типа забора груза </p></figcaption></figure>

Если вы планируете привозить заказ на склад службы доставки, выберите пункт доставки, куда будете привозить заказы&#x20;

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FCqxzgN2A6ler9vdPAtzf%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-05-01%20%D0%B2%2020.23.25.png?alt=media&#x26;token=205aadd9-433a-491f-8eb1-6e0b3c4840a2" alt=""><figcaption><p>Настройка забора груза "Со склада СД"</p></figcaption></figure>

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

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FUUno6EWMhh0S4UzAI0Nn%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-05-01%20%D0%B2%2020.23.36.png?alt=media&#x26;token=ce800b66-bbf4-417b-a179-bb192f66dbdd" alt=""><figcaption><p>Выбор города отправления заказов </p></figcaption></figure>

Выберите склад из списка или на карте

{% hint style="info" %}
Некоторые службы доставки требуют, чтобы отправка была со склада указанного вами в договоре со службой доставки, в таком случае выберите указанный в договоре адрес склада службы доставки
{% endhint %}

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FzBuYasFap0EoGBfNJW3g%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-05-01%20%D0%B2%2020.24.17.png?alt=media&#x26;token=97ec07ff-d54e-4bf4-9680-ecc1f8af7d38" alt=""><figcaption><p>Выберите склад службы доставки из списка или на карте </p></figcaption></figure>

Подтвердите выбор склада&#x20;

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FOMGhDpSHJCpQ7u7KdZjW%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-05-01%20%D0%B2%2020.24.36.png?alt=media&#x26;token=d8d1eb7d-4f23-4ead-bef3-765789168683" alt=""><figcaption></figcaption></figure>

После подтверждения выбора настройку подключения службы доставки можно считать завершенной, если служб доставок было подключено несколько повторите эту настройку для других служб

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2FiXjWT3YBRAgdUfBKgGdE%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-05-01%20%D0%B2%2020.24.51.png?alt=media&#x26;token=1d7473b5-ee36-4179-9777-57dee54ec47b" alt=""><figcaption></figcaption></figure>

После заполнения настроек для всех подключенных служб доставки нажмите кнопку "сохранить"

<figure><img src="https://149468416-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLo474ql7jgpwSAeS8WAS%2Fuploads%2F7f7SCUGDavV46Tm2iiwg%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-05-01%20%D0%B2%2020.36.17%20(1).png?alt=media&#x26;token=111500a9-0ea2-4818-a36d-15cbf6ad7036" alt=""><figcaption><p>Сохранение настроек интеграции с ApiShip </p></figcaption></figure>

{% hint style="info" %}
Если вы добавили новую службу доставки в ApiShip, чтобы она появилась в настройках TGShop необходимо заново скопировать токен ApiShip и ввести его, чтобы система добавила службу доставки для последующей настройки
{% endhint %}