Skip to content
P4 Software P4 Software / logisticaHQ-en

Add these docs to Claude

Ask Claude questions about these docs. Claude reads the published pages and links you back to them. Copy this address:

https://p4-software.opendocs.page/mcp

In claude.ai or Claude Desktop: open Settings, then Connectors, choose Add custom connector and paste the address.

In Claude Code, run:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Setting up the yard

Setting up a Warehouse, in the order to do it

A new Warehouse does these steps once. Steps 1 to 4 are quick; steps 5 and 6 are what make the "closest door" advice possible.

Before you start

  • The Warehouse needs a time zone. Set it on Setup > Warehouse > Warehouses. Without one, or with one the System cannot use, the board answers "The time zone of Warehouse is not set or is not one this System can draw. Set it on the Warehouse before using the dock schedule".
  • The dock's opening hours come from the Calendar settings until you type your own: Start of working day in hours (default 8), End of working day in hours (default 18), Working days of week (default Monday to Friday) and Hidden days of week (default Sunday), all on Setup > System > Configuration. Outside those hours, or on a day that is not a working day, no door can be booked. An end of 24 means the whole day to the last minute. If the start is not before the end, the Calendar hours are ignored and the dock counts as open at every hour. The board opens on the same working day.
  • Zones. The "closest door" advice aims at a zone. A shipping load aims at the Warehouse's Staging zone (zone type Staging; the first one by code when there are several). A Receiving load aims at the load type's Receiving zone.

1. Equipment types

Yard > Equipment types lists the trucks and trailers the dock books. Press Seed defaults on a new Warehouse. It adds 14 common types, named in your own language: if you work in Spanish they are written in Spanish (Caja seca 53', Caja refrigerada 53', Plataforma escalonada, Pipa, Torton, Rabón, Full ...), otherwise in English; the codes are the same either way, so a later press in the other language adds nothing new (it is safe to press again: it adds only the codes that are missing and never changes a row you edited, and a message says how many were new):

Code Name
DRY53, DRY48 Dry van 53', Dry van 48'
REEFER53 Reefer 53' (refrigerated)
PUP28 Pup 28'
FLAT48, STEPDECK Flatbed 48', Step deck (both need a ground-level door)
BOX26 Box truck 26'
CONT20, CONT40 Container 20', Container 40'
SPRINTER Sprinter/van
TANKER Tanker (needs a ground-level door)
TORTON, RABON Torton, Rabón (with their Carta Porte codes C3 and C2)
FULL Full

The names are written in English; edit them if you want them in Spanish. New adds your own type. Click a code to edit.

Field What it does
Equipment type code Required, up to 32 characters, capitals. Two types cannot share a code, even in a different case.
Name Required. This is what the desk picks in Truck type.
Equipment category A label (dry van, reefer, flatbed, box truck, container, tanker, cargo van, double trailer, other). It does not change any rule.
Length (ft) The longest unit. A door with a shorter length limit will not be offered. Empty means it does not matter.
Required door style Any door style, Dock height door or Ground level door. A flatbed that needs ground level is never offered a dock-height door, and a Ramp door or Drive-in bay fits neither requirement.
Refrigerated equipment Marks a refrigerated truck. It does not force a cold door, but a refrigerated truck is not charged the "ties up a cold door" penalty for using one.
Carta Porte vehicle Configuration, Carta Porte trailer subtype, Equipment sequence Stored for later; they change nothing yet.
Warehouse Empty means every Warehouse.
Equipment type is active A type that is switched off cannot be booked.

A type that an appointment, a door's list or a group's list still uses cannot be deleted; switch it off instead (see "When a delete is refused").

2. Dock groups

Yard > Dock groups. A group is for one Warehouse. You do not need groups to book; use them for doors that behave alike or share a crew.

