Logistics and delivery
Delivery services, freight carriers and fleets are connected under Integrations, the Services tab. The general rules (card statuses, the Changes line, a second account, disconnecting) are on the Connecting services page. A shipping order, a courier call and a command to a car change things in the real world, so what the agent does on its own and what it sends as a card is described in Approving actions. Catalog: Logistics.
CDEK
Orders, rate quotes, tracking, pickup points and courier calls. Scenarios are on the integration page.
What the agent can do
Quote rates, create orders and call a courier, track parcels and find pickup points.
Before you start
A contract with CDEK for a company or sole trader. A retail sender account issues no keys.
Steps
Sign in with the contract account
At lk.cdek.ru sign in as the account the contract is tied to.
Open Integration
In the account menu pick Integration (lk.cdek.ru/integration).
Create a key
Click create a new key. Paste Account into Client ID and Secure password into Client Secret. Secure password is shown once.
How to revoke access
Click Disconnect on the connection card and delete the key in the Integration section of the CDEK account.
Troubleshooting
- No Integration section: the account has no contract, or you are not signed in as the contract account.
- Secure password lost: issue a new key and click Re-enter credentials.
Russian Post
Postal shipments: orders, rates, tracking, address normalization and post office search. Scenarios are on the integration page.
What the agent can do
Create shipments, quote rates, track parcels, normalize addresses and find post offices.
Before you start
An account at otpravka.pochta.ru with an approved access request. Approval takes a few business days.
Steps
Create the account
Sign up at otpravka.pochta.ru and wait for the request to be approved.
Copy the token
In the API section (otpravka.pochta.ru/settings#/api-settings) copy the API token into Access token.
Enter login and password
Put the account login and password into Username and Password. The login works best as a phone number in the +7XXXXXXXXXX format.
How to revoke access
Click Disconnect on the card. A new token is issued in the account by the button next to the API token field in the API section.
Troubleshooting
- No token in the account: the request is not approved yet.
- The login is rejected: enter it as a phone number in the +7XXXXXXXXXX format.
PEC
Cost and time quotes, branches and zones, cargo status and shipping orders. Scenarios are on the integration page.
What the agent can do
Quote cost and time, check cargo status and place shipping orders.
Steps
Sign in to the account
At kabinet.pecom.ru sign in with the client account: its login is the Username.
Issue an API key
In the registration data, the API keys block, issue a separate key for the agent and paste it into API Key.
Limitations
Counterparties' cargo and documents are visible only with the extended personal account.
How to revoke access
Click Disconnect on the card and delete this key in the API keys block.
Troubleshooting
- Counterparties' cargo is not visible: the extended PEC personal account is needed.
Yandex Delivery
Price quotes, courier orders, delivery across Russia, pickup points and tracking. Scenarios are on the integration page.
What the agent can do
Quote delivery prices, create courier orders and track them.
Before you start
The login and password for dostavka.yandex.ru issued by your Yandex Delivery manager.
Steps
Get a token
In the account, on the Integration tab, in the activate integration section, click get token.
Paste the token
Paste it into Access token.
Limitations
After the account password changes, the token stops working.
How to revoke access
Click Disconnect on the card. Changing the account password closes access on the Yandex Delivery side too.
Troubleshooting
- Credentials not accepted: the account password was changed. Get a new token and click Re-enter credentials.
Luch Transport
Freight across the Urals: cost quotes, shipping orders and cargo status. Scenarios are on the integration page.
What the agent can do
Quote costs, place shipping orders and check cargo status.
Steps
Ask for the tokens
Write to OTR IT at info@otr-it.ru in free form. They usually set up a working chat with your staff.
Paste the token pair
Put X-User into Identifier (X-User) and X-Token into Token (X-Token).
Limitations
Orders are placed for the organization the account is tied to. Check the payer and payment method under the contract with your Luch Transport manager.
How to revoke access
Click Disconnect on the card, and write to OTR IT to close the tokens.
Troubleshooting
- An order is not placed: check the contract and payer with the manager.
ATI.SU
A freight exchange: loads, bids, trucks, companies, ATI-Docs, time slots and the rate index. Scenarios are on the integration page.
What the agent can do
Search loads and trucks, work with bids, companies and ATI-Docs documents.
Before you start
A verified ATI.SU account. For ongoing work, a client_id issued on request to api@ati.su.
Steps
Open My tokens
Sign in as the company's contact and open ati.su/developers/tokens.
Request a client_id
Write to api@ati.su with the employee's name and email, the product name and the purpose of using the API.
Create a permanent token
Enter the client_id, click create token and copy the value from the Token column into API Token.
Limitations
- Create temporary token issues a token for a short term: enough for a check, not for ongoing work.
- A token stops working when the password changes or the contact or company is deleted.
How to revoke access
Click Disconnect on the card and delete the token under My tokens.
Troubleshooting
- The connection stopped working: the temporary token expired or the contact's password changed.
Yandex Fleet
A Yandex Taxi fleet: cars, drivers and couriers, orders, GPS tracks and transactions. Scenarios are on the integration page.
What the agent can do
Read the fleet's cars, drivers, orders, tracks and transactions.
Before you start
The Director role at fleet.yandex.ru: under another role a key cannot be created.
Steps
Open the API section
In the dispatcher pick its settings and go to the API section.
Create a key and carry three values
Paste the secret key into API Key, the client ID into Client ID (Clid, e.g. taxi/park/<uuid>) and the partner ID into Park ID (UUID). The key is shown once.
How to revoke access
Click Disconnect on the card and delete the key in the dispatcher's API section.
Troubleshooting
- A key cannot be created: your role is not Director.
StarLine
A car alarm: location, vehicle state, remote commands and OBD. Scenarios are on the integration page.
What the agent can do
Read the location and state of the account's cars and send remote commands.
Before you start
A StarLine ID account whose device list shows the system, and an approved developer request.
Steps
Send a request
At my.starline.ru, in the developers section (visible with the Russian interface), describe the purpose of using the API. Approval arrives by email.
Create an app
After the email open the developers section and create an app. Paste AppId into App ID and Secret into App Secret.
Enter the StarLine ID sign-in
Fill in StarLine ID Login and StarLine ID Password.
Limitations
The keys open only the cars of this StarLine ID account.
How to revoke access
Click Disconnect on the card and delete the app in the developers section.
Troubleshooting
- The request is not reviewed: it does not describe the purpose of using the API.
Frequently asked questions
There is no key section in my CDEK account. Why?
CDEK issues API keys only under a contract with a company or sole trader. Without a contract the account works as a retail one and has no Integration section.
The temporary ATI.SU token stopped working. What now?
A temporary token is good for a check. For ongoing work request a client_id at api@ati.su and create a permanent token at ati.su/developers/tokens.
Why does Russian Post not give a token right after sign-up?
Signing up at otpravka.pochta.ru sends an access request and a contract for signature. Until the request is approved, the account has no token.
What do I need for Yandex Fleet?
The Director role in the fleet account and three values from the API section of the dispatcher: the secret key, the client ID and the park ID.
See also
Didn't find an answer? How to reach us