VECOZO Claims

Overview

With VECOZO Claims, Flux automates claims exchange with health insurers according to the current GDS standard. Flux sends claims securely via VECOZO and automatically processes return information, error messages, and statuses back into the record.

As a result, you do not have to upload claim files manually or review return messages separately. Flux handles the technical process from submission through return processing.

What this integration does

• Create, validate, and send claims to VECOZO
• Full support for the GDS and Vektis XML standards
• Automatic authentication through VECOZO permissions and certificates
• Retrieve, process, and display return messages in Flux
• Automatic retries for time-outs or temporary network issues
• Pre-checks and validation before submission so errors are visible immediately

When to use this integration

• You want to handle claims fully automatically in Flux
• Your practice submits claims to health insurers through VECOZO
• You want to meet health insurer and Vektis requirements without manual extra steps

Configuration

Go to Settings → Apps → Claims to activate VECOZO Claims in Flux after the VECOZO authorization for Claims is active.

Requirements

To activate the VECOZO Claims service, you need the following:

1. A Flux user with the Owner role
2. A VECOZO login for the contact person of the practice or organization
3. A valid Chamber of Commerce number and AGB code for the practice or organization
4. Contracts with health insurers

Set up in Flux

Request an external authorization for Flux in the VECOZO portal for the Claims service.

Once that authorization is active, complete the setup in Flux:

• In Flux, go to Settings → Apps → Claims
• Click Activate

The integration is then active. From that moment on, you can submit claims from Flux via VECOZO.

Set up in VECOZO

The contact person of your practice or organization must explicitly authorize Flux in Mijn VECOZO for the Claims service.

• Log in to Mijn VECOZO
• Go to Mijn externe toestemmingsverklaringen
• Click Add authorization
• In the Applicatie list, select the Claims service
• In the Type instantie list, select the correct party type, usually Tussenpartij software
• In the Geeft toestemmingsverklaring aan list, select Flux
• Click Continue, accept the disclaimer, and click Save
• Click Save

It takes about 30 minutes for the authorization to become active. Then check in Flux whether you can enable the integration. If needed, also review the VECOZO explanation about authorizations.

Claims processing

With VECOZO Claims, Flux handles the secure and automated exchange of claim messages with health insurers via the GDS standard.

Flux manages the technical flow from certificate authentication to error handling, return processing, and automatic retries after time-outs. Thanks to built-in pre-checks, many errors are visible before submission so you can correct them directly in Flux.

To submit claims, the contracts with the relevant health insurers must be configured correctly.

How the claims process works

For a functional explanation of the claims process itself, including how claims are created, checked, and submitted, see the documentation about claims.

1. A care performance is ready to be claimed
2. Flux automatically validates all claim data (patient, insurer, performances, rates, and contract rules)
3. If everything is correct, Flux creates a GDS XML message and sends it through the secure VECOZO connection
4. VECOZO performs technical checks and forwards the message to the correct health insurer
5. Flux automatically retrieves return messages and processes them in the record.
6. The status of each claim is updated directly in Flux (for example Submitted, Approved, Rejected)

Pre-checks in Flux

Before submission, Flux performs extensive validations, including:

• Validation of required fields and correct XML structure.
• Validation of valid AGB codes, UZOVI codes, and dates.
• Validation of duplicate or incomplete claims.
• Warnings for missing contracts or invalid performances.

Thanks to these pre-checks, most errors are visible before submission so unnecessary rejections can be prevented.

Return messages and error handling

Flux processes return information fully automatically.

• Return messages from VECOZO are retrieved and linked to the original claim
• Error codes and error descriptions are shown in clear language
• Users can immediately see what went wrong and how to solve it
• Corrections can be resubmitted directly from Flux
• All error codes are stored and logged so the process remains traceable
• Time-outs are automatically recovered with smart retry mechanisms

This helps you identify, correct, and resubmit errors quickly without technical knowledge of XML or VECOZO.

Important notes

• Certificate: this integration uses Flux’s system certificate, so as a healthcare provider you do not need your own VECOZO certificate for claims
• Authorization required: without an active authorization for the Claims service, Flux cannot submit claims on behalf of your practice
• Insurance status: also use the COV check in Flux to submit claims to the correct health insurer; COV requires its own separate authorization in Mijn VECOZO
• Timely processing: VECOZO stores return information only for a limited period (up to 90 days); Flux retrieves it automatically in time
• GDS version changes: Flux automatically follows new claims standards, so you do not need to do anything yourself

Frequently asked questions

Frequently asked questions about the VECOZO Claims service.