DSN filing

Build, validate and submit French social declarations (DSN / PASRAU) to net-entreprises

Build and submit a monthly DSN

POST

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/monthly

Builds the monthly DSN (Déclaration Sociale Nominative) from the tenant payroll results, runs the DSN-VAL controls and submits the conformant declaration to net-entreprises. Returns the created declaration with its deposit identifier.

Build and submit a monthly DSN › path Parameters

partnerId

integer · int32 · required

Partner identifier (must match your API key)

tenantId

integer · int32 · required

Tenant identifier (the déclarant)

Build and submit a monthly DSN › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Build and submit a monthly DSN › Request Body

DsnMonthlyRequest

DsnPeriod · required

employeeId

integer · int32

Optional employee identifier to restrict the declaration to a single individual

Build and submit a monthly DSN › Responses

Created - DSN built, validated and submitted

A built and/or submitted DSN declaration

DsnDeclaration

declarationId

string

Unique declaration identifier

type

string · enum

Declaration type

Enum values:

MONTHLY

AMORCAGE

DsnPeriod

status

string · enum

Current declaration status

Enum values:

BUILT

VALIDATED

SUBMITTED

ACCEPTED

REJECTED

submittedAt

string · date-time

Build and validate a DSN (no submit)

POST

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/validate

Builds a DSN from the tenant payroll results and runs the DSN-VAL control catalogue without submitting it to net-entreprises. Returns the list of anomalies detected (empty when conformant).

Build and validate a DSN (no submit) › path Parameters

partnerId

integer · int32 · required

Partner identifier (must match your API key)

tenantId

integer · int32 · required

Tenant identifier (the déclarant)

Build and validate a DSN (no submit) › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Build and validate a DSN (no submit) › Request Body

DsnMonthlyRequest

DsnPeriod · required

employeeId

integer · int32

Optional employee identifier to restrict the declaration to a single individual

Build and validate a DSN (no submit) › Responses

OK - DSN built and validated

Result of building a DSN and running the DSN-VAL controls

DsnValidationResult

conformant

boolean

True when no blocking anomaly was found (definition of done: zero anomalies)

DsnAnomaly[]

Send a signal d'amorçage (SADV)

POST

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/amorcage

Sends a signal d'amorçage (déclaration SADV) to net-entreprises so the withholding-tax (PAS) rates (CRM) can be initialised before the first nominal DSN.

Send a signal d'amorçage (SADV) › path Parameters

partnerId

integer · int32 · required

Partner identifier (must match your API key)

tenantId

integer · int32 · required

Tenant identifier (the déclarant)

Send a signal d'amorçage (SADV) › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Send a signal d'amorçage (SADV) › Request Body

DsnAmorcageRequest

DsnPeriod · required

Send a signal d'amorçage (SADV) › Responses

Created - Signal d'amorçage submitted

A built and/or submitted DSN declaration

DsnDeclaration

declarationId

string

Unique declaration identifier

type

string · enum

Declaration type

Enum values:

MONTHLY

AMORCAGE

DsnPeriod

status

string · enum

Current declaration status

Enum values:

BUILT

VALIDATED

SUBMITTED

ACCEPTED

REJECTED

submittedAt

string · date-time

Import an existing DSN (reprise / migration)

POST

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/import

Parses an existing DSN flat file (.dsn) supplied by the partner for reprise/migration purposes and returns the structured content extracted from it.

Import an existing DSN (reprise / migration) › path Parameters

partnerId

integer · int32 · required

Partner identifier (must match your API key)

tenantId

integer · int32 · required

Tenant identifier (the déclarant)

Import an existing DSN (reprise / migration) › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Import an existing DSN (reprise / migration) › Request Body

string

Raw DSN flat file content (NEODeS format)

Import an existing DSN (reprise / migration) › Responses

OK - DSN parsed

Structured content extracted from an imported DSN flat file

DsnImportResult

norm

string

Detected NEODeS norm version (e.g. CT2026.1.2)

object[]

Declarations parsed from the file

Get DSN deposit status

GET

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/{declarationId}/status

Returns the deposit status of a submitted DSN, including the ARL (Accusé de Réception Logique) and the certificat de conformité once available from net-entreprises.

Get DSN deposit status › path Parameters

partnerId

integer · int32 · required

Partner identifier (must match your API key)

tenantId

integer · int32 · required

Tenant identifier (the déclarant)

declarationId

string · required

Declaration identifier returned at submission

Get DSN deposit status › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get DSN deposit status › Responses

Current state derived from the AEE, certificat/BAN, BIS and CRM return stream.

DsnStatus

declarationId

string · required

state

string · enum · required

Enum values:

Prepared

Submitted

Acknowledged

Certified

BusinessReturnsAvailable

