МойСклад (MoySklad)
A shop that keeps its orders in МойСклад needs no API work: Govza reads the customer order, calls a courier and writes the delivery’s progress back into the order. This page describes what Govza reads from an order and what it writes. Step-by-step setup, in Russian, is at govza.app/integrations/moysklad.
Connecting
Section titled “Connecting”The account admin creates a token in МойСклад (user settings → «Токены») and hands it to Govza. Govza connects it to the shop’s company and, with the shop, picks:
- the status that calls a courier, «Собран» for example;
- for each МойСклад warehouse, the Govza branch the courier collects from;
- the statuses the order moves to by itself once the courier has picked it up and delivered it;
- whether the courier collects the unpaid part of the order.
A token works on every МойСклад tariff. Nothing is installed in МойСклад.
When Govza calls a courier
Section titled “When Govza calls a courier”When the order moves into the chosen status. An order in a cancel status (type «Unsuccessful») never calls a courier.
An order calls one courier. While that courier is on the way the order can move through any statuses, back into the calling one included, without a second.
Govza hears about order changes from МойСклад webhooks, at once. Webhooks only work on paid and trial tariffs; on the free tariff Govza checks for changed orders itself, once a minute.
What Govza reads from a customer order
Section titled “What Govza reads from a customer order”| МойСклад field | What it is to the courier |
|---|---|
Delivery address (shipmentAddressFull, else shipmentAddress) |
The address, which Govza places on the map. The flat travels as its own field; «Другое» and the address comment become address notes |
Warehouse (store) |
The branch the courier collects from. A warehouse without a branch uses the default branch |
Counterparty phone (agent.phone) or an order attribute |
Who to call. Pick the attribute in the settings when the recipient is someone else. An order without a phone still goes out: the courier goes by the address and the comment, and calls the shop if they can’t find the recipient |
| Counterparty name | The recipient’s name |
Sum (sum) minus paid (payedSum) |
What the courier collects for the goods. Collection can be turned off |
Comment (description) |
The courier’s note, without Govza’s own lines |
Planned date (deliveryPlannedMoment) |
A delivery time, when it is more than 30 minutes ahead and carries a time, not just a date |
What Govza writes into the order
Section titled “What Govza writes into the order”Comment. Below a ——— Govza ——— line Govza writes the order code, the
delivery status and price, the courier’s name, phone and vehicle and the
tracking link, and keeps those lines up to date, a change of courier included.
The shop’s text above the line is never changed.
Statuses. Optionally, a status for an order the courier has picked up and one for a delivered order.
A «Доставка Govza» line. Optionally, a service priced at the delivery fee is added to the order once, so the fee reaches the documents.
Cancellation
Section titled “Cancellation”- An order moved to a cancel status or deleted cancels its Govza courier.
- A delivered order is never cancelled.
To call a new courier after a cancellation, yours or Govza’s (no courier was free, for example), move the order out of the calling status and back. An order that just stays in the calling status calls no new one.
When no courier was called
Section titled “When no courier was called”The order is in the calling status but the comment has no Govza lines. Check:
| Cause | What to do |
|---|---|
| The order has no delivery address | Fill in «Адрес доставки» and save the order |
| The address can’t be found on the map | Check the city, street and house, and save the order |
| The order’s warehouse has no Govza branch and there is no default branch | Write to us and we’ll pick a branch for it |
Govza reads a corrected order again once it is saved.