Master records

Master records are your saved, reusable data (vehicles, drivers, customers, goods, and so on). You prepare them once and then choose them with a click when creating each DeCA.

On this page

What master records are

In Master records (/maestros) you manage nine types of reusable data:

  • Vehicles
  • Trailers
  • Drivers
  • Customers / Loaders / Contracting parties
  • Origin
  • Destination
  • Goods
  • DeCA templates
  • Passenger routes

Each record is yours (only your company can see it) and can be disabled without losing the history.

View, search and filter

  1. Choose the type

    Select one of the nine entities to see its list.

  2. Search and filter

    Use the search box to find by text and the status filter (All, Active, Inactive). By default all are shown. Next to them you choose how many records to see per page (10, 25, 50 or 100; 25 by default): the amount applies to the search and filters and is kept when you change page; changing it takes you back to the first page.

Create or edit a record

  1. Open the form

    Click New (or select a record to edit it). Its record opens full screen; when you go back, the list keeps its page, search and filters. In Customers / Shippers / Contractors the button is called New company; the Role field shows its part in the transport.

  2. Fill in the fields

    The fields depend on the type (for example number plate and type for vehicles; NIF and legal name for customers). If a customer has a tax ID from another country, tick Foreign identification next to the NIF; when importing a CSV, put yes in the nif_extranjero column. With the Contractual loader or Logistics operator role, Address, Postal code and City are required: without them the record is not saved, and when importing a CSV the row is rejected, stating which column is missing. Records you already had without an address are kept as they are; you will be asked to complete it when you edit them. Save.

Note

If you try to create a duplicate record within your company (same number plate or NIF), you will see a warning and it will not be saved.

In Goods, nature is required and names the record in the list and the search when creating a DeCA. Description is an optional internal note: it stays in Masters and is not copied to the document. Older records without a nature receive their description once when the update is applied. Editing a Masters record does not change DeCAs already saved.

In Goods, Quantity / weight is optional. If you enter it, use a number greater than zero with up to nine integer digits and two decimal places; a decimal comma or point is accepted. Unit is optional too. If you choose the unit Other, the Magnitude type field appears so you can say which one it is (for example, cages); it is required when you enter a quantity, and it is preloaded, editable, when the record is used in a shipment. Older text that cannot be converted unambiguously is kept in the peso_habitual_original column of the CSV export, and quantity is left empty for correction. This historical column is read only: importing it does not change the original. In the record, Quantity / weight and Unit share one row; if you do not want to set a unit, leave “Not specified”. If the record keeps a text from the old “Usual weight” field, you will see it as Previous text (read-only), so you can review it and complete the quantity and the unit. The list shows the Quantity / weight column with the quantity and its unit.

For Origin and Destination, Address and Locality are required. Company name, tax ID and postcode may be empty. Records without a company name appear by address and locality in lists and searches. This rule applies when creating, editing, importing and saving from a DeCA. Existing records are retained; complete both fields when editing them and before issuing a document that uses them.

Origin and Destination (formerly Senders and Recipients) store your usual loading and unloading addresses; existing records and DeCAs already issued do not change. If an address works for both, tick Also create in Destination on an Origin record, or Also create in Origin on a Destination record, when you create or edit it. When you press Save, an independent copy with all the data being saved, empty fields included, is created in the other master, active even if the source record is disabled; afterwards each record is edited, disabled or deleted on its own. If both are saved, you will see Address saved in Origin and Destination. If the other master already has an identical record, even a disabled one, no other one is created: the notice links to it. If it has one with the same address but some different data, it is not changed and the copy is not created: the notice links to that record so you can review it and, if it is a different address, offers Create the copy anyway. The tax ID or company name alone do not count as a match. The copy uses one record in its master: if your plan has no room left, your record is saved, the copy is not, and the notice says so. Administrators and Operators can do this.

In Drivers, under More details, there are Email and Additional email for a copy of the DeCA. Both are optional and each accepts a single address; you can save only the additional one. If automatic sending to the driver is enabled (Account → DeCA issuing), the DeCA is sent to both, separately; if both addresses are the same, it is sent only once. An example of an additional email is their company's.