Rejected

simulated

boolean · required

True only for the deterministic partner-sandbox channel.

depotId

string

message

string

Get comptes-rendus métier (CRM)

GET

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/{declarationId}/crm

Retrieves the comptes-rendus métier (NEORES returns) emitted by the receiving organisms for a submitted DSN.

Get comptes-rendus métier (CRM) › path Parameters

partnerId

integer · int32 · required

Partner identifier (must match your API key)

tenantId

integer · int32 · required

Tenant identifier (the déclarant)

declarationId

string · required

Declaration identifier returned at submission

Get comptes-rendus métier (CRM) › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get comptes-rendus métier (CRM) › Responses

Comptes-rendus métier (NEORES returns) for a submitted DSN

DsnCrmResult

declarationId

string

object[]

List of comptes-rendus métier emitted by the receiving organisms

Build a monthly DSN from a persisted payrun (no submission)

POST

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/monthly-from-payrun

Builds the monthly DSN (Déclaration Sociale Nominative) from a persisted payrun result for a given employee and period. Returns the generated DSN and its fast schema-validation result without submitting it to Net-entreprises.

Build a monthly DSN from a persisted payrun (no submission) › path Parameters

partnerId

integer · int32 · required

Partner identifier (must match your API key)

tenantId

integer · int32 · required

Tenant identifier (the déclarant)

Build a monthly DSN from a persisted payrun (no submission) › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Build a monthly DSN from a persisted payrun (no submission) › Request Body

employeeId

integer · int64 · required

year

integer · required

month

integer · required

resultSetId

integer · int64 · min: 1

Optional exact result-set ID returned by payrollresults/sets?payrunJobId=... . Recommended after every recalculation so DSN construction cannot read an older same-period result while indexes converge. The set must belong to the requested employee and period.

userId

integer · int64

strict

boolean

Build a monthly DSN from a persisted payrun (no submission) › Responses

OK - DSN built from the persisted payrun

DsnBuildFromPayrunResponse

tenantId

string · required

employeeId

integer · int64 · required

period

string · pattern: ^\d{4}-(0[1-9]|1[0-2… · required

cotisationSource

string · enum · required

Enum values:

NativePayrunResult

TemplateFallback

cotisationCount

integer · required

payrollResultId

integer · int64 · required

warnings

string[] · required

valid

boolean · required

rubriqueCount

integer · required

object[] · required

content

string · required

Generated NEODeS flat file. This build endpoint does not submit it.

POST/partners/{partnerId}/tenants/{tenantId}/dsn/monthly-from-payrun

curl https://versohq-main-2cc89fe.zuplo.app/partners/:partnerId/tenants/:tenantId/dsn/monthly-from-payrun \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "employeeId": 1,
  "year": 2026,
  "month": 1,
  "resultSetId": 42
}'

Example Request Body

{
  "employeeId": 1,
  "year": 2026,
  "month": 1,
  "resultSetId": 42
}

json

application/json

Example Responses

{
  "tenantId": "tenantId",
  "employeeId": 0,
  "period": "period",
  "cotisationSource": "NativePayrunResult",
  "cotisationCount": 0,
  "payrollResultId": 0,
  "warnings": [
    "string"
  ],
  "valid": true,
  "rubriqueCount": 0,
  "issues": [
    {
      "rubrique": "rubrique",
      "severity": "severity",
      "message": "message"
    }
  ],
  "content": "content"
}

json

application/json

Run the official DSN control on a persisted payrun

POST

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/monthly-from-payrun/control

Builds the DSN in forced strict mode from persisted PayrollEngine results, then runs the configured official control engine. This endpoint never submits to Net-entreprises. A blocking response identifies the PayrollEngine Case and field to correct whenever the triggering rubrique is known.

Run the official DSN control on a persisted payrun › path Parameters

partnerId

integer · int32 · required

Partner identifier (must match your API key)

tenantId

integer · int32 · required

Tenant identifier (the déclarant)

Run the official DSN control on a persisted payrun › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Run the official DSN control on a persisted payrun › Request Body

MonthlyFromPayrunRequest

employeeId

integer · int64 · required

year

integer · min: 2026 · required

month

integer · min: 1 · max: 12 · required

resultSetId

integer · int64 · min: 1

Optional exact result-set ID returned by payrollresults/sets?payrunJobId=... . Recommended after every recalculation so DSN operations cannot read an older same-period result while indexes converge. The set must belong to the requested employee and period.

userId

integer · int64

Default: 0

strict

boolean

Accepted for request compatibility. The control endpoint always forces strict mode.

Run the official DSN control on a persisted payrun › Responses

Control completed without a blocking anomaly

DsnControlResponse

tenantId

string · required

status

string · enum · required

Enum values:

clean

blocking

not_run

unavailable

valid

boolean · required

reportId

string | null · required

Opaque archived official-control report id; null when no report was produced or archiving failed.

DsnDiagnostic[] · required

period

string

cotisationSource

string

payrollResultId

integer · int64

warnings

string[]

error

string

message

string | null

engine

string

blocking

integer | null

nonBlocking

integer | null

POST/partners/{partnerId}/tenants/{tenantId}/dsn/monthly-from-payrun/control

curl https://versohq-main-2cc89fe.zuplo.app/partners/:partnerId/tenants/:tenantId/dsn/monthly-from-payrun/control \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "employeeId": 1,
  "year": 2026,
  "month": 1,
  "strict": true
}'