Field What it does
Warehouse, Name Required.
Dock group direction Inbound and outbound (default), Inbound freight or Outbound freight. A door takes a truck only if the door and its group both work that direction.
Crew limit per hour Optional. The trucks your crews can work at the dock at once in one clock hour. It is a warning, not a rule: it drives the crew strip, the "All crews busy then" warning and the Improve flow tips, and it never blocks or refuses a booking or a move. Empty means no limit. It must be at least 1 when filled in.
Allowed equipment types Empty accepts any type. A door with its own list uses its own; a door with none uses its group's.
Dock group is active A group that is switched off takes its doors off the board. It cannot be switched off while a truck on one of its doors is still coming: "Dock group [North wall] has [2] active appointment(s) on its doors. Move or cancel them on the dock schedule, then switch the group off."

A group that still has doors, rules or appointments, or that is on a load type's list, cannot be deleted; switch it off instead (see "When a delete is refused").

3. Dock load types

Yard > Dock load types. The desk must pick one for every booking, so every direction you book needs at least one. A client user sees their own client's types plus the shared ones.

Field What it does
Name Required.
Load type direction Inbound freight (default) or Outbound freight. The booking panel offers a type only for a truck of that direction. A type marked Inbound and outbound serves both directions: the panel offers it for a Receiving truck and for a shipping truck.
Default minutes 1 to 1440, default 60. The time at the door under a Fixed rule.
Duration rule Fixed duration, Minutes per pallet or Minutes per order line. The last two multiply the pallets (or lines) by Minutes per pallet or line, round up, and hold the result between Shortest appointment (minutes) and Longest appointment (minutes). When the count or the rate is missing, the default minutes are used.
Needs refrigerated equipment Only cold doors (Temperature controlled door) can take this type.
Needs hazmat door Only doors marked Door accepts hazmat can take it.
Allowed dock groups Empty allows every group. Otherwise the door must be in one of them; a door with no group fits none.
Receiving zone The zone the pallets go to. It drives the forklift cost. See "How the closest-door advice works".
Warehouse Empty means every Warehouse.
Client Only staff of a 3PL company see this. Empty shares the type with every client.

A carrier's own pace beats the rule: once a carrier (by its carrier record, else by name) has three finished visits of a load type, the next options use the average of its last 20, and the panel says "Based on this carrier's past trucks". A load type that an appointment or a rule uses cannot be deleted.

4. Dock capacity rules

Yard > Dock capacity rules says when the dock is open and when it is shut. A rule is for a Warehouse and, if you fill them in, one group, one door and one load type. Leave all three empty to cover the whole Warehouse.

Rule type What it does
Dock opening hours The booking must sit inside the hours, end to end.
Dock blackout No booking may overlap it (touching its edge is fine).

A third type, Dock capacity override, is no longer offered: nothing in scheduling reads it. A row of that type saved earlier still opens and is listed, and it changes nothing.

  • A rule you type replaces the Calendar hours for the doors it covers. The moment one Dock opening hours rule covers a door, the Calendar settings no longer apply to it, and a day with no opening-hours rule is closed. If you add one rule for Saturday, Monday to Friday are closed. Add a rule for every day you work, or add none.
  • A new rule starts as an all-day blackout. From time and To time are hours and minutes like 08:30. A start later than the end is an overnight rule. An all-day rule ends at 23:59. Equal times mean the whole day.
  • Weekday is Every day or one day; From day and To day are both included. A rule with only a weekday repeats every week.

5. The scheduling fields on each dock door

Open Setup > Warehouse > Dock doors, then a door. With the module on, the dialog ends with a Dock scheduling part (staff only):

Field What it does
Dock door direction Inbound and outbound, or one direction only.
Dock door style Dock height door, Ground level door, Ramp door or Drive-in bay.
Dock group The group the door belongs to. The list offers only groups that are switched on, plus the door's current group even when that one is off, so opening an old door never blanks its group.
Allowed equipment types The trucks this door takes. Empty uses the group's list; empty on both means any truck. A type that was switched off after the door was saved is still listed, marked "(switched off)".
Temperature controlled door A cold door.
Door accepts hazmat The door may take a load type that carries hazardous goods.
Door length limit (ft) The longest unit the door takes. Empty means no limit. A 53' trailer never lands on a 28' door, even when the list says any.
Dock door sequence The door's place in the order of the board's lanes.
Door is used for scheduling Off takes the door (and its trucks) off the board.

