DoliURSSAF — Dolibarr module

Declare your turnover to URSSAF without re-keying, straight from Dolibarr.

DoliURSSAF automatically computes, for each reporting period, the turnover you have
actually cashed in, split by activity type (sales, services, liberal), and gives
you the exact figures to report on autoentrepreneur.urssaf.fr. You get a
ready-to-copy report, and full tracking of your declarations with automatic
reminders.

Who is it for?

For auto-entrepreneurs and micro-entreprises (French sole traders) who run their
business in Dolibarr and must declare their turnover to URSSAF, monthly or quarterly.
Whether you are under the VAT franchise or VAT-liable, in BIC, BNC or CIPAV, the
module adapts to your scheme.

What the module does

  • Cashed-in turnover calculation over the period, from the payments actually
    received (not from issued invoices) — the correct basis for the URSSAF declaration.
  • Split by activity type: sale of goods (BIC), commercial/craft services (BIC),
    service provision (BNC), regulated liberal activity (CIPAV).
  • Rounded amount to declare, ready to copy onto the URSSAF website.
  • Report for manual declaration: the detail of amounts per activity type,
    printable.
  • Status tracking for each declaration (draft, validated, declared), timestamped.
  • Automatic reminders before each deadline, via Dolibarr’s native agenda (email).
  • Automatic draft preparation when each new period opens (optional).

The module is a declaration assistant: it computes and prepares everything, you
validate and copy the figures onto autoentrepreneur.urssaf.fr. Nothing is
submitted on your behalf — you keep control of your official declaration.

Requirements

  • Dolibarr : 20.0 → 25.x and PHP : 7.4 → 8.4
  • The Invoices and Agenda modules enabled (source of the cashed-in turnover
    and of the reminders).
  • An auto-entrepreneur account on autoentrepreneur.urssaf.fr.

Installation

  1. Download the doliurssaf-x.y.z.zip archive from your account after purchase.
  2. In Dolibarr: Setup → Modules/Applications → Deploy/install an external module,
    then upload the archive.
    (Or unzip the doliurssaf/ folder into htdocs/custom/ of your Dolibarr.)
  3. Enable DoliURSSAF in the module list (group Pichisoft (Pichinov)).

The module installs on its own: no extra companion module to add.

Activating your license

Your purchase grants a perpetual use license and one year of updates.

  1. Open the module settings, License tab.
  2. Enter the license key received by email at purchase (format
    PSFT-XXXXX-XXXXX-XXXXX).
  3. Click Activate.

The status turns to License active and the end date of your updates is shown.

Good to know: without a license, the module stays fully usable. The license
unlocks updates and support. You will never be blocked in a declaration
because a license expired.

Configuration

In the module Settings:

The declarant

  • SIRET of the auto-entrepreneur (taken from the company record if left empty).
  • Periodicity: monthly or quarterly — it must match the one registered with URSSAF.

Amount basis

  • Cashed-in amount (VAT franchise): you declare the amount actually received.
  • Turnover excl. tax: if you are VAT-liable, you declare the net turnover.

Activity types

  • Default type for product lines and service lines without a product record.
  • CIPAV option for regulated liberal professions.

Each product/service can carry its own URSSAF activity type; lines without a type use
the configured default.

Reminders and automation

  • Reminder lead time before the deadline (in days): when the reminder email is
    sent.
  • Automatic draft creation when the period opens (a scheduled job prepares the
    draft with the computed turnover and the reminder — it never validates or declares
    anything).

Day-to-day use

1. Prepare a declaration

From the module, click Prepare the declaration of the last closed period. The
module computes the cashed-in turnover over the period, split by type, from your
payments.

2. Check and validate

Review the amounts (you see the detail of the payments included). Validate to
freeze the amounts so you can copy them safely.

3. Copy onto URSSAF

Open the Report for manual declaration (printable) and report the amounts, type by
type, onto autoentrepreneur.urssaf.fr.

4. Mark as declared

Back in Dolibarr, click Mark as declared. The declaration is timestamped and an
event is logged in the agenda. You keep a full, dated trace of every declaration.

URSSAF activity types

TypeFor which activity
Sale of goods (BIC)Buying and reselling goods
Commercial or craft services (BIC)Services of a commercial or craft nature
Service provision (BNC)Non-regulated liberal services
Liberal activity (CIPAV)Regulated liberal professions affiliated to CIPAV

Assigning the right type to your products/services guarantees an accurate split,
exactly as the URSSAF form requires.

Updates

While your update subscription is active, the module notifies you of new versions and
installs them in one click, safely (automatic backup and rollback on failure).
Nothing is ever installed without your consent.

When the subscription ends, the module keeps working normally; only new versions
are no longer delivered. You can renew at any time from the License tab.

Support

A question, an issue, an idea for improvement? From the module’s About page, click
Contact support: your message reaches us directly, with the technical context
of your installation (versions, environment — never any business data). You see that
context before sending and can send without it.

License & subscription

  • One-off purchase: perpetual use license of the module.
  • Update subscription: renewable yearly, to keep receiving new versions (notably
    the adaptations to URSSAF regulatory changes) and support.
  • The module stays usable even without an active subscription.

DoliURSSAF is published by Pichisoft (Pichinov). Dolibarr is a trademark of the Dolibarr association; this module is an independent commercial extension of it.