Published using Google Docs
WTP 3 documentation
Updated automatically every 5 minutes

WTP platform documentation

According to the specifications of CITE forestal (public institution)

According to the private Sector:

Difference between the request from Public institutions and Private Companies:

The Native Android Application

Tools that are available for the general public:

Link a physical QR code to the system

API for interoperability with other systems:

Main Back-end Admin to the system:

According to the specifications of CITE forestal (public institution)

When login to the web-application, the user will be greeted based on his profile.

In this case on the left, the user has access to many options from Censo, Tala de Arboles, Arrastre y almacenamiento, trozado, Transporte etc….

In real life, someone will usually have access to a few of these options, not all of them.

Someone responsible for cutting down trees, will not have access to the “censo” modules unless he has the privilege to do this task.

In the case of Censo, a user from a specific company can have access to the entire list of the trees that were “registered” via his company.

This allows the user to view on google maps where the different trees are located based on the GPS.

One of the requests is to make this feature available offline, something that Google Maps don’t provide currently.

That way, the user can directly go to the tree that needs to be cut, or to go to the next tree that needs to be registered for approval before being cut.

In order to add a new tree to be registered by the system, the user click the button “Añadir un nuevo registro”

This will automatically collect the latest GPS information

Sometimes, this can happen, where all the trees from the same company are not located in the same region.

This can be interpreted as a potential fraud, or the company has different fields in different parts of Peru.

The important part, is that public institution can have access to this information in real time via our Restful API under: 

In order to add information about a specific tree, the software automatically collects the GPS, and displays the position of the user via a satellite image from Google.

Satellite image providers can be changed, and if required, the WTP-project can integrate other satellite image sources.

Before the data can be added to the system, the user has to add a photo of the tree, and answer certains questions manually.

Not all the information is required to be filled out.

If the required fields are not all filled out, the information cannot be submitted to the platform.

In the case of cutting the tree “tala”, the user will see the following screen.

To make it easy for the user to do the work, he will see 2 screens.

On the right side is the list of all the trees (with their identification number) that have been cut, and on the left, the list of all the trees that were “censored” but not cut yet.

The user can in real-time search for a specific tree based on the parcel, identification number, species, or volume of wood.

In the case of “tala de arboles” the question are different than in the case of the “Censo”

The user can see his GPS position via a Google Satellite image. Having access to the Satellite image, could help the user to see if it is a recently deforested area or not.

With future integration with other service providers, we could mark certain parts of the land as protected, and inform the user that the tree he wants to cut cannot be cut.

In order to make the work simpler, the system automatically generates the identification code based on the parameters that were set by the user in the previous step.

This allows the user to fill-out only the minimum requirement, without repeating himself all the time.

In this case where 1 tree will be cut, redondant information such as the original tree identification number, species are automatically added to new pieces of wood that are coming out from the main tree.

As well, we respect all recommendation of documenting all the process of registering the information about “Rama” and “Fuste” in the system

Once the field is filled out, the user can add all the information one by one.

For the next step which is “Arrastre”, the same process happens again.

On the left side, the list of all the pieces of wood that were registered in the previous step (tala). On the right side, the list from the “censo” of the company.

For data protection, if a user works for company A, then he can only have access to the data from the company he works for.

Here as well, the user just has to click on the piece of wood that will need to be processed. This will minimize the risk of typing a wrong identification code.

Even though the logic of adding information to the system is the same, the questions regarding this step are different. Each module uses a different set of questions.

To make the work more efficient, the user can see all the tree that are linked to a specific tree, so he doesn’t have to enter redundant information, and simply answer the question from a specific wood.

All the user needs to do is to take a photo, answer the question that are shown to his screen, and that’s it.

To fight illegal wood, in the case that no information has been added to the system, then the screen on the left will appear empty.

This means that none of the previous work has been done, and therefore a new piece of wood cannot be cut, transported, cause it was not properly identified in the system, and therefore can be considered as illegal.

In that case, the user cannot add and document a new piece of wood to the system, because no “legal” wood has been registered in the previous step.

