> For the complete documentation index, see [llms.txt](https://docs.live-eo.com/tradeaware/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.live-eo.com/tradeaware/using-the-tradeaware-web-app/products-and-plot-linking/for-buyers-request-plot-data.md).

# For buyers: request plot data

This page is for buyers. If a buyer asked you for plot data, see For suppliers: link plots to your buyers' products.

**Important: before you start**

* Your suppliers must be connected to you, which means they have accepted your invitation. See [Connect with your supply chain](https://docs.live-eo.com/tradeaware/using-the-tradeaware-web-app/connect-with-your-supply-chain).
* Your suppliers need their plots in TradeAware. They can also import new plots while they link them.
* To use products in transactions, your account needs Transaction Management. See [Manage your transactions](https://docs.live-eo.com/tradeaware/using-the-tradeaware-web-app/manage-your-transactions).

### Open the Products page

Select **Products** (the tag icon, second in the left navigation, under Plots).

<figure><img src="https://1342046618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbenSEfMyYbRWLaKU6iTs%2Fuploads%2FiwauXfKWIGMmkrXIYl1F%2FScreenshot%202026-10-07%20at%2014.52.02.png?alt=media&amp;token=3ae58af0-6deb-40c2-90ff-89b84237c3bb" alt=""><figcaption></figcaption></figure>

### The Products table

The table lists the products you own and any products a buyer has shared with you as a supplier.

| Column       | What it shows                                                                                                                   |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| Product name | The name you gave the product.                                                                                                  |
| Reference ID | Your own reference, for example the material number from your ERP.                                                              |
| Commodity    | Set automatically from the HS code.                                                                                             |
| HS Code      | The EUDR HS code of the product.                                                                                                |
| Buyer        | "You (your business name)" for your own products. For a product a buyer shared with you, the buyer's name.                      |
| Supplier     | The supplier the product is shared with, or "Multiple entries" when there are several. Click it to see or change the suppliers. |
| Valid until  | The "Mapping valid until" date the supplier set, or "Multiple entries" when suppliers set different dates.                      |
| Plots        | How many plots are linked. Click it to see them.                                                                                |
| Status       | Not shared, Shared, Ready or Expired (see below).                                                                               |

| Status     | Meaning                                                                                    |
| ---------- | ------------------------------------------------------------------------------------------ |
| Not shared | The product isn't shared with any supplier yet.                                            |
| Shared     | The product is shared, and at least one supplier hasn't linked plots yet.                  |
| Ready      | Every supplier has linked at least one plot, and no "Mapping valid until" date has passed. |
| Expired    | A supplier's "Mapping valid until" date has passed.                                        |

When a product has several suppliers, it shows the status of the supplier furthest behind. For example, one supplier Ready and another still Shared shows Shared. Expired always shows as Expired.

{% hint style="info" %}
Note: Ready means plots are linked. It doesn't mean they have been analyzed or assessed. Review the linked plots and their risk before you use the product in a transaction.
{% endhint %}

Use the search bar to find products by name, reference or HS code. Use the filters for HS Code, Supplier, Status and Commodity. For example, filter on Status = Shared to see which products are still waiting for plot data, or on one supplier to see what that supplier still has to do.

### Add products

Select the + button at the top of the table to open Add products. You can add products one at a time or import them from a CSV file.

#### Add a product manually

| Field               | Required    | Notes                                                          |
| ------------------- | ----------- | -------------------------------------------------------------- |
| Product name        | Yes         | Up to 255 characters.                                          |
| Reference ID        | No          | Your own reference, for example "SAP-PRD-00482".               |
| Product description | No          | Up to 1,000 characters.                                        |
| HS Code             | Yes         | Search or browse the HS codes covered by the EUDR.             |
| Commodity           | Set for you | Filled in from the HS code.                                    |
| Suppliers           | No          | Choose connected suppliers to request plot data straight away. |

Select Save, or Add another to save and start the next product.

#### Import products from a CSV file

1. In Add products, drop your file on Import from .csv, or select Browse files to import (.csv).
2. TradeAware shows a preview: how many rows are ready to import and how many need review, with the reason for each row that needs review.
3. Select Import \[n] products. Only the rows without problems are imported. Rows that fail stay in the preview with the reason.

Your file needs a header row. Column names aren't case sensitive, and spaces, hyphens and underscores are ignored, so "HS Code", "hs\_code" and "hscode" all work.

| Column       | Required | Also accepted       |
| ------------ | -------- | ------------------- |
| name         | Yes      | product name        |
| hs code      | Yes      | hsCode              |
| reference id | No       | buyerProductRef     |
| description  | No       | product description |

`name,hs code,reference id,description`\
`Cocoa beans Grade A,1801,SKU-10442,Raw cocoa beans`\
`Oak boards 25mm,4407.91,SKU-20871,Kiln-dried oak`

* TradeAware recognizes the separator, for example a comma, semicolon or tab.
* You can import up to 1,000 rows per file. Split larger files.
* HS codes may contain dots or spaces ("4407.91" and "440791" are the same). A row with an HS code outside the EUDR scope is rejected when you import.
* Suppliers aren't part of the CSV. After the import, select the new products and use Request plot data (see below).

### Request plot data from your suppliers

Sharing a product with a supplier is the request. The supplier gets a notification in TradeAware: "*\[Your business] is requesting plots for \[product name]*", and can then link plots to it. Only suppliers that are connected to you appear in the list.

Note: TradeAware notifies suppliers in the app only, not by email. Let your suppliers know to check their notifications.

#### For one product

1. Click the product's Supplier cell, or open the row menu and select "**Manage supplier access"**
2. In Supplier access, choose the suppliers who deliver this product. Suppliers you don't select are removed from the product.
3. Select Save.

<figure><img src="https://1342046618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbenSEfMyYbRWLaKU6iTs%2Fuploads%2FggCu8LUDxpL2SNRIz2Ig%2FScreenshot%202026-10-07%20at%2014.59.54.png?alt=media&amp;token=b890e37f-3c65-4161-a966-75ebd0fbb33e" alt="" width="375"><figcaption></figcaption></figure>

Important: Removing a supplier also removes the plots they linked to the product. TradeAware asks you to confirm: "Remove access for \[name]? They will no longer see this product and all assigned plots will be removed." If you add them again later, they start with no linked plots.

#### For several products at once

1. Tick the products in the table. The tick box in the header selects all products shown. You can only select your own products.
2. Select **Request plot data**. The Manage sharing window opens.
3. Choose the suppliers and select Save changes.

<figure><img src="https://1342046618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbenSEfMyYbRWLaKU6iTs%2Fuploads%2FiCx10Ee4wSmovyGyCYAt%2FScreenshot%202026-10-07%20at%2015.00.58.png?alt=media&amp;token=c03f36f8-8c1c-4dac-b740-48ad1a9e56c3" alt="" width="375"><figcaption></figcaption></figure>

Every selected product ends up with exactly the suppliers in the list. The list starts with every supplier already attached to any of the selected products. Suppliers you add get the request for all selected products, and suppliers you remove lose access to all of them, together with the plots they linked.

* You can request plot data for up to 10,000 products at a time.
* Request plot data isn't available when one of the selected products has more than three suppliers. Manage those products one at a time with Manage supplier access….
* Keep the tab open until the progress message says the action has finished. If some products fail, they stay selected so you can try again.

### Track progress

* Watch the Status column, and filter by Status or Supplier to see what's still open.
* When a supplier links plots, you get a notification: *"\[Supplier] mapped \[n] plots for \[product name]*". Select Go to to see the plots.
* Click the Plots count to open Plots attached to \[product name]. Plots are grouped by supplier, with the supplier's status, number of plots and area. For each plot you see Name, Commodity, Country, Area (ha), Risk and Status. A supplier who hasn't started yet shows "Shared — supplier has not started mapping."
* Click Multiple entries in the Supplier column to open Shared with. It lists every supplier of the product with their status, "Valid until" date and plots, and has a Manage sharing button.

<figure><img src="https://1342046618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbenSEfMyYbRWLaKU6iTs%2Fuploads%2FQBNx8Ct8qeWof6nHvBrW%2FScreenshot%202026-10-07%20at%2015.03.31.png?alt=media&amp;token=0385e1f7-b625-45be-915a-2055a16ac1cf" alt="" width="375"><figcaption></figcaption></figure>

### Use a product in a transaction

1. In a transaction, select Add product or commodity.
2. Open the Products tab. It lists your products with their Reference ID, Commodity, HS Code, Supplier, Plots and Status.
3. Tick the products and select Add products.

Each product becomes a card with the product name, its Reference ID, the product description, net mass and production period, and the product's suppliers with the plots they linked already selected. If the linked plots carry production dates or species, the production period and species are filled in from them. Add the net mass, check the rest, then save or submit as usual.

<figure><img src="https://1342046618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbenSEfMyYbRWLaKU6iTs%2Fuploads%2FC8eZhZDzOUuZHbQM9j2Q%2FScreenshot%202026-10-07%20at%2015.04.45.png?alt=media&amp;token=055c1f30-bebd-4059-9589-55adfb18d9ee" alt="" width="375"><figcaption></figcaption></figure>

What goes into the DDS. When the transaction is submitted, TradeAware includes every plot that the suppliers on the card have linked to the product at that moment, plus any other plots you selected on the card.

* To leave one supplier's plots out of this transaction, remove that supplier from the card. Unticking one of a supplier's linked plots doesn't remove it from the DDS while it's still linked to the product.
* If a supplier changes their linked plots before the transaction is submitted, the DDS uses their updated set.
* An expired mapping is still used. Check the product's status before you submit, and ask the supplier to confirm their plots if it shows Expired.
* Each supplier on the card needs at least one plot selected, otherwise you see "Plots required to submit transaction". If a supplier hasn't linked plots yet, wait for them or remove them from the card.
* For a product with more than three suppliers, the card starts with three of them. Add the others with Add supplier and select their plots.

### Edit or delete products

* To change a product, open the row menu and select Edit. You can change the name, Reference ID, description and HS code.
* To delete one product, open the row menu and select Delete product. To delete several, tick them and select Delete products (up to 10,000 at a time).
* Deleting a product also removes its supplier access and the plots linked to it. This can't be undone.
* Products a buyer shared with you can't be edited, deleted or selected. Only the owner can change them.

### Good to know

* A supplier can link up to 1,000 plots to one product. A product can be shared with up to 1,000 suppliers.
* The "Mapping valid until" date is set by the supplier and is for information. TradeAware doesn't block or remove a mapping when the date passes. The product shows Expired so you know to ask for a refresh.
* A supplier can only link plots their own business owns. Plots that belong to your supplier's suppliers can't be linked to your product.
* Products, sharing and linked plots belong to one workspace and aren't visible from your other workspaces.
* Suppliers only see their own linked plots. They never see who else supplies the same product.

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.live-eo.com/tradeaware/using-the-tradeaware-web-app/products-and-plot-linking/for-buyers-request-plot-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
