Reference
How TruSource operates, step by step.
TruSource collects the evidence for agricultural exports to the European Union. This guide describes what the platform does and gives the procedure for each party. It is published in full, so anyone evaluating TruSource can read exactly how it works before they talk to us.
One direction: land to container
A farm has a boundary or a point. A lot records what came off one or more farms. A shipment carries lots to one buyer. Documents attach to any of them.
Three parties
The origin partner holds the evidence. The operator carries the legal duty. The field agent records boundaries in the field.
Evidence, not certification
TruSource records evidence and shows what is absent. It does not certify a supply chain, and it does not send anything to an authority.
What TruSource does
TruSource keeps a record of where produce grew and what paperwork it has. It makes the record in one direction — from the land to the container.
- A farm has a boundary or a point.
- A lot records what came off one or more farms.
- A shipment carries one or more lots to one buyer.
- A document attaches to the farm, the lot, the shipment, or the organisation.
TruSource then runs the checks. It knows which documents each country and each commodity needs, and it shows you what is missing.
All parties sign in the same way: open the platform at app.trusource.io, enter your work email and password, and select the workspace you want. A person can belong to more than one workspace — several exporters, a buyer, or both — and the workspaces stay separate.
Who uses it
Three parties use TruSource. Each has different tasks and sees different screens.
| Party | Who this is | What this party does |
|---|---|---|
| Origin partner | The exporter — a cooperative, an estate, or a producer. | Records the farms, the lots, and the shipments. Files the documents. Shares a consignment with a buyer. |
| Operator | The buyer — the company that puts the goods on the EU market. | Connects to a supplier. Examines a consignment. Asks for a document. Makes a due diligence statement. |
| Field agent | A person who goes to the farms. | Records the boundary of each farm that an admin assigns to that person. |
Terms
The platform uses one word for one thing. These are the terms you will see on screen.
| Term | What it is |
|---|---|
| Workspace | One organisation in TruSource. All records belong to one workspace. |
| Farm | One area of land. It has a boundary or a point. |
| Boundary | The shape of a farm, as a line around it. |
| Point | One position on a farm. The EU regulation permits a point for a farm of less than 4 hectares. |
| Lot | A quantity of one commodity. It comes from one or more farms. |
| Shipment | One or more lots that go to one buyer. The operator sees a shipment as a consignment. |
| Consignment | A shipment that an origin partner shared with an operator. |
| Document | A file — for example, a licence or a certificate. |
| Connection | An agreement between an operator and an origin partner. |
| Due diligence statement | The record that an operator makes before it puts goods on the EU market. |
| Cutoff date | 31 December 2020. Land cleared after this date cannot supply the EU market. |
Procedures for the origin partner
The origin partner is the exporter. These procedures are given in the sequence of the work.
Find the work to do
- 1Click Overview.
- 2Read the rows below Needs attention.
- 3Click a row to correct that problem.
The Overview screen shows what needs your attention, in sequence of importance. Each row opens the screen that corrects the problem.
Add a farm
- 1Click Farms.
- 2Click Add farm.
- 3Type the name of the farm.
- 4Select the country.
- 5Type the locality and the name of the producer.
- 6Select one or more commodities.
- 7Click Add farm.
Read the checks on a farm
- 1Click Farms.
- 2Click the name of the farm.
- 3Read Export readiness.
- 4Click a check to see the full text.
The farm screen shows the map, the facts about the geolocation, and the checks. The checks come from the country, the commodities, the documents, and the deforestation check.
Record a lot
- 1Click Lots.
- 2Click New lot.
- 3Select the commodity.
- 4Type the reference of the lot.
- 5Select each farm that supplied the lot.
- 6Type the quantity from each farm.
- 7Click Open the lot.
Make a shipment
- 1Click Shipments.
- 2Click New shipment.
- 3Type the reference, the buyer, and the destination.
- 4Click Start the shipment.
- 5Click Add a lot.
- 6Select a lot and type the quantity.
- 7Do the last two steps again for each lot.
Add a document
- 1Click Documents.
- 2Click Upload document.
- 3Select what the document is about — for example, a farm or a shipment.
- 4Select the type of the document.
- 5Select the file.
- 6Type the dates that the document is valid between.
- 7Click Upload.
Accept a buyer
- 1Click Buyers.
- 2Find the request at the top of the screen.
- 3Read the reason that the buyer gives.
- 4Click Accept.
- 5Select the workspace to connect.
- 6Click Connect.
Share a consignment
- 1Click Buyers.
- 2Find the buyer.
- 3Click Share a shipment.
- 4Select each shipment to share.
- 5Select how long the access continues.
- 6Type a note if you want to.
- 7Click Share.
The buyer then sees the shipment, its lots, the farms behind the lots, and the documents. The buyer sees nothing else in your workspace. To stop the access, click Stop sharing next to the consignment, then click Stop sharing again to confirm.
Answer a request for evidence
- 1Click Shipments.
- 2Click the shipment.
- 3Find the request below Shared with buyers.
- 4Click Answer.
- 5Select the document that answers the request.
- 6Type your reply.
- 7Click Send answer.
Procedures for the operator
The operator is the buyer. The EU regulation puts the legal duty on this party.
Connect to a supplier
- 1Click Suppliers.
- 2Click Connect a supplier.
- 3Type the email address of a person at the exporter.
- 4Type why you need the connection.
- 5Click Send request.
Examine a consignment
- 1Click Consignments.
- 2Click the reference of the consignment.
The consignment screen has five parts. Read them in this sequence.
| Part | What it shows |
|---|---|
| The heading | Who shared the consignment, when, and for how long. |
| The checks | The result of the checks of the supplier. TruSource does not make a second result. |
| On board | Each lot, its commodity, and how many farms it comes from. |
| Where it grew | Each farm, its area, and whether it has a boundary or a point. |
| Documents | Each document. Click Download to get the file. |
Ask for a document
- 1Open the consignment.
- 2Click Ask for a document.
- 3Select what you need.
- 4Type why you need it.
- 5Type a date if there is one. If there is no date, leave the field empty.
- 6Click Send request.
TruSource knows which documents the commodity and the country need, and the list shows only what this consignment needs. You select from that list — you do not type the name of a document. The supplier sees the request on their own screen of that shipment.
When the supplier answers
- 1Open the consignment.
- 2Read the answer below the request.
- 3Click Download to examine the document.
- 4Click Accept if the document is correct.
- 5Click Send back if it is not correct.
Make a due diligence statement
- 1Click Declarations.
- 2Click New statement.
- 3Type your reference.
- 4Click Start.
- 5Select each consignment that the statement covers.
- 6Read the result at the top of the screen.
TruSource calculates the quantity, the commodity, and the geolocations from the consignments. You do not type them. The result is one of two.
| Result | What to do |
|---|---|
| Ready to file | Continue to the next procedure. |
| Not ready to file | Read each reason. Most reasons are for the supplier to correct. Open the consignment and ask for what is missing. |
File the statement
- 1Click File this statement.
- 2Read the text in the window.
- 3Click File it.
The screen then shows the record. The record does not change when the suppliers change their data. If something changes after you file — a supplier draws a new boundary, for example — TruSource shows a message at the top of the statement telling you what changed. Read the message, then click Freeze again to make a new record.
Get the geolocations
- 1Open the statement.
- 2Click Download GeoJSON.
- 3Send the file to the EU system.
Procedures for the field agent
A field agent sees only the farms that an admin assigns to that person. If you see no farms, ask an admin to assign them. The farm count and the total area show only the assigned farms.
Record a boundary
- 1Click Farms.
- 2Click the name of the farm.
- 3Click Change next to the map.
- 4Draw the boundary on the map, or type the position of a point.
- 5Select how you captured the geolocation.
- 6If you recorded a point, type the area that the producer declares.
- 7Click Save.
For an admin: assign a farm
- 1Click Farms.
- 2Click the name of the farm.
- 3Find Field agents on this plot.
- 4Click the box next to the name of the field agent.
The checks
TruSource runs these checks. Each check gives one of three results: it passes, it fails, or it is not conclusive.
| Check | What it examines |
|---|---|
| Farm is located | The farm has a boundary or a point. |
| Point is permitted | A point is only for a farm of less than 4 hectares. |
| Farm is in the country | The shape is inside the country that the record gives. |
| Area is possible | The area is not too small and not too large. This finds an error in the position of a decimal point. |
| Shape is correct | The shape does not cross itself. |
| No two farms overlap | Two farms in the workspace do not claim the same land. |
| Land was not cleared | A provider examined the land against satellite data. See The deforestation check. |
| Documents are on file | Each document that the country and the commodity need is present, clean, and in date. |
| Lots are ready | Each lot on a shipment passes its own checks. |
| Quantities agree | A lot does not supply more than it holds. |
Each check shows its result and the reason for it. The same rules run on the supplier screen and the buyer screen, so both parties see one result rather than two.
The deforestation check
TruSource sends the shape of a farm to FAO Whisp. Whisp examines the land against satellite data. It uses JRC GFC2020 for the land at the cutoff date, and GFW RADD for changes after that date.
| Result | What it means |
|---|---|
| Not assessed | No provider examined this farm. This is not the same as clear. |
| Low risk | The provider found no deforestation after the cutoff date. |
| Loss detected | The provider found deforestation. Produce from this farm cannot go to the EU market. |
| Not conclusive | The provider examined the farm but cannot decide. A person must look at it. |
A point has no area, so TruSource makes a circle around the point and calculates the radius from the area that the producer declares. A boundary gives a better result than a circle, and the check says so in its text — along with the radius, the datasets, and the date.
The satellite data changes each week, so each result shows its date. After 30 days, TruSource tells you to run the check again, and the Overview screen lists the farms that need a new one.
What TruSource does not do
The limits matter as much as the features. These are stated in the guide and repeated here so nobody has to discover them during an audit.
- It does not certify a supply chain. It records evidence and shows what is absent.
- It does not send anything to an authority. The operator downloads the GeoJSON and files it in the EU system.
- It does not produce a second opinion on a consignment. The buyer sees the supplier’s checks, run under the same rules.
- It does not treat an absent deforestation check as a pass. A farm nobody examined shows not assessed.
- It does not change a record that an operator filed. A later change appears next to it as a new record.
Read the guide, then run the procedures.
The procedures above are the whole platform. Create a workspace and work through them on your own farms, or bring a real shipment and we will walk it through with you.
Your first 20 shipments come with Starter features, free.