The option of seeing the entire history of the wood, still exists, but for efficiency reasons, this can be deactivated in the user profile.

Wood workers working in the field, want to document their work, and if the system can save a step in the process, then it is a gain for them.

In case there is duplicate information that has been put on the tree, a warning will appear next from the wood, to inform the user that the system contains 2 trees with the same identification number, and allow the user to fix this mistake.

To make it simple for the user, we use color coding on the navigation bar.

In this case, the system uses “green” for the navigation bar, to tell the user that he has access to the system as a “Transporter”.

As well, all the questions that are asked to the driver differ from the question asked to a woodworker.

One of the great improvements to the previous system is that now we use an automatic background refresh system from the GPS location, that updates the GPS position automatically in the background.

The option of always asking to get the GPS location is done in real-time in the background. One less step for the user.

The commercialization module as well, is different, and uses a different color coding.

As of November 1, 2021, we have build 13 different questionnaires/modules that will intervene at different times based on the role and the options request by the user.

In this case all required fields are not filled-out, not completed; they are marked red to tell the user that the form has not been completed.

And therefore the user has to correct all the information before being able to submit the data to our platform.

The Internet is not available around the entire country of Peru, and the speed in most of the places is not very fast.

To help with this problem, our system automatically reduces the size of the photo, and optimizes the compression of the photo so it would use a minimum amount of internet bandwidth.

Once an information has been successfully added to the system, the user will be greeted with a success message.

As well, a QR code is generated that can be printed on the piece of wood, for a simple identification.

Under the “report” tool, a user with “admin” privilege can access all the information that was reported for his company.

Since most of the data are not structured (each of the 13 different modules have different questions), the data is displayed as raw as it is stored on the system.

The most important data are the information about the employee, the volume, and the species of the wood.

According to the private Sector:

The private sector wants something much more simpler than the requirement from Public institutions.

We call this feature “Procesamiento por lotes” or “batch processing” in English.

The idea is the user can document his work directly from 1 single screen, instead of the 3 steps process that was requested by “Cite forestal”

The screen is very simple.

On the right hand the user can see a photo that is required for the documentation of his work, and on the left, the user will have to define the step of the traceability system he wants to document his work.

The key difference is that this new system does not require the use of the device GPS.

The user can either add a photo of his work, and drag & drop an image to the grey zone.

Once a photo appears on the screen, the system will collect all exif data, and the GPS data that were embedded in the photo, and use it as location.

Therefore a user with a laptop just have to upload all the images from the field work. If the images have GPS data, they will be automatically processed and can be added to the system.

From there the user will select his stage of the process, and all the prepared questions will appear.

All the user has to do is answer the different questions (some are required, some are optional).

We have currently 13 modules, and therefore 1 of the 13 forms will appear.

The key difference with this system, is that there is no automatic identification generator that will generate the identification number automatically for the user.

In the case that no GPS data was found in the image, the user will be prompted to share his GPS location via the app, iPad, tablet, and then the GPS data from the device (and not from the photo) will be taken in consideration.

If the user use a mobile or tablet, the user can check where the GPS has been located him

At any time, the user can refresh the GPS position and see his position on a Google Satellite image (by default).

The key concept of this module is to allow an easy and fast data entry for the worker on the field. Through different interviews, we found out that most of the workers just want to add information directly to the system as easy and fast as possible. So giving the opportunity to do it all with 1 single screen, is a big help, and can boost productivity.

As well, giving the user the possibility to use any kind of device such as desktop/laptop computer to do the work is greatly appreciated, instead of Smartphones that have GPS integrated. To do so, we have to extract the GPS information from the EXIF data of an image.

One problem, not every smartphone embedded the GPS data into their photos. iOS devices don’t share the GPS data as part of the photo format, and not all Android devices are sharing the GPS information inside of the images.

Difference between the request from Public institutions and Private Companies:

WHen it comes to the traceability and documentation request from the public institution, they want that if a piece of wood does not have a tree that was properly registered in the system, this particular piece of wood cannot be entered into the system.

