Settling with the agent's final account
Applies from version 2258.
On an ordinary agency request every service is an item with its own price and cost account. That works when the services are known in advance. After a port call they often are not: the agent sends one final account afterwards, listing port dues, pilotage, launch, transport and a dozen other positions.
For that case an agency request can be settled with the agent's final account. The request then
carries a single item called Agency Fees, and the agent's own spreadsheet is imported into the
invoice later. ZeeBORN splits the amount across the cost accounts when the invoice is approved.
This has to be switched on once
Purchasing → Configuration → Edit → tab Agency Requests Mail Text — tick the box at the top,
"Agency requests: add "Agency Fees" item and allow importing the agency final account (summary
sheet) into the invoice", then Save.
Without the box there is no question when creating a request and no import button. Everything behaves exactly as before, so switching it on changes nothing about agency requests already in the system.
Creating the request
Purchasing → New → New Agency Request → choose the vessel. ZeeBORN then asks:
Will this agency request be settled with the agent's final account?
The question appears only when the setting above is on, and only in the office — agency requests cannot be created on board.
From here the document runs through the usual steps: approve the requisition, request for quotation
if you want one, purchase order, send it. A purchase order holding Agency Fees can be approved
with price 0 and does not ask for an estimated price. That is intended: at this point nobody knows
the amount yet.
Importing the final account
Register the invoice for the purchase order as usual, then:
Invoice → Import AR Summary Sheet → load or drop the file → Import Summary Sheet
The button appears only on a purchase order holding Agency Fees, and only while the invoice
has no account lines yet. After a successful import it is gone — which is also how you can tell
that an import has already run.
What the file has to look like
Row 1 holds exactly these headings, then one row per cost position:
A row with Total in the first column ends the list. Empty rows are skipped.
When something in the file is wrong
ZeeBORN lists every faulty row with its row number and imports nothing at all — not the good rows either:
The summary sheet was not imported. Row 3: account 99999 is not available for this vessel …
Correct the file and import it again. Cancelling the dialog leaves the invoice untouched. This is deliberate: a half-imported final account would be harder to find and repair than one that was rejected outright.
What you see after approval
When the invoice is approved, the single Agency Fees item in the purchase order is replaced by
one item per account, named agency costs: …. The budget is booked per account and cost
department, exactly as if the positions had been entered by hand.
That is the point of the whole route: the agent sends one document, and the costs still land on the right accounts.
Printing
Agency requests are printed with their own forms where such forms are installed, and with the ordinary purchasing forms where they are not. Nothing has to be selected for this, and a missing agency form is no longer reported as an error.
Related
- Agency Requests — the ordinary agency request with its own items
- Invoice Registration — recording and approving invoices