# 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="/files/4psgR678NQPplGNyDssL" alt=""><figcaption><p>Раздел "службы доставки" </p></figcaption></figure>

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

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

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

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

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

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

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

<figure><img src="/files/GjrbzfjES9d0lCclQmOL" alt=""><figcaption><p>Панель управления ApiShip </p></figcaption></figure>

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

<figure><img src="/files/rOAAkT4KqzoRwkR0NkS9" 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="/files/irxf3X9eSVZwaWuNXbFy" alt=""><figcaption><p>Настройки служб доставок в TGShop </p></figcaption></figure>

<figure><img src="/files/a50xVWsuaQU2WAFZlzHj" alt=""><figcaption><p>Выбор типа забора груза </p></figcaption></figure>

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

<figure><img src="/files/4tgkh3n62hSMeQjoKbRe" alt=""><figcaption><p>Настройка забора груза "Со склада СД"</p></figcaption></figure>

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

<figure><img src="/files/4FutHbr6p2PNQCeoVdnU" alt=""><figcaption><p>Выбор города отправления заказов </p></figcaption></figure>

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

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

<figure><img src="/files/5yyxJUl7CuiZws1VOhAl" alt=""><figcaption><p>Выберите склад службы доставки из списка или на карте </p></figcaption></figure>

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

<figure><img src="/files/BiDsRqUyCsikC5ailIho" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/VLkZCXfQmRKb9TBx0OSE" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/43di72rdorlG9N9fPGZr" alt=""><figcaption><p>Сохранение настроек интеграции с ApiShip </p></figcaption></figure>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tgshop.io/osnovnye-nastroiki/sposoby-dostavki/apiship.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.