The Dock doors list has a column for each of these fields, so you can see and sort the whole dock at a glance: with the module on it offers Dock door direction, Dock door style, Dock group, Allowed equipment types (the names, or "Any equipment type"), Temperature controlled door, Door is used for scheduling, Door accepts hazmat, Door length limit (ft) and Dock door sequence, and the Pack slip printer and BOL printer columns are there with or without the module. Open Columns to choose; the direction, style, group, equipment, cold and in-use columns show at first and the others are one tick away. A layout you saved keeps what you chose. Every column sorts and filters except Allowed equipment types, which holds a list. The minutes from a door to each zone are in the door's dialog, not in the list. The scheduling columns are not offered to a user tied to one client. | Zone travel times | See below. |

A door that holds a truck that is still coming cannot be switched off, and cannot be moved to another Warehouse. A truck is still coming until it is finished, cancelled or a no-show. The save is refused with the count and what to do: "Dock door [Door 4] has [2] active appointment(s). Move or cancel them on the dock schedule, then switch the door off." (or "... then move the door to the other Warehouse."). The same goes for moving the door into a group that is switched off: "Dock group [Old bay] is switched off, and dock door [Door 4] has [2] active appointment(s). Move or cancel them on the dock schedule, or pick a group that is switched on." Move the trucks to another door, or cancel them from the truck panel, and save again. This check works while the module is on. A user tied to one client who moves a door that holds trucks that are still coming is told "Dock scheduling Setup is changed by Warehouse staff. Ask your Warehouse contact to make this change." and nothing else, because the count belongs to every client.

A door with appointments or capacity rules cannot be deleted (see "When a delete is refused"); switch Door is used for scheduling off instead, once no truck is coming.

6. Door-to-zone travel times (what makes "closest" possible)

At the end of the same dialog, Zone travel times has one box per zone of the door's Warehouse: Minutes to zone ZONE. Type the minutes a forklift needs to drive from this door to that zone, per pallet. A box left empty means "not measured". Change the Warehouse in the dialog and the boxes change with it. The times are saved with the door.

The "closest door" advice needs these times. Without them every door looks the same to the ranking, the reasons "Closest to ..." and "... more forklift minutes" never appear, and the options are ordered by time alone. A door nobody measured is treated like the longest walk that was measured, so leaving a door out never makes it look good.

When a delete is refused

Deleting a row the module uses is refused with a sentence that names the row and says what to do; nothing is half-deleted. Warehouse staff see these sentences. A user tied to one client who tries a delete that runs into dock rows is told "Dock scheduling Setup is changed by Warehouse staff. Ask your Warehouse contact to make this change." and nothing else, because the counts belong to every client.

What you delete Refused while What to do
An equipment type An appointment used it, or a door's or group's allowed list names it. Switch it off; or take it off the list first.
A dock group A door, a rule, a load type's list or an appointment uses it. Move the doors, delete the rules, take it off the list; switch it off instead. With an open appointment on its doors: move or cancel those first.
A dock load type An appointment or a rule uses it. Delete the rules; the type stays for the history of its appointments.
A dock door A truck is still coming, any appointment used it, or a rule names it. Move or cancel the open trucks; switch the door off instead; delete the rules.
A zone A load type's Receiving zone is that zone: "Zone [X] is the Receiving zone of load type [Y]. Pick another Receiving zone on the load type first, then delete the zone." Pick another zone on the load type first. The zone's travel times go with it.
A client A dock appointment or a dock load type names it. Delete its load types first. A client with appointments stays for their history.
A Warehouse An appointment, a dock group, a load type, an equipment type or a capacity rule names it. Delete the dock Setup first, or discontinue the Warehouse. A Warehouse with appointments is discontinued instead.
A carrier An appointment names it. The carrier stays for the history of those appointments.

