Bilingual documents for the port and the principal
A port agent’s job means writing the same information twice, for two different readers: the port authority and customs expect a Turkish document, while the owner and the vessel’s foreign master read English. This article, on the document side of ship agency software, covers how to produce both from the same record without losing track of which version was used or whether it was actually delivered.
Two readers, one source of truth
The problem starts the moment the two documents are written separately: one is prepared in Turkish and sent, and an English summary is typed up by hand for the owner. Over time a figure drifts between the two — a document fee might read EUR 90 in the Turkish copy and EUR 95 in the English summary — and finding which one is right takes time. The right approach is producing both languages from a single record: the numbers come from the same database row, only the text language changes.
Turkish regulation itself expects bilingual output
This is not just the agent’s own preference; Turkish maritime regulation requires some information on board to exist in two languages already. Article 16 of the Ports Regulation (Limanlar Yönetmeliği) requires that passenger vessels on cabotage or short-sea routes display signage — showing maximum passenger numbers and life-saving equipment locations — in both Turkish and English, placed where everyone on board can see it (Limanlar Yönetmeliği, Art. 16). It follows the same logic for an agent’s own documents to stay consistent across both languages.
Version control
Official forms change from time to time; a declaration template the port authority asks for today may need a different field a year from now. A document produced from an outdated template may not be accepted. That is why document templates need to be kept under version control, with the record showing which version was used for which call — so you can answer “when, and with which template, was this document produced” in an audit. A template update needs to cover the English copy along with the Turkish one; updating them separately eventually produces two documents that carry different fields in each language.
Consistent terminology
Maritime terms do not always translate one to one between Turkish and English: “ordino” against “cargo manifest approval”, or “liman çıkış belgesi” against “port clearance” — a loose translation of either can leave an owner expecting the wrong document. A template pack should fix, once, which Turkish term maps to which English one; leaving that choice to whoever happens to be translating on a given day lets the same Turkish term drift into two different English terms over time, and the owner ends up unsure which document is which.
Proof of delivery
Producing a document is not the same as delivering it. When a notice went to the port authority, and when a DA reached the owner, both need to be logged on their own. That record settles both the “we notified on time” defence and a dispute with the owner over “we never received this document”.
Beyond official forms: correspondence
Bilingual discipline is not limited to official forms. A short cover note attached to an email to the owner, or a delay notice, should follow the same rule: the same date and amount should reach both sides, only the language changing. Otherwise a mismatch between the date in a note to the owner and the date on the official declaration filed with the port authority can go unnoticed, and it turns into an argument over which date is correct in an audit or a dispute with the owner.
Example
An agent prepares two documents for a passenger vessel’s departure clearance at İzmir: a Turkish departure declaration for the port authority, and an English final DA for the owner. Both are produced from the same cost lines in the same call file; the total shows as EUR 2,600 on both. Each document’s send date and recipient are logged separately on the file.
How it works in Rotenta
- The Documents module defines a TR/EN template pair for each document type; when a template updates, the older version stays in the archive.
- When producing a document from a call file, the language is chosen; the numbers and dates come from the same record, only the text language changes.
- The produced document is downloaded through PDF output or sent directly to its recipient; the send date and recipient are logged on the call file’s Official Notifications tab.
- If crew also need a U-ETDS report, that notice leaves its own trace on the same tab.
- Once the call closes, every document produced stays attached to the file; which template version produced it stays visible afterward.
See which cost lines these documents draw from in disbursement accounts, and where the owner views them in principal accounts and the owner portal.
Frequently asked questions
How is a figure kept from drifting between the Turkish and English copies?
Both copies are produced from the same record; the numbers come from one database row, only the text is translated. There is no drift the way there is with two documents typed separately.
Do older documents become invalid when the template changes?
No; a document produced from an older template stays valid for the date it was produced, and the archive shows which version made it. New documents draw from the current template.
How is it proven a document was actually delivered?
The send date and recipient are logged on the call file; this record backs an “on-time notice” defence or settles a dispute with the owner.
Which documents come out bilingual?
Declarations to the port authority and customs, disbursement accounts sent to the owner, and correspondence are the typical cases; which document types are needed is set by the call in the Ship Call module.
Which templates come ready at setup?
Common notification and disbursement templates come as a ready TR/EN pair; if you need a template specific to your firm, get in touch.
More in this category
- Principal accounts: foreign currency and the owner portal
A foreign-currency ledger for the owner, and a portal where they see their own calls, statement and document PDFs — two pieces that cut down email traffic.
- Disbursement accounts: proforma DA to final DA
From the proforma disbursement account to the final DA: every cost line reported to the owner in its own currency, backed by its receipt.
- How to choose ship agency software
Five criteria for a port agent choosing software: one port call file, an FX-aware ledger, bilingual documents, statutory notices and an owner portal.
- The port call file: nomination to departure
One record holds a vessel's entire call, from nomination to departure, and becomes unchangeable once it closes: the port call file.