CMR Documents
Borderbolt provides a dedicated module for creating and managing CMR documents (Convention relative au contrat de transport international de Marchandises par Route) — the standard international consignment note required for road freight transport.
Overview
The CMR module supports:
- Create a new CMR document with all standard box fields
- Edit the document with auto-save functionality
- Finalize to lock the document
- Generate PDF with color-coded copies for all parties
CMR Document List
Navigate to the CMR section in the sidebar. The list view shows all CMR documents in an AG-Grid table with:
- Document number (clickable link to detail)
- Dossier number
- Status (Draft / Final)
- Consignor and consignee names
- Created date
Actions
- Download PDF — Generate and download the CMR document
- Delete — Remove the document (Draft status only)
Creating a CMR
Click New CMR to open the creation form. The form is organized in a two-column layout matching the official CMR box structure.
Left Column
| Field | CMR Box | Description |
|---|---|---|
| Dossier Number | — | Optional reference to link to a dossier |
| Consignor | Box 1 | Sender name and full address |
| Consignee | Box 2 | Receiver name and full address |
| Delivery Place | Box 3 | Final delivery location |
| Takeover Place | Box 4 | Goods pickup location |
| Takeover Date | Box 4 | Date goods are picked up |
Right Column
| Field | CMR Box | Description |
|---|---|---|
| Transporter | Box 16 | Carrier name and address |
| Signing Location | Box 21 | Place where the CMR is signed |
| Signing Date | Box 21 | Date of signature |
| Number of Pages | — | Choose 3 or 4 copies in the PDF |
Goods Items Table
The goods table allows you to add line items for the shipment:
| Column | CMR Box | Description |
|---|---|---|
| Marks & Numbers | Box 6 | Identification marks on packages |
| Packages | Box 7 | Number of packages |
| Packaging Type | Box 8 | Type of packaging (pallets, boxes, etc.) |
| Nature of Goods | Box 9 | Description of the goods |
| Statistical Number | Box 10 | HS code or statistical number |
| Gross Weight (kg) | Box 11 | Weight in kilograms |
| Volume (m3) | Box 12 | Volume in cubic meters |
Click Add Item to add new rows. Use the trash icon to remove items.
Editing a CMR
The Show/Edit page has the same two-column layout as the creation form.
Auto-Save
All fields auto-save when you move to the next field (on blur) with a 500ms debounce. A “Saving…” indicator appears in the header during save operations.
Only CMR documents in Draft status can be edited. Finalized documents are read-only.
Additional Fields
The edit view also supports these fields (beyond what’s available during creation):
| Field | CMR Box | Description |
|---|---|---|
| Added Documents | Box 5 | List of annexed/attached documents |
| Consignor Instructions | Box 13 | Special instructions from sender |
| Freight Payment Type | Box 14 | How freight is paid |
| Refund Currency & Amount | Box 14 | Cash on delivery details |
| Succeeding Transporter | Box 17 | Additional carrier information |
| Transporter Reservations | Box 18 | Carrier notes or reservations |
| Special Agreements | Box 19 | Special conditions between parties |
| Incoterms | — | ICC Incoterms code and location |
| Comments | — | Additional notes from consignor |
Versioning
CMR documents use a versioning system. When a full update is made, a new data version is created rather than overwriting the existing data. This provides an audit trail of changes made to the document.
Finalizing a CMR
When the document is complete, click the Finalize button. A confirmation dialog will appear since this action is irreversible.
After finalization:
- The status changes from Draft to Final
- All form fields become read-only
- The document can no longer be edited or deleted
- PDF generation remains available
Finalization is a one-way action. Make sure all information is correct before finalizing.
PDF Generation
CMR PDFs can be generated at any time, regardless of status.
PDF Copies
The generated PDF contains multiple color-coded copies, matching the standard CMR convention:
| Copy | Color | Recipient |
|---|---|---|
| 1st copy | Red | Consignor (sender) |
| 2nd copy | Blue | Consignee (receiver) |
| 3rd copy | Green | Transporter (carrier) |
| 4th copy (optional) | Grey | Additional transporter copy |
The number of copies (3 or 4) is configurable per document via the Number of Pages field.
Multi-Language Headers
Each copy includes headers in three languages:
- French (original CMR convention language)
- Dutch
- German
Downloading vs Previewing
- Download — Click the download button to save the PDF file (filename:
CMR-documentNr-{number}.pdf) - Preview — Click the preview button to open the PDF inline in your browser
CMR Statuses
| Status | Description |
|---|---|
| Draft | Editable. Can be modified, deleted, and PDF generated. |
| Final | Locked. Read-only. PDF generation still available. |