User manual
Aggregator
Collects and forwards raw material between farmers and downstream buyers while preserving traceability.
Workflow steps
Detailed instructions
If you do not have an account, please follow the general account registration instructions. If you already have an account, open the aGreen Traceability app on your mobile phone and log in using your registered phone number and password under the Aggregator role.
Mobile App
Login screen for the Aggregator role on the mobile app Detailed instructions
Scan the Farmer's sale QR code to view the Digital Passport. Confirm the purchase to transfer the lot from the Farmer's warehouse to yours.
2.1Verify product origin
If you want to review the complete journey of the lot, use your phone camera to scan the QR code provided by the Farmer. This will open the Digital Passport showing detailed farm logs, coordinates of the cultivation boundary, and processing details.
Digital Passport page showing lot details and supply chain logs, part 1 
Digital Passport page showing lot details and supply chain logs, part 2 On the Digital Passport, you can also locate the source, search directions from your current location to the harvest address, and review field photos uploaded by the Farmer.
Location mapping and navigation directions 2.2Purchase from Farmer
To purchase a lot, open the aGreen Traceability app and tap 'Buy' on the home screen to scan the Farmer's sale QR code. The app will display details including farmer name, product type, cultivation logs, and quantity.
Scanning the sale QR code with the Aggregator device Once you verify the details and confirm the purchase, the transaction will be saved to the blockchain. The lot is added to your warehouse, and the system automatically deducts the volume from the Farmer's warehouse.
Confirm purchase details and complete transaction Detailed instructions
After confirming the purchase, the lot will be displayed in your 'Warehouse'. You can review the list of raw or purchased lots, monitor stock levels, and prepare for downstream sales.
Mobile App
Aggregator warehouse showing the list of purchased lots Detailed instructions
Select purchased lots from warehouse, split the lot when necessary, select packaging options, take a real product photo, and generate sale QR code.
4.1Log sales activities
To log a sale, tap 'Sell' and choose 'Select from warehouse' on the home screen, or access the 'Warehouse' list directly, select the lot under 'Purchased goods', and tap the Sell button.
Select lot to sell from warehouse inventory When the 'Sell product' screen appears, verify the details and choose 'Sell all' or 'Sell part' depending on your needs. The system allows you to split the lot to sell to different buyers. You must enter the exact volume to be sold in this transaction.
Enter volume and select full or partial sale Select the appropriate packaging option for the lot. If you do not repackage the goods, deselect 'Standard packaging (with GTIN code)'; the lot will continue to use the Farmer's original GTIN or GLN. If you repackage the goods under your own standard, select 'Standard packaging (with GTIN code)' and enter the packaged volume to generate a new GTIN.
Select packaging options and manage GTIN code Take a real photo of the shipment to be sold as evidence. Tap the 'Create QR' button to generate the sale QR code containing the GS1 Digital Link.
Take a product photo and generate the sale QR code Upon successful generation, the sale QR code will display with a 15-minute countdown timer. You can show this screen for the buyer to scan directly, take a screenshot, download the QR code, or print it. Note that the GS1 Digital Link in the QR remains valid long-term, but the transaction session is only valid for 15 minutes. If the buyer does not confirm within this period, the transaction will lapse and you must generate a new QR. After a successful transaction, the sold volume is recorded in your warehouse under 'Sold goods'.
Account registration (applies to all Roles)
New users must register first (mobile app or https://trace.vnforest.org) before following the steps below.