> ## Documentation Index
> Fetch the complete documentation index at: https://docs-nce.global-e.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Requirements for Global-e Merchants using SFTP server as a DDS source for EUDR regulation

Part of [EU Deforestation Regulation (EUDR)](https://docs-nce.global-e.com/eu-deforestation-regulation-eudr.md).

## About This Service

Global-e offers an EUDR (EU Deforestation Regulation) data intake service that receives your product-level Due Diligence Statement (DDS) reference and/or TARIC document codes via SFTP. Global-e stores this data and passes the applicable values into shipping and customs documents so EU customs clearance is not delayed for EUDR-regulated products.

To use this service, provide the data listed below in a CSV file. Global-e handles parsing, storage, and use of the data on documents — you supply the product identifiers and EUDR values.

## What does this service do?

* Accepts product-level EUDR data (DDS reference and/or TARIC document code) via SFTP CSV
* Matches each row to the product in the Global-e catalogue using `ProductCode`
* Stores the values so they can be included on documents used for customs declaration
* Supports exemption TARIC codes (Y196 / Y129 / Y188) that do not require a DDS reference number

## How do you submit the required data?

* Via SFTP Server.
* The SFTP defined for the merchant (existing) will have a new folder `/Eudr`
* Upload CSV file(s) to this folder. Global-e reads, parses, and stores them.

## What do you need to provide?

The table below lists the fields in the EUDR SFTP file. `ProductCode` is always required. For each product row, you must populate either `eudrDdsReference` or `eudrTaricCode` (one of the two).

| Field | What to Provide | Required? |
| - | - | - |
| `ProductCode` | Your product identifier used by Global-e for catalogue lookup **Non-Shopify merchants** — use the SKU / product code stored in the Global-e catalogue. **Shopify merchants using SFTP** — use the Variant ID (stored in the Global-e catalogue as product code). | Yes — Mandatory |
| `eudrDdsReference` | Due Diligence Statement (DDS) reference number issued after registration in TRACES. Quoted on the customs declaration for EUDR-regulated products. | Not mandatory on its own — but required if `eudrTaricCode` is empty |
| `eudrTaricCode` | TARIC document code for the product when a DDS reference is not required (or when declaring an applicable exemption / special case code). | Not mandatory on its own — but required if `eudrDdsReference` is empty |

**Business rule**

> [!NOTE]
>
> **One of the two fields must be populated on each row: either `eudrDdsReference` or `eudrTaricCode`.**
>
> TARIC codes Y196, Y129, and Y188 do not require a DDS reference number. For those products, populate `eudrTaricCode` with the applicable code and leave `eudrDdsReference` empty.

## File data examples

| ProductCode | eudrDdsReference | eudrTaricCode | Notes |
| - | - | - | - |
| WD-4401-NAT | 123YYSS | | DDS reference provided; TARIC code left empty |
| BAG-LEATHER-02 | 3456ZZZZ | | DDS reference provided; TARIC code left empty |
| 40192837465812 | | Y196 | Exemption / special TARIC code — DDS not required |
| SHOE-OXF-BRN-42 | | Y129 | Exemption TARIC code — DDS not required |

## Field checklist (quick reference)

| Field | Requirement |
| - | - |
| **ProductCode** | Mandatory |
| **eudrDdsReference** | Not mandatory (fill if no TARIC code) |
| **eudrTaricCode** | Not mandatory (fill if no DDS reference) |
| **Row rule** | Populate either `eudrDdsReference` or `eudrTaricCode` |
| **Y196 / Y129 / Y188** | DDS reference not required — use `eudrTaricCode` |

## File Format: .csv file

**File layout**

Header row: **ProductCode, eudrDdsReference, eudrTaricCode**

```csv theme={null}
ProductCode,eudrDdsReference,eudrTaricCode
```

* Include all three columns in every file.
* Leave the unused optional column empty for that row — do not omit the column from the header.

## How Global-e uses this data

* On product lookup, Global-e uses `ProductCode` to match the catalogue item
* If a DDS reference is present, it can be passed into documents for customs declaration
* If a TARIC code such as Y196 / Y129 / Y188 is present instead, documents reflect that code without a DDS reference
* If neither `eudrDdsReference` nor `eudrTaricCode` is provided for a product, the .csv file should not contain a record with a product code only. Such record is not valid.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.