How It Works
The FVA integration works in three steps:1. Automated Report Generation
Every day at midnight, an automated job generates a report listing all vehicles whose insurance coverage started or stopped during the previous day. The report includes:- Vehicle registration number
- Insurer code
- Broker code
- Asset id (internal reference)
- Coverage start and end dates
- Operation type (see below)
- A CSV file for internal review
- An XML file in a ZIP ready for submission to the FVA
2. Automatic Submission
Once generated, the report is automatically uploaded to the FVA API via the upload-to-connector mechanism using the FVA connector (ConnectorType.FVA in tenant configuration).
The submission uses the tenant’s secure certificate.
If the file is accepted, a scheduled job is automatically created to retrieve the integration report one hour later.
3. Report Retrieval
One hour after the file is accepted, a scheduled job automatically retrieves the integration report from the FVA API. This report lists:- Accepted vehicles: Successfully registered in the FVA file. For each accepted vehicle, the system marks the corresponding asset as declared to FVA.
- Rejections: Vehicles that were rejected, with error codes and reasons.
Operation Types
Each line in the FVA report indicates what happened to the vehicle’s coverage:C - Coverage Creation
When: A vehicle’s coverage was started during the reporting period. Example: An asset coverage starts on January 15th → One line with operation type C, start date = 15/01, end date = empty (coverage is active).R - Coverage Termination
When: A vehicle’s coverage was stopped during the reporting period. Example: An asset coverage stops on January 20th → One line with operation type R, end date = 20/01.Same-Day Cancellation
When: A vehicle’s coverage is started and stopped in the same period: What Korint does: The system generates two separate lines:- One C line (creation) showing the coverage started
- One R line (termination) showing the coverage ended
Related Documentation
- Reports: How reports are configured and run
- Third-Party Integrations Overview: Overview of all external system integrations