If one piece of wood is registered in the section of transportation, it is a requirement that this piece of wood have been properly registered in the step before. If the piece of wood has not been registered properly before, then the system should reject the piece of wood.

As well, if a wood-cutter claims that a specific tree has been cut in 4 Shaft (Fuste) and 3 branches (Ramas), then all this information has to be added to the system in order to be a valid transaction. If 1 trunc has been cut in 4 pieces, then it is imperative that the 4 pieces have to appear on the system.

From a private company point of view, they just want to identify a piece of wood, and document what they see as they see it on the field. Adding this “anti-fraud” system in the system will add frustration for the wood-worker since there will be time where the system will refuse the data entry in the system, while the piece of wood is in front of him.

The Native Android Application

The native Android application can be downloaded from or directly via the Google Play store under: 

Only user with a validated account (belonging to an existing wood company that is considered legal by the institution) and a verified telephone number (to avoid scam) are verified by SMS. Once the user has verified his SMS, we collect the UUID A universally unique identifier (UUID) is a 128-bit label used for information in computer systems, that identifies the telephone ID directly with the user telephone number. That way, the user just has to login once to his account, and his smartphone is automatically linked to his telephone number for easy reporting.

One of the main reasons why we only focused on the Android Application, and we don’t have an application for Apple (iOS) devices is that the iOS market share in Peru is very small. As of october 2021, only 8% of the population in Peru use an iOS device, vs 91% Android.

But nothing stops a private company from funding the WTP-Project to build an iOS application.

The main screen is very similar to the web-application under 

The main difference is the “Sincronizar App” button that will download all the data from a user company, so that the wood-worker can have access to all information at all times, even when there is absolutely no internet connection.

To keep the data storage to a minimum, only the text data is being stored on the smartphone.

From 2 companies we have done the test, we had pre-imported about 10,000 information, and location of trees that needed to be cut.

All these 10,000 trees needed to be cut where stored locally on the user device, and the user can get access to all of it at any time without any internet access.

Once the user has completed the work, and has access to an internet connection, he can click the same “sincronizar App” button, and this will trigger a data synchronization (including photos) with our platform.

That way, all the documentation that the user has done on the field is being reported back to the platform, and the new data is available to anybody no matter if they use the web, or the mobile application.

One of the key differences with the Web-Application, and that currently the user doesn't have access to the entire listing of the trees that need to be cut, transformed or transported.

The only way is that the user enters the identification code of the tree, or a piece of wood, or a QR code scan to gain access to the information about the specific tree/ piece of wood.

Once the user has entered the information about the tree, he has access to the entire information about this piece of wood/ tree.

And to add information to the specific tree, the user simply has to take a photo of the tree, and answer all the questions that the app is asking him.

The core difference between the native Android App, and the web-application is that there is no background logic integrated into the system.

The lack of internet connection in the field makes it impossible to connect to our platform to get the most relevant data.

One of the future features would be to integrate the entire traceability logic developed by public institutions inside of the application directly, instead of retrieving the logic from our current platform.

Currently, the application retrieves all its logic via the API of our platform. This allows us to keep the application as small as possible, and as fast as possible specially for users that don’t have the latest smartphone with them.

But in order to retrieve this information, an internet connection is required.

One option, if to code all this logic that was implemented on our platform and accessible via our API, directly to the Native application. This would require a substantial amount of work from the native app developer, and a higher scrutiny from Google regarding the possibilities of our application.

Tools that are available for the general public:

Possibility to identify a piece of wood from either his:

  • Código del Árbol
  • Resolución del plan Operativo
  • Numero de Contrato
  • Guia de transporte Forestal (GTF)

Generator of an QR code that contains the  piece of wood identification number that can be printed and put on a piece of wood.

Scanner of QR code that works directly from the web page under: https://wtpwebdemo/scan.html 

Volume of wood calculator

Wood volume calculator that can be checked via: https://wtpwebdemo/volume/ 

Link a physical QR code to the system

QR Code: a machine-readable code consisting of an array of black and white squares, typically used for storing URLs or other information for reading by the camera on a smartphone.