In Drivers you can set an optional Usual vehicle: search for it by plate among the vehicles in your Masters (each result shows the plate and its module) or choose No usual vehicle to leave it empty. Several drivers can share the same vehicle. It is suggested when you select that driver in a goods or passenger DeCA, a template or a route, and you can change it for each transport; changing the vehicle of a DeCA does not change the record. If you later deactivate the vehicle, the record keeps it and shows it as deactivated, but it is no longer suggested; if you delete it, the record is left without a usual vehicle. The drivers CSV and Excel files do not include this field, and importing them does not change it.

In DeCA templates and Passenger routes, the vehicle (in routes, the Usual bus) and the driver are chosen with a search box, as when creating a DeCA, and picking the driver suggests their usual vehicle in the same way: it is filled in if the vehicle is empty, or the current one is kept and Use usual vehicle · [plate] appears. In a route, each journey (Outbound and Return) with Use general bus and drivers unticked has its own help: if its bus is empty, it uses the route's usual bus, which is kept, and the button sets the bus for that journey only. The backup driver never triggers it. The vehicle left selected is the one saved. A deactivated vehicle, trailer or driver cannot be chosen again, but the one already saved is kept: it is shown as “(deactivated)” with a notice next to the field, and saving other changes (for example, the name) does not remove it; to remove or replace it, change it yourself. A copy of the record cannot save it: the notice asks you to choose another one or remove it before saving. When the template or route is used in a DeCA it is not loaded, and the form says which deactivated records were not loaded. The usual vehicle help says “You can change it for this template” or “for this route”.

In Passenger routes, besides the Usual driver, you can enter a Usual backup driver, optional and different from the usual one. When you load the route into a passenger DeCA, it fills in the general backup driver; when you save a route from a DeCA, the general backup driver is taken. The routes CSV includes this column; older files without it are still imported. Existing routes have no backup driver until you enter one.

In Passenger routes you can keep the outbound journey and an optional return in the same route, which still counts as a single record. Below Outbound, the Add return button creates the Return block by reversing the origin, destination and stops of the outbound journey (for this, the outbound journey needs the origin and destination address and town); you can then edit it or remove it with Remove return, and nothing is saved until you press Save. Route stops are reversed by the « · » separator; if the text cannot be split, it is kept and you are asked to check their order. Loading a route with a return into a DeCA creates two services, outbound and return, without dates and with their stops; saving a route from a DeCA also saves the return of the first service. The CSV includes the return columns, and an older file without them is imported without deleting a route's return. Existing routes keep a single journey until you add a return.

Each journey of a Passenger route (the Outbound and, if it has one, the Return) has the Use general bus and drivers checkbox, ticked by default: the journey uses the route's usual bus and drivers. If you untick it, you can choose the Bus for this journey, the Main driver for this journey and the Backup driver for this journey; if you leave the bus or the main driver empty, the usual ones are used, and an empty backup driver (No backup driver) means that journey has no backup. The backup driver cannot be the same driver as the journey's main driver. When you load the route into a DeCA, each service is loaded with that choice and those assignments; when you save a route from a DeCA, the outbound's and its return's assignments are saved too. The CSV includes these columns; an older file without them does not change the saved assignments, and existing routes use the general ones on all their journeys.

Each journey of a Passenger route also has Usual times · optional: Planned departure time and Planned arrival time. The Route does not store dates: when you use it in a DeCA, the outbound and return times are restored and you fill in the dates of that transport. If the arrival time is earlier than the departure, it may be a night service: the Route is saved and you are warned that, when you use it, you will have to enter a later arrival date. Add return creates the return without times, even if the outbound has them, and Remove return also removes its times. From the detail of a passenger DeCA, Save as template opens Save as a passenger route, which also keeps the times of the outbound journey and its return. The Routes CSV carries the four times; an older file without those columns does not delete the saved times.

If a driver record is linked to a user (see Users and security), it cannot be deleted: it is disabled. To delete it, first remove the link in Account → Users.

Disable, re-enable and delete

  • Disable: the record stops appearing in the Create DeCA dropdowns, but remains in the history of the documents that already used it.
  • Re-enable: it becomes available again for new documents.
  • Delete: permanent removal. If the record is used by any DeCA, it cannot be deleted; disable it instead.
  • Favourite: mark the ones you use most so they appear first.

DeCA templates