Example Request Body

{
  "employeeId": 1,
  "year": 2026,
  "month": 1,
  "strict": true
}

json

application/json

Example Responses

{
  "tenantId": "tenantId",
  "period": "period",
  "status": "clean",
  "valid": true,
  "reportId": "reportId",
  "anomalies": [
    {
      "category": "bloquant",
      "scope": "envoi",
      "code": "code",
      "message": "message",
      "rubrique": "S21.G00.40.007",
      "libelle": "libelle",
      "valeur": "valeur",
      "ligne": 0,
      "salarie": "salarie",
      "source": {
        "managedBy": "partner",
        "caseName": "caseName",
        "field": "field",
        "slot": "slot",
        "guidance": "guidance"
      }
    }
  ],
  "cotisationSource": "cotisationSource",
  "payrollResultId": 0,
  "warnings": [
    "string"
  ],
  "error": "error",
  "message": "message",
  "engine": "engine",
  "blocking": 0,
  "nonBlocking": 0
}

json

application/json

Preview DSN payments from a persisted payrun

POST

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/monthly-from-payrun/payment-preview

Returns the per-organism amounts and whether each S21.G00.20 payment block can be emitted. This endpoint is lenient and never submits to Net-entreprises; status needs_attention and anomalies explain payment configuration still to complete.

Preview DSN payments from a persisted payrun › path Parameters

partnerId

integer · int32 · required

Partner identifier (must match your API key)

tenantId

integer · int32 · required

Tenant identifier (the déclarant)

Preview DSN payments from a persisted payrun › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Preview DSN payments from a persisted payrun › Request Body

MonthlyFromPayrunRequest

employeeId

integer · int64 · required

year

integer · min: 2026 · required

month

integer · min: 1 · max: 12 · required

resultSetId

integer · int64 · min: 1

userId

integer · int64

Default: 0

strict

boolean

Accepted for request compatibility. The control endpoint always forces strict mode.

Preview DSN payments from a persisted payrun › Responses

Payment preview

DsnPaymentPreviewResponse

status

string · enum · required

Enum values:

ready

needs_attention

valid

boolean · required

reportId

null · required

Always null: payment preview does not run the official control engine.

period

string · required

DsnPaymentPreviewLine[] · required

totalMontant

number · decimal · required

warnings

string[] · required

DsnDiagnostic[] · required

POST/partners/{partnerId}/tenants/{tenantId}/dsn/monthly-from-payrun/payment-preview

curl https://versohq-main-2cc89fe.zuplo.app/partners/:partnerId/tenants/:tenantId/dsn/monthly-from-payrun/payment-preview \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "employeeId": 1,
  "year": 2026,
  "month": 1
}'

Example Request Body

{
  "employeeId": 1,
  "year": 2026,
  "month": 1
}

json

application/json

Example Responses

{
  "status": "ready",
  "valid": true,
  "reportId": null,
  "period": "period",
  "payments": [
    {
      "ops": "ops",
      "identifiantOps": "identifiantOps",
      "mode": "mode",
      "montant": 0,
      "blocEmitted": true
    }
  ],
  "totalMontant": 0,
  "warnings": [
    "string"
  ],
  "anomalies": [
    {
      "category": "bloquant",
      "scope": "envoi",
      "code": "code",
      "message": "message",
      "rubrique": "S21.G00.40.007",
      "libelle": "libelle",
      "valeur": "valeur",
      "ligne": 0,
      "salarie": "salarie",
      "source": {
        "managedBy": "partner",
        "caseName": "caseName",
        "field": "field",
        "slot": "slot",
        "guidance": "guidance"
      }
    }
  ]
}

json

application/json

Submit a payrun-backed monthly DSN

POST

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/monthly-from-payrun/transmit

Builds the declaration from persisted PayrollEngine results, runs the configured DSN control gate, then submits it. In the partner sandbox the same route uses a deterministic synthetic return channel and always responds with simulated=true; it never contacts net-entreprises.

Submit a payrun-backed monthly DSN › path Parameters

