Sign in

v1

latestOpenAPI 3.0.12026-07-243686491.1 MB
Tax Compliance

Register a team's FR tax compliance

Sets the FR compliance identifiers and/or fiscal registration on an existing team. countryCode must be fr (the only country supported today). At least one of the two blocks is required. Idempotent upsert. Required scope: teams:write </br>Organization authorization: supported

put/api/v1/teams/{teamId}/tax-compliance/{countryCode}

Path parameters

teamIdinteger required
countryCodestring required

Request body

compliance_identifiersobject nullable

The company's official French registration numbers, given as key/value pairs where each key names a type of identifier and the value is the number itself. You do not need to send all three — always include FR_SIREN, and add the others only if they apply:

  • FR_SIREN — required. The 9-digit number that identifies the company nationally.
  • FR_SIRET — optional. The 14-digit number that identifies one specific site of the company (its SIREN followed by a 5-digit site code). Include it when registering a particular establishment.
  • FR_VAT — optional. The company's French VAT number. It is derived from the SIREN/SIRET, so you normally don't need to set it yourself.

Example request

{
  "compliance_identifiers": {
    "FR_SIREN": "840227060",
    "FR_SIRET": "84022706000012",
    "FR_VAT": "FR00840227060"
  },
  "fiscal_registration": {
    "vatPaymentBasis": "ENCAISSEMENTS",
    "legalFormCode": "5710",
    "vatExemptionReasonCode": "VATEX-FR-FRANCHISE",
    "declaration": {
      "issuanceScope": "IN_SCOPE_2026"
    }
  }
}

Response

Compliance data registered