A template stores the details that repeat across your goods DeCAs: the parties, the vehicle, one or more shipments and your usual notes. When you choose it while creating a DeCA, everything comes in already filled in.

  1. Give it a name and choose your role

    The template name and your company's role (actual carrier or contractual shipper) are the only required details. Everything else can be left unfinished and completed for each transport.

  2. Enter the other party

    Press the magnifying glass to pick a company from your Master data, or type its details. Whatever is loaded can be changed for this template.

  3. Add the shipments

    A template always has at least one shipment and can hold up to 100. You can add, duplicate (the copy is placed right below the original) and remove shipments; if you remove one by mistake, Undo brings back the last one removed. The order is kept. Each shipment can be collapsed by pressing its header, which keeps showing its number and route; collapsing it deletes nothing.

  4. Choose how the addresses are organised

    Just as when creating a DeCA: Addresses per shipment, Shared origin or Shared destination. The option is saved with the template. See Several shipments with the same origin or destination.

  5. Fill in each shipment

    Nature of the goods, quantity and unit (with the magnitude type if you choose “Other”), ADR, packages, container number and special authorisation. If you enter a quantity, it must be a number greater than zero; decimals are accepted. Dates and times are not saved: you enter them on each DeCA.

  6. Write the notes

    DeCA notes are copied to the document when you use the template. Internal notes are only there to help you organise your templates and never appear on the document.

In the list, each template shows how many shipments it holds and a summary of its origin and destination. The search box finds a template by the address of any of its shipments, not just the first.

Save an issued DeCA as a template

On the page of a goods DeCA that has already been issued, click Save as template and enter a name. The new template keeps all the shipments of the document in their order, the way the addresses are organised, the other party, the vehicle, the trailer, the driver, the goods details of each shipment and the DeCA notes. The document is not modified.

It is not saved, and a message tells you why, if a template with that name already exists, if the document has more than 100 shipments or if its notes are longer than 1000 characters.

Use a template

When creating a goods DeCA, choose it in the template dropdown. See Start from a template.

Note

Do you have older templates? They still work the same way: they are read as a single shipment with “Addresses per shipment” and are not modified until you open and save them. The oldest ones stored origin and destination in a single box: when you open one, that text appears in the address field and you only need to fill in the postcode and town. If they keep a weight written as text, you will see it for reference so you can fill in the quantity and the unit.

Import and export CSV

To load many records at once or take them to another tool.

For Vehicles and Trailers the main option is the guided Excel template: click Download Excel template to get a file with dropdown lists (so you don't have to memorise the allowed values), a column that fills itself in based on the vehicle type you choose, and an instructions sheet. Fill it in and click Import Excel to upload it. CSV is still available as a secondary, technical option, without dropdowns.

  1. Export

    Click Export CSV to download all the records of the current type.

  2. Import

    Click Import CSV and upload the file in the same format.

The DeCA templates CSV has one row per shipment: a template with three shipments takes up three rows with the same name, in their order, and each row states how the addresses are organised. On import, each template is saved in full or not at all, and anything that cannot be imported is reported with its line number. CSV files exported before this change still work: each row is imported as a template with one shipment.

Each file you import can have up to 2,000 rows and 1 MB; the DeCA templates file, which takes one row per shipment, up to 5,000 rows and 3 MB. If a file exceeds its limit, nothing is imported and you are told so: split it into several files, keeping the rows of each template together.

If you run many imports in a row — more than 20 in five minutes — the platform asks you to wait a few minutes before the next one. And if an Excel template is under its size limit but the text in its cells takes up more than 1 MB, it is not imported either: shorten the text or split the records across several files.

Note

Import and export —both Excel and CSV— depend on your plan. If your plan does not include them, the buttons do not appear. See Plans and payment.

Limits by plan

Each type of master record may have a cap depending on your plan (for example, a maximum number of vehicles or drivers). Once you reach it, you will not be able to add more records of that type until you free up space (by disabling records) or upgrade your plan. Plans with an unlimited allowance show no cap.

If an Excel file looks small but becomes too large when unzipped, it is not imported: reduce its content or split it before trying again.

New quantities accept at most two decimal places, using a comma with no added zeros. Extra decimal places show an error beside the field; correct it without losing the rest of the form. The same rule applies to Masters and Templates. Historical values and issued documents are preserved without automatic changes.