МойСклад

Магазину, который ведёт заказы в сервисе МойСклад, API не нужен: Govza сама читает заказ покупателя, вызывает курьера и пишет в заказ, как идёт доставка. Эта страница описывает, что именно Govza берёт из заказа и что в него пишет. Как подключиться, по шагам, — на govza.app/integrations/moysklad.

Подключение

Администратор аккаунта создаёт в панели МойСклад токен (настройки пользователя → «Токены») и передаёт его Govza. Govza подключает его к компании магазина и вместе с магазином выбирает:

статус, при котором вызывается курьер, например «Собран»;
для каждого склада в аккаунте МойСклад — филиал Govza, откуда курьер забирает заказ;
статусы, в которые заказ переходит сам, когда курьер его забрал и вручил;
берёт ли курьер с покупателя неоплаченную часть заказа.

Токен работает на любом тарифе МойСклад. Ничего устанавливать в аккаунт МойСклад не нужно.

Когда Govza вызывает курьера

Когда заказ переходит в выбранный статус. Заказ в статусе отмены (тип «Отрицательный») курьера не вызывает никогда.

Курьер на заказ вызывается один раз. Пока он едет, заказ можно двигать по статусам как угодно, в том числе снова в вызывающий: второго курьера не будет.

Govza узнаёт об изменениях заказов по вебхукам МойСклад, сразу. Вебхуки работают только на платных и пробном тарифах; на бесплатном Govza раз в минуту сама проверяет изменённые заказы.

Что Govza берёт из заказа покупателя

Поле МойСклад	Что это для курьера
Адрес доставки (`shipmentAddressFull`, иначе `shipmentAddress`)	Адрес: Govza находит его на карте. Квартира — отдельным полем, «Другое» и комментарий к адресу — в пояснения к адресу
Склад (`store`)	Филиал, откуда курьер забирает заказ. Склад без филиала — филиал по умолчанию
Телефон контрагента (`agent.phone`) или доп. поле заказа	Кому звонить. Доп. поле выбирается в настройках, если получатель — другой человек. Без телефона заказ всё равно уходит: курьер едет по адресу и комментарию, а если не найдёт получателя, звонит в магазин
Имя контрагента	Имя получателя
Сумма (`sum`) минус оплачено (`payedSum`)	Сколько курьер берёт за товар. Сбор оплаты можно выключить
Комментарий (`description`)	Комментарий курьеру, без строк Govza
Планируемая дата (`deliveryPlannedMoment`)	Время доставки, если оно позже чем через 30 минут и указано со временем, а не только датой

Что Govza пишет в заказ

Комментарий. Под чертой ——— Govza ——— Govza пишет код заказа, статус доставки, её стоимость, имя, телефон и машину курьера и ссылку отслеживания и обновляет эти строки сама, в том числе когда курьер сменился. Текст магазина выше черты не меняется.

Позвонить за час

——— Govza ———
Заказ CM4821: курьер везёт заказ
Доставка: 250 ₽
Курьер: Ахмед, +7 928 123-45-67
Авто: Kia Rio (цвет: белый) — А123ВС 95
Отслеживание: https://track.govza.app/…

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

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

Отмена

Заказ перешёл в статус отмены или удалён — курьер Govza отменяется.
Доставленный заказ не отменяется.

Чтобы вызвать нового курьера после отмены — вашей или Govza (например, не нашлось свободного), — переведите заказ из вызывающего статуса в любой другой и обратно. Заказ, который просто остаётся в вызывающем статусе, нового курьера не вызывает.

Если курьер не вызвался

Заказ в вызывающем статусе, а строк Govza в комментарии нет — проверьте:

Причина	Что сделать
В заказе не указан адрес доставки	Заполните «Адрес доставки» и сохраните заказ
Адрес не находится на карте	Проверьте город, улицу и дом и сохраните заказ
Склад заказа не сопоставлен с филиалом Govza, а филиала по умолчанию нет	Напишите нам: выберем филиал для склада

После сохранения исправленного заказа Govza читает его снова.