You can find some of the metal tags with pre-printed QR code, that you can attack directly to the piece of wood you want to identify directly via your smartphone.

Simply go to the feature called “Escanear un código de QR”.

On the right screen you can see 2 fields:

  • “Número de ID de etiqueta” which represent the number of the tag
  • “Número de identificación de la pieza de madera / árbol” which consist of putting the Identification number of the tree in the field

The number of identificación de la pieza de madera / árbol can be anything from a piece of wood, a Purchase order….

Once the “on the field” and “identification number of the metal” are entered, simply click the button “enlace” (internet connection is required) to link the physical object with its blockchain hash equivalent.

On the left side of this module, the system can automatically generate an identification system for you.

A QR Code can hold up to 4296 alphanumeric characters. With these quantities the potential variations are essentially limitless.

To make it simple, instead of writing down the Identification number of the tree, the system will generate the hash of the operation that you can print on a piece of paper, and then stick to the piece of wood.

No more writing on the piece of wood, simply print the QR code and stick it to the wood.

For the system to work, you need an internet connection to get the hash from the blockchain.

API for interoperability with other systems:

A REST API (also known as RESTful API) is an application programming interface (API or web API) that conforms to the constraints of REST architectural style and allows for interaction with RESTful web services. REST stands for representational state transfer.

The current API of the WTP-project can be accessed via and is currently mainly used by our Native Android Application.

Currently it can manage all 13 modules that we have on the web-application, and manage user credentials, authentication, retrieving of information and adding of information.

Generally speaking, an API allows information to be changed, modified or simply deleted, since the backend of our application is connected to the blockchain system, information can only be added.

In order to access the API, any company or organization needs to have the proper credentials to authenticate to the API, and be able to connect data.

All the Data that are available from the API are using the Jsend format. Put simply, JSend is a specification that lays down some rules for how JSON responses from web servers should be formatted. JSend focuses on application-level (as opposed to protocol- or transport-level) messaging which makes it ideal for use in REST-style applications and APIs.

This is how a request would look like:

AS well, the native Android application is using the API to do the synchronization between the mobile Android smartphone and the server, to allow the user to be able to access all the data from the company he is working for before going to the field where there is no internet or cell phone reception.

Once the internet connection is back, the user just has to click on the synchronize button, to synchronize all the data between the user's smartphone and the information stored on our platform. This synchronization system is made via our API.

As well, the WTP-project is ready to give access to all our data via our API to any organization, from private companies, public institutions. All is required is to set up the server, the software of the organization to gain access to our data.

This will allow us to collaborate directly with any institution (Osinfor, Serfor), private companies, NGO etc...

Main Back-end Admin to the system:

The main admin to the system can be found under: 

User with super admin privilege can login like any other website, with a username and password

Once logged in, there are 3 main function that exist:

  • Users: with the list of all users that exist on our platform
  • Company: with the list of all registered and validated company on our platform
  • Block explorer: with the list of all data that have been added to the system

The user function lists all user accounts that have access to the platform.

In order to access the platform, a user needs a validated cell phone number.

From there, the super admin can add new user, and or revoke their access as well, in the case an employee does not work for a company anymore.

The company function lists all company accounts that have access to the platform.

From there, the super admin can add a new company, and or revoke their access as well, in the case a company is set to do illegal wood.

This interface can interconnect directly with public institutions such as serfor for real-time auto-approval, aut-revocation of a company access.

Via our API, an institution like Serfor could let us know to suspend a company account if they are set to practice illegal wood, all in real-time.

The block explorer is just a web-interface that displays all the data that are stored on our blockchain.

The images are stored in an IPFS format, and currently only Brave or Opera support the IPFS format for now. That’s the reason you don’t see images in this screenshot.

For transparency reasons, the user doesn't have to trust the information that we show via the WTP web-application or WTP native-application, they can gain access to the data directly from the source.

As well, if needed, any developer could build their own piece of software, or an integration with existing software such as MC-Sniff or “Data Bosque” can be done via our API, or directly via this web-application.

As well, for big data analysis, this information is available via our API.