Skip to main content

Import a service contract from PDF

When you have the PDF of a supply contract, rAInty can read it automatically and extract the relevant data for you. The process uses OCR for scanned documents and an AI model to interpret the content and map it to the correct fields.

The result is a pre-filled form that you review and confirm before saving. You do not need to type anything yourself unless a field needs correction.

Before you start​

Make sure you have the PDF of the supply contract. Accepted formats are standard PDFs from utility providers, including both digital contracts and scanned copies.

The contract must be linked to a property. If you are starting from the Suppliers menu, rAInty will ask you to choose the property first.

Steps​

1 — Open the wizard​

From the Suppliers menu:

  1. Open the Suppliers section from the sidebar.
  2. Click Add contract.
  3. A property picker appears. Select the property you want to link the contract to and confirm.

From a property detail page:

  1. Open the property from the Properties section.
  2. Scroll to the supply contracts section.
  3. Click Add contract. The property is already pre-selected.

2 — Upload the PDF​

On the first wizard screen:

  1. Click Choose PDF (or drag the file onto the upload area).
  2. Select the contract PDF from your device.
  3. The file name appears next to the button once selected.
  4. Click Analyze contract.

rAInty uploads the file, extracts the text (using OCR if the PDF is a scan), and sends the content to the AI model. This step usually takes a few seconds.

3 — Review extracted data​

Once the analysis is complete, the wizard moves to the review screen. The form is pre-filled with the data extracted from the contract.

Check each field carefully. Fields that could not be extracted with confidence may be left blank — fill them in manually.

The form includes the following sections.

Contract details

  • Service type (Electricity, Gas, Water, Internet, etc.)
  • Service name and offer name
  • Contract code and customer code
  • Supply identifier type (POD, PDR, customer code, meter serial, etc.) and its value
  • Billing frequency and expected amount
  • Supply address and billing address
  • Contract signature date and validity dates
  • Payment method (SDD, bank transfer, card, etc.)
  • IBAN and SDD mandate reference if applicable

Technical details (relevant for energy contracts)

  • Power in kW and voltage level
  • Whether the supply is for a resident household
  • Whether it is for domestic use
  • Whether the bill is digital

Economic conditions The lower section of the form shows the price conditions. Each row represents a tariff period.

  • Valid from / valid to dates
  • Unit of measure (kWh, smc, m³, month, etc.)
  • Unit price
  • Fixed monthly or yearly fee
  • Peak and off-peak prices (F1/F2/F3 tariff bands for electricity)

You can add multiple rows if the contract has different price conditions for different periods.

4 — Save the contract​

Once you have reviewed and corrected the data, click Save contract.

rAInty saves the contract, links it to the property, archives the PDF document, and indexes its content so the assistant can answer questions about it later.

The wizard then shows a confirmation screen. You can close or click Import another contract to start again.

What happens if extraction misses something?​

The AI model extracts as much as it can, but some contracts use non-standard layouts or include information in footnotes and attachments that cannot be parsed automatically.

If a field is blank or incorrect after extraction, simply type the correct value before saving. The data you enter manually always takes priority over the extracted values.

Re-opening a partially completed import​

rAInty saves your progress locally. If you close the wizard before finishing, the extracted data is still available when you reopen it. The wizard will offer to continue from where you left off.

To start a fresh import for the same property, click Reset on the first screen.