Skip to main content

What to ask of your surveyors

What it is for​

Your surveys are processed automatically as they arrive in the Stonal Smartdoc document library: they are filed, and the information they contain is extracted from them.

How well that works depends a great deal on how the documents were produced. So the recommendations below are for your surveying contractors, ideally written into the specifications of your contracts.

These are not requirements

A survey that does not follow them will still be handled. These recommendations exist to greatly simplify the transmission of your surveys and to make the information they hold more usable.

A report to open to your surveyors​

Before any question of format, give your surveyors the list of rooms in your portfolio as it exists in Stonal. The "Diagnostiqueurs : libellés des pièces" report (surveyors: room labels) is there for that. You will find it under ⚙️ Settings, in the platform's side menu.

For each room, it shows:

  • the property and the building, with their code and label;
  • the floor and the unit;
  • the room type and its label in Stonal;
  • its floor area.

The surveyor can filter by property, building, unit, address or room type, then download the table as Excel or CSV to prepare the visit.

What you gain: survey reports that reuse your room labels, so each finding attaches unambiguously to the right room, unit and building.

How to open it to a surveyor: create an account for them in user management, with:

  • a report group that contains this report;
  • a portfolio scope limited to the properties covered by their assignment;
  • an end date, using the temporary account option, so that access stops on its own when the contract ends.

This action depends on the permissions granted to you: you may not have access to it. If you need it, get in touch with your contact person.

Organisations still on Abyla

The report also exists in an Abyla version. That version presents the portfolio at the level of your organisation: the account's portfolio scope does not narrow its content.

1. Send surveys through the API​

This is the recommendation that pays off most. Ask your surveyors to use our document API to upload their surveys automatically.

What you gain:

  • direct, immediate integration, with no manual transmission — so nothing forgotten, no wrong recipient, no delay;
  • compliance analyses that are always up to date, since the survey arrives as soon as it is produced.

The API is available and documented: Upload a file.

2. Use the Stonal building codes​

Ask your surveyors to use your portfolio's codes as they exist in Stonal to identify what they survey: buildings, units, premises.

Without them, what a document attaches to has to be guessed. With them, it is certain.

Surveyors can query our base directly to retrieve those codes without asking you: see Searching data in the API Guide. For rooms, the dedicated report is simpler.

3. Have the metadata sent too​

Our artificial intelligence automatically extracts the key information from a survey — visit date, validity, rating, result. But a poor-quality document, or an unsuitable format, limits how precise that extraction can be.

Where possible, have that information sent directly through the API. The error rate then drops to zero, because there is nothing left to interpret.

4. Where the API is not an option: produce readable documents​

These practices markedly improve extraction accuracy:

Good practiceWhy
Native PDFs, not scansAvoids character-recognition errors
One survey per file, with no cover pageA PDF bundling several surveys is hard to split
If scanning cannot be avoided, scan wellGood resolution, straight page, decent contrast, no rotation; avoid coloured text
Explicit plain-text statements for key informationInformation that is readable is information that can be extracted
No tick boxes, and nothing that appears only in an image or a watermarkThose are not text, even in a native PDF
A consistent document structure across contractorsFewer errors, simpler processing
The property and unit code in the file name and in the documentThat is what attaches the document to the right place
Tables and lists are no longer a problem

Our artificial intelligence handles them well. For information that only exists in a technical diagram or on a plan — a location, for instance — a written description remains far more reliable.

See also​