How the closest-door advice works

For every free opening on every door that can take the truck, the board works out a cost in minutes, and offers the three cheapest, one per door before any door repeats:

  • Waiting: how far the start is from the time the carrier asked for, early or late.
  • Forklift: the door's minutes to the load's zone, times the pallets, times the forklift weight.
  • Crew full, +45 minutes: the door's group already has as many trucks at the dock as its crew limit allows in an hour the visit touches. This ranks the option lower and warns; it does not remove it.
  • Cold door for a dry load, +60 minutes: a dry load is charged an hour for taking a cold door. It is a penalty, not a ban; when only cold doors are open they are offered with a warning.

The load's zone is the load type's Receiving zone; for a shipping load with none it is the Warehouse's Staging zone. A Receiving load with no zone is ranked on time alone. Pallets matter for the forklift cost, so the panel asks for them (type 0 if you do not know).

Settings

On Setup > System > Configuration (shown only while the module is on). Each is read with its default when the company never touched it.

Setting Default What it does
Business_Yard_AppointmentNumberPrefix ("Dock appointment number prefix") APT- The start of the appointment number. The rest is seven digits: APT-0000012.
Business_Yard_SlotMinutes ("Length of one slot on the dock board ...") 15 minutes The board's step. Appointments start and end on a slot, and the options start on the grid. Between 1 and 1440. Changing it later is safe: bookings made on the old grid still block the right time.
Business_Yard_DefaultDurationMinutes ("How long a dock appointment lasts when the person booking does not say ...") 60 minutes Used when the load type has no default of its own.
Business_Yard_TurnaroundMinutes ("Time a dock door is held after an appointment ends ...") 15 minutes The next truck cannot start until this has passed. A longer turnaround leaves fewer openings; 0 allows back-to-back trucks.
Business_Yard_ForkliftWeightPercent ("How much a minute of forklift travel to a door counts against a minute of carrier waiting ...") 100 % 100 weighs them one for one. A higher number sends trucks to the closest door even when that means waiting; 0 ignores the forklift, offers the earliest time, and the Improve flow proposes no door moves.
Business_Yard_RequireEquipmentTypeOnBooking ("Require an equipment type (for example a dry van, a reefer or a flatbed) on every dock appointment ...") Off When on, the desk must pick a Truck type before booking. The type comes from Equipment types.
Business_Yard_SendCarrierEmails ("Email the carrier when a dock appointment is booked, moved or cancelled ...") Off See "The gate pass and the carrier Email".
Business_Yard_NotificationCcEmails ("Comma separated CC recipients added to every carrier dock appointment Email ...") empty Comma separated; for example the office.

The drop trailer settings (also on that screen, and shown only while Drop trailers are switched on):

Setting Default What it does
Business_Yard_TrailerFreeHours 48 hours How long a trailer may wait between its check-in and the moment it is ready to leave (unloaded and empty, or loaded and sealed) before it counts as over its free time. A carrier can have its own number under Carrier terms.
Business_Yard_PickupGraceHours 24 hours How long the carrier has to collect a trailer after it was told the trailer is ready. A carrier can have its own number.
Business_Yard_ReeferWaitAlertHours 4 hours A loaded refrigerated trailer that waits longer than this shows a red warning.
Business_Yard_TrailerClockSkipsClosedDays On Hours on days the Warehouse is closed do not count toward the free time and the time to collect.
Business_Yard_RequireAppointmentForGateIn Off When on, a trailer with no appointment is refused at the gate unless the clerk gives a reason.
Business_Yard_SendPickupNotices Off Allows the ready-for-pickup notice. Separate from the booking emails on purpose.
Business_Yard_VisitNumberPrefix VIS- The start of the stay number: VIS-0000123.

The switches themselves, Business_Yard_Enabled and Business_Yard_TrailerTracking_Enabled, are set by a super user on Tenant details and are not on the Tenant's Configuration screen.

Was this page helpful?