partnerId

integer · int32 · required

Partner identifier (must match your API key)

tenantId

integer · int32 · required

Tenant identifier (the déclarant)

Submit a payrun-backed monthly DSN › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

X-Verso-Test-Scenario

string · enum

Sandbox-only deterministic return scenario. Omit for success. Rejected outside the enabled sandbox simulator.

Enum values:

success

ban_blocking

bis_identity

crm_urssaf

crm_pas

Default: success

Submit a payrun-backed monthly DSN › Request Body

DsnMonthlyFromPayrunTransmitRequest

employeeId

integer · int64 · required

year

integer · min: 2026 · required

month

integer · min: 1 · max: 12 · required

resultSetId

integer · int64 · min: 1

Optional exact result-set ID returned by payrollresults/sets?payrunJobId=... . Recommended after every recalculation so transmission cannot read an older same-period result while indexes converge. The set must belong to the requested employee and period.

userId

integer · int64

Default: 1

declarationType

string · enum

Enum values:

Default: 01

allowSkippedControl

boolean

Exceptional override. The Indy sandbox normally runs the configured control engine.

Default: false

Submit a payrun-backed monthly DSN › Responses

Accepted - poll receipt.depotId on the status and returns routes

DsnTransmitResponse

simulated

boolean · required

DsnStatus · required

Current state derived from the AEE, certificat/BAN, BIS and CRM return stream.

object · required

POST/partners/{partnerId}/tenants/{tenantId}/dsn/monthly-from-payrun/transmit

curl https://versohq-main-2cc89fe.zuplo.app/partners/:partnerId/tenants/:tenantId/dsn/monthly-from-payrun/transmit \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "employeeId": 0,
  "year": 2026,
  "month": 1,
  "resultSetId": 1,
  "userId": 1,
  "declarationType": "01",
  "allowSkippedControl": false
}'

Example Request Body

{
  "employeeId": 0,
  "year": 2026,
  "month": 1,
  "resultSetId": 1,
  "userId": 1,
  "declarationType": "01",
  "allowSkippedControl": false
}

json

Example Responses

{
  "simulated": true,
  "receipt": {
    "declarationId": "declarationId",
    "depotId": "depotId",
    "state": "Prepared",
    "message": "message",
    "simulated": true
  },
  "provenance": {},
  "sequence": {},
  "control": {}
}

json

application/json

Get structured DSN returns

GET

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/{declarationId}/returns

Lists and parses the AEE, certificat/BAN, BIS and CRM documents available for a deposit. Sandbox responses are deterministic and carry simulated=true.

Get structured DSN returns › path Parameters

partnerId

integer · int32 · required

tenantId

integer · int32 · required

declarationId

string · required

Deposit identifier returned as receipt.depotId

Get structured DSN returns › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get structured DSN returns › Responses

Structured return channel

DsnReturnsResponse

tenantId

string · required

depotId

string · required

simulated

boolean · required

state

string · enum · required

Enum values:

Prepared

Submitted

Acknowledged

Certified

BusinessReturnsAvailable

Rejected

DsnReturnMetadata[] · required

object[] · required

archived

boolean · required

GET/partners/{partnerId}/tenants/{tenantId}/dsn/{declarationId}/returns

curl https://versohq-main-2cc89fe.zuplo.app/partners/:partnerId/tenants/:tenantId/dsn/:declarationId/returns \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "tenantId": "tenantId",
  "depotId": "depotId",
  "simulated": true,
  "state": "Prepared",
  "listed": [
    {
      "nature": "nature",
      "natureLabel": "natureLabel",
      "statut": "statut",
      "ops": "ops",
      "publication": "publication",
      "hasDocument": true
    }
  ],
  "documents": [
    {
      "nature": "nature",
      "natureLabel": "natureLabel",
      "statut": "statut",
      "ops": "ops",
      "publication": "publication",
      "hasDocument": true,
      "kind": "Neores",
      "parseError": "parseError",
      "summary": {},
      "returnId": "returnId"
    }
  ],
  "archived": true
}

json

application/json

Get raw DSN return documents

GET

https://versohq-main-2cc89fe.zuplo.app

/partners/{partnerId}/tenants/{tenantId}/dsn/{declarationId}/returns/raw

Returns the original XML documents in a JSON envelope. Sandbox documents are synthetic and carry simulated=true.

Get raw DSN return documents › path Parameters

partnerId

integer · int32 · required

tenantId

integer · int32 · required

declarationId

string · required

Deposit identifier returned as receipt.depotId

Get raw DSN return documents › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get raw DSN return documents › Responses

Raw return documents

DsnRawReturnsResponse

tenantId

string · required

depotId

string · required

simulated

boolean · required

object[] · required

Rate tables