A site is one physical place where you hold equipment or goods: a container / ISO tank depot, a bulk-liquid tank storage terminal, a warehouse, or a mix of...
Sites
A site is one physical place where you hold equipment or goods: a container / ISO tank depot, a bulk-liquid tank storage terminal, a warehouse, or a mix of these. Everything else in the Warehouse App belongs to a site: every unit has its slot in a site's yard, every storage tank stands on a site's tank farm, every gate-in, gate-out, yard move and tank operation is booked against a site. The Sites screen is therefore the root of the operation. Here you register each depot or terminal, draw its yard plan (the blocks, bays, rows and tiers your yard planners and reach-stacker drivers work with), and open the live yard that shows the stack as it stands right now.
Where to find it: Workspace → Logistics → Warehouse → Sites. It is the first entry of the Warehouse menu and, unless the administrator chose another landing page under Settings → Appearance, the page the Warehouse menu opens on.
Who can use it
View sites, the live yard, units, tanks and movements is needed to see the list, open a site, its live yard and its yard plan (read-only).
Add and edit sites, zones and the yard plan (part of the group Add sites and edit their yard plan) is needed to add, edit or delete a site, and to draw, move, resize or remove zones and place storage tanks on the plan. Without it the Add a site button, the edit and delete buttons and the drawing tools are not shown.
The operating buttons on a site page each follow their own permission, all part of the group Gate in and out, move units, fill and empty tanks: Gate in and Gate out need Gate in and gate out; Move needs Move units in the yard; Product in / out needs Fill, empty and transfer tanks, take readings.
A role with Cannot delete anything never sees the delete button on a site; editing stays allowed.
Administrators can do everything. Permissions are set per role under Settings → People & access → Roles, in the Warehouse section.
Where it sits in the operation
A site is built top-down. You register the site (name, kind, codes, yard size, gate hours). On its yard plan you draw zones: container stacks, a tank farm, the gate, roads, buildings, cleaning station, repair shop, truck parking, rail track and quay. A container stack zone is divided automatically into ground slots (bays × rows) and stacked to the zone's stack height (tiers); each unit that is gated in gets one of those slots as its position. Storage tanks are added under Storage tanks and then placed on the plan, normally inside a tank farm zone. From that one plan the App draws the 2D live yard, the Live 3D scene and the zone list of the yard check, and computes the site's occupancy.
Figure 1 A site is a tree: zones on the plan, slots inside the container stacks, units in the slots, tanks on the tank farm. Every live view of the site is drawn from this one plan.
What you see
At the top is the page title with the total of Units in: every container and ISO tank that is on one of your sites right now (status In the yard, Being cleaned or In repair). Next to the tabs, the Guide button opens the set-up guide (start from nothing, a new cycle, or the tour); on the very first visit an administrator or site editor gets the tour opened automatically, once. Add a site sits at the top right for people who may edit sites.
The list has these columns:
Column
What it shows
Site
The name (a link to the site page), with the short code next to it if you gave one.
What kind of site is it?
Container / tank depot, Tank storage terminal, Warehouse for goods, or A bit of everything.
City
City and country.
Units in
How many units are on this site now (in the yard, being cleaned or in repair).
Storage tanks
How many fixed storage tanks the site has.
Occupancy
How full the container stacks are, as a bar and a percentage: the units on site against the slot capacity of all container stack zones (ground slots times stack height). A site without stack zones shows a dash.
At the end of each row are buttons to open the Live yard, edit the site and delete it. The list has the usual search, sort, print and Excel export.
When you have no sites yet, the screen shows Start with your first site ("A site is a depot, a tank terminal or a warehouse. Add it, draw its yard plan, and the live view appears.") and an Add a site button.
Inside a site
Click a site's name to open it. The site page shows the site name, its kind and city, a link back to Sites, and the number of units on it (this figure updates live as units come and go). The tabs and their content form one card:
Live yard: an isometric picture of the yard, drawn from the yard plan, with every container, ISO tank, storage tank and truck.
Yard plan: the flat grid where you draw zones and place storage tanks.
Storage tanks: the tanks of this site only. This tab appears only when the Terminal module is on.
Movements: everything that happened on this site (see Movements).
At the top right of the card are the buttons, each shown only to people with the matching permission:
Live 3D: the same site as a 3D scene (see Live 3D).
Yard check: opens the yard check for this site. Shown when the Depot module is on (see Yard check).
Gate in, Gate out and Move: the gate and yard-move forms, with this site already filled in.
Product in / out: tank receipts, deliveries and transfers, when the Terminal module is on and the site has storage tanks.
On a phone the tab strip scrolls, so these buttons are repeated under the tabs and stay in reach for the gate clerk.
The live yard
Drag to look around, scroll (or pinch) to zoom. Click a unit to open its unit card. Click a tank to open it where you can act on it: the tank form for people who may edit tanks, otherwise Product in / out for people who operate tanks.
The filter tabs above the picture highlight what you are looking for and dim everything else: Everything, Loaded, Dirty, Tests due, Damaged, Being serviced and On hold.
Fit the yard brings the whole yard back into view. Full screen fills the screen, which works well on a TV in the control room.
The picture refreshes by itself every few seconds: it asks for new movements on this site at the interval set as Live view refresh (seconds) under Warehouse settings → Yard and safety (default 5, minimum 2). A gate in shows a truck driving in and putting the unit in its slot; a gate in or out saved from the buttons above appears at once, without waiting for the next refresh.
When the Transport module is on, a strip Expected today lists the trucks planned to arrive at this site today from planned trips: time, plate (or trip number), unit and client, with a Gate in button for a delivery or a Gate out button for a pick-up. That button opens the gate form already linked to the trip stop and the unit.
If the site has no yard plan yet, the live yard shows This site has no yard plan yet. and, for people who may edit the plan, a Draw the yard plan button.
Add a site
Click Add a site at the top right.
Type the Name, for example "Antwerp depot".
Choose What kind of site is it? Container / tank depot, Tank storage terminal, Warehouse for goods, or A bit of everything.
Optional: a Short code (for example ANR1), up to 20 characters, stored in capitals. It is shown on labels and positions.
Optional: city, country and address.
Optional: the EDI codes: the UN/LOCODE of the place (5 characters, for example BEANR for Antwerp) and the Depot code your partners use for this depot (up to 17 characters). They go into the location segments of your EDI messages; you only need them if you exchange EDI (see EDI).
Optional: Gate hours and trucks per slot: the opening and closing time of this site's gate and how many trucks the gate takes in one slot. They drive the gate appointment slots of this site. Leave them empty to use the workspace values from Settings → Yard and safety.
Set the Yard size in squares of 2.5 m × 2.5 m (between 8 and 400 each way). The default 48 × 32 squares is a yard of 120 m × 80 m. You can make it bigger later.
Optional: Run for one client, when the whole site serves one client (a dedicated depot). Leave it empty when the site serves all your clients.
Click Save and draw the yard plan. The site page opens straight on the Yard plan tab.
Draw the yard plan
The yard plan is a top-down grid. Each square is 2.5 m × 2.5 m. You draw rectangles called zones.
Open the site and click the Yard plan tab.
In the toolbar, pick what to draw: Container stack, Tank farm, Building, Cleaning station, Repair shop, Gate, Road, Truck parking, Rail track or Quay.
Drag on the grid to draw the zone. It is saved at once and gets a name such as "Container stack 1".
The zone opens in a panel on the side. Change its Name and optional Short code. For a container stack, set the Stack height: how many units may stand on top of each other (1 to 9; for ISO tanks usually 1 or 2). A new stack starts at 3.
The panel shows the stack's room, for example "4 bays × 6 rows × 2 high = 48 slots". Click Save.
To change a zone, choose Select, then drag the zone to move it, or drag its bottom-right corner to resize it. Click a zone or a tank to change or remove it.
To delete a zone, select it and click Remove zone.
Click See it live to look at the result in the live yard.
How a stack is addressed
A bay is one 20-foot ground slot along the length of the zone, about 2.5 squares (6.25 m); the number of bays is the zone length in squares divided by 2.5, rounded down. Each square across the zone is one row. The tier is the height in the stack, 1 being the ground. A 40-foot or 45-foot unit takes two neighbouring bays. A unit's position reads zone-bay-row-tier, using the zone's short code when it has one (otherwise its name), with bay and row on two digits: A-03-02-1 is zone A, bay 3, row 2, tier 1. In the Units list the site name is put in front: "Antwerp depot · A-03-02-1". A unit placed in a zone without a slot (for example in the cleaning station) shows just the zone.
Figure 2 Positions are computed from the drawn rectangle: bays along the length, rows across, tiers up to the stack height. The same numbers give the slot capacity behind the Occupancy column.
Place a storage tank on the plan
First add the tank under Storage tanks. Tanks that are not on the plan yet appear in the yard plan under Place a storage tank.
Click the tank's button, then click on the grid where its centre should be, normally inside a tank farm zone. The circle is drawn to the tank's diameter and must fit inside the yard.
A tank placed inside a tank farm zone belongs to that zone; outside any tank farm it belongs to no zone.
To move a placed tank later, choose Select and drag it.
Edit or delete a site
Click the edit button at the end of the row, change what you need, and click Save. The row updates in place.
To delete, click the delete button and confirm. You can undo it right after.
Controls and exceptions
Zones cannot overlap. You will see: "This zone overlaps "Container stack 1". Zones cannot overlap."
A zone or a tank must stay on the grid: "The zone must stay inside the yard."
You cannot delete a site while units are on it: "There are 5 units on this site. Gate them out before deleting the site." Gate the units out first (or move them to another site through a gate out and a gate in).
A zone with units in it may be moved, but you cannot remove it, shrink it below the bays and rows its units use, lower its stack height below the highest occupied tier, or change its kind: "There are 5 units in this zone. Move them out before removing or shrinking it."
The yard size can grow, but never smaller than the zones already drawn: when you save a smaller size, the App keeps it just large enough for the furthest zone.
Codes are cleaned on save: the short code is put in capitals, EDI codes keep only valid characters and are cut to 5 (UN/LOCODE) and 17 (depot code) characters.
Drawing on the plan never moves a unit. When the plan and the yard disagree (a unit stands where the plan has no slot, a stack was re-striped on the ground), redraw the zone first, then correct each unit's position with Move, or walk the yard with a Yard check. Every move is a normal movement with its own record.
For the manager
Occupancy is your capacity signal per site. It counts units against slots, so a 40-foot unit counts once although it takes two ground slots; read it as a stack-fill indicator, not a TEU figure. A depot running above about 80–85% loses productivity on digging (re-handles); plan stack heights and repositioning before you get there.
Units in on the list header is your total equipment on hand across sites; the same figure per site feeds the dashboard tiles and the Reports.
Keep zone short codes stable: positions on EIRs, labels and movement history use them, and your reach-stacker drivers work from them.
The site's Run for one client, gate hours and trucks per slot shape what the gate and Gate appointments offer; the UN/LOCODE and depot code are what your shipping-line partners see in EDI.
In AI Reports, units and movements carry the site as a field (Containers and ISO tanks (Warehouse); Yard and tank movements (Warehouse)), so you can ask for gate-ins per site per month or average days on site per site.
Tips
Draw the gate and the roads too. The trucks in the live yard and in Live 3D drive along your roads.
Give each stack a short code (A, B, C…). Positions then read like "A-03-02-1": zone A, bay 3, row 2, tier 1.
Keep ISO tank stacks low (1 or 2 high) and dry container stacks higher.
Use the Tests due filter in the live yard each morning to see which units need a 2.5- or 5-year inspection; On hold shows what may not leave.
Put a screen in the office with the live yard in full screen.
Glossary
Site
A depot, tank terminal, warehouse or mixed facility; the root of every unit, tank and movement.
Zone
A rectangle drawn on the yard plan: container stack, tank farm, building, cleaning station, repair shop, gate, road, truck parking, rail track or quay.
Square
One cell of the yard plan grid, 2.5 m × 2.5 m.
Bay
One 20-foot ground slot along the length of a stack zone (about 2.5 squares).
Row
One square across a stack zone.
Tier
The level in the stack; tier 1 is on the ground.
Stack height
The maximum number of tiers in a container stack zone (1 to 9).
Position
A unit's slot, written zone-bay-row-tier, for example A-03-02-1.
Occupancy
Units on site divided by the slot capacity of all container stack zones.
UN/LOCODE
The five-character UN code of the location (BEANR = Antwerp), used in EDI messages.
Depot code
The identifier your EDI partners use for this depot.
Gate-in / gate-out
A unit entering or leaving the site through the gate, each with its interchange receipt (EIR).
Related screens
Units: the containers and ISO tanks on your sites, and gate in / gate out.
