Dijit.app Dijit.app Documentation

Documentation/ Master records and catalogues/ The external product catalogue

The external product catalogue

The external catalogue is your own list of items, with the code you use for each one. You upload it once from an Excel file and, when you link a line to your item, the line ends up carrying your code.

Database › External product catalogue

Who it is for

It is for you if you keep your own list of items —in management software or in a spreadsheet— and you want the lines of your delivery notes and invoices to carry your code.

The catalogue lives in Dijit. The codes you put in are the ones from your software, and Dijit neither invents them nor checks them against it: it keeps them, writes them on the lines and carries them into the files you generate.

The menu entry appears when your management software is not connected directly to Dijit. If it is, the items come from your software and the line is linked against its own list, as your software's page explains.

Uploading your list from Excel

  1. Go to Database › External product catalogue.
  2. Press Import. Import catalogue from Excel opens.
  3. If you have no Excel file ready, press Download template and fill it in.
  4. Press Choose Excel file and pick your file. Dijit tells you how many rows it found.
  5. Say which column of your Excel goes to each field. The code and the name are required; the rest is optional. If either is missing, you get "Choose the code column and the name column."
  6. Confirm. When it finishes you see the result: Received, Created, Updated and, if there are any, Skipped rows with the reason for each one.

You can import as often as you like, for instance every time you add new items in your own software.

The Excel columns

FieldRequiredWhat it is for
Product ID (from your software)YesThe code you want to see on your lines.
Product NameYesWhat you search by when you link the line.
SKUNoHelps you find it in the search.
FamilyNoA grouping, as free text.
Unit of MeasureNoThe unit you handle the item in.
Conversion FactorNoHow it relates to the base unit.
VATNoThe rate that applies, as a written percentage.
EAN CodeNoThe barcode. Helps you find it.
Extra CodeNoOne more free field.
NotesNoFree text for remarks.

Family here is free text, not a dropdown: it has nothing to do with the families in the product master. Write it the same way every time if you mean to group by it.

The rules of the import

If the Excel file has no data, Dijit says "The file has no rows." and imports nothing.

Adding an item by hand

On the same screen you can create, edit and delete items one at a time, and download the whole list with Export.

  1. Press New Product.
  2. Fill in the fields. They are the same as the Excel columns.
  3. Save. The confirmation is "Product created successfully".

On the form, the only required field is the name: without it you get "Product name is required". Even so, put the code in as well, because an item with no code cannot be linked to a line.

The search box on the screen finds items by name, SKU or reference, and each column has its own filter and sort as well.

Linking a line to your item

Document › items tab › line › ERP item assignment

  1. Open the document and go to its items.
  2. On the line, press the ERP item assignment button.
  3. In Catalogue item, type part of the code or of the name and pick yours from the list.
  4. Save.

What stays on the line is your code, in the ERP reference code field. That field also takes the code typed in by hand, without going through the catalogue.

If the item you pick is in the catalogue without a code, you get "That catalogue item has no code: nothing has been assigned." and the line stays as it was. Dijit puts no number of its own there: a code your software does not know is no use to anyone. Add the code to the item in the catalogue and pick it again.

From that link onwards, the lines of that same item from that same supplier arrive with your code already in place. The lines that were already there without a code stay as they were: those you link one by one.

You doing it the first time is not a reading failure: it works that way in every integration, and there are four concrete reasons why no system can get that match right on its own.

The places your code shows up

The catalogue on sales documents

On some accounts this same catalogue feeds the description and packaging dropdowns on the lines of sales delivery notes: instead of typing the name on every line, you pick it from the list and the description always comes out written the same way. Those dropdowns also take a value that is not on the list, and when the reference has a single packaging, the packaging fills itself in.

Keeping the catalogue up to date

Common situations

SituationCauseWhat to do
The Catalogue item dropdown is empty You have not uploaded your list yet. Import the Excel file from the catalogue screen.
You get "That catalogue item has no code" That item is in the catalogue without a code. Add it in the catalogue, or in the Excel file, and import again.
The import will not confirm The code column or the name column has not been chosen. Choose both: they are the required ones.
It says the file has no rows The sheet is empty, or the data is on another sheet of the file. Check the file and choose it again.
There are skipped rows The code is repeated or missing. Read the reason for each row in the result and fix the Excel file.
You uploaded the wrong Excel file Nothing was deleted: the import only creates and updates. Upload the right one; matching codes are updated with the good data. Delete by hand anything that was created and should not be there.
You cannot see the menu entry Your management software is connected directly to Dijit. Nothing: the items come from your software and the line is linked against its list.
Your description is not the supplier's That is normal: everyone names an item their own way. Nothing. That is why you make the link the first time; Dijit does not guess, it remembers what you pick.

↑ Back to top

Last reviewed: 21 October 2026 · The Dijit.app team