Skip to main content

​
Overview

In the EUDR Articles area (/articles), you manage your products and raw materials. Each article has an article type: Purchase or Sale. Orders, EUDR checks and DDS creation reuse this article data. A saved article is not yet a reviewed or compliant article. EUDR relevance, manual classification and the compliance result are different things; see the Status glossary.

​
Searching and deleted articles

The search box above the table reads Search articles by number or name. Three fields are searched: the name, the internal article number and the article number from your own system — each as a partial match.
Separate several article numbers with commas. 1001,1002,1003 shows all three articles at once — handy for looking up a list out of your ERP in one go. Spaces around the commas do no harm. Every part is matched against all three fields, so a comma inside a name is read as a separator too.
The Show deleted switch pulls deleted articles into the list. Two buttons then appear above the table, each carrying the number of selected articles: one to restore them and one to delete them permanently. This is what this import message points at:
Article ‘ART-1001’ was deleted. Restore it on the Articles page by enabling the “Show deleted” filter.
Where ART-1001 stands, the message prints your internal article number. A re-import does not create the article again, because that would cut its history off from its orders and evidence; restore it here and import again afterwards. The full wording of every import message appears in the Import Results dialog. Deleted articles stay restorable for five years — the EUDR retention period; after that they are removed for good.

​
Importing Articles (Excel or CSV)

Download the template from the arrow beside Import on the Articles page: choose Download Excel template (recommended) or Download CSV template.
Settings → CSV Imports stores column mappings for your own ERP headers. It is not the template download location. You only need a custom mapping when your file differs from the template.
The Excel template (.xlsx) is the recommended download. It contains a second sheet, “Guide”, listing each column’s requirement, description and accepted values. The CSV template is the plain alternative without that sheet. In coded columns the code (e.g. purchase) always works — the import additionally accepts the label as Polygon One displays it in your interface language (Purchase, Einkauf on a German login).

​
Template Fields

The columns in template order:
Do not leave the HS code empty if you use the EUDR module. For users with the EUDR module it is mandatory when creating an article — in the UI, via the API, and in the CSV import: a row creating a new article is rejected with an error when the HS code is missing. Users who only use the PPWR module can leave it empty. Rows that update an existing article may always leave the column empty — the stored HS code is kept. An article created without an HS code is flagged for manual EUDR review — it is never silently treated as “not EUDR-relevant”. Purchase articles without a supplier are rejected with a row error.
The former External Article Number column is no longer part of the template. Existing files and saved column mappings keep working: the column is still accepted on upload and written to the legacy customer article number. New files no longer need it.

​
Performing the Import

1

Prepare the file

Fill in the Excel or CSV template. Excel data is read from the first worksheet; leave the guide on the second sheet. Treat article numbers, HS codes and GTIN/EAN as text to preserve leading zeros.
2

Map the columns

For custom headers, check Settings → CSV Imports → Articles. The matching template does not require a custom mapping.
3

Select the file

Click Import on Articles, select your .xlsx, .xls or .csv file and confirm with Open. If no overwrites need confirmation, the import starts directly after the file check.
4

Confirm overwrites if requested

A preview opens only when stored values would be overwritten. Review the changes, select the intended records and explicitly confirm the overwrites. The preview itself has not saved anything yet.
5

Check the result

A completely successful import of new articles shows a short confirmation. Updates, skipped rows or failures open a detailed result view. Correct failed rows and import them again. For an unsuitable file layout, the error dialog may offer AI-assisted mapping; review and confirm its result before saving. See Import errors.
Suppliers can be created automatically during the article import if they do not yet exist. The system recognizes suppliers based on their name or external ID.

​
Existing Articles and Repeated Rows

The internal article number determines whether the import creates or updates an article. Identical data is skipped as unchanged. Empty optional import fields — such as weight, EAN or description — do not clear stored values; use the edit dialog to clear them. Several rows with the same article number can add different suppliers. Their remaining article data must agree. Conflicting populated values, such as name, HS code or weight, reject that article group. Import adds supplier links; it does not remove existing links.

​
Creating Articles Manually

1

Create a new article

In the Articles area, click Create.
2

Enter the data

Fill in the following fields:
  • Name (required)
  • Internal article number (required)
  • HS code (required for users with the EUDR module)
  • Article type — purchase or sale
  • Supplier (required for purchase articles) — select from existing suppliers
  • Weight per piece (kg) (optional) — lets orders use piece counts instead of kilograms
  • Source varies per order (optional) — each order gets its own copy of the article with its own source
  • EAN, short description (optional)
