Terminal Passes

The workplace of an elevator or transshipment facility: receive the truck, enter quality, weigh it, close the visit. Section Transport Appointments, route /transport-appointments.

How the process works

A single truck visit to a terminal is seen by three parties, and each works in its own section of the platform. The steps run in sequence: until whoever’s turn it is takes their step, the truck waits.

Step 4 is a fork. By default you take the sample and enter the parameters yourself. If the cargo owner assigned an external laboratory to their request, an independent surveyor enters the parameters and all you have to do is weigh the truck.

This page is for the terminal. The other two parties need their own: Stock Requests and Voyages — for the trader or farmer · Laboratory: Quality Check — for the surveyor.

What a pass is

A pass (visit) is one arrival of one truck at your site for a specific operation.

The cargo owner calls the same object a voyage, and it lives inside their volume request. Statuses are shared both ways: what you change on your side, the trader sees in their table, and the other way round.

In the interface the section is still called “Transport Appointments” and the records themselves “Appointments”. Those are the labels in the screenshots below. In the documentation they are called passes, so as not to confuse them with the trader’s volume request.

Where passes come from

A pass is not created manually on desktop — there is no button in the list. The form is available on mobile: “Transport Appointments” → “Create appointment”.

Main screen

The number in brackets is how many passes are on the tab.

Filters: Search (plate, driver, EDRPOU), Arrival period, Quota holder EDRPOU (8 or 10 digits), and the Refresh button with a timestamp.

If a stage holds too many records, “Showing the first N appointments of the stage. Narrow the period to see the rest” appears at the bottom.

Operation types

Pass statuses

The left column is what you see; the right is what the trader sees in their voyage table at that moment.

Calendar

The Table / Calendar switch in the top right. Modes: month, week, day.

• The header holds counters for the period: trucks, railcars, vessels, and tonnage for receiving (→) and shipping (←).
• A day cell shows the number of vehicles and colour markers for the stages.
• The right-hand panel filters by stage, operation type, commodities, quota holders and quotas.
• The mode and the date are kept in the page address — the link opens in the same view.

Pass details

Click a table row.

Sections: General information · Cargo · Transport and driver (with a link to documents, if attached) · Contract quality parameters · Processing result.

At the top is a hint banner:

Step 1 — enter quality

The “Save quality” button — after that the system compares what was entered against the contract:

There is no “Enter quality” button — that is normal in two cases: quality has already been entered, or an external laboratory enters it. In the second case the parameters arrive from the surveyor’s inspection visit, and all you have to do is weigh the truck.

Pause — the trader’s decision

No action is needed from you.

• The trader allows it — they pick a storage and adjust the class if needed. The pass moves to “To weighing”, and the details gain the “The trader allowed acceptance despite the quality mismatch” banner.
• The trader rejects it — the pass becomes “Returned” and the truck is turned away permanently.

Step 2 — weight control

The check is Gross = Tare + Net. Otherwise the form shows “Gross must equal tare plus net” and will not submit.

The “Storage” field has two hints:

• “Assigned by the trader — change it if the cargo goes to a different storage” — when a storage was already chosen in the trader’s decision;
• “The trader did not specify a storage — choose where we unload” — when it was not.

The “Complete appointment” button → the “Appointment completed” toast, the Completed status, and the “Completed” tab. The tonnage drops into the storage balance on the trader’s side.

Personal Telegram

The link is made to your account, not to your company: the company does not enable it, require it, or see it. This is not the driver bot — that one is separate.

1. Avatar in the top right → “System settings”.
2. The Telegram block, state “Not connected” → Connect.
3. A one-time link and a QR code appear: “Open in Telegram” or “Copy link”.
4. Open the bot and press Start.
5. Return to the tab and press “I have connected — check”.
6. Done: your @username and the connection date are shown, and the button changes to “Disconnect”.

Details:

• The link is single-use and lives for about 15 minutes. Every press of “Connect” kills the previous one — an old tab with an old QR code will not work.
• To unlink: the “Disconnect” button on the web, or the /stop command in the chat with the bot. The web state catches up on its own.
• Confirmation happens inside Telegram and the web page does not learn about it by itself — the state refreshes when you return to the tab or press “check”.

Limitations of the current version