3

Save

Click Create to add the article.

​
Editing an Article: the Supplier Block

Open Edit from the article row’s action menu. Alongside the master data, review the source setting, EUDR classification and material composition here. For purchase articles, the edit dialog (“Edit Article”) contains the field “Suppliers” as a multi-select. It is prefilled with all the article’s active supplier links.
What the field holds is the complete supplier set. The dialog writes exactly that list — any link not in it is removed on save. Removing an entry is therefore the intended way to unlink a supplier. So check the block before saving.
Further rules:
  • A purchase article needs at least one supplier: “Purchase articles require at least one supplier.”
  • There is no “Select all” here.
  • Converting a purchase article into a sales article unlinks all suppliers.
  • Opening a sales article leaves existing links untouched.
  • The create dialog works with one supplier; add further ones afterwards via editing.

​
Assigning the same supplier to several articles

Tick several articles in the article list and the Assign supplier button appears above the table. The Assign supplier dialog searches for one existing supplier and links it to every selected article.
This bulk action adds, it does not replace. Unlike the edit dialog above — which writes exactly the set the field holds — suppliers already linked stay linked. The dialog says so itself: “The suppliers already linked to them are kept.”
Further rules:
  • You need the Manage articles permission; without it the action cannot be carried out.
  • The supplier must already exist — the picker searches your supplier list. Create a new supplier under Suppliers first.
  • One supplier is assigned per run. Repeat for a second one.
  • Order-specific article copies are excluded: their supplier comes from their order.
  • Afterwards Polygon One reports how many articles were linked, how many already had that supplier, how many were skipped because they are not purchase articles, and, if any were affected, how many were no longer available — deleted between your selection and the confirmation, say. If not a single link was made, the same message appears as a warning.
  • The selection is capped. If your filter selected too many articles at once, the dialog says so with the maximum before anything is written — narrow the filter then.
This bulk action is available in the EUDR article list (/articles).

​
Entering a Weight with a Comma

The field “Weight per Piece (kg)” accepts decimals with a comma — 0,5 and 2,5 work just like 0.5. An empty field clears the weight. In the dialog, invalid input is rejected with “Enter a weight greater than 0, e.g. 2.5.” On import and over the API a weight that is not a number greater than 0 is rejected as well, but with a technical error message.
On CSV import, the file’s delimiter decides, not your language. With a semicolon separator, 2,5 means 2.5 kg; 1.234 is interpreted as thousands grouping and means 1,234 kg. With a comma separator, use 2.5: "2,5" is invalid and is rejected as an error. In Excel, use real numeric cells. Check the magnitude in the preview when one appears, otherwise immediately after import.

​
Plausibility and Duplicate Checks

When you create an article manually, Polygon One checks your input and points out possible issues. There are two kinds of notices:

​
Soft Warnings (non-blocking)

These warnings appear after you submit the form. You can still create the article via “Create anyway” — or correct the input and submit again.

​
Hard Block (blocking)

​
HS Code and EUDR Relevance

Polygon One derives the initial classification from the HS code. The seven commodity groups are cattle, cocoa, coffee, oil palm, rubber, soya and wood. A commodity name alone does not replace checking the specific product and code.
  • Manual review required means classification is unresolved, not “not relevant”. Examples include missing codes, ambiguous parent headings and certain ex headings.
  • Under Edit, check the HS code, EUDR relevant and Commodity group. A relevant article needs a relevant commodity group. Saving confirms the displayed classification when manual review was pending, so check it even when changing another field.
  • When Material composition exists, it determines the article’s classification. Changing the article HS code or manually classifying the article does not override that material derivation. Review and save the materials separately; see Article Import or Bill of Materials?.
  • Classification alone does not confirm origin or compliance. Continue with the required origin data, evidence and EUDR checks.

​
Source Varies per Order

Fixed source (standing) uses the same article basis across orders. With Source varies per order (perOrder), order-specific copies keep origin information separate. Expand the article group in the list to open the copies. Normally, change classification and weight per piece on the template. Copies with their own HS code retain their own classification; copies already assigned to an active DDS are not silently reclassified or overwritten with a new weight. Review affected orders and unresolved notices after a change. While order-specific copies exist, you cannot simply switch the template back to fixed source. A bill of materials describes materials; it replaces neither an order nor its origin data. Continue with Import & Creation and Weights.
Under Settings → CSV Imports → Articles you can permanently map your column names to the Polygon One fields. Use the REST API for automatic synchronization of your article data — details in the API reference.