{
  "openapi": "3.1.0",
  "info": {
    "title": "API Puncto",
    "version": "1.0",
    "description": "Synchronisez votre SIRH ou votre ERP avec Puncto : collaborateurs, contrats, absences, variables de paie, documents, référentiels de l’entreprise, temps et congés, déclarations et bulletins de paie."
  },
  "servers": [
    {
      "url": "https://api.puncto.fr",
      "description": "Production"
    },
    {
      "url": "https://staging.api.puncto.fr",
      "description": "Staging"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Collaborateurs",
      "description": "Les salariés de l’entreprise."
    },
    {
      "name": "Contrats",
      "description": "Contrats de travail, avenants, lieux de travail et périodes d’essai."
    },
    {
      "name": "Absences",
      "description": "Congés, arrêts et autres absences."
    },
    {
      "name": "Variables de paie",
      "description": "Primes, heures supplémentaires, retenues et indemnités du mois."
    },
    {
      "name": "Astreintes",
      "description": "Types et périodes d’astreinte."
    },
    {
      "name": "Variables récurrentes",
      "description": "Échéanciers mensuels : primes récurrentes, avantages en nature, véhicule de fonction."
    },
    {
      "name": "Bulletins de paie",
      "description": "Bulletins validés, lignes telles qu’imprimées sur le PDF du collaborateur."
    },
    {
      "name": "Documents",
      "description": "Contrats signés, justificatifs et documents générés par Puncto."
    },
    {
      "name": "Entreprise",
      "description": "Entreprise, établissements, postes, équipes, mutuelle et prévoyance."
    },
    {
      "name": "Temps et congés",
      "description": "Soldes de congés, télétravail, feuilles de temps et forfaits jours."
    },
    {
      "name": "Déclarations",
      "description": "Mois de paie et suivi des déclarations : DSN, DPAE, signalements."
    },
    {
      "name": "Rapports",
      "description": "Données agrégées, dont l’index de l’égalité professionnelle."
    }
  ],
  "paths": {
    "/public/v1/collaborators": {
      "get": {
        "operationId": "listCollaborators",
        "tags": [
          "Collaborateurs"
        ],
        "summary": "Lister les collaborateurs",
        "description": "Liste paginée des collaborateurs de l’entreprise, triés par nom puis prénom. Avec un filtre sur un collaborateur, une liste vide renvoie `404`.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de collaborateurs",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiCollaborator"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Aucun collaborateur ne correspond au filtre",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "post": {
        "operationId": "createCollaborator",
        "tags": [
          "Collaborateurs"
        ],
        "summary": "Créer un collaborateur et son premier contrat",
        "description": "Crée le collaborateur, son compte et son premier contrat, en tout ou rien.\n\nEnsuite, Puncto invite le collaborateur (email personnel) si le contrat commence sous 2 jours ou a commencé, et dépose la DPAE si `dpaeDoneByPuncto` est `true` et que le contrat commence sous 8 jours. Un échec de ces envois n’annule pas la création.\n\nCollaborateur déjà connu (même `foreignErpId` ou numéro de sécurité sociale) : `409` avec son `collaboratorId`. Créez alors son contrat avec `POST /public/v1/contracts`. Voir le [guide des contrats](/guides/contrats).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "foreignErpId",
                  "identity",
                  "contact",
                  "isBoeth",
                  "dependentChildrenCount",
                  "iban",
                  "bic",
                  "contract"
                ],
                "properties": {
                  "foreignErpId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100,
                    "description": "Identifiant du collaborateur dans votre système, unique dans l’entreprise. Déjà utilisé : `409` avec le `collaboratorId`.",
                    "example": "salarie-123"
                  },
                  "identity": {
                    "type": "object",
                    "required": [
                      "firstName",
                      "lastName",
                      "birthDate",
                      "birthCountryCode",
                      "birthCity",
                      "nationality"
                    ],
                    "properties": {
                      "firstName": {
                        "type": "string",
                        "maxLength": 100
                      },
                      "lastName": {
                        "type": "string",
                        "maxLength": 100
                      },
                      "birthDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date de naissance.",
                        "example": "1991-06-14"
                      },
                      "birthCountryCode": {
                        "type": "string",
                        "enum": [
                          "FR",
                          "GP",
                          "BL",
                          "MF",
                          "MQ",
                          "GF",
                          "RE",
                          "PM",
                          "YT",
                          "WF",
                          "PF",
                          "NC",
                          "MC",
                          "AF",
                          "AL",
                          "DZ",
                          "AD",
                          "AO",
                          "AG",
                          "AR",
                          "AM",
                          "AU",
                          "AT",
                          "AZ",
                          "BS",
                          "BH",
                          "BD",
                          "BB",
                          "BY",
                          "BE",
                          "BZ",
                          "BJ",
                          "BT",
                          "BO",
                          "BA",
                          "BW",
                          "BR",
                          "BN",
                          "BG",
                          "BF",
                          "BI",
                          "CV",
                          "KH",
                          "CM",
                          "CA",
                          "CF",
                          "TD",
                          "CL",
                          "CN",
                          "CO",
                          "KM",
                          "CD",
                          "CG",
                          "CR",
                          "CI",
                          "HR",
                          "CU",
                          "CY",
                          "CZ",
                          "DK",
                          "DJ",
                          "DM",
                          "DO",
                          "EC",
                          "EG",
                          "SV",
                          "GQ",
                          "ER",
                          "EE",
                          "SZ",
                          "ET",
                          "FJ",
                          "FI",
                          "GA",
                          "GM",
                          "GE",
                          "DE",
                          "GH",
                          "GR",
                          "GD",
                          "GT",
                          "GN",
                          "GW",
                          "GY",
                          "HT",
                          "HN",
                          "HU",
                          "IS",
                          "IN",
                          "ID",
                          "IR",
                          "IQ",
                          "IE",
                          "IL",
                          "IT",
                          "JM",
                          "JP",
                          "JO",
                          "KZ",
                          "KE",
                          "KI",
                          "KP",
                          "KR",
                          "KW",
                          "KG",
                          "LA",
                          "LV",
                          "LB",
                          "LS",
                          "LR",
                          "LY",
                          "LI",
                          "LT",
                          "LU",
                          "MG",
                          "MW",
                          "MY",
                          "MV",
                          "ML",
                          "MT",
                          "MH",
                          "MR",
                          "MU",
                          "MX",
                          "FM",
                          "MD",
                          "MN",
                          "ME",
                          "MA",
                          "MZ",
                          "MM",
                          "NA",
                          "NR",
                          "NP",
                          "NL",
                          "NZ",
                          "NI",
                          "NE",
                          "NG",
                          "NO",
                          "OM",
                          "PK",
                          "PW",
                          "PS",
                          "PA",
                          "PG",
                          "PY",
                          "PE",
                          "PH",
                          "PL",
                          "PT",
                          "QA",
                          "RO",
                          "RU",
                          "RW",
                          "KN",
                          "LC",
                          "VC",
                          "WS",
                          "SM",
                          "ST",
                          "SA",
                          "SN",
                          "RS",
                          "SC",
                          "SL",
                          "SG",
                          "SK",
                          "SI",
                          "SB",
                          "SO",
                          "ZA",
                          "SS",
                          "ES",
                          "LK",
                          "SD",
                          "SR",
                          "SE",
                          "CH",
                          "SY",
                          "TW",
                          "TJ",
                          "TZ",
                          "TH",
                          "TL",
                          "TG",
                          "TO",
                          "TT",
                          "TN",
                          "TR",
                          "TM",
                          "TV",
                          "UG",
                          "UA",
                          "AE",
                          "GB",
                          "US",
                          "UY",
                          "UZ",
                          "VU",
                          "VE",
                          "VN",
                          "YE",
                          "ZM",
                          "ZW"
                        ],
                        "description": "Pays de naissance."
                      },
                      "birthCity": {
                        "type": "string",
                        "maxLength": 100
                      },
                      "birthDepartmentCode": {
                        "type": "string",
                        "maxLength": 3,
                        "description": "Département de naissance, obligatoire pour une naissance en France.",
                        "example": "44"
                      },
                      "nationality": {
                        "type": "string",
                        "enum": [
                          "FR",
                          "GP",
                          "BL",
                          "MF",
                          "MQ",
                          "GF",
                          "RE",
                          "PM",
                          "YT",
                          "WF",
                          "PF",
                          "NC",
                          "MC",
                          "AF",
                          "AL",
                          "DZ",
                          "AD",
                          "AO",
                          "AG",
                          "AR",
                          "AM",
                          "AU",
                          "AT",
                          "AZ",
                          "BS",
                          "BH",
                          "BD",
                          "BB",
                          "BY",
                          "BE",
                          "BZ",
                          "BJ",
                          "BT",
                          "BO",
                          "BA",
                          "BW",
                          "BR",
                          "BN",
                          "BG",
                          "BF",
                          "BI",
                          "CV",
                          "KH",
                          "CM",
                          "CA",
                          "CF",
                          "TD",
                          "CL",
                          "CN",
                          "CO",
                          "KM",
                          "CD",
                          "CG",
                          "CR",
                          "CI",
                          "HR",
                          "CU",
                          "CY",
                          "CZ",
                          "DK",
                          "DJ",
                          "DM",
                          "DO",
                          "EC",
                          "EG",
                          "SV",
                          "GQ",
                          "ER",
                          "EE",
                          "SZ",
                          "ET",
                          "FJ",
                          "FI",
                          "GA",
                          "GM",
                          "GE",
                          "DE",
                          "GH",
                          "GR",
                          "GD",
                          "GT",
                          "GN",
                          "GW",
                          "GY",
                          "HT",
                          "HN",
                          "HU",
                          "IS",
                          "IN",
                          "ID",
                          "IR",
                          "IQ",
                          "IE",
                          "IL",
                          "IT",
                          "JM",
                          "JP",
                          "JO",
                          "KZ",
                          "KE",
                          "KI",
                          "KP",
                          "KR",
                          "KW",
                          "KG",
                          "LA",
                          "LV",
                          "LB",
                          "LS",
                          "LR",
                          "LY",
                          "LI",
                          "LT",
                          "LU",
                          "MG",
                          "MW",
                          "MY",
                          "MV",
                          "ML",
                          "MT",
                          "MH",
                          "MR",
                          "MU",
                          "MX",
                          "FM",
                          "MD",
                          "MN",
                          "ME",
                          "MA",
                          "MZ",
                          "MM",
                          "NA",
                          "NR",
                          "NP",
                          "NL",
                          "NZ",
                          "NI",
                          "NE",
                          "NG",
                          "NO",
                          "OM",
                          "PK",
                          "PW",
                          "PS",
                          "PA",
                          "PG",
                          "PY",
                          "PE",
                          "PH",
                          "PL",
                          "PT",
                          "QA",
                          "RO",
                          "RU",
                          "RW",
                          "KN",
                          "LC",
                          "VC",
                          "WS",
                          "SM",
                          "ST",
                          "SA",
                          "SN",
                          "RS",
                          "SC",
                          "SL",
                          "SG",
                          "SK",
                          "SI",
                          "SB",
                          "SO",
                          "ZA",
                          "SS",
                          "ES",
                          "LK",
                          "SD",
                          "SR",
                          "SE",
                          "CH",
                          "SY",
                          "TW",
                          "TJ",
                          "TZ",
                          "TH",
                          "TL",
                          "TG",
                          "TO",
                          "TT",
                          "TN",
                          "TR",
                          "TM",
                          "TV",
                          "UG",
                          "UA",
                          "AE",
                          "GB",
                          "US",
                          "UY",
                          "UZ",
                          "VU",
                          "VE",
                          "VN",
                          "YE",
                          "ZM",
                          "ZW"
                        ]
                      }
                    }
                  },
                  "contact": {
                    "type": "object",
                    "required": [
                      "address",
                      "postalCode",
                      "city",
                      "countryCode",
                      "personalEmail",
                      "professionalEmail"
                    ],
                    "properties": {
                      "address": {
                        "type": "string",
                        "maxLength": 250,
                        "description": "Adresse postale : lettres, chiffres, espace, apostrophe, tiret et point seulement (norme DSN)."
                      },
                      "addressDetails": {
                        "type": "string",
                        "maxLength": 250,
                        "description": "Complément d’adresse."
                      },
                      "postalCode": {
                        "type": "string",
                        "maxLength": 10
                      },
                      "city": {
                        "type": "string",
                        "maxLength": 100
                      },
                      "countryCode": {
                        "type": "string",
                        "enum": [
                          "FR",
                          "GP",
                          "BL",
                          "MF",
                          "MQ",
                          "GF",
                          "RE",
                          "PM",
                          "YT",
                          "WF",
                          "PF",
                          "NC",
                          "MC",
                          "AF",
                          "AL",
                          "DZ",
                          "AD",
                          "AO",
                          "AG",
                          "AR",
                          "AM",
                          "AU",
                          "AT",
                          "AZ",
                          "BS",
                          "BH",
                          "BD",
                          "BB",
                          "BY",
                          "BE",
                          "BZ",
                          "BJ",
                          "BT",
                          "BO",
                          "BA",
                          "BW",
                          "BR",
                          "BN",
                          "BG",
                          "BF",
                          "BI",
                          "CV",
                          "KH",
                          "CM",
                          "CA",
                          "CF",
                          "TD",
                          "CL",
                          "CN",
                          "CO",
                          "KM",
                          "CD",
                          "CG",
                          "CR",
                          "CI",
                          "HR",
                          "CU",
                          "CY",
                          "CZ",
                          "DK",
                          "DJ",
                          "DM",
                          "DO",
                          "EC",
                          "EG",
                          "SV",
                          "GQ",
                          "ER",
                          "EE",
                          "SZ",
                          "ET",
                          "FJ",
                          "FI",
                          "GA",
                          "GM",
                          "GE",
                          "DE",
                          "GH",
                          "GR",
                          "GD",
                          "GT",
                          "GN",
                          "GW",
                          "GY",
                          "HT",
                          "HN",
                          "HU",
                          "IS",
                          "IN",
                          "ID",
                          "IR",
                          "IQ",
                          "IE",
                          "IL",
                          "IT",
                          "JM",
                          "JP",
                          "JO",
                          "KZ",
                          "KE",
                          "KI",
                          "KP",
                          "KR",
                          "KW",
                          "KG",
                          "LA",
                          "LV",
                          "LB",
                          "LS",
                          "LR",
                          "LY",
                          "LI",
                          "LT",
                          "LU",
                          "MG",
                          "MW",
                          "MY",
                          "MV",
                          "ML",
                          "MT",
                          "MH",
                          "MR",
                          "MU",
                          "MX",
                          "FM",
                          "MD",
                          "MN",
                          "ME",
                          "MA",
                          "MZ",
                          "MM",
                          "NA",
                          "NR",
                          "NP",
                          "NL",
                          "NZ",
                          "NI",
                          "NE",
                          "NG",
                          "NO",
                          "OM",
                          "PK",
                          "PW",
                          "PS",
                          "PA",
                          "PG",
                          "PY",
                          "PE",
                          "PH",
                          "PL",
                          "PT",
                          "QA",
                          "RO",
                          "RU",
                          "RW",
                          "KN",
                          "LC",
                          "VC",
                          "WS",
                          "SM",
                          "ST",
                          "SA",
                          "SN",
                          "RS",
                          "SC",
                          "SL",
                          "SG",
                          "SK",
                          "SI",
                          "SB",
                          "SO",
                          "ZA",
                          "SS",
                          "ES",
                          "LK",
                          "SD",
                          "SR",
                          "SE",
                          "CH",
                          "SY",
                          "TW",
                          "TJ",
                          "TZ",
                          "TH",
                          "TL",
                          "TG",
                          "TO",
                          "TT",
                          "TN",
                          "TR",
                          "TM",
                          "TV",
                          "UG",
                          "UA",
                          "AE",
                          "GB",
                          "US",
                          "UY",
                          "UZ",
                          "VU",
                          "VE",
                          "VN",
                          "YE",
                          "ZM",
                          "ZW"
                        ]
                      },
                      "personalEmail": {
                        "type": "string",
                        "format": "email",
                        "minLength": 3,
                        "maxLength": 250,
                        "description": "Email personnel : identifiant de connexion du collaborateur et adresse de son invitation. Unique dans tout Puncto."
                      },
                      "professionalEmail": {
                        "type": "string",
                        "format": "email",
                        "minLength": 3,
                        "maxLength": 250
                      },
                      "phoneNumber": {
                        "type": "string",
                        "minLength": 8,
                        "maxLength": 15
                      }
                    }
                  },
                  "socialSecurityNumber": {
                    "type": "string",
                    "description": "NIR ou NIA, avec ou sans clé ni espaces ; NIR provisoires (7 ou 8 en tête) refusés. Sans numéro, Puncto attribue un NTT d’après `sex` et `contract.dpaeDoneByPuncto` doit valoir `false` (CDI, CDD, apprentissage).",
                    "example": "2910644123456"
                  },
                  "identityType": {
                    "type": "string",
                    "enum": [
                      "NIR",
                      "NIA"
                    ],
                    "default": "NIR",
                    "description": "Nature de `socialSecurityNumber`, ignorée sans numéro."
                  },
                  "sex": {
                    "type": "string",
                    "enum": [
                      "MALE",
                      "FEMALE"
                    ],
                    "description": "Obligatoire sans `socialSecurityNumber` (sert au NTT). Avec un numéro, doit correspondre à son premier chiffre."
                  },
                  "isBoeth": {
                    "type": "boolean",
                    "description": "Le collaborateur est bénéficiaire de l’obligation d’emploi (BOETH)."
                  },
                  "dependentChildrenCount": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9
                  },
                  "disabledDependentChildrenCount": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9,
                    "default": 0,
                    "description": "Parmi `dependentChildrenCount`, les enfants à charge handicapés."
                  },
                  "maritalStatus": {
                    "type": "string",
                    "enum": [
                      "SINGLE",
                      "MARRIED",
                      "CIVIL_PARTNERSHIP",
                      "COHABITING",
                      "SEPARATED",
                      "DIVORCED",
                      "WIDOWED"
                    ],
                    "description": "Situation matrimoniale, facultative. Puncto la conserve sans encore s’en servir dans la paie.\n\n- `SINGLE` : Célibataire\n- `MARRIED` : Marié(e)\n- `CIVIL_PARTNERSHIP` : Pacsé(e)\n- `COHABITING` : En concubinage\n- `SEPARATED` : Séparé(e)\n- `DIVORCED` : Divorcé(e)\n- `WIDOWED` : Veuf ou veuve"
                  },
                  "iban": {
                    "type": "string",
                    "description": "IBAN du compte de paiement du salaire."
                  },
                  "bic": {
                    "type": "string"
                  },
                  "contract": {
                    "type": "object",
                    "description": "Premier contrat, mêmes champs que `POST /public/v1/contracts`.",
                    "required": [
                      "workerType",
                      "startDate",
                      "dpaeDoneByPuncto"
                    ],
                    "properties": {
                      "workerType": {
                        "type": "string",
                        "enum": [
                          "EMPLOYEE_CDI",
                          "EMPLOYEE_CDD",
                          "APPRENTICESHIP_CONTRACT",
                          "INTERN",
                          "CORPORATE_OFFICER"
                        ],
                        "description": "Type de contrat. Le contrat de professionnalisation n’est pas encore pris en charge.\n\n- `EMPLOYEE_CDI` : Salarié - CDI\n- `EMPLOYEE_CDD` : Salarié - CDD\n- `APPRENTICESHIP_CONTRACT` : Alternant - Apprentissage\n- `INTERN` : Stagiaire\n- `CORPORATE_OFFICER` : Dirigeant (Mandat social)"
                      },
                      "startDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date de début du contrat.",
                        "example": "2026-11-02"
                      },
                      "endDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Fin prévue, au plus tôt la date de début. Obligatoire pour un CDD, un apprentissage et un stage ; facultative pour un mandat social ; refusée pour un CDI."
                      },
                      "cddMotif": {
                        "type": "string",
                        "enum": [
                          "01",
                          "02",
                          "03",
                          "04",
                          "05",
                          "06",
                          "07",
                          "08",
                          "09",
                          "10",
                          "11",
                          "12",
                          "13",
                          "14",
                          "15"
                        ],
                        "description": "Motif de recours, obligatoire pour un CDD.\n\n- `01` : 01 - Remplacement d'un salarié\n- `02` : 02 - Accroissement temporaire de l'activité de l'entreprise\n- `03` : 03 - Emplois à caractère saisonnier\n- `04` : 04 - Contrat vendanges\n- `05` : 05 - Contrat d'usage\n- `06` : 06 - Contrat à durée déterminée à objet défini\n- `07` : 07 - Remplacement d'un chef d'entreprise\n- `08` : 08 - Remplacement du chef d'une exploitation agricole\n- `09` : 09 - Recrutement de personnes sans emploi rencontrant des difficultés sociales et professionnelles particulières\n- `10` : 10 - Complément de formation professionnelle au salarié\n- `11` : 11 - Formation professionnelle au salarié par la voie de l'apprentissage, en vue de l'obtention d'une qualification professionnelle sanctionnée par un diplôme ou un titre à finalité professionnelle enregistré au répertoire national des certifications professionnelles\n- `12` : 12 - Remplacement d'un salarié passé provisoirement à temps partiel\n- `13` : 13 - Attente de la suppression définitive du poste du salarié ayant quitté définitivement l'entreprise\n- `14` : 14 - Contrat de voyage\n- `15` : 15 - Recrutement d'un intérimaire en sa qualité de BOETH"
                      },
                      "establishmentId": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Établissement de rattachement. Par défaut : celui du dernier contrat à sa fin (changements de lieu de travail compris), sinon du contrat en attente de saisie, sinon le siège. Ne pas combiner avec `establishmentSiret`.",
                        "example": "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                      },
                      "establishmentSiret": {
                        "type": "string",
                        "minLength": 1,
                        "description": "SIRET de l’établissement (14 chiffres, espaces ignorés). Ne pas combiner avec `establishmentId`.",
                        "example": "55210055400013"
                      },
                      "companyRoleId": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Poste existant. Renseignez `companyRoleId` ou `companyRoleName`.",
                        "example": "crol_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                      },
                      "companyRoleName": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 255,
                        "description": "Intitulé du poste : réutilise le poste de ce nom exact, sinon le crée. Renseignez `companyRoleId` ou `companyRoleName`.",
                        "example": "Développeuse backend"
                      },
                      "companyTeamId": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Équipe existante. Ne pas combiner avec `companyTeamName`.",
                        "example": "ctea_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                      },
                      "companyTeamName": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 255,
                        "description": "Nom de l’équipe : réutilise l’équipe de ce nom exact, sinon la crée. Ne pas combiner avec `companyTeamId`."
                      },
                      "managerId": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Identifiant Puncto du manager.",
                        "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                      },
                      "trialPeriodEndDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Fin de la période d’essai initiale, au plus tôt la date de début et, avec une position conventionnelle, au plus tard le maximum conventionnel. Apprentissage : sa présence suffit, la fin est calculée (45 jours en entreprise). Refusée pour un stage et un mandat social."
                      },
                      "dpaeDoneByPuncto": {
                        "type": "boolean",
                        "description": "`true` : Puncto dépose la DPAE (CDI, CDD, apprentissage), à la création si le contrat commence sous 8 jours ou a commencé, sinon 8 jours avant. Exige un NIR ou NIA à la date de début : sans numéro (NTT), `true` renvoie `400`. `false` : vous la déposez. Sans effet pour un stage ou un mandat social."
                      },
                      "healthServiceCode": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 255,
                        "description": "Code du service de santé au travail, requis si Puncto dépose la DPAE et que l’établissement n’en a pas (il y est alors enregistré)."
                      },
                      "internshipStudies": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Stage : formation suivie, obligatoire."
                      },
                      "internshipSchool": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Stage : établissement d’enseignement, obligatoire."
                      },
                      "internshipPaidLeaveDays": {
                        "type": "integer",
                        "minimum": 1,
                        "description": "Stage uniquement : jours de congés payés accordés."
                      },
                      "hasMutuelleDispense": {
                        "type": "boolean",
                        "description": "Le salarié est dispensé de mutuelle. Incompatible avec `mutuelleOcContractId`."
                      },
                      "mutuelleOcContractId": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Contrat de mutuelle de l’entreprise (à cotisation forfaitaire), en vigueur à la date de début et ouvert au statut cadre ou non cadre du salarié.",
                        "example": "ocon_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                      },
                      "mutuelleForfaitChoice": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Formule de mutuelle choisie parmi celles du contrat (`UNIQUE`, `OPTION_<code>`, `CONDITION_<code>` ou, quand plusieurs forfaits partagent une option, `TIER_<code>__<libellé>`). Obligatoire avec `mutuelleOcContractId`.",
                        "example": "CONDITION_02"
                      },
                      "prevoyanceOcContractId": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Contrat de prévoyance de l’entreprise, en vigueur à la date de début et ouvert au statut cadre ou non cadre du salarié.",
                        "example": "ocon_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                      },
                      "corporateOfficerSalaryMaintenance": {
                        "type": "boolean",
                        "description": "Mandat social uniquement : rémunération maintenue pendant les arrêts, sous déduction des IJSS."
                      },
                      "amendment": {
                        "type": "object",
                        "description": "Conditions du contrat à sa date de début. Obligatoire, sauf en apprentissage (voir `amendments`). Rémunération : `grossAnnualSalary` (CDI, CDD, mandat social) ou `hourlyRate` / `smoothedMonthlyAmount` (stage).",
                        "required": [
                          "isCadre",
                          "quotity",
                          "conventionalWorkerStatus",
                          "workerOutsideFranceStatus",
                          "weekDaysWorked",
                          "codePcsEse"
                        ],
                        "properties": {
                          "isCadre": {
                            "type": "boolean",
                            "description": "Statut cadre (retraite complémentaire) : `true` en position `CADRE`, `false` en `ETAM`. Doit concorder avec `conventionalWorkerStatus` et la population de la prévoyance."
                          },
                          "quotity": {
                            "description": "Temps de travail du contrat. La forme dépend de `type`.",
                            "oneOf": [
                              {
                                "title": "Heures",
                                "type": "object",
                                "required": [
                                  "type",
                                  "monthlyWorkingHours",
                                  "workingPercentage",
                                  "paidContractualOvertimeHours",
                                  "rttContractualOvertimeHours",
                                  "rcrContractualOvertimeHours"
                                ],
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "HEURE"
                                  },
                                  "monthlyWorkingHours": {
                                    "type": "number",
                                    "minimum": 0,
                                    "description": "Heures mensuelles, 151.67 pour un temps plein."
                                  },
                                  "workingPercentage": {
                                    "type": "number",
                                    "minimum": 1,
                                    "maximum": 100,
                                    "description": "Pourcentage d’un temps plein."
                                  },
                                  "paidContractualOvertimeHours": {
                                    "type": "number",
                                    "minimum": 0,
                                    "description": "Heures supplémentaires contractuelles payées, par semaine. Interdites à temps partiel."
                                  },
                                  "rttContractualOvertimeHours": {
                                    "type": "number",
                                    "minimum": 0,
                                    "description": "Heures supplémentaires contractuelles compensées en RTT, par semaine. Exige des JRTT paramétrés dans l’entreprise."
                                  },
                                  "rcrContractualOvertimeHours": {
                                    "type": "number",
                                    "minimum": 0,
                                    "description": "Heures supplémentaires contractuelles compensées en repos, par semaine."
                                  },
                                  "isCeilingProrated": {
                                    "type": "boolean",
                                    "description": "Temps partiel : plafond de la sécurité sociale proratisé à hauteur de la quotité. Absent : `true`. `false` quand le salarié et l’employeur renoncent à la proratisation pour cotiser comme à temps plein."
                                  }
                                }
                              },
                              {
                                "title": "Forfait jours",
                                "type": "object",
                                "required": [
                                  "type",
                                  "forfaitDailyAmount",
                                  "monthlyWorkingDays",
                                  "workingPercentage"
                                ],
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "FORFAIT_JOUR"
                                  },
                                  "forfaitDailyAmount": {
                                    "type": "number",
                                    "minimum": 0,
                                    "description": "Nombre de jours travaillés par an (218 pour un forfait complet)."
                                  },
                                  "monthlyWorkingDays": {
                                    "type": "number",
                                    "minimum": 0,
                                    "description": "Jours travaillés par mois."
                                  },
                                  "workingPercentage": {
                                    "type": "number",
                                    "minimum": 1,
                                    "maximum": 100
                                  },
                                  "isCeilingProrated": {
                                    "type": "boolean",
                                    "description": "Forfait jours réduit : plafond de la sécurité sociale proratisé à hauteur des jours du forfait (jours / 218). Absent : `false`, un forfait jours réduit garde un plafond entier. `true` suppose le consentement du salarié."
                                  }
                                }
                              },
                              {
                                "title": "Forfait heures",
                                "type": "object",
                                "required": [
                                  "type",
                                  "period",
                                  "forfaitHours",
                                  "monthlyWorkingHours",
                                  "annualWorkingDaysCap",
                                  "workingPercentage"
                                ],
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "FORFAIT_HEURE"
                                  },
                                  "period": {
                                    "type": "string",
                                    "enum": [
                                      "WEEKLY",
                                      "MONTHLY",
                                      "YEARLY"
                                    ],
                                    "description": "Seul le forfait hebdomadaire `WEEKLY` est accepté."
                                  },
                                  "forfaitHours": {
                                    "type": "number",
                                    "minimum": 0,
                                    "description": "Heures du forfait par semaine, au-delà de la durée légale de 35 heures."
                                  },
                                  "monthlyWorkingHours": {
                                    "type": "number",
                                    "minimum": 0
                                  },
                                  "annualWorkingDaysCap": {
                                    "type": "number",
                                    "minimum": 1,
                                    "maximum": 365
                                  },
                                  "workingPercentage": {
                                    "type": "number",
                                    "const": 100,
                                    "description": "Le forfait heures réduit n’est pas pris en charge."
                                  }
                                }
                              },
                              {
                                "title": "Non concerné",
                                "type": "object",
                                "required": [
                                  "type"
                                ],
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "NON_CONCERNE"
                                  }
                                }
                              }
                            ]
                          },
                          "conventionalWorkerStatus": {
                            "type": "string",
                            "enum": [
                              "01",
                              "02",
                              "03",
                              "04",
                              "05",
                              "06",
                              "07",
                              "08",
                              "09",
                              "10"
                            ],
                            "description": "Statut conventionnel DSN, en général `04` cadre, `03` cadre dirigeant ou mandataire social, `07` stagiaire, `05` sinon. `03` et `04` exigent `\"isCadre\": true` ; `05` à `07`, `false`.\n\n- `01` : 01 - agriculteur salarié de son exploitation\n- `02` : 02 - artisan ou commerçant salarié de son entreprise\n- `03` : 03 - cadre dirigeant (votant au collège employeur des élections prud'homales)\n- `04` : 04 - autres cadres au sens de la convention collective (ou du statut pour les régimes spéciaux)\n- `05` : 05 - profession intermédiaire (technicien, contremaître, agent de maîtrise, clergé)\n- `06` : 06 - employé administratif d'entreprise, de commerce, agent de service\n- `07` : 07 - ouvriers qualifiés et non qualifiés y compris ouvriers agricoles\n- `08` : 08 - agent de la fonction publique d'Etat\n- `09` : 09 - agent de la fonction publique hospitalière\n- `10` : 10 - agent de la fonction publique territoriale"
                          },
                          "workerOutsideFranceStatus": {
                            "type": "string",
                            "enum": [
                              "01",
                              "02",
                              "03",
                              "99"
                            ],
                            "description": "Statut d’expatriation déclaré en DSN, `99` hors expatriation.\n\n- `01` : 01 - Détaché\n- `02` : 02 - Expatrié\n- `03` : 03 - Frontalier\n- `99` : 99 - Non concerné"
                          },
                          "conventionalPosition": {
                            "description": "Position Syntec. Obligatoire pour un CDI ou un CDD.",
                            "oneOf": [
                              {
                                "title": "Cadre",
                                "type": "object",
                                "required": [
                                  "type",
                                  "position"
                                ],
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "CADRE"
                                  },
                                  "position": {
                                    "type": "string",
                                    "enum": [
                                      "1.1",
                                      "1.2",
                                      "2.1 (moins 26 ans)",
                                      "2.1 (au moins 26 ans)",
                                      "2.2",
                                      "2.3",
                                      "3.1",
                                      "3.2",
                                      "3.3"
                                    ]
                                  }
                                }
                              },
                              {
                                "title": "ETAM",
                                "type": "object",
                                "required": [
                                  "type",
                                  "position"
                                ],
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "const": "ETAM"
                                  },
                                  "position": {
                                    "type": "string",
                                    "enum": [
                                      "1.1",
                                      "1.2",
                                      "2.1",
                                      "2.2",
                                      "2.3",
                                      "3.1",
                                      "3.2",
                                      "3.3"
                                    ]
                                  }
                                }
                              }
                            ]
                          },
                          "weekDaysWorked": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 127,
                            "description": "Jours travaillés en masque de bits : 1 lundi, 2 mardi, 4 mercredi, 8 jeudi, 16 vendredi, 32 samedi, 64 dimanche (31 du lundi au vendredi)."
                          },
                          "workSchedule": {
                            "type": "object",
                            "description": "Planning type, jour par jour, cohérent avec la quotité. Sans planning, seuls les jours de `weekDaysWorked` comptent, sans plages horaires.",
                            "required": [
                              "version",
                              "days"
                            ],
                            "properties": {
                              "version": {
                                "type": "integer",
                                "const": 1
                              },
                              "days": {
                                "type": "object",
                                "description": "Jours travaillés (au moins un) ; un jour absent n’est pas travaillé.",
                                "additionalProperties": false,
                                "properties": {
                                  "MONDAY": {
                                    "type": "object",
                                    "required": [
                                      "morning",
                                      "afternoon"
                                    ],
                                    "properties": {
                                      "morning": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      },
                                      "afternoon": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      }
                                    }
                                  },
                                  "TUESDAY": {
                                    "type": "object",
                                    "required": [
                                      "morning",
                                      "afternoon"
                                    ],
                                    "properties": {
                                      "morning": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      },
                                      "afternoon": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      }
                                    }
                                  },
                                  "WEDNESDAY": {
                                    "type": "object",
                                    "required": [
                                      "morning",
                                      "afternoon"
                                    ],
                                    "properties": {
                                      "morning": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      },
                                      "afternoon": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      }
                                    }
                                  },
                                  "THURSDAY": {
                                    "type": "object",
                                    "required": [
                                      "morning",
                                      "afternoon"
                                    ],
                                    "properties": {
                                      "morning": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      },
                                      "afternoon": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      }
                                    }
                                  },
                                  "FRIDAY": {
                                    "type": "object",
                                    "required": [
                                      "morning",
                                      "afternoon"
                                    ],
                                    "properties": {
                                      "morning": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      },
                                      "afternoon": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      }
                                    }
                                  },
                                  "SATURDAY": {
                                    "type": "object",
                                    "required": [
                                      "morning",
                                      "afternoon"
                                    ],
                                    "properties": {
                                      "morning": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      },
                                      "afternoon": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      }
                                    }
                                  },
                                  "SUNDAY": {
                                    "type": "object",
                                    "required": [
                                      "morning",
                                      "afternoon"
                                    ],
                                    "properties": {
                                      "morning": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      },
                                      "afternoon": {
                                        "type": [
                                          "object",
                                          "null"
                                        ],
                                        "required": [
                                          "start",
                                          "end"
                                        ],
                                        "properties": {
                                          "start": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "09:00"
                                          },
                                          "end": {
                                            "type": "string",
                                            "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                            "example": "12:30"
                                          }
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          },
                          "grossAnnualSalary": {
                            "type": "number",
                            "minimum": 0,
                            "description": "Salaire brut annuel en euros, au moins le minimum conventionnel (SMC) et le SMIC au prorata du temps de travail. Obligatoire pour un CDI, un CDD et un mandat social (`422` sinon, `null` compris)."
                          },
                          "hourlyRate": {
                            "type": "number",
                            "minimum": 0,
                            "description": "Stage : gratification horaire en euros, au moins le minimum légal. Obligatoire sauf avec `smoothedMonthlyAmount` (`422` sinon, `null` compris)."
                          },
                          "smoothedMonthlyAmount": {
                            "type": "number",
                            "minimum": 0,
                            "description": "Stage : gratification mensuelle lissée, à la place de `hourlyRate`."
                          },
                          "codePcsEse": {
                            "type": "string",
                            "enum": [
                              "100x",
                              "210x",
                              "220x",
                              "231a",
                              "232a",
                              "233a",
                              "233b",
                              "233c",
                              "233d",
                              "311c",
                              "311d",
                              "311e",
                              "312a",
                              "331a",
                              "332a",
                              "332b",
                              "333a",
                              "333b",
                              "333c",
                              "333d",
                              "333e",
                              "333f",
                              "334a",
                              "335a",
                              "341a",
                              "341b",
                              "342b",
                              "342c",
                              "342d",
                              "342f",
                              "342g",
                              "342h",
                              "343a",
                              "344a",
                              "344b",
                              "344c",
                              "344d",
                              "351a",
                              "352a",
                              "352b",
                              "353a",
                              "353b",
                              "353c",
                              "354a",
                              "354b",
                              "354c",
                              "354e",
                              "354f",
                              "354g",
                              "371a",
                              "372a",
                              "372b",
                              "372c",
                              "372d",
                              "372e",
                              "372f",
                              "373a",
                              "373b",
                              "373c",
                              "373d",
                              "374a",
                              "374b",
                              "374c",
                              "374d",
                              "375a",
                              "375b",
                              "376a",
                              "376b",
                              "376c",
                              "376d",
                              "376e",
                              "376f",
                              "376g",
                              "377a",
                              "380a",
                              "381b",
                              "381c",
                              "382a",
                              "382b",
                              "382c",
                              "382d",
                              "383a",
                              "383b",
                              "383c",
                              "384a",
                              "384b",
                              "384c",
                              "385a",
                              "385b",
                              "385c",
                              "386b",
                              "386c",
                              "386d",
                              "386e",
                              "387a",
                              "387b",
                              "387c",
                              "387d",
                              "387e",
                              "387f",
                              "388a",
                              "388b",
                              "388c",
                              "388d",
                              "388e",
                              "389a",
                              "389b",
                              "389c",
                              "421a",
                              "421b",
                              "422a",
                              "422b",
                              "422c",
                              "422d",
                              "422e",
                              "423a",
                              "423b",
                              "424a",
                              "425a",
                              "431a",
                              "431b",
                              "431c",
                              "431d",
                              "431e",
                              "431f",
                              "432b",
                              "432d",
                              "433a",
                              "433b",
                              "433c",
                              "433d",
                              "434a",
                              "434b",
                              "434c",
                              "434d",
                              "434e",
                              "434f",
                              "434g",
                              "435a",
                              "435b",
                              "441a",
                              "441b",
                              "451a",
                              "451b",
                              "451c",
                              "451d",
                              "451e",
                              "451g",
                              "451h",
                              "452a",
                              "452b",
                              "461b",
                              "461c",
                              "461d",
                              "461e",
                              "461f",
                              "462a",
                              "462b",
                              "462c",
                              "462d",
                              "462e",
                              "463a",
                              "463b",
                              "463c",
                              "463d",
                              "463e",
                              "464a",
                              "464b",
                              "465a",
                              "465b",
                              "465c",
                              "466a",
                              "466b",
                              "466c",
                              "467a",
                              "467b",
                              "467c",
                              "467d",
                              "468a",
                              "468b",
                              "471a",
                              "471b",
                              "472a",
                              "472b",
                              "472c",
                              "472d",
                              "473a",
                              "473b",
                              "473c",
                              "474a",
                              "474b",
                              "474c",
                              "475a",
                              "475b",
                              "476a",
                              "476b",
                              "477a",
                              "477b",
                              "477c",
                              "477d",
                              "478a",
                              "478b",
                              "478c",
                              "478d",
                              "479a",
                              "479b",
                              "480a",
                              "480b",
                              "481a",
                              "481b",
                              "482a",
                              "483a",
                              "484a",
                              "484b",
                              "485a",
                              "485b",
                              "486b",
                              "486c",
                              "486d",
                              "486e",
                              "487a",
                              "487b",
                              "488a",
                              "488b",
                              "521a",
                              "521b",
                              "522a",
                              "523a",
                              "523b",
                              "523c",
                              "523d",
                              "524a",
                              "524b",
                              "524c",
                              "524d",
                              "525a",
                              "525b",
                              "525c",
                              "525d",
                              "526a",
                              "526b",
                              "526c",
                              "526d",
                              "526e",
                              "531a",
                              "531b",
                              "531c",
                              "532a",
                              "532b",
                              "532c",
                              "533a",
                              "533b",
                              "533c",
                              "534a",
                              "534b",
                              "541b",
                              "541c",
                              "541d",
                              "542a",
                              "542b",
                              "543b",
                              "543c",
                              "543e",
                              "543f",
                              "543g",
                              "543h",
                              "544a",
                              "545a",
                              "545b",
                              "545c",
                              "545d",
                              "546a",
                              "546b",
                              "546c",
                              "546d",
                              "546e",
                              "551a",
                              "552a",
                              "553b",
                              "553c",
                              "554a",
                              "554b",
                              "554c",
                              "554d",
                              "554e",
                              "554f",
                              "554g",
                              "554h",
                              "554j",
                              "555a",
                              "556a",
                              "561b",
                              "561c",
                              "561d",
                              "561e",
                              "561f",
                              "562a",
                              "562b",
                              "563a",
                              "563b",
                              "563c",
                              "564a",
                              "564b",
                              "621a",
                              "621b",
                              "621c",
                              "621d",
                              "621e",
                              "621f",
                              "621g",
                              "622a",
                              "622c",
                              "622d",
                              "622e",
                              "622f",
                              "622g",
                              "623a",
                              "623b",
                              "623d",
                              "623e",
                              "623f",
                              "623g",
                              "624b",
                              "624c",
                              "624d",
                              "624e",
                              "624f",
                              "624g",
                              "625a",
                              "625b",
                              "625c",
                              "625d",
                              "625f",
                              "625g",
                              "625h",
                              "626a",
                              "626b",
                              "626c",
                              "627a",
                              "627b",
                              "627c",
                              "627d",
                              "627e",
                              "627f",
                              "628a",
                              "628b",
                              "628c",
                              "628d",
                              "628e",
                              "628f",
                              "628g",
                              "631a",
                              "632a",
                              "632b",
                              "632c",
                              "632d",
                              "632e",
                              "632f",
                              "632g",
                              "632h",
                              "632j",
                              "632k",
                              "633a",
                              "633b",
                              "633c",
                              "633d",
                              "634a",
                              "634b",
                              "634c",
                              "634d",
                              "635a",
                              "636a",
                              "636b",
                              "636c",
                              "636d",
                              "637a",
                              "637b",
                              "637c",
                              "637d",
                              "641a",
                              "641b",
                              "642a",
                              "642b",
                              "643a",
                              "644a",
                              "651a",
                              "651b",
                              "652a",
                              "652b",
                              "653a",
                              "654b",
                              "654c",
                              "655a",
                              "656b",
                              "656c",
                              "671a",
                              "671c",
                              "671d",
                              "672a",
                              "673a",
                              "673b",
                              "673c",
                              "674a",
                              "674b",
                              "674c",
                              "674d",
                              "674e",
                              "675a",
                              "675b",
                              "675c",
                              "676a",
                              "676b",
                              "676c",
                              "676d",
                              "676e",
                              "681a",
                              "681b",
                              "682a",
                              "683a",
                              "684a",
                              "684b",
                              "685a",
                              "691a",
                              "691b",
                              "691c",
                              "691d",
                              "691e",
                              "691f",
                              "692a",
                              "9999"
                            ],
                            "description": "Code PCS-ESE de l’emploi (nomenclature INSEE).",
                            "example": "388a"
                          },
                          "mealVoucherStatus": {
                            "type": "string",
                            "enum": [
                              "DEFAULT",
                              "DISABLED"
                            ],
                            "description": "- `DEFAULT` : Suit le paramétrage entreprise\n- `DISABLED` : Désactivé"
                          },
                          "remoteWorkAllowanceStatus": {
                            "type": "string",
                            "enum": [
                              "DEFAULT",
                              "DISABLED"
                            ],
                            "description": "- `DEFAULT` : Suit le paramétrage entreprise\n- `DISABLED` : Désactivé"
                          },
                          "remoteWorkWeeklyDays": {
                            "type": [
                              "integer",
                              "null"
                            ],
                            "minimum": 0,
                            "maximum": 7,
                            "description": "Jours de télétravail par semaine, quand l’indemnité de télétravail l’exige."
                          },
                          "mealAllowanceType": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "enum": [
                              "ON_SITE",
                              "OFF_SITE",
                              "TRAVEL_RESTAURANT",
                              null
                            ],
                            "description": "- `ON_SITE` : Repas sur le lieu de travail\n- `OFF_SITE` : Repas hors des locaux\n- `TRAVEL_RESTAURANT` : Repas au restaurant en déplacement"
                          },
                          "workPlace": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "description": "Lieu de travail effectif, s’il diffère de l’adresse de l’établissement. Code INSEE requis en France ; Mayotte non prise en charge.",
                            "required": [
                              "address",
                              "addressDetails",
                              "postalCode",
                              "city",
                              "countryCode",
                              "inseeCode"
                            ],
                            "properties": {
                              "address": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 250
                              },
                              "addressDetails": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "maxLength": 250
                              },
                              "postalCode": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 10
                              },
                              "city": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "countryCode": {
                                "type": "string",
                                "enum": [
                                  "FR",
                                  "GP",
                                  "BL",
                                  "MF",
                                  "MQ",
                                  "GF",
                                  "RE",
                                  "PM",
                                  "YT",
                                  "WF",
                                  "PF",
                                  "NC",
                                  "MC",
                                  "AF",
                                  "AL",
                                  "DZ",
                                  "AD",
                                  "AO",
                                  "AG",
                                  "AR",
                                  "AM",
                                  "AU",
                                  "AT",
                                  "AZ",
                                  "BS",
                                  "BH",
                                  "BD",
                                  "BB",
                                  "BY",
                                  "BE",
                                  "BZ",
                                  "BJ",
                                  "BT",
                                  "BO",
                                  "BA",
                                  "BW",
                                  "BR",
                                  "BN",
                                  "BG",
                                  "BF",
                                  "BI",
                                  "CV",
                                  "KH",
                                  "CM",
                                  "CA",
                                  "CF",
                                  "TD",
                                  "CL",
                                  "CN",
                                  "CO",
                                  "KM",
                                  "CD",
                                  "CG",
                                  "CR",
                                  "CI",
                                  "HR",
                                  "CU",
                                  "CY",
                                  "CZ",
                                  "DK",
                                  "DJ",
                                  "DM",
                                  "DO",
                                  "EC",
                                  "EG",
                                  "SV",
                                  "GQ",
                                  "ER",
                                  "EE",
                                  "SZ",
                                  "ET",
                                  "FJ",
                                  "FI",
                                  "GA",
                                  "GM",
                                  "GE",
                                  "DE",
                                  "GH",
                                  "GR",
                                  "GD",
                                  "GT",
                                  "GN",
                                  "GW",
                                  "GY",
                                  "HT",
                                  "HN",
                                  "HU",
                                  "IS",
                                  "IN",
                                  "ID",
                                  "IR",
                                  "IQ",
                                  "IE",
                                  "IL",
                                  "IT",
                                  "JM",
                                  "JP",
                                  "JO",
                                  "KZ",
                                  "KE",
                                  "KI",
                                  "KP",
                                  "KR",
                                  "KW",
                                  "KG",
                                  "LA",
                                  "LV",
                                  "LB",
                                  "LS",
                                  "LR",
                                  "LY",
                                  "LI",
                                  "LT",
                                  "LU",
                                  "MG",
                                  "MW",
                                  "MY",
                                  "MV",
                                  "ML",
                                  "MT",
                                  "MH",
                                  "MR",
                                  "MU",
                                  "MX",
                                  "FM",
                                  "MD",
                                  "MN",
                                  "ME",
                                  "MA",
                                  "MZ",
                                  "MM",
                                  "NA",
                                  "NR",
                                  "NP",
                                  "NL",
                                  "NZ",
                                  "NI",
                                  "NE",
                                  "NG",
                                  "NO",
                                  "OM",
                                  "PK",
                                  "PW",
                                  "PS",
                                  "PA",
                                  "PG",
                                  "PY",
                                  "PE",
                                  "PH",
                                  "PL",
                                  "PT",
                                  "QA",
                                  "RO",
                                  "RU",
                                  "RW",
                                  "KN",
                                  "LC",
                                  "VC",
                                  "WS",
                                  "SM",
                                  "ST",
                                  "SA",
                                  "SN",
                                  "RS",
                                  "SC",
                                  "SL",
                                  "SG",
                                  "SK",
                                  "SI",
                                  "SB",
                                  "SO",
                                  "ZA",
                                  "SS",
                                  "ES",
                                  "LK",
                                  "SD",
                                  "SR",
                                  "SE",
                                  "CH",
                                  "SY",
                                  "TW",
                                  "TJ",
                                  "TZ",
                                  "TH",
                                  "TL",
                                  "TG",
                                  "TO",
                                  "TT",
                                  "TN",
                                  "TR",
                                  "TM",
                                  "TV",
                                  "UG",
                                  "UA",
                                  "AE",
                                  "GB",
                                  "US",
                                  "UY",
                                  "UZ",
                                  "VU",
                                  "VE",
                                  "VN",
                                  "YE",
                                  "ZM",
                                  "ZW"
                                ]
                              },
                              "inseeCode": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "pattern": "^(\\d{5}|2[ABab]\\d{3})$",
                                "description": "Code officiel géographique de la commune (2A / 2B pour la Corse)."
                              }
                            }
                          },
                          "applyJeiExoneration": {
                            "type": "boolean",
                            "description": "Appliquer l’exonération JEI."
                          },
                          "applyAcreExoneration": {
                            "type": "boolean",
                            "description": "Appliquer l’exonération ACRE."
                          }
                        }
                      },
                      "apprenticeshipFormationLevel": {
                        "type": "string",
                        "enum": [
                          "03",
                          "04",
                          "05",
                          "06",
                          "07",
                          "08"
                        ],
                        "description": "Contrat d’apprentissage uniquement : niveau du diplôme préparé, obligatoire.\n\n- `03` : 03 - Niveau de formation équivalent au CAP (certificat d'aptitude professionnelle) ou au BEP (brevet d'études professionnelles)\n- `04` : 04 - Formation de niveau du bac (général, technologique ou professionnel), du brevet de technicien (BT) ou du brevet professionnel\n- `05` : 05 - Formation de niveau bac+2 : licence 2, BTS (brevet de technicien supérieur), DUT (diplôme universitaire de technologie), etc.\n- `06` : 06 - Formation de niveau bac+3 et bac+4 : licence 3, licence professionnelle, master 1, etc.\n- `07` : 07 - Formation de niveau bac+5 : master 2, diplôme d'études approfondies, diplôme d'études supérieures spécialisées, diplôme d'ingénieur, etc.\n- `08` : 08 - Formation de niveau bac+8 : doctorat, habilitation à diriger des recherches, etc."
                      },
                      "apprenticeshipFormationYearsPeriods": {
                        "type": "object",
                        "description": "Apprentissage uniquement : périodes des années de formation, au moins une (absente ou `null` : non suivie). Consécutives, sans chevauchement, du début à la fin du contrat.",
                        "properties": {
                          "FIRST_YEAR": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "required": [
                              "startDate",
                              "endDate"
                            ],
                            "properties": {
                              "startDate": {
                                "type": "string",
                                "format": "date",
                                "description": "Début de l’année de formation."
                              },
                              "endDate": {
                                "type": "string",
                                "format": "date",
                                "description": "Fin de l’année de formation, au plus tôt son début."
                              }
                            }
                          },
                          "SECOND_YEAR": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "required": [
                              "startDate",
                              "endDate"
                            ],
                            "properties": {
                              "startDate": {
                                "type": "string",
                                "format": "date",
                                "description": "Début de l’année de formation."
                              },
                              "endDate": {
                                "type": "string",
                                "format": "date",
                                "description": "Fin de l’année de formation, au plus tôt son début."
                              }
                            }
                          },
                          "THIRD_YEAR": {
                            "type": [
                              "object",
                              "null"
                            ],
                            "required": [
                              "startDate",
                              "endDate"
                            ],
                            "properties": {
                              "startDate": {
                                "type": "string",
                                "format": "date",
                                "description": "Début de l’année de formation."
                              },
                              "endDate": {
                                "type": "string",
                                "format": "date",
                                "description": "Fin de l’année de formation, au plus tôt son début."
                              }
                            }
                          }
                        }
                      },
                      "amendments": {
                        "type": "array",
                        "description": "Apprentissage uniquement, obligatoire : un avenant par année de `apprenticeshipFormationYearsPeriods`, commençant au début de cette année.",
                        "items": {
                          "type": "object",
                          "description": "Conditions d’une année de formation, applicables à sa date de début.",
                          "required": [
                            "isCadre",
                            "quotity",
                            "conventionalWorkerStatus",
                            "workerOutsideFranceStatus",
                            "weekDaysWorked",
                            "codePcsEse",
                            "remunerationPercentage",
                            "remunerationReference",
                            "apprenticeshipFormationYear"
                          ],
                          "properties": {
                            "isCadre": {
                              "type": "boolean",
                              "description": "Statut cadre (retraite complémentaire) : `true` en position `CADRE`, `false` en `ETAM`. Doit concorder avec `conventionalWorkerStatus` et la population de la prévoyance."
                            },
                            "quotity": {
                              "description": "Temps de travail du contrat. La forme dépend de `type`.",
                              "oneOf": [
                                {
                                  "title": "Heures",
                                  "type": "object",
                                  "required": [
                                    "type",
                                    "monthlyWorkingHours",
                                    "workingPercentage",
                                    "paidContractualOvertimeHours",
                                    "rttContractualOvertimeHours",
                                    "rcrContractualOvertimeHours"
                                  ],
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "HEURE"
                                    },
                                    "monthlyWorkingHours": {
                                      "type": "number",
                                      "minimum": 0,
                                      "description": "Heures mensuelles, 151.67 pour un temps plein."
                                    },
                                    "workingPercentage": {
                                      "type": "number",
                                      "minimum": 1,
                                      "maximum": 100,
                                      "description": "Pourcentage d’un temps plein."
                                    },
                                    "paidContractualOvertimeHours": {
                                      "type": "number",
                                      "minimum": 0,
                                      "description": "Heures supplémentaires contractuelles payées, par semaine. Interdites à temps partiel."
                                    },
                                    "rttContractualOvertimeHours": {
                                      "type": "number",
                                      "minimum": 0,
                                      "description": "Heures supplémentaires contractuelles compensées en RTT, par semaine. Exige des JRTT paramétrés dans l’entreprise."
                                    },
                                    "rcrContractualOvertimeHours": {
                                      "type": "number",
                                      "minimum": 0,
                                      "description": "Heures supplémentaires contractuelles compensées en repos, par semaine."
                                    },
                                    "isCeilingProrated": {
                                      "type": "boolean",
                                      "description": "Temps partiel : plafond de la sécurité sociale proratisé à hauteur de la quotité. Absent : `true`. `false` quand le salarié et l’employeur renoncent à la proratisation pour cotiser comme à temps plein."
                                    }
                                  }
                                },
                                {
                                  "title": "Forfait jours",
                                  "type": "object",
                                  "required": [
                                    "type",
                                    "forfaitDailyAmount",
                                    "monthlyWorkingDays",
                                    "workingPercentage"
                                  ],
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "FORFAIT_JOUR"
                                    },
                                    "forfaitDailyAmount": {
                                      "type": "number",
                                      "minimum": 0,
                                      "description": "Nombre de jours travaillés par an (218 pour un forfait complet)."
                                    },
                                    "monthlyWorkingDays": {
                                      "type": "number",
                                      "minimum": 0,
                                      "description": "Jours travaillés par mois."
                                    },
                                    "workingPercentage": {
                                      "type": "number",
                                      "minimum": 1,
                                      "maximum": 100
                                    },
                                    "isCeilingProrated": {
                                      "type": "boolean",
                                      "description": "Forfait jours réduit : plafond de la sécurité sociale proratisé à hauteur des jours du forfait (jours / 218). Absent : `false`, un forfait jours réduit garde un plafond entier. `true` suppose le consentement du salarié."
                                    }
                                  }
                                },
                                {
                                  "title": "Forfait heures",
                                  "type": "object",
                                  "required": [
                                    "type",
                                    "period",
                                    "forfaitHours",
                                    "monthlyWorkingHours",
                                    "annualWorkingDaysCap",
                                    "workingPercentage"
                                  ],
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "FORFAIT_HEURE"
                                    },
                                    "period": {
                                      "type": "string",
                                      "enum": [
                                        "WEEKLY",
                                        "MONTHLY",
                                        "YEARLY"
                                      ],
                                      "description": "Seul le forfait hebdomadaire `WEEKLY` est accepté."
                                    },
                                    "forfaitHours": {
                                      "type": "number",
                                      "minimum": 0,
                                      "description": "Heures du forfait par semaine, au-delà de la durée légale de 35 heures."
                                    },
                                    "monthlyWorkingHours": {
                                      "type": "number",
                                      "minimum": 0
                                    },
                                    "annualWorkingDaysCap": {
                                      "type": "number",
                                      "minimum": 1,
                                      "maximum": 365
                                    },
                                    "workingPercentage": {
                                      "type": "number",
                                      "const": 100,
                                      "description": "Le forfait heures réduit n’est pas pris en charge."
                                    }
                                  }
                                },
                                {
                                  "title": "Non concerné",
                                  "type": "object",
                                  "required": [
                                    "type"
                                  ],
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "NON_CONCERNE"
                                    }
                                  }
                                }
                              ]
                            },
                            "conventionalWorkerStatus": {
                              "type": "string",
                              "enum": [
                                "01",
                                "02",
                                "03",
                                "04",
                                "05",
                                "06",
                                "07",
                                "08",
                                "09",
                                "10"
                              ],
                              "description": "Statut conventionnel DSN, en général `04` cadre, `03` cadre dirigeant ou mandataire social, `07` stagiaire, `05` sinon. `03` et `04` exigent `\"isCadre\": true` ; `05` à `07`, `false`.\n\n- `01` : 01 - agriculteur salarié de son exploitation\n- `02` : 02 - artisan ou commerçant salarié de son entreprise\n- `03` : 03 - cadre dirigeant (votant au collège employeur des élections prud'homales)\n- `04` : 04 - autres cadres au sens de la convention collective (ou du statut pour les régimes spéciaux)\n- `05` : 05 - profession intermédiaire (technicien, contremaître, agent de maîtrise, clergé)\n- `06` : 06 - employé administratif d'entreprise, de commerce, agent de service\n- `07` : 07 - ouvriers qualifiés et non qualifiés y compris ouvriers agricoles\n- `08` : 08 - agent de la fonction publique d'Etat\n- `09` : 09 - agent de la fonction publique hospitalière\n- `10` : 10 - agent de la fonction publique territoriale"
                            },
                            "workerOutsideFranceStatus": {
                              "type": "string",
                              "enum": [
                                "01",
                                "02",
                                "03",
                                "99"
                              ],
                              "description": "Statut d’expatriation déclaré en DSN, `99` hors expatriation.\n\n- `01` : 01 - Détaché\n- `02` : 02 - Expatrié\n- `03` : 03 - Frontalier\n- `99` : 99 - Non concerné"
                            },
                            "conventionalPosition": {
                              "description": "Position Syntec. Obligatoire pour un CDI ou un CDD.",
                              "oneOf": [
                                {
                                  "title": "Cadre",
                                  "type": "object",
                                  "required": [
                                    "type",
                                    "position"
                                  ],
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "CADRE"
                                    },
                                    "position": {
                                      "type": "string",
                                      "enum": [
                                        "1.1",
                                        "1.2",
                                        "2.1 (moins 26 ans)",
                                        "2.1 (au moins 26 ans)",
                                        "2.2",
                                        "2.3",
                                        "3.1",
                                        "3.2",
                                        "3.3"
                                      ]
                                    }
                                  }
                                },
                                {
                                  "title": "ETAM",
                                  "type": "object",
                                  "required": [
                                    "type",
                                    "position"
                                  ],
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "ETAM"
                                    },
                                    "position": {
                                      "type": "string",
                                      "enum": [
                                        "1.1",
                                        "1.2",
                                        "2.1",
                                        "2.2",
                                        "2.3",
                                        "3.1",
                                        "3.2",
                                        "3.3"
                                      ]
                                    }
                                  }
                                }
                              ]
                            },
                            "weekDaysWorked": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 127,
                              "description": "Jours travaillés en masque de bits : 1 lundi, 2 mardi, 4 mercredi, 8 jeudi, 16 vendredi, 32 samedi, 64 dimanche (31 du lundi au vendredi)."
                            },
                            "workSchedule": {
                              "type": "object",
                              "description": "Planning type, jour par jour, cohérent avec la quotité. Sans planning, seuls les jours de `weekDaysWorked` comptent, sans plages horaires.",
                              "required": [
                                "version",
                                "days"
                              ],
                              "properties": {
                                "version": {
                                  "type": "integer",
                                  "const": 1
                                },
                                "days": {
                                  "type": "object",
                                  "description": "Jours travaillés (au moins un) ; un jour absent n’est pas travaillé.",
                                  "additionalProperties": false,
                                  "properties": {
                                    "MONDAY": {
                                      "type": "object",
                                      "required": [
                                        "morning",
                                        "afternoon"
                                      ],
                                      "properties": {
                                        "morning": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        },
                                        "afternoon": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        }
                                      }
                                    },
                                    "TUESDAY": {
                                      "type": "object",
                                      "required": [
                                        "morning",
                                        "afternoon"
                                      ],
                                      "properties": {
                                        "morning": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        },
                                        "afternoon": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        }
                                      }
                                    },
                                    "WEDNESDAY": {
                                      "type": "object",
                                      "required": [
                                        "morning",
                                        "afternoon"
                                      ],
                                      "properties": {
                                        "morning": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        },
                                        "afternoon": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        }
                                      }
                                    },
                                    "THURSDAY": {
                                      "type": "object",
                                      "required": [
                                        "morning",
                                        "afternoon"
                                      ],
                                      "properties": {
                                        "morning": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        },
                                        "afternoon": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        }
                                      }
                                    },
                                    "FRIDAY": {
                                      "type": "object",
                                      "required": [
                                        "morning",
                                        "afternoon"
                                      ],
                                      "properties": {
                                        "morning": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        },
                                        "afternoon": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        }
                                      }
                                    },
                                    "SATURDAY": {
                                      "type": "object",
                                      "required": [
                                        "morning",
                                        "afternoon"
                                      ],
                                      "properties": {
                                        "morning": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        },
                                        "afternoon": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        }
                                      }
                                    },
                                    "SUNDAY": {
                                      "type": "object",
                                      "required": [
                                        "morning",
                                        "afternoon"
                                      ],
                                      "properties": {
                                        "morning": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        },
                                        "afternoon": {
                                          "type": [
                                            "object",
                                            "null"
                                          ],
                                          "required": [
                                            "start",
                                            "end"
                                          ],
                                          "properties": {
                                            "start": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "09:00"
                                            },
                                            "end": {
                                              "type": "string",
                                              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                              "example": "12:30"
                                            }
                                          }
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            },
                            "grossAnnualSalary": {
                              "type": "number",
                              "minimum": 0,
                              "description": "Salaire brut annuel en euros, au moins le minimum conventionnel (SMC) et le SMIC au prorata du temps de travail. Obligatoire pour un CDI, un CDD et un mandat social (`422` sinon, `null` compris)."
                            },
                            "hourlyRate": {
                              "type": "number",
                              "minimum": 0,
                              "description": "Stage : gratification horaire en euros, au moins le minimum légal. Obligatoire sauf avec `smoothedMonthlyAmount` (`422` sinon, `null` compris)."
                            },
                            "smoothedMonthlyAmount": {
                              "type": "number",
                              "minimum": 0,
                              "description": "Stage : gratification mensuelle lissée, à la place de `hourlyRate`."
                            },
                            "codePcsEse": {
                              "type": "string",
                              "enum": [
                                "100x",
                                "210x",
                                "220x",
                                "231a",
                                "232a",
                                "233a",
                                "233b",
                                "233c",
                                "233d",
                                "311c",
                                "311d",
                                "311e",
                                "312a",
                                "331a",
                                "332a",
                                "332b",
                                "333a",
                                "333b",
                                "333c",
                                "333d",
                                "333e",
                                "333f",
                                "334a",
                                "335a",
                                "341a",
                                "341b",
                                "342b",
                                "342c",
                                "342d",
                                "342f",
                                "342g",
                                "342h",
                                "343a",
                                "344a",
                                "344b",
                                "344c",
                                "344d",
                                "351a",
                                "352a",
                                "352b",
                                "353a",
                                "353b",
                                "353c",
                                "354a",
                                "354b",
                                "354c",
                                "354e",
                                "354f",
                                "354g",
                                "371a",
                                "372a",
                                "372b",
                                "372c",
                                "372d",
                                "372e",
                                "372f",
                                "373a",
                                "373b",
                                "373c",
                                "373d",
                                "374a",
                                "374b",
                                "374c",
                                "374d",
                                "375a",
                                "375b",
                                "376a",
                                "376b",
                                "376c",
                                "376d",
                                "376e",
                                "376f",
                                "376g",
                                "377a",
                                "380a",
                                "381b",
                                "381c",
                                "382a",
                                "382b",
                                "382c",
                                "382d",
                                "383a",
                                "383b",
                                "383c",
                                "384a",
                                "384b",
                                "384c",
                                "385a",
                                "385b",
                                "385c",
                                "386b",
                                "386c",
                                "386d",
                                "386e",
                                "387a",
                                "387b",
                                "387c",
                                "387d",
                                "387e",
                                "387f",
                                "388a",
                                "388b",
                                "388c",
                                "388d",
                                "388e",
                                "389a",
                                "389b",
                                "389c",
                                "421a",
                                "421b",
                                "422a",
                                "422b",
                                "422c",
                                "422d",
                                "422e",
                                "423a",
                                "423b",
                                "424a",
                                "425a",
                                "431a",
                                "431b",
                                "431c",
                                "431d",
                                "431e",
                                "431f",
                                "432b",
                                "432d",
                                "433a",
                                "433b",
                                "433c",
                                "433d",
                                "434a",
                                "434b",
                                "434c",
                                "434d",
                                "434e",
                                "434f",
                                "434g",
                                "435a",
                                "435b",
                                "441a",
                                "441b",
                                "451a",
                                "451b",
                                "451c",
                                "451d",
                                "451e",
                                "451g",
                                "451h",
                                "452a",
                                "452b",
                                "461b",
                                "461c",
                                "461d",
                                "461e",
                                "461f",
                                "462a",
                                "462b",
                                "462c",
                                "462d",
                                "462e",
                                "463a",
                                "463b",
                                "463c",
                                "463d",
                                "463e",
                                "464a",
                                "464b",
                                "465a",
                                "465b",
                                "465c",
                                "466a",
                                "466b",
                                "466c",
                                "467a",
                                "467b",
                                "467c",
                                "467d",
                                "468a",
                                "468b",
                                "471a",
                                "471b",
                                "472a",
                                "472b",
                                "472c",
                                "472d",
                                "473a",
                                "473b",
                                "473c",
                                "474a",
                                "474b",
                                "474c",
                                "475a",
                                "475b",
                                "476a",
                                "476b",
                                "477a",
                                "477b",
                                "477c",
                                "477d",
                                "478a",
                                "478b",
                                "478c",
                                "478d",
                                "479a",
                                "479b",
                                "480a",
                                "480b",
                                "481a",
                                "481b",
                                "482a",
                                "483a",
                                "484a",
                                "484b",
                                "485a",
                                "485b",
                                "486b",
                                "486c",
                                "486d",
                                "486e",
                                "487a",
                                "487b",
                                "488a",
                                "488b",
                                "521a",
                                "521b",
                                "522a",
                                "523a",
                                "523b",
                                "523c",
                                "523d",
                                "524a",
                                "524b",
                                "524c",
                                "524d",
                                "525a",
                                "525b",
                                "525c",
                                "525d",
                                "526a",
                                "526b",
                                "526c",
                                "526d",
                                "526e",
                                "531a",
                                "531b",
                                "531c",
                                "532a",
                                "532b",
                                "532c",
                                "533a",
                                "533b",
                                "533c",
                                "534a",
                                "534b",
                                "541b",
                                "541c",
                                "541d",
                                "542a",
                                "542b",
                                "543b",
                                "543c",
                                "543e",
                                "543f",
                                "543g",
                                "543h",
                                "544a",
                                "545a",
                                "545b",
                                "545c",
                                "545d",
                                "546a",
                                "546b",
                                "546c",
                                "546d",
                                "546e",
                                "551a",
                                "552a",
                                "553b",
                                "553c",
                                "554a",
                                "554b",
                                "554c",
                                "554d",
                                "554e",
                                "554f",
                                "554g",
                                "554h",
                                "554j",
                                "555a",
                                "556a",
                                "561b",
                                "561c",
                                "561d",
                                "561e",
                                "561f",
                                "562a",
                                "562b",
                                "563a",
                                "563b",
                                "563c",
                                "564a",
                                "564b",
                                "621a",
                                "621b",
                                "621c",
                                "621d",
                                "621e",
                                "621f",
                                "621g",
                                "622a",
                                "622c",
                                "622d",
                                "622e",
                                "622f",
                                "622g",
                                "623a",
                                "623b",
                                "623d",
                                "623e",
                                "623f",
                                "623g",
                                "624b",
                                "624c",
                                "624d",
                                "624e",
                                "624f",
                                "624g",
                                "625a",
                                "625b",
                                "625c",
                                "625d",
                                "625f",
                                "625g",
                                "625h",
                                "626a",
                                "626b",
                                "626c",
                                "627a",
                                "627b",
                                "627c",
                                "627d",
                                "627e",
                                "627f",
                                "628a",
                                "628b",
                                "628c",
                                "628d",
                                "628e",
                                "628f",
                                "628g",
                                "631a",
                                "632a",
                                "632b",
                                "632c",
                                "632d",
                                "632e",
                                "632f",
                                "632g",
                                "632h",
                                "632j",
                                "632k",
                                "633a",
                                "633b",
                                "633c",
                                "633d",
                                "634a",
                                "634b",
                                "634c",
                                "634d",
                                "635a",
                                "636a",
                                "636b",
                                "636c",
                                "636d",
                                "637a",
                                "637b",
                                "637c",
                                "637d",
                                "641a",
                                "641b",
                                "642a",
                                "642b",
                                "643a",
                                "644a",
                                "651a",
                                "651b",
                                "652a",
                                "652b",
                                "653a",
                                "654b",
                                "654c",
                                "655a",
                                "656b",
                                "656c",
                                "671a",
                                "671c",
                                "671d",
                                "672a",
                                "673a",
                                "673b",
                                "673c",
                                "674a",
                                "674b",
                                "674c",
                                "674d",
                                "674e",
                                "675a",
                                "675b",
                                "675c",
                                "676a",
                                "676b",
                                "676c",
                                "676d",
                                "676e",
                                "681a",
                                "681b",
                                "682a",
                                "683a",
                                "684a",
                                "684b",
                                "685a",
                                "691a",
                                "691b",
                                "691c",
                                "691d",
                                "691e",
                                "691f",
                                "692a",
                                "9999"
                              ],
                              "description": "Code PCS-ESE de l’emploi (nomenclature INSEE).",
                              "example": "388a"
                            },
                            "mealVoucherStatus": {
                              "type": "string",
                              "enum": [
                                "DEFAULT",
                                "DISABLED"
                              ],
                              "description": "- `DEFAULT` : Suit le paramétrage entreprise\n- `DISABLED` : Désactivé"
                            },
                            "remoteWorkAllowanceStatus": {
                              "type": "string",
                              "enum": [
                                "DEFAULT",
                                "DISABLED"
                              ],
                              "description": "- `DEFAULT` : Suit le paramétrage entreprise\n- `DISABLED` : Désactivé"
                            },
                            "remoteWorkWeeklyDays": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "minimum": 0,
                              "maximum": 7,
                              "description": "Jours de télétravail par semaine, quand l’indemnité de télétravail l’exige."
                            },
                            "mealAllowanceType": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "enum": [
                                "ON_SITE",
                                "OFF_SITE",
                                "TRAVEL_RESTAURANT",
                                null
                              ],
                              "description": "- `ON_SITE` : Repas sur le lieu de travail\n- `OFF_SITE` : Repas hors des locaux\n- `TRAVEL_RESTAURANT` : Repas au restaurant en déplacement"
                            },
                            "workPlace": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "description": "Lieu de travail effectif, s’il diffère de l’adresse de l’établissement. Code INSEE requis en France ; Mayotte non prise en charge.",
                              "required": [
                                "address",
                                "addressDetails",
                                "postalCode",
                                "city",
                                "countryCode",
                                "inseeCode"
                              ],
                              "properties": {
                                "address": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 250
                                },
                                "addressDetails": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "maxLength": 250
                                },
                                "postalCode": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 10
                                },
                                "city": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "countryCode": {
                                  "type": "string",
                                  "enum": [
                                    "FR",
                                    "GP",
                                    "BL",
                                    "MF",
                                    "MQ",
                                    "GF",
                                    "RE",
                                    "PM",
                                    "YT",
                                    "WF",
                                    "PF",
                                    "NC",
                                    "MC",
                                    "AF",
                                    "AL",
                                    "DZ",
                                    "AD",
                                    "AO",
                                    "AG",
                                    "AR",
                                    "AM",
                                    "AU",
                                    "AT",
                                    "AZ",
                                    "BS",
                                    "BH",
                                    "BD",
                                    "BB",
                                    "BY",
                                    "BE",
                                    "BZ",
                                    "BJ",
                                    "BT",
                                    "BO",
                                    "BA",
                                    "BW",
                                    "BR",
                                    "BN",
                                    "BG",
                                    "BF",
                                    "BI",
                                    "CV",
                                    "KH",
                                    "CM",
                                    "CA",
                                    "CF",
                                    "TD",
                                    "CL",
                                    "CN",
                                    "CO",
                                    "KM",
                                    "CD",
                                    "CG",
                                    "CR",
                                    "CI",
                                    "HR",
                                    "CU",
                                    "CY",
                                    "CZ",
                                    "DK",
                                    "DJ",
                                    "DM",
                                    "DO",
                                    "EC",
                                    "EG",
                                    "SV",
                                    "GQ",
                                    "ER",
                                    "EE",
                                    "SZ",
                                    "ET",
                                    "FJ",
                                    "FI",
                                    "GA",
                                    "GM",
                                    "GE",
                                    "DE",
                                    "GH",
                                    "GR",
                                    "GD",
                                    "GT",
                                    "GN",
                                    "GW",
                                    "GY",
                                    "HT",
                                    "HN",
                                    "HU",
                                    "IS",
                                    "IN",
                                    "ID",
                                    "IR",
                                    "IQ",
                                    "IE",
                                    "IL",
                                    "IT",
                                    "JM",
                                    "JP",
                                    "JO",
                                    "KZ",
                                    "KE",
                                    "KI",
                                    "KP",
                                    "KR",
                                    "KW",
                                    "KG",
                                    "LA",
                                    "LV",
                                    "LB",
                                    "LS",
                                    "LR",
                                    "LY",
                                    "LI",
                                    "LT",
                                    "LU",
                                    "MG",
                                    "MW",
                                    "MY",
                                    "MV",
                                    "ML",
                                    "MT",
                                    "MH",
                                    "MR",
                                    "MU",
                                    "MX",
                                    "FM",
                                    "MD",
                                    "MN",
                                    "ME",
                                    "MA",
                                    "MZ",
                                    "MM",
                                    "NA",
                                    "NR",
                                    "NP",
                                    "NL",
                                    "NZ",
                                    "NI",
                                    "NE",
                                    "NG",
                                    "NO",
                                    "OM",
                                    "PK",
                                    "PW",
                                    "PS",
                                    "PA",
                                    "PG",
                                    "PY",
                                    "PE",
                                    "PH",
                                    "PL",
                                    "PT",
                                    "QA",
                                    "RO",
                                    "RU",
                                    "RW",
                                    "KN",
                                    "LC",
                                    "VC",
                                    "WS",
                                    "SM",
                                    "ST",
                                    "SA",
                                    "SN",
                                    "RS",
                                    "SC",
                                    "SL",
                                    "SG",
                                    "SK",
                                    "SI",
                                    "SB",
                                    "SO",
                                    "ZA",
                                    "SS",
                                    "ES",
                                    "LK",
                                    "SD",
                                    "SR",
                                    "SE",
                                    "CH",
                                    "SY",
                                    "TW",
                                    "TJ",
                                    "TZ",
                                    "TH",
                                    "TL",
                                    "TG",
                                    "TO",
                                    "TT",
                                    "TN",
                                    "TR",
                                    "TM",
                                    "TV",
                                    "UG",
                                    "UA",
                                    "AE",
                                    "GB",
                                    "US",
                                    "UY",
                                    "UZ",
                                    "VU",
                                    "VE",
                                    "VN",
                                    "YE",
                                    "ZM",
                                    "ZW"
                                  ]
                                },
                                "inseeCode": {
                                  "type": [
                                    "string",
                                    "null"
                                  ],
                                  "pattern": "^(\\d{5}|2[ABab]\\d{3})$",
                                  "description": "Code officiel géographique de la commune (2A / 2B pour la Corse)."
                                }
                              }
                            },
                            "applyJeiExoneration": {
                              "type": "boolean",
                              "description": "Appliquer l’exonération JEI."
                            },
                            "applyAcreExoneration": {
                              "type": "boolean",
                              "description": "Appliquer l’exonération ACRE."
                            },
                            "remunerationPercentage": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1000,
                              "description": "Rémunération en pourcentage de `remunerationReference`."
                            },
                            "remunerationReference": {
                              "type": "string",
                              "enum": [
                                "SMIC",
                                "SMC"
                              ],
                              "description": "- `SMIC` : SMIC\n- `SMC` : Minimum conventionnel (SMC)"
                            },
                            "apprenticeshipFormationYear": {
                              "type": "string",
                              "enum": [
                                "FIRST_YEAR",
                                "SECOND_YEAR",
                                "THIRD_YEAR"
                              ],
                              "description": "- `FIRST_YEAR` : Première année\n- `SECOND_YEAR` : Deuxième année\n- `THIRD_YEAR` : Troisième année"
                            }
                          }
                        }
                      },
                      "apprenticeshipCalendar": {
                        "type": "object",
                        "description": "Contrat d’apprentissage uniquement : calendrier de formation.",
                        "required": [
                          "schoolDays"
                        ],
                        "properties": {
                          "endDate": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "date",
                            "description": "Date jusqu’à laquelle le calendrier est connu."
                          },
                          "schoolDays": {
                            "type": "array",
                            "maxItems": 1500,
                            "items": {
                              "type": "string",
                              "format": "date"
                            },
                            "description": "Jours passés en formation."
                          }
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "foreignErpId": "salarie-123",
                "identity": {
                  "firstName": "Camille",
                  "lastName": "Durand",
                  "birthDate": "1991-06-14",
                  "birthCountryCode": "FR",
                  "birthCity": "Nantes",
                  "birthDepartmentCode": "44",
                  "nationality": "FR"
                },
                "contact": {
                  "address": "12 rue de la Paix",
                  "postalCode": "75002",
                  "city": "Paris",
                  "countryCode": "FR",
                  "personalEmail": "camille.durand@example.com",
                  "professionalEmail": "camille.durand@entreprise.fr"
                },
                "socialSecurityNumber": "2910644123456",
                "isBoeth": false,
                "dependentChildrenCount": 0,
                "iban": "FR7630004000031234567890143",
                "bic": "BNPAFRPPXXX",
                "contract": {
                  "workerType": "EMPLOYEE_CDI",
                  "startDate": "2026-11-02",
                  "establishmentSiret": "55210055400013",
                  "companyRoleName": "Développeuse backend",
                  "companyTeamName": "Plateforme",
                  "managerId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
                  "trialPeriodEndDate": "2027-03-01",
                  "dpaeDoneByPuncto": true,
                  "amendment": {
                    "isCadre": true,
                    "quotity": {
                      "type": "HEURE",
                      "monthlyWorkingHours": 151.67,
                      "workingPercentage": 100,
                      "paidContractualOvertimeHours": 0,
                      "rttContractualOvertimeHours": 0,
                      "rcrContractualOvertimeHours": 0
                    },
                    "conventionalWorkerStatus": "04",
                    "workerOutsideFranceStatus": "99",
                    "conventionalPosition": {
                      "type": "CADRE",
                      "position": "2.1 (au moins 26 ans)"
                    },
                    "weekDaysWorked": 31,
                    "grossAnnualSalary": 48000,
                    "codePcsEse": "388a"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Collaborateur et contrat créés",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiCreatedCollaborator"
                }
              }
            }
          },
          "400": {
            "description": "Contrat refusé, rien n’est enregistré : salaire sous le minimum, période d’essai invalide, motif de CDD manquant, années de formation incomplètes, statut cadre incohérent, DPAE sans NIR ni NIA, mutuelle ou prévoyance incompatible, désignation introuvable…",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Le salaire brut annuel doit être au moins 42 000 € (minimum applicable : 3 500 €/mois)"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "description": "Collaborateur déjà présent dans l’entreprise, ou création concurrente en cours",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "string",
                      "description": "Message lisible, en français."
                    },
                    "collaboratorId": {
                      "type": "string",
                      "description": "Collaborateur qui porte déjà ce `foreignErpId` ou ce numéro de sécurité sociale. Absent quand une autre création est en cours dans l’entreprise : réessayez."
                    }
                  }
                },
                "example": {
                  "error": "Le foreignErpId \"salarie-123\" est déjà celui du collaborateur coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY : pour lui créer un nouveau contrat, utilisez POST /public/v1/contracts",
                  "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/collaborators/{collaboratorId}": {
      "get": {
        "operationId": "getCollaborator",
        "tags": [
          "Collaborateurs"
        ],
        "summary": "Consulter un collaborateur",
        "description": "Renvoie la fiche du collaborateur, dont son sexe déduit du numéro. Avant le début d’une embauche, identité et position sont celles du contrat à venir.",
        "parameters": [
          {
            "name": "collaboratorId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du collaborateur.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Collaborateur",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiCollaborator"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "put": {
        "operationId": "updateCollaborator",
        "tags": [
          "Collaborateurs"
        ],
        "summary": "Modifier un collaborateur",
        "description": "Modifie un collaborateur : identité, coordonnées, enfants à charge, numéro de sécurité sociale, mode de paiement, `foreignErpId`, manager. Tout ou rien ; les champs absents ne changent pas. `PATCH` est aussi accepté.",
        "parameters": [
          {
            "name": "collaboratorId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du collaborateur.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Au moins un champ, au format de la création. Les champs absents ne changent pas.",
                "properties": {
                  "identity": {
                    "type": "object",
                    "properties": {
                      "firstName": {
                        "type": "string",
                        "maxLength": 100
                      },
                      "usageFirstName": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "maxLength": 100,
                        "description": "Prénom d’usage. `null` le retire."
                      },
                      "lastName": {
                        "type": "string",
                        "maxLength": 100
                      },
                      "usageLastName": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "maxLength": 100,
                        "description": "Nom d’usage. `null` le retire."
                      },
                      "birthDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date de naissance.",
                        "example": "1991-06-14"
                      },
                      "birthCountryCode": {
                        "type": "string",
                        "enum": [
                          "FR",
                          "GP",
                          "BL",
                          "MF",
                          "MQ",
                          "GF",
                          "RE",
                          "PM",
                          "YT",
                          "WF",
                          "PF",
                          "NC",
                          "MC",
                          "AF",
                          "AL",
                          "DZ",
                          "AD",
                          "AO",
                          "AG",
                          "AR",
                          "AM",
                          "AU",
                          "AT",
                          "AZ",
                          "BS",
                          "BH",
                          "BD",
                          "BB",
                          "BY",
                          "BE",
                          "BZ",
                          "BJ",
                          "BT",
                          "BO",
                          "BA",
                          "BW",
                          "BR",
                          "BN",
                          "BG",
                          "BF",
                          "BI",
                          "CV",
                          "KH",
                          "CM",
                          "CA",
                          "CF",
                          "TD",
                          "CL",
                          "CN",
                          "CO",
                          "KM",
                          "CD",
                          "CG",
                          "CR",
                          "CI",
                          "HR",
                          "CU",
                          "CY",
                          "CZ",
                          "DK",
                          "DJ",
                          "DM",
                          "DO",
                          "EC",
                          "EG",
                          "SV",
                          "GQ",
                          "ER",
                          "EE",
                          "SZ",
                          "ET",
                          "FJ",
                          "FI",
                          "GA",
                          "GM",
                          "GE",
                          "DE",
                          "GH",
                          "GR",
                          "GD",
                          "GT",
                          "GN",
                          "GW",
                          "GY",
                          "HT",
                          "HN",
                          "HU",
                          "IS",
                          "IN",
                          "ID",
                          "IR",
                          "IQ",
                          "IE",
                          "IL",
                          "IT",
                          "JM",
                          "JP",
                          "JO",
                          "KZ",
                          "KE",
                          "KI",
                          "KP",
                          "KR",
                          "KW",
                          "KG",
                          "LA",
                          "LV",
                          "LB",
                          "LS",
                          "LR",
                          "LY",
                          "LI",
                          "LT",
                          "LU",
                          "MG",
                          "MW",
                          "MY",
                          "MV",
                          "ML",
                          "MT",
                          "MH",
                          "MR",
                          "MU",
                          "MX",
                          "FM",
                          "MD",
                          "MN",
                          "ME",
                          "MA",
                          "MZ",
                          "MM",
                          "NA",
                          "NR",
                          "NP",
                          "NL",
                          "NZ",
                          "NI",
                          "NE",
                          "NG",
                          "NO",
                          "OM",
                          "PK",
                          "PW",
                          "PS",
                          "PA",
                          "PG",
                          "PY",
                          "PE",
                          "PH",
                          "PL",
                          "PT",
                          "QA",
                          "RO",
                          "RU",
                          "RW",
                          "KN",
                          "LC",
                          "VC",
                          "WS",
                          "SM",
                          "ST",
                          "SA",
                          "SN",
                          "RS",
                          "SC",
                          "SL",
                          "SG",
                          "SK",
                          "SI",
                          "SB",
                          "SO",
                          "ZA",
                          "SS",
                          "ES",
                          "LK",
                          "SD",
                          "SR",
                          "SE",
                          "CH",
                          "SY",
                          "TW",
                          "TJ",
                          "TZ",
                          "TH",
                          "TL",
                          "TG",
                          "TO",
                          "TT",
                          "TN",
                          "TR",
                          "TM",
                          "TV",
                          "UG",
                          "UA",
                          "AE",
                          "GB",
                          "US",
                          "UY",
                          "UZ",
                          "VU",
                          "VE",
                          "VN",
                          "YE",
                          "ZM",
                          "ZW"
                        ],
                        "description": "Pays de naissance."
                      },
                      "birthCity": {
                        "type": "string",
                        "maxLength": 100
                      },
                      "birthDepartmentCode": {
                        "type": "string",
                        "maxLength": 3,
                        "description": "Département de naissance, obligatoire avec `birthCountryCode` à `FR`.",
                        "example": "44"
                      },
                      "nationality": {
                        "type": "string",
                        "enum": [
                          "FR",
                          "GP",
                          "BL",
                          "MF",
                          "MQ",
                          "GF",
                          "RE",
                          "PM",
                          "YT",
                          "WF",
                          "PF",
                          "NC",
                          "MC",
                          "AF",
                          "AL",
                          "DZ",
                          "AD",
                          "AO",
                          "AG",
                          "AR",
                          "AM",
                          "AU",
                          "AT",
                          "AZ",
                          "BS",
                          "BH",
                          "BD",
                          "BB",
                          "BY",
                          "BE",
                          "BZ",
                          "BJ",
                          "BT",
                          "BO",
                          "BA",
                          "BW",
                          "BR",
                          "BN",
                          "BG",
                          "BF",
                          "BI",
                          "CV",
                          "KH",
                          "CM",
                          "CA",
                          "CF",
                          "TD",
                          "CL",
                          "CN",
                          "CO",
                          "KM",
                          "CD",
                          "CG",
                          "CR",
                          "CI",
                          "HR",
                          "CU",
                          "CY",
                          "CZ",
                          "DK",
                          "DJ",
                          "DM",
                          "DO",
                          "EC",
                          "EG",
                          "SV",
                          "GQ",
                          "ER",
                          "EE",
                          "SZ",
                          "ET",
                          "FJ",
                          "FI",
                          "GA",
                          "GM",
                          "GE",
                          "DE",
                          "GH",
                          "GR",
                          "GD",
                          "GT",
                          "GN",
                          "GW",
                          "GY",
                          "HT",
                          "HN",
                          "HU",
                          "IS",
                          "IN",
                          "ID",
                          "IR",
                          "IQ",
                          "IE",
                          "IL",
                          "IT",
                          "JM",
                          "JP",
                          "JO",
                          "KZ",
                          "KE",
                          "KI",
                          "KP",
                          "KR",
                          "KW",
                          "KG",
                          "LA",
                          "LV",
                          "LB",
                          "LS",
                          "LR",
                          "LY",
                          "LI",
                          "LT",
                          "LU",
                          "MG",
                          "MW",
                          "MY",
                          "MV",
                          "ML",
                          "MT",
                          "MH",
                          "MR",
                          "MU",
                          "MX",
                          "FM",
                          "MD",
                          "MN",
                          "ME",
                          "MA",
                          "MZ",
                          "MM",
                          "NA",
                          "NR",
                          "NP",
                          "NL",
                          "NZ",
                          "NI",
                          "NE",
                          "NG",
                          "NO",
                          "OM",
                          "PK",
                          "PW",
                          "PS",
                          "PA",
                          "PG",
                          "PY",
                          "PE",
                          "PH",
                          "PL",
                          "PT",
                          "QA",
                          "RO",
                          "RU",
                          "RW",
                          "KN",
                          "LC",
                          "VC",
                          "WS",
                          "SM",
                          "ST",
                          "SA",
                          "SN",
                          "RS",
                          "SC",
                          "SL",
                          "SG",
                          "SK",
                          "SI",
                          "SB",
                          "SO",
                          "ZA",
                          "SS",
                          "ES",
                          "LK",
                          "SD",
                          "SR",
                          "SE",
                          "CH",
                          "SY",
                          "TW",
                          "TJ",
                          "TZ",
                          "TH",
                          "TL",
                          "TG",
                          "TO",
                          "TT",
                          "TN",
                          "TR",
                          "TM",
                          "TV",
                          "UG",
                          "UA",
                          "AE",
                          "GB",
                          "US",
                          "UY",
                          "UZ",
                          "VU",
                          "VE",
                          "VN",
                          "YE",
                          "ZM",
                          "ZW"
                        ]
                      }
                    }
                  },
                  "contact": {
                    "type": "object",
                    "description": "`contact.personalEmail` (identifiant de connexion) ne se modifie pas par l’API : `400`.",
                    "properties": {
                      "address": {
                        "type": "string",
                        "maxLength": 250,
                        "description": "Adresse postale : lettres, chiffres, espace, apostrophe, tiret et point seulement (norme DSN)."
                      },
                      "addressDetails": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "maxLength": 250,
                        "description": "Complément d’adresse. `null` le retire."
                      },
                      "postalCode": {
                        "type": "string",
                        "maxLength": 10
                      },
                      "city": {
                        "type": "string",
                        "maxLength": 100
                      },
                      "countryCode": {
                        "type": "string",
                        "enum": [
                          "FR",
                          "GP",
                          "BL",
                          "MF",
                          "MQ",
                          "GF",
                          "RE",
                          "PM",
                          "YT",
                          "WF",
                          "PF",
                          "NC",
                          "MC",
                          "AF",
                          "AL",
                          "DZ",
                          "AD",
                          "AO",
                          "AG",
                          "AR",
                          "AM",
                          "AU",
                          "AT",
                          "AZ",
                          "BS",
                          "BH",
                          "BD",
                          "BB",
                          "BY",
                          "BE",
                          "BZ",
                          "BJ",
                          "BT",
                          "BO",
                          "BA",
                          "BW",
                          "BR",
                          "BN",
                          "BG",
                          "BF",
                          "BI",
                          "CV",
                          "KH",
                          "CM",
                          "CA",
                          "CF",
                          "TD",
                          "CL",
                          "CN",
                          "CO",
                          "KM",
                          "CD",
                          "CG",
                          "CR",
                          "CI",
                          "HR",
                          "CU",
                          "CY",
                          "CZ",
                          "DK",
                          "DJ",
                          "DM",
                          "DO",
                          "EC",
                          "EG",
                          "SV",
                          "GQ",
                          "ER",
                          "EE",
                          "SZ",
                          "ET",
                          "FJ",
                          "FI",
                          "GA",
                          "GM",
                          "GE",
                          "DE",
                          "GH",
                          "GR",
                          "GD",
                          "GT",
                          "GN",
                          "GW",
                          "GY",
                          "HT",
                          "HN",
                          "HU",
                          "IS",
                          "IN",
                          "ID",
                          "IR",
                          "IQ",
                          "IE",
                          "IL",
                          "IT",
                          "JM",
                          "JP",
                          "JO",
                          "KZ",
                          "KE",
                          "KI",
                          "KP",
                          "KR",
                          "KW",
                          "KG",
                          "LA",
                          "LV",
                          "LB",
                          "LS",
                          "LR",
                          "LY",
                          "LI",
                          "LT",
                          "LU",
                          "MG",
                          "MW",
                          "MY",
                          "MV",
                          "ML",
                          "MT",
                          "MH",
                          "MR",
                          "MU",
                          "MX",
                          "FM",
                          "MD",
                          "MN",
                          "ME",
                          "MA",
                          "MZ",
                          "MM",
                          "NA",
                          "NR",
                          "NP",
                          "NL",
                          "NZ",
                          "NI",
                          "NE",
                          "NG",
                          "NO",
                          "OM",
                          "PK",
                          "PW",
                          "PS",
                          "PA",
                          "PG",
                          "PY",
                          "PE",
                          "PH",
                          "PL",
                          "PT",
                          "QA",
                          "RO",
                          "RU",
                          "RW",
                          "KN",
                          "LC",
                          "VC",
                          "WS",
                          "SM",
                          "ST",
                          "SA",
                          "SN",
                          "RS",
                          "SC",
                          "SL",
                          "SG",
                          "SK",
                          "SI",
                          "SB",
                          "SO",
                          "ZA",
                          "SS",
                          "ES",
                          "LK",
                          "SD",
                          "SR",
                          "SE",
                          "CH",
                          "SY",
                          "TW",
                          "TJ",
                          "TZ",
                          "TH",
                          "TL",
                          "TG",
                          "TO",
                          "TT",
                          "TN",
                          "TR",
                          "TM",
                          "TV",
                          "UG",
                          "UA",
                          "AE",
                          "GB",
                          "US",
                          "UY",
                          "UZ",
                          "VU",
                          "VE",
                          "VN",
                          "YE",
                          "ZM",
                          "ZW"
                        ]
                      },
                      "professionalEmail": {
                        "type": "string",
                        "format": "email",
                        "minLength": 3,
                        "maxLength": 250
                      },
                      "phoneNumber": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "minLength": 8,
                        "maxLength": 15,
                        "description": "`null` le retire."
                      }
                    }
                  },
                  "dependentChildrenCount": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9
                  },
                  "disabledDependentChildrenCount": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9,
                    "description": "Parmi `dependentChildrenCount`, les enfants à charge handicapés."
                  },
                  "maritalStatus": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "SINGLE",
                      "MARRIED",
                      "CIVIL_PARTNERSHIP",
                      "COHABITING",
                      "SEPARATED",
                      "DIVORCED",
                      "WIDOWED",
                      null
                    ],
                    "description": "Situation matrimoniale. `null` la retire.\n\n- `SINGLE` : Célibataire\n- `MARRIED` : Marié(e)\n- `CIVIL_PARTNERSHIP` : Pacsé(e)\n- `COHABITING` : En concubinage\n- `SEPARATED` : Séparé(e)\n- `DIVORCED` : Divorcé(e)\n- `WIDOWED` : Veuf ou veuve"
                  },
                  "socialSecurityNumber": {
                    "type": "string",
                    "description": "NIR ou NIA, avec ou sans clé ni espaces, avec `identityType`. S’applique à partir du prochain mois de paie ouvert.",
                    "example": "2910644123456"
                  },
                  "identityType": {
                    "type": "string",
                    "enum": [
                      "NIR",
                      "NIA"
                    ],
                    "description": "Nature de `socialSecurityNumber`, à envoyer avec lui."
                  },
                  "paymentOptionType": {
                    "type": "string",
                    "enum": [
                      "virement",
                      "check",
                      "cash"
                    ],
                    "description": "Mode de paiement du salaire. `virement` demande `iban` et `bic`."
                  },
                  "iban": {
                    "type": "string",
                    "description": "IBAN du compte de paiement, avec `bic`. Sans `paymentOptionType`, le mode passe à `virement`."
                  },
                  "bic": {
                    "type": "string"
                  },
                  "foreignErpId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "minLength": 1,
                    "maxLength": 100,
                    "description": "Identifiant du collaborateur dans votre système, unique dans l’entreprise. `null` le retire."
                  },
                  "managerId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "minLength": 1,
                    "description": "Identifiant Puncto du manager (autre collaborateur de l’entreprise). `null` retire le manager."
                  }
                }
              },
              "example": {
                "foreignErpId": "salarie-123",
                "managerId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Collaborateur modifié",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiCollaborator"
                }
              }
            }
          },
          "400": {
            "description": "Champ non modifiable, numéro de sécurité sociale déjà utilisé, ou manager introuvable ou égal au collaborateur",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Le manager de foreignErpId \"salarie-007\" est introuvable"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "409": {
            "description": "Le `foreignErpId` appartient déjà à un autre collaborateur",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Le foreignErpId \"salarie-123\" est déjà utilisé par un autre collaborateur de l’entreprise"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "delete": {
        "operationId": "deleteCollaborator",
        "tags": [
          "Collaborateurs"
        ],
        "summary": "Supprimer un collaborateur",
        "description": "Supprime définitivement le collaborateur, son contrat et ses données, ainsi que sa connexion s’il n’a pas de compte dans une autre entreprise.\n\nRefusé (`400`) si une paie du contrat ou le contrat est clôturé, si une DSN événementielle a été déclarée pour lui, ou s’il a plusieurs contrats.",
        "parameters": [
          {
            "name": "collaboratorId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du collaborateur.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Collaborateur supprimé"
          },
          "400": {
            "description": "Suppression refusée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Une paie de ce contrat a déjà été clôturée, il ne peut plus être supprimé."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/contracts": {
      "get": {
        "operationId": "listContracts",
        "tags": [
          "Contrats"
        ],
        "summary": "Lister les contrats",
        "description": "Liste paginée des contrats de l’entreprise, terminés, à venir et en cours de création compris. Tri par date de début (sans date en dernier), puis par identifiant.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          },
          {
            "name": "workerType[]",
            "in": "query",
            "description": "Types de contrat à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "EMPLOYEE_CDI",
                  "EMPLOYEE_CDD",
                  "PROFESSIONALIZATION_CONTRACT",
                  "APPRENTICESHIP_CONTRACT",
                  "INTERN",
                  "CORPORATE_OFFICER"
                ],
                "description": "- `EMPLOYEE_CDI` : Salarié - CDI\n- `EMPLOYEE_CDD` : Salarié - CDD\n- `PROFESSIONALIZATION_CONTRACT` : Alternant - Contrat de professionnalisation\n- `APPRENTICESHIP_CONTRACT` : Alternant - Apprentissage\n- `INTERN` : Stagiaire\n- `CORPORATE_OFFICER` : Dirigeant (Mandat social)"
              }
            }
          },
          {
            "name": "activationStatus[]",
            "in": "query",
            "description": "Statuts de contrat à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "C_INVITATION_SENT",
                  "A_TO_BE_REALIZED",
                  "B_ACTION_NEEDED",
                  "E_ARCHIVED",
                  "D_ACTIVE",
                  "F_TO_CLOSE",
                  "G_UPCOMING"
                ],
                "description": "- `C_INVITATION_SENT` : Invitation envoyée\n- `A_TO_BE_REALIZED` : Contrat à réaliser\n- `B_ACTION_NEEDED` : Action nécessaire\n- `E_ARCHIVED` : Contrat archivé\n- `D_ACTIVE` : Contrat en cours\n- `F_TO_CLOSE` : Contrat à clôturer\n- `G_UPCOMING` : Arrivée prochaine"
              }
            }
          },
          {
            "name": "activeAt",
            "in": "query",
            "description": "Contrats en cours à cette date : commencés au plus tard ce jour, sans fin ou finissant au plus tôt ce jour.",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-10-01"
            }
          },
          {
            "name": "referenceDate",
            "in": "query",
            "description": "Date de résolution de `currentAmendment` et `establishmentId`. Par défaut, aujourd’hui, ou la date de début d’un contrat pas encore commencé.",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-10-01"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de contrats",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiContract"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Aucun collaborateur ne correspond au filtre",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "post": {
        "operationId": "createContract",
        "tags": [
          "Contrats"
        ],
        "summary": "Créer un contrat",
        "description": "Crée un contrat pour un collaborateur existant (réembauche, stage puis CDI…).\n\n- Ses autres contrats doivent finir avant la date de début : clôturez d’abord un contrat sans date de fin.\n- Un contrat en attente de saisie dans Puncto est complété, pas doublé.\n- Un contrat du collaborateur commence déjà ce jour-là : `409` avec son `contractId`.\n\nInvitation et DPAE : comme `POST /public/v1/collaborators`. Voir le [guide des contrats](/guides/contrats).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Le collaborateur, par son identifiant Puncto, et les champs du contrat.",
                "required": [
                  "collaboratorId",
                  "workerType",
                  "startDate",
                  "dpaeDoneByPuncto"
                ],
                "properties": {
                  "collaboratorId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Identifiant Puncto du collaborateur.",
                    "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "workerType": {
                    "type": "string",
                    "enum": [
                      "EMPLOYEE_CDI",
                      "EMPLOYEE_CDD",
                      "APPRENTICESHIP_CONTRACT",
                      "INTERN",
                      "CORPORATE_OFFICER"
                    ],
                    "description": "Type de contrat. Le contrat de professionnalisation n’est pas encore pris en charge.\n\n- `EMPLOYEE_CDI` : Salarié - CDI\n- `EMPLOYEE_CDD` : Salarié - CDD\n- `APPRENTICESHIP_CONTRACT` : Alternant - Apprentissage\n- `INTERN` : Stagiaire\n- `CORPORATE_OFFICER` : Dirigeant (Mandat social)"
                  },
                  "startDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Date de début du contrat.",
                    "example": "2026-11-02"
                  },
                  "endDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Fin prévue, au plus tôt la date de début. Obligatoire pour un CDD, un apprentissage et un stage ; facultative pour un mandat social ; refusée pour un CDI."
                  },
                  "cddMotif": {
                    "type": "string",
                    "enum": [
                      "01",
                      "02",
                      "03",
                      "04",
                      "05",
                      "06",
                      "07",
                      "08",
                      "09",
                      "10",
                      "11",
                      "12",
                      "13",
                      "14",
                      "15"
                    ],
                    "description": "Motif de recours, obligatoire pour un CDD.\n\n- `01` : 01 - Remplacement d'un salarié\n- `02` : 02 - Accroissement temporaire de l'activité de l'entreprise\n- `03` : 03 - Emplois à caractère saisonnier\n- `04` : 04 - Contrat vendanges\n- `05` : 05 - Contrat d'usage\n- `06` : 06 - Contrat à durée déterminée à objet défini\n- `07` : 07 - Remplacement d'un chef d'entreprise\n- `08` : 08 - Remplacement du chef d'une exploitation agricole\n- `09` : 09 - Recrutement de personnes sans emploi rencontrant des difficultés sociales et professionnelles particulières\n- `10` : 10 - Complément de formation professionnelle au salarié\n- `11` : 11 - Formation professionnelle au salarié par la voie de l'apprentissage, en vue de l'obtention d'une qualification professionnelle sanctionnée par un diplôme ou un titre à finalité professionnelle enregistré au répertoire national des certifications professionnelles\n- `12` : 12 - Remplacement d'un salarié passé provisoirement à temps partiel\n- `13` : 13 - Attente de la suppression définitive du poste du salarié ayant quitté définitivement l'entreprise\n- `14` : 14 - Contrat de voyage\n- `15` : 15 - Recrutement d'un intérimaire en sa qualité de BOETH"
                  },
                  "establishmentId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Établissement de rattachement. Par défaut : celui du dernier contrat à sa fin (changements de lieu de travail compris), sinon du contrat en attente de saisie, sinon le siège. Ne pas combiner avec `establishmentSiret`.",
                    "example": "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "establishmentSiret": {
                    "type": "string",
                    "minLength": 1,
                    "description": "SIRET de l’établissement (14 chiffres, espaces ignorés). Ne pas combiner avec `establishmentId`.",
                    "example": "55210055400013"
                  },
                  "companyRoleId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Poste existant. Renseignez `companyRoleId` ou `companyRoleName`.",
                    "example": "crol_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "companyRoleName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "Intitulé du poste : réutilise le poste de ce nom exact, sinon le crée. Renseignez `companyRoleId` ou `companyRoleName`.",
                    "example": "Développeuse backend"
                  },
                  "companyTeamId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Équipe existante. Ne pas combiner avec `companyTeamName`.",
                    "example": "ctea_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "companyTeamName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "Nom de l’équipe : réutilise l’équipe de ce nom exact, sinon la crée. Ne pas combiner avec `companyTeamId`."
                  },
                  "managerId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Identifiant Puncto du manager.",
                    "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "trialPeriodEndDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Fin de la période d’essai initiale, au plus tôt la date de début et, avec une position conventionnelle, au plus tard le maximum conventionnel. Apprentissage : sa présence suffit, la fin est calculée (45 jours en entreprise). Refusée pour un stage et un mandat social."
                  },
                  "dpaeDoneByPuncto": {
                    "type": "boolean",
                    "description": "`true` : Puncto dépose la DPAE (CDI, CDD, apprentissage), à la création si le contrat commence sous 8 jours ou a commencé, sinon 8 jours avant. Exige un NIR ou NIA à la date de début : sans numéro (NTT), `true` renvoie `400`. `false` : vous la déposez. Sans effet pour un stage ou un mandat social."
                  },
                  "healthServiceCode": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "Code du service de santé au travail, requis si Puncto dépose la DPAE et que l’établissement n’en a pas (il y est alors enregistré)."
                  },
                  "internshipStudies": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Stage : formation suivie, obligatoire."
                  },
                  "internshipSchool": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Stage : établissement d’enseignement, obligatoire."
                  },
                  "internshipPaidLeaveDays": {
                    "type": "integer",
                    "minimum": 1,
                    "description": "Stage uniquement : jours de congés payés accordés."
                  },
                  "hasMutuelleDispense": {
                    "type": "boolean",
                    "description": "Le salarié est dispensé de mutuelle. Incompatible avec `mutuelleOcContractId`."
                  },
                  "mutuelleOcContractId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Contrat de mutuelle de l’entreprise (à cotisation forfaitaire), en vigueur à la date de début et ouvert au statut cadre ou non cadre du salarié.",
                    "example": "ocon_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "mutuelleForfaitChoice": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Formule de mutuelle choisie parmi celles du contrat (`UNIQUE`, `OPTION_<code>`, `CONDITION_<code>` ou, quand plusieurs forfaits partagent une option, `TIER_<code>__<libellé>`). Obligatoire avec `mutuelleOcContractId`.",
                    "example": "CONDITION_02"
                  },
                  "prevoyanceOcContractId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Contrat de prévoyance de l’entreprise, en vigueur à la date de début et ouvert au statut cadre ou non cadre du salarié.",
                    "example": "ocon_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "corporateOfficerSalaryMaintenance": {
                    "type": "boolean",
                    "description": "Mandat social uniquement : rémunération maintenue pendant les arrêts, sous déduction des IJSS."
                  },
                  "amendment": {
                    "type": "object",
                    "description": "Conditions du contrat à sa date de début. Obligatoire, sauf en apprentissage (voir `amendments`). Rémunération : `grossAnnualSalary` (CDI, CDD, mandat social) ou `hourlyRate` / `smoothedMonthlyAmount` (stage).",
                    "required": [
                      "isCadre",
                      "quotity",
                      "conventionalWorkerStatus",
                      "workerOutsideFranceStatus",
                      "weekDaysWorked",
                      "codePcsEse"
                    ],
                    "properties": {
                      "isCadre": {
                        "type": "boolean",
                        "description": "Statut cadre (retraite complémentaire) : `true` en position `CADRE`, `false` en `ETAM`. Doit concorder avec `conventionalWorkerStatus` et la population de la prévoyance."
                      },
                      "quotity": {
                        "description": "Temps de travail du contrat. La forme dépend de `type`.",
                        "oneOf": [
                          {
                            "title": "Heures",
                            "type": "object",
                            "required": [
                              "type",
                              "monthlyWorkingHours",
                              "workingPercentage",
                              "paidContractualOvertimeHours",
                              "rttContractualOvertimeHours",
                              "rcrContractualOvertimeHours"
                            ],
                            "properties": {
                              "type": {
                                "type": "string",
                                "const": "HEURE"
                              },
                              "monthlyWorkingHours": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Heures mensuelles, 151.67 pour un temps plein."
                              },
                              "workingPercentage": {
                                "type": "number",
                                "minimum": 1,
                                "maximum": 100,
                                "description": "Pourcentage d’un temps plein."
                              },
                              "paidContractualOvertimeHours": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Heures supplémentaires contractuelles payées, par semaine. Interdites à temps partiel."
                              },
                              "rttContractualOvertimeHours": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Heures supplémentaires contractuelles compensées en RTT, par semaine. Exige des JRTT paramétrés dans l’entreprise."
                              },
                              "rcrContractualOvertimeHours": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Heures supplémentaires contractuelles compensées en repos, par semaine."
                              },
                              "isCeilingProrated": {
                                "type": "boolean",
                                "description": "Temps partiel : plafond de la sécurité sociale proratisé à hauteur de la quotité. Absent : `true`. `false` quand le salarié et l’employeur renoncent à la proratisation pour cotiser comme à temps plein."
                              }
                            }
                          },
                          {
                            "title": "Forfait jours",
                            "type": "object",
                            "required": [
                              "type",
                              "forfaitDailyAmount",
                              "monthlyWorkingDays",
                              "workingPercentage"
                            ],
                            "properties": {
                              "type": {
                                "type": "string",
                                "const": "FORFAIT_JOUR"
                              },
                              "forfaitDailyAmount": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Nombre de jours travaillés par an (218 pour un forfait complet)."
                              },
                              "monthlyWorkingDays": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Jours travaillés par mois."
                              },
                              "workingPercentage": {
                                "type": "number",
                                "minimum": 1,
                                "maximum": 100
                              },
                              "isCeilingProrated": {
                                "type": "boolean",
                                "description": "Forfait jours réduit : plafond de la sécurité sociale proratisé à hauteur des jours du forfait (jours / 218). Absent : `false`, un forfait jours réduit garde un plafond entier. `true` suppose le consentement du salarié."
                              }
                            }
                          },
                          {
                            "title": "Forfait heures",
                            "type": "object",
                            "required": [
                              "type",
                              "period",
                              "forfaitHours",
                              "monthlyWorkingHours",
                              "annualWorkingDaysCap",
                              "workingPercentage"
                            ],
                            "properties": {
                              "type": {
                                "type": "string",
                                "const": "FORFAIT_HEURE"
                              },
                              "period": {
                                "type": "string",
                                "enum": [
                                  "WEEKLY",
                                  "MONTHLY",
                                  "YEARLY"
                                ],
                                "description": "Seul le forfait hebdomadaire `WEEKLY` est accepté."
                              },
                              "forfaitHours": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Heures du forfait par semaine, au-delà de la durée légale de 35 heures."
                              },
                              "monthlyWorkingHours": {
                                "type": "number",
                                "minimum": 0
                              },
                              "annualWorkingDaysCap": {
                                "type": "number",
                                "minimum": 1,
                                "maximum": 365
                              },
                              "workingPercentage": {
                                "type": "number",
                                "const": 100,
                                "description": "Le forfait heures réduit n’est pas pris en charge."
                              }
                            }
                          },
                          {
                            "title": "Non concerné",
                            "type": "object",
                            "required": [
                              "type"
                            ],
                            "properties": {
                              "type": {
                                "type": "string",
                                "const": "NON_CONCERNE"
                              }
                            }
                          }
                        ]
                      },
                      "conventionalWorkerStatus": {
                        "type": "string",
                        "enum": [
                          "01",
                          "02",
                          "03",
                          "04",
                          "05",
                          "06",
                          "07",
                          "08",
                          "09",
                          "10"
                        ],
                        "description": "Statut conventionnel DSN, en général `04` cadre, `03` cadre dirigeant ou mandataire social, `07` stagiaire, `05` sinon. `03` et `04` exigent `\"isCadre\": true` ; `05` à `07`, `false`.\n\n- `01` : 01 - agriculteur salarié de son exploitation\n- `02` : 02 - artisan ou commerçant salarié de son entreprise\n- `03` : 03 - cadre dirigeant (votant au collège employeur des élections prud'homales)\n- `04` : 04 - autres cadres au sens de la convention collective (ou du statut pour les régimes spéciaux)\n- `05` : 05 - profession intermédiaire (technicien, contremaître, agent de maîtrise, clergé)\n- `06` : 06 - employé administratif d'entreprise, de commerce, agent de service\n- `07` : 07 - ouvriers qualifiés et non qualifiés y compris ouvriers agricoles\n- `08` : 08 - agent de la fonction publique d'Etat\n- `09` : 09 - agent de la fonction publique hospitalière\n- `10` : 10 - agent de la fonction publique territoriale"
                      },
                      "workerOutsideFranceStatus": {
                        "type": "string",
                        "enum": [
                          "01",
                          "02",
                          "03",
                          "99"
                        ],
                        "description": "Statut d’expatriation déclaré en DSN, `99` hors expatriation.\n\n- `01` : 01 - Détaché\n- `02` : 02 - Expatrié\n- `03` : 03 - Frontalier\n- `99` : 99 - Non concerné"
                      },
                      "conventionalPosition": {
                        "description": "Position Syntec. Obligatoire pour un CDI ou un CDD.",
                        "oneOf": [
                          {
                            "title": "Cadre",
                            "type": "object",
                            "required": [
                              "type",
                              "position"
                            ],
                            "properties": {
                              "type": {
                                "type": "string",
                                "const": "CADRE"
                              },
                              "position": {
                                "type": "string",
                                "enum": [
                                  "1.1",
                                  "1.2",
                                  "2.1 (moins 26 ans)",
                                  "2.1 (au moins 26 ans)",
                                  "2.2",
                                  "2.3",
                                  "3.1",
                                  "3.2",
                                  "3.3"
                                ]
                              }
                            }
                          },
                          {
                            "title": "ETAM",
                            "type": "object",
                            "required": [
                              "type",
                              "position"
                            ],
                            "properties": {
                              "type": {
                                "type": "string",
                                "const": "ETAM"
                              },
                              "position": {
                                "type": "string",
                                "enum": [
                                  "1.1",
                                  "1.2",
                                  "2.1",
                                  "2.2",
                                  "2.3",
                                  "3.1",
                                  "3.2",
                                  "3.3"
                                ]
                              }
                            }
                          }
                        ]
                      },
                      "weekDaysWorked": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 127,
                        "description": "Jours travaillés en masque de bits : 1 lundi, 2 mardi, 4 mercredi, 8 jeudi, 16 vendredi, 32 samedi, 64 dimanche (31 du lundi au vendredi)."
                      },
                      "workSchedule": {
                        "type": "object",
                        "description": "Planning type, jour par jour, cohérent avec la quotité. Sans planning, seuls les jours de `weekDaysWorked` comptent, sans plages horaires.",
                        "required": [
                          "version",
                          "days"
                        ],
                        "properties": {
                          "version": {
                            "type": "integer",
                            "const": 1
                          },
                          "days": {
                            "type": "object",
                            "description": "Jours travaillés (au moins un) ; un jour absent n’est pas travaillé.",
                            "additionalProperties": false,
                            "properties": {
                              "MONDAY": {
                                "type": "object",
                                "required": [
                                  "morning",
                                  "afternoon"
                                ],
                                "properties": {
                                  "morning": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  },
                                  "afternoon": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  }
                                }
                              },
                              "TUESDAY": {
                                "type": "object",
                                "required": [
                                  "morning",
                                  "afternoon"
                                ],
                                "properties": {
                                  "morning": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  },
                                  "afternoon": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  }
                                }
                              },
                              "WEDNESDAY": {
                                "type": "object",
                                "required": [
                                  "morning",
                                  "afternoon"
                                ],
                                "properties": {
                                  "morning": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  },
                                  "afternoon": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  }
                                }
                              },
                              "THURSDAY": {
                                "type": "object",
                                "required": [
                                  "morning",
                                  "afternoon"
                                ],
                                "properties": {
                                  "morning": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  },
                                  "afternoon": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  }
                                }
                              },
                              "FRIDAY": {
                                "type": "object",
                                "required": [
                                  "morning",
                                  "afternoon"
                                ],
                                "properties": {
                                  "morning": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  },
                                  "afternoon": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  }
                                }
                              },
                              "SATURDAY": {
                                "type": "object",
                                "required": [
                                  "morning",
                                  "afternoon"
                                ],
                                "properties": {
                                  "morning": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  },
                                  "afternoon": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  }
                                }
                              },
                              "SUNDAY": {
                                "type": "object",
                                "required": [
                                  "morning",
                                  "afternoon"
                                ],
                                "properties": {
                                  "morning": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  },
                                  "afternoon": {
                                    "type": [
                                      "object",
                                      "null"
                                    ],
                                    "required": [
                                      "start",
                                      "end"
                                    ],
                                    "properties": {
                                      "start": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "09:00"
                                      },
                                      "end": {
                                        "type": "string",
                                        "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                        "example": "12:30"
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      },
                      "grossAnnualSalary": {
                        "type": "number",
                        "minimum": 0,
                        "description": "Salaire brut annuel en euros, au moins le minimum conventionnel (SMC) et le SMIC au prorata du temps de travail. Obligatoire pour un CDI, un CDD et un mandat social (`422` sinon, `null` compris)."
                      },
                      "hourlyRate": {
                        "type": "number",
                        "minimum": 0,
                        "description": "Stage : gratification horaire en euros, au moins le minimum légal. Obligatoire sauf avec `smoothedMonthlyAmount` (`422` sinon, `null` compris)."
                      },
                      "smoothedMonthlyAmount": {
                        "type": "number",
                        "minimum": 0,
                        "description": "Stage : gratification mensuelle lissée, à la place de `hourlyRate`."
                      },
                      "codePcsEse": {
                        "type": "string",
                        "enum": [
                          "100x",
                          "210x",
                          "220x",
                          "231a",
                          "232a",
                          "233a",
                          "233b",
                          "233c",
                          "233d",
                          "311c",
                          "311d",
                          "311e",
                          "312a",
                          "331a",
                          "332a",
                          "332b",
                          "333a",
                          "333b",
                          "333c",
                          "333d",
                          "333e",
                          "333f",
                          "334a",
                          "335a",
                          "341a",
                          "341b",
                          "342b",
                          "342c",
                          "342d",
                          "342f",
                          "342g",
                          "342h",
                          "343a",
                          "344a",
                          "344b",
                          "344c",
                          "344d",
                          "351a",
                          "352a",
                          "352b",
                          "353a",
                          "353b",
                          "353c",
                          "354a",
                          "354b",
                          "354c",
                          "354e",
                          "354f",
                          "354g",
                          "371a",
                          "372a",
                          "372b",
                          "372c",
                          "372d",
                          "372e",
                          "372f",
                          "373a",
                          "373b",
                          "373c",
                          "373d",
                          "374a",
                          "374b",
                          "374c",
                          "374d",
                          "375a",
                          "375b",
                          "376a",
                          "376b",
                          "376c",
                          "376d",
                          "376e",
                          "376f",
                          "376g",
                          "377a",
                          "380a",
                          "381b",
                          "381c",
                          "382a",
                          "382b",
                          "382c",
                          "382d",
                          "383a",
                          "383b",
                          "383c",
                          "384a",
                          "384b",
                          "384c",
                          "385a",
                          "385b",
                          "385c",
                          "386b",
                          "386c",
                          "386d",
                          "386e",
                          "387a",
                          "387b",
                          "387c",
                          "387d",
                          "387e",
                          "387f",
                          "388a",
                          "388b",
                          "388c",
                          "388d",
                          "388e",
                          "389a",
                          "389b",
                          "389c",
                          "421a",
                          "421b",
                          "422a",
                          "422b",
                          "422c",
                          "422d",
                          "422e",
                          "423a",
                          "423b",
                          "424a",
                          "425a",
                          "431a",
                          "431b",
                          "431c",
                          "431d",
                          "431e",
                          "431f",
                          "432b",
                          "432d",
                          "433a",
                          "433b",
                          "433c",
                          "433d",
                          "434a",
                          "434b",
                          "434c",
                          "434d",
                          "434e",
                          "434f",
                          "434g",
                          "435a",
                          "435b",
                          "441a",
                          "441b",
                          "451a",
                          "451b",
                          "451c",
                          "451d",
                          "451e",
                          "451g",
                          "451h",
                          "452a",
                          "452b",
                          "461b",
                          "461c",
                          "461d",
                          "461e",
                          "461f",
                          "462a",
                          "462b",
                          "462c",
                          "462d",
                          "462e",
                          "463a",
                          "463b",
                          "463c",
                          "463d",
                          "463e",
                          "464a",
                          "464b",
                          "465a",
                          "465b",
                          "465c",
                          "466a",
                          "466b",
                          "466c",
                          "467a",
                          "467b",
                          "467c",
                          "467d",
                          "468a",
                          "468b",
                          "471a",
                          "471b",
                          "472a",
                          "472b",
                          "472c",
                          "472d",
                          "473a",
                          "473b",
                          "473c",
                          "474a",
                          "474b",
                          "474c",
                          "475a",
                          "475b",
                          "476a",
                          "476b",
                          "477a",
                          "477b",
                          "477c",
                          "477d",
                          "478a",
                          "478b",
                          "478c",
                          "478d",
                          "479a",
                          "479b",
                          "480a",
                          "480b",
                          "481a",
                          "481b",
                          "482a",
                          "483a",
                          "484a",
                          "484b",
                          "485a",
                          "485b",
                          "486b",
                          "486c",
                          "486d",
                          "486e",
                          "487a",
                          "487b",
                          "488a",
                          "488b",
                          "521a",
                          "521b",
                          "522a",
                          "523a",
                          "523b",
                          "523c",
                          "523d",
                          "524a",
                          "524b",
                          "524c",
                          "524d",
                          "525a",
                          "525b",
                          "525c",
                          "525d",
                          "526a",
                          "526b",
                          "526c",
                          "526d",
                          "526e",
                          "531a",
                          "531b",
                          "531c",
                          "532a",
                          "532b",
                          "532c",
                          "533a",
                          "533b",
                          "533c",
                          "534a",
                          "534b",
                          "541b",
                          "541c",
                          "541d",
                          "542a",
                          "542b",
                          "543b",
                          "543c",
                          "543e",
                          "543f",
                          "543g",
                          "543h",
                          "544a",
                          "545a",
                          "545b",
                          "545c",
                          "545d",
                          "546a",
                          "546b",
                          "546c",
                          "546d",
                          "546e",
                          "551a",
                          "552a",
                          "553b",
                          "553c",
                          "554a",
                          "554b",
                          "554c",
                          "554d",
                          "554e",
                          "554f",
                          "554g",
                          "554h",
                          "554j",
                          "555a",
                          "556a",
                          "561b",
                          "561c",
                          "561d",
                          "561e",
                          "561f",
                          "562a",
                          "562b",
                          "563a",
                          "563b",
                          "563c",
                          "564a",
                          "564b",
                          "621a",
                          "621b",
                          "621c",
                          "621d",
                          "621e",
                          "621f",
                          "621g",
                          "622a",
                          "622c",
                          "622d",
                          "622e",
                          "622f",
                          "622g",
                          "623a",
                          "623b",
                          "623d",
                          "623e",
                          "623f",
                          "623g",
                          "624b",
                          "624c",
                          "624d",
                          "624e",
                          "624f",
                          "624g",
                          "625a",
                          "625b",
                          "625c",
                          "625d",
                          "625f",
                          "625g",
                          "625h",
                          "626a",
                          "626b",
                          "626c",
                          "627a",
                          "627b",
                          "627c",
                          "627d",
                          "627e",
                          "627f",
                          "628a",
                          "628b",
                          "628c",
                          "628d",
                          "628e",
                          "628f",
                          "628g",
                          "631a",
                          "632a",
                          "632b",
                          "632c",
                          "632d",
                          "632e",
                          "632f",
                          "632g",
                          "632h",
                          "632j",
                          "632k",
                          "633a",
                          "633b",
                          "633c",
                          "633d",
                          "634a",
                          "634b",
                          "634c",
                          "634d",
                          "635a",
                          "636a",
                          "636b",
                          "636c",
                          "636d",
                          "637a",
                          "637b",
                          "637c",
                          "637d",
                          "641a",
                          "641b",
                          "642a",
                          "642b",
                          "643a",
                          "644a",
                          "651a",
                          "651b",
                          "652a",
                          "652b",
                          "653a",
                          "654b",
                          "654c",
                          "655a",
                          "656b",
                          "656c",
                          "671a",
                          "671c",
                          "671d",
                          "672a",
                          "673a",
                          "673b",
                          "673c",
                          "674a",
                          "674b",
                          "674c",
                          "674d",
                          "674e",
                          "675a",
                          "675b",
                          "675c",
                          "676a",
                          "676b",
                          "676c",
                          "676d",
                          "676e",
                          "681a",
                          "681b",
                          "682a",
                          "683a",
                          "684a",
                          "684b",
                          "685a",
                          "691a",
                          "691b",
                          "691c",
                          "691d",
                          "691e",
                          "691f",
                          "692a",
                          "9999"
                        ],
                        "description": "Code PCS-ESE de l’emploi (nomenclature INSEE).",
                        "example": "388a"
                      },
                      "mealVoucherStatus": {
                        "type": "string",
                        "enum": [
                          "DEFAULT",
                          "DISABLED"
                        ],
                        "description": "- `DEFAULT` : Suit le paramétrage entreprise\n- `DISABLED` : Désactivé"
                      },
                      "remoteWorkAllowanceStatus": {
                        "type": "string",
                        "enum": [
                          "DEFAULT",
                          "DISABLED"
                        ],
                        "description": "- `DEFAULT` : Suit le paramétrage entreprise\n- `DISABLED` : Désactivé"
                      },
                      "remoteWorkWeeklyDays": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "minimum": 0,
                        "maximum": 7,
                        "description": "Jours de télétravail par semaine, quand l’indemnité de télétravail l’exige."
                      },
                      "mealAllowanceType": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "enum": [
                          "ON_SITE",
                          "OFF_SITE",
                          "TRAVEL_RESTAURANT",
                          null
                        ],
                        "description": "- `ON_SITE` : Repas sur le lieu de travail\n- `OFF_SITE` : Repas hors des locaux\n- `TRAVEL_RESTAURANT` : Repas au restaurant en déplacement"
                      },
                      "workPlace": {
                        "type": [
                          "object",
                          "null"
                        ],
                        "description": "Lieu de travail effectif, s’il diffère de l’adresse de l’établissement. Code INSEE requis en France ; Mayotte non prise en charge.",
                        "required": [
                          "address",
                          "addressDetails",
                          "postalCode",
                          "city",
                          "countryCode",
                          "inseeCode"
                        ],
                        "properties": {
                          "address": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 250
                          },
                          "addressDetails": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "maxLength": 250
                          },
                          "postalCode": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 10
                          },
                          "city": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "countryCode": {
                            "type": "string",
                            "enum": [
                              "FR",
                              "GP",
                              "BL",
                              "MF",
                              "MQ",
                              "GF",
                              "RE",
                              "PM",
                              "YT",
                              "WF",
                              "PF",
                              "NC",
                              "MC",
                              "AF",
                              "AL",
                              "DZ",
                              "AD",
                              "AO",
                              "AG",
                              "AR",
                              "AM",
                              "AU",
                              "AT",
                              "AZ",
                              "BS",
                              "BH",
                              "BD",
                              "BB",
                              "BY",
                              "BE",
                              "BZ",
                              "BJ",
                              "BT",
                              "BO",
                              "BA",
                              "BW",
                              "BR",
                              "BN",
                              "BG",
                              "BF",
                              "BI",
                              "CV",
                              "KH",
                              "CM",
                              "CA",
                              "CF",
                              "TD",
                              "CL",
                              "CN",
                              "CO",
                              "KM",
                              "CD",
                              "CG",
                              "CR",
                              "CI",
                              "HR",
                              "CU",
                              "CY",
                              "CZ",
                              "DK",
                              "DJ",
                              "DM",
                              "DO",
                              "EC",
                              "EG",
                              "SV",
                              "GQ",
                              "ER",
                              "EE",
                              "SZ",
                              "ET",
                              "FJ",
                              "FI",
                              "GA",
                              "GM",
                              "GE",
                              "DE",
                              "GH",
                              "GR",
                              "GD",
                              "GT",
                              "GN",
                              "GW",
                              "GY",
                              "HT",
                              "HN",
                              "HU",
                              "IS",
                              "IN",
                              "ID",
                              "IR",
                              "IQ",
                              "IE",
                              "IL",
                              "IT",
                              "JM",
                              "JP",
                              "JO",
                              "KZ",
                              "KE",
                              "KI",
                              "KP",
                              "KR",
                              "KW",
                              "KG",
                              "LA",
                              "LV",
                              "LB",
                              "LS",
                              "LR",
                              "LY",
                              "LI",
                              "LT",
                              "LU",
                              "MG",
                              "MW",
                              "MY",
                              "MV",
                              "ML",
                              "MT",
                              "MH",
                              "MR",
                              "MU",
                              "MX",
                              "FM",
                              "MD",
                              "MN",
                              "ME",
                              "MA",
                              "MZ",
                              "MM",
                              "NA",
                              "NR",
                              "NP",
                              "NL",
                              "NZ",
                              "NI",
                              "NE",
                              "NG",
                              "NO",
                              "OM",
                              "PK",
                              "PW",
                              "PS",
                              "PA",
                              "PG",
                              "PY",
                              "PE",
                              "PH",
                              "PL",
                              "PT",
                              "QA",
                              "RO",
                              "RU",
                              "RW",
                              "KN",
                              "LC",
                              "VC",
                              "WS",
                              "SM",
                              "ST",
                              "SA",
                              "SN",
                              "RS",
                              "SC",
                              "SL",
                              "SG",
                              "SK",
                              "SI",
                              "SB",
                              "SO",
                              "ZA",
                              "SS",
                              "ES",
                              "LK",
                              "SD",
                              "SR",
                              "SE",
                              "CH",
                              "SY",
                              "TW",
                              "TJ",
                              "TZ",
                              "TH",
                              "TL",
                              "TG",
                              "TO",
                              "TT",
                              "TN",
                              "TR",
                              "TM",
                              "TV",
                              "UG",
                              "UA",
                              "AE",
                              "GB",
                              "US",
                              "UY",
                              "UZ",
                              "VU",
                              "VE",
                              "VN",
                              "YE",
                              "ZM",
                              "ZW"
                            ]
                          },
                          "inseeCode": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "pattern": "^(\\d{5}|2[ABab]\\d{3})$",
                            "description": "Code officiel géographique de la commune (2A / 2B pour la Corse)."
                          }
                        }
                      },
                      "applyJeiExoneration": {
                        "type": "boolean",
                        "description": "Appliquer l’exonération JEI."
                      },
                      "applyAcreExoneration": {
                        "type": "boolean",
                        "description": "Appliquer l’exonération ACRE."
                      }
                    }
                  },
                  "apprenticeshipFormationLevel": {
                    "type": "string",
                    "enum": [
                      "03",
                      "04",
                      "05",
                      "06",
                      "07",
                      "08"
                    ],
                    "description": "Contrat d’apprentissage uniquement : niveau du diplôme préparé, obligatoire.\n\n- `03` : 03 - Niveau de formation équivalent au CAP (certificat d'aptitude professionnelle) ou au BEP (brevet d'études professionnelles)\n- `04` : 04 - Formation de niveau du bac (général, technologique ou professionnel), du brevet de technicien (BT) ou du brevet professionnel\n- `05` : 05 - Formation de niveau bac+2 : licence 2, BTS (brevet de technicien supérieur), DUT (diplôme universitaire de technologie), etc.\n- `06` : 06 - Formation de niveau bac+3 et bac+4 : licence 3, licence professionnelle, master 1, etc.\n- `07` : 07 - Formation de niveau bac+5 : master 2, diplôme d'études approfondies, diplôme d'études supérieures spécialisées, diplôme d'ingénieur, etc.\n- `08` : 08 - Formation de niveau bac+8 : doctorat, habilitation à diriger des recherches, etc."
                  },
                  "apprenticeshipFormationYearsPeriods": {
                    "type": "object",
                    "description": "Apprentissage uniquement : périodes des années de formation, au moins une (absente ou `null` : non suivie). Consécutives, sans chevauchement, du début à la fin du contrat.",
                    "properties": {
                      "FIRST_YEAR": {
                        "type": [
                          "object",
                          "null"
                        ],
                        "required": [
                          "startDate",
                          "endDate"
                        ],
                        "properties": {
                          "startDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Début de l’année de formation."
                          },
                          "endDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Fin de l’année de formation, au plus tôt son début."
                          }
                        }
                      },
                      "SECOND_YEAR": {
                        "type": [
                          "object",
                          "null"
                        ],
                        "required": [
                          "startDate",
                          "endDate"
                        ],
                        "properties": {
                          "startDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Début de l’année de formation."
                          },
                          "endDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Fin de l’année de formation, au plus tôt son début."
                          }
                        }
                      },
                      "THIRD_YEAR": {
                        "type": [
                          "object",
                          "null"
                        ],
                        "required": [
                          "startDate",
                          "endDate"
                        ],
                        "properties": {
                          "startDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Début de l’année de formation."
                          },
                          "endDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Fin de l’année de formation, au plus tôt son début."
                          }
                        }
                      }
                    }
                  },
                  "amendments": {
                    "type": "array",
                    "description": "Apprentissage uniquement, obligatoire : un avenant par année de `apprenticeshipFormationYearsPeriods`, commençant au début de cette année.",
                    "items": {
                      "type": "object",
                      "description": "Conditions d’une année de formation, applicables à sa date de début.",
                      "required": [
                        "isCadre",
                        "quotity",
                        "conventionalWorkerStatus",
                        "workerOutsideFranceStatus",
                        "weekDaysWorked",
                        "codePcsEse",
                        "remunerationPercentage",
                        "remunerationReference",
                        "apprenticeshipFormationYear"
                      ],
                      "properties": {
                        "isCadre": {
                          "type": "boolean",
                          "description": "Statut cadre (retraite complémentaire) : `true` en position `CADRE`, `false` en `ETAM`. Doit concorder avec `conventionalWorkerStatus` et la population de la prévoyance."
                        },
                        "quotity": {
                          "description": "Temps de travail du contrat. La forme dépend de `type`.",
                          "oneOf": [
                            {
                              "title": "Heures",
                              "type": "object",
                              "required": [
                                "type",
                                "monthlyWorkingHours",
                                "workingPercentage",
                                "paidContractualOvertimeHours",
                                "rttContractualOvertimeHours",
                                "rcrContractualOvertimeHours"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "HEURE"
                                },
                                "monthlyWorkingHours": {
                                  "type": "number",
                                  "minimum": 0,
                                  "description": "Heures mensuelles, 151.67 pour un temps plein."
                                },
                                "workingPercentage": {
                                  "type": "number",
                                  "minimum": 1,
                                  "maximum": 100,
                                  "description": "Pourcentage d’un temps plein."
                                },
                                "paidContractualOvertimeHours": {
                                  "type": "number",
                                  "minimum": 0,
                                  "description": "Heures supplémentaires contractuelles payées, par semaine. Interdites à temps partiel."
                                },
                                "rttContractualOvertimeHours": {
                                  "type": "number",
                                  "minimum": 0,
                                  "description": "Heures supplémentaires contractuelles compensées en RTT, par semaine. Exige des JRTT paramétrés dans l’entreprise."
                                },
                                "rcrContractualOvertimeHours": {
                                  "type": "number",
                                  "minimum": 0,
                                  "description": "Heures supplémentaires contractuelles compensées en repos, par semaine."
                                },
                                "isCeilingProrated": {
                                  "type": "boolean",
                                  "description": "Temps partiel : plafond de la sécurité sociale proratisé à hauteur de la quotité. Absent : `true`. `false` quand le salarié et l’employeur renoncent à la proratisation pour cotiser comme à temps plein."
                                }
                              }
                            },
                            {
                              "title": "Forfait jours",
                              "type": "object",
                              "required": [
                                "type",
                                "forfaitDailyAmount",
                                "monthlyWorkingDays",
                                "workingPercentage"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "FORFAIT_JOUR"
                                },
                                "forfaitDailyAmount": {
                                  "type": "number",
                                  "minimum": 0,
                                  "description": "Nombre de jours travaillés par an (218 pour un forfait complet)."
                                },
                                "monthlyWorkingDays": {
                                  "type": "number",
                                  "minimum": 0,
                                  "description": "Jours travaillés par mois."
                                },
                                "workingPercentage": {
                                  "type": "number",
                                  "minimum": 1,
                                  "maximum": 100
                                },
                                "isCeilingProrated": {
                                  "type": "boolean",
                                  "description": "Forfait jours réduit : plafond de la sécurité sociale proratisé à hauteur des jours du forfait (jours / 218). Absent : `false`, un forfait jours réduit garde un plafond entier. `true` suppose le consentement du salarié."
                                }
                              }
                            },
                            {
                              "title": "Forfait heures",
                              "type": "object",
                              "required": [
                                "type",
                                "period",
                                "forfaitHours",
                                "monthlyWorkingHours",
                                "annualWorkingDaysCap",
                                "workingPercentage"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "FORFAIT_HEURE"
                                },
                                "period": {
                                  "type": "string",
                                  "enum": [
                                    "WEEKLY",
                                    "MONTHLY",
                                    "YEARLY"
                                  ],
                                  "description": "Seul le forfait hebdomadaire `WEEKLY` est accepté."
                                },
                                "forfaitHours": {
                                  "type": "number",
                                  "minimum": 0,
                                  "description": "Heures du forfait par semaine, au-delà de la durée légale de 35 heures."
                                },
                                "monthlyWorkingHours": {
                                  "type": "number",
                                  "minimum": 0
                                },
                                "annualWorkingDaysCap": {
                                  "type": "number",
                                  "minimum": 1,
                                  "maximum": 365
                                },
                                "workingPercentage": {
                                  "type": "number",
                                  "const": 100,
                                  "description": "Le forfait heures réduit n’est pas pris en charge."
                                }
                              }
                            },
                            {
                              "title": "Non concerné",
                              "type": "object",
                              "required": [
                                "type"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "NON_CONCERNE"
                                }
                              }
                            }
                          ]
                        },
                        "conventionalWorkerStatus": {
                          "type": "string",
                          "enum": [
                            "01",
                            "02",
                            "03",
                            "04",
                            "05",
                            "06",
                            "07",
                            "08",
                            "09",
                            "10"
                          ],
                          "description": "Statut conventionnel DSN, en général `04` cadre, `03` cadre dirigeant ou mandataire social, `07` stagiaire, `05` sinon. `03` et `04` exigent `\"isCadre\": true` ; `05` à `07`, `false`.\n\n- `01` : 01 - agriculteur salarié de son exploitation\n- `02` : 02 - artisan ou commerçant salarié de son entreprise\n- `03` : 03 - cadre dirigeant (votant au collège employeur des élections prud'homales)\n- `04` : 04 - autres cadres au sens de la convention collective (ou du statut pour les régimes spéciaux)\n- `05` : 05 - profession intermédiaire (technicien, contremaître, agent de maîtrise, clergé)\n- `06` : 06 - employé administratif d'entreprise, de commerce, agent de service\n- `07` : 07 - ouvriers qualifiés et non qualifiés y compris ouvriers agricoles\n- `08` : 08 - agent de la fonction publique d'Etat\n- `09` : 09 - agent de la fonction publique hospitalière\n- `10` : 10 - agent de la fonction publique territoriale"
                        },
                        "workerOutsideFranceStatus": {
                          "type": "string",
                          "enum": [
                            "01",
                            "02",
                            "03",
                            "99"
                          ],
                          "description": "Statut d’expatriation déclaré en DSN, `99` hors expatriation.\n\n- `01` : 01 - Détaché\n- `02` : 02 - Expatrié\n- `03` : 03 - Frontalier\n- `99` : 99 - Non concerné"
                        },
                        "conventionalPosition": {
                          "description": "Position Syntec. Obligatoire pour un CDI ou un CDD.",
                          "oneOf": [
                            {
                              "title": "Cadre",
                              "type": "object",
                              "required": [
                                "type",
                                "position"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "CADRE"
                                },
                                "position": {
                                  "type": "string",
                                  "enum": [
                                    "1.1",
                                    "1.2",
                                    "2.1 (moins 26 ans)",
                                    "2.1 (au moins 26 ans)",
                                    "2.2",
                                    "2.3",
                                    "3.1",
                                    "3.2",
                                    "3.3"
                                  ]
                                }
                              }
                            },
                            {
                              "title": "ETAM",
                              "type": "object",
                              "required": [
                                "type",
                                "position"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "ETAM"
                                },
                                "position": {
                                  "type": "string",
                                  "enum": [
                                    "1.1",
                                    "1.2",
                                    "2.1",
                                    "2.2",
                                    "2.3",
                                    "3.1",
                                    "3.2",
                                    "3.3"
                                  ]
                                }
                              }
                            }
                          ]
                        },
                        "weekDaysWorked": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 127,
                          "description": "Jours travaillés en masque de bits : 1 lundi, 2 mardi, 4 mercredi, 8 jeudi, 16 vendredi, 32 samedi, 64 dimanche (31 du lundi au vendredi)."
                        },
                        "workSchedule": {
                          "type": "object",
                          "description": "Planning type, jour par jour, cohérent avec la quotité. Sans planning, seuls les jours de `weekDaysWorked` comptent, sans plages horaires.",
                          "required": [
                            "version",
                            "days"
                          ],
                          "properties": {
                            "version": {
                              "type": "integer",
                              "const": 1
                            },
                            "days": {
                              "type": "object",
                              "description": "Jours travaillés (au moins un) ; un jour absent n’est pas travaillé.",
                              "additionalProperties": false,
                              "properties": {
                                "MONDAY": {
                                  "type": "object",
                                  "required": [
                                    "morning",
                                    "afternoon"
                                  ],
                                  "properties": {
                                    "morning": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    },
                                    "afternoon": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    }
                                  }
                                },
                                "TUESDAY": {
                                  "type": "object",
                                  "required": [
                                    "morning",
                                    "afternoon"
                                  ],
                                  "properties": {
                                    "morning": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    },
                                    "afternoon": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    }
                                  }
                                },
                                "WEDNESDAY": {
                                  "type": "object",
                                  "required": [
                                    "morning",
                                    "afternoon"
                                  ],
                                  "properties": {
                                    "morning": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    },
                                    "afternoon": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    }
                                  }
                                },
                                "THURSDAY": {
                                  "type": "object",
                                  "required": [
                                    "morning",
                                    "afternoon"
                                  ],
                                  "properties": {
                                    "morning": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    },
                                    "afternoon": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    }
                                  }
                                },
                                "FRIDAY": {
                                  "type": "object",
                                  "required": [
                                    "morning",
                                    "afternoon"
                                  ],
                                  "properties": {
                                    "morning": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    },
                                    "afternoon": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    }
                                  }
                                },
                                "SATURDAY": {
                                  "type": "object",
                                  "required": [
                                    "morning",
                                    "afternoon"
                                  ],
                                  "properties": {
                                    "morning": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    },
                                    "afternoon": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    }
                                  }
                                },
                                "SUNDAY": {
                                  "type": "object",
                                  "required": [
                                    "morning",
                                    "afternoon"
                                  ],
                                  "properties": {
                                    "morning": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    },
                                    "afternoon": {
                                      "type": [
                                        "object",
                                        "null"
                                      ],
                                      "required": [
                                        "start",
                                        "end"
                                      ],
                                      "properties": {
                                        "start": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "09:00"
                                        },
                                        "end": {
                                          "type": "string",
                                          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                          "example": "12:30"
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          }
                        },
                        "grossAnnualSalary": {
                          "type": "number",
                          "minimum": 0,
                          "description": "Salaire brut annuel en euros, au moins le minimum conventionnel (SMC) et le SMIC au prorata du temps de travail. Obligatoire pour un CDI, un CDD et un mandat social (`422` sinon, `null` compris)."
                        },
                        "hourlyRate": {
                          "type": "number",
                          "minimum": 0,
                          "description": "Stage : gratification horaire en euros, au moins le minimum légal. Obligatoire sauf avec `smoothedMonthlyAmount` (`422` sinon, `null` compris)."
                        },
                        "smoothedMonthlyAmount": {
                          "type": "number",
                          "minimum": 0,
                          "description": "Stage : gratification mensuelle lissée, à la place de `hourlyRate`."
                        },
                        "codePcsEse": {
                          "type": "string",
                          "enum": [
                            "100x",
                            "210x",
                            "220x",
                            "231a",
                            "232a",
                            "233a",
                            "233b",
                            "233c",
                            "233d",
                            "311c",
                            "311d",
                            "311e",
                            "312a",
                            "331a",
                            "332a",
                            "332b",
                            "333a",
                            "333b",
                            "333c",
                            "333d",
                            "333e",
                            "333f",
                            "334a",
                            "335a",
                            "341a",
                            "341b",
                            "342b",
                            "342c",
                            "342d",
                            "342f",
                            "342g",
                            "342h",
                            "343a",
                            "344a",
                            "344b",
                            "344c",
                            "344d",
                            "351a",
                            "352a",
                            "352b",
                            "353a",
                            "353b",
                            "353c",
                            "354a",
                            "354b",
                            "354c",
                            "354e",
                            "354f",
                            "354g",
                            "371a",
                            "372a",
                            "372b",
                            "372c",
                            "372d",
                            "372e",
                            "372f",
                            "373a",
                            "373b",
                            "373c",
                            "373d",
                            "374a",
                            "374b",
                            "374c",
                            "374d",
                            "375a",
                            "375b",
                            "376a",
                            "376b",
                            "376c",
                            "376d",
                            "376e",
                            "376f",
                            "376g",
                            "377a",
                            "380a",
                            "381b",
                            "381c",
                            "382a",
                            "382b",
                            "382c",
                            "382d",
                            "383a",
                            "383b",
                            "383c",
                            "384a",
                            "384b",
                            "384c",
                            "385a",
                            "385b",
                            "385c",
                            "386b",
                            "386c",
                            "386d",
                            "386e",
                            "387a",
                            "387b",
                            "387c",
                            "387d",
                            "387e",
                            "387f",
                            "388a",
                            "388b",
                            "388c",
                            "388d",
                            "388e",
                            "389a",
                            "389b",
                            "389c",
                            "421a",
                            "421b",
                            "422a",
                            "422b",
                            "422c",
                            "422d",
                            "422e",
                            "423a",
                            "423b",
                            "424a",
                            "425a",
                            "431a",
                            "431b",
                            "431c",
                            "431d",
                            "431e",
                            "431f",
                            "432b",
                            "432d",
                            "433a",
                            "433b",
                            "433c",
                            "433d",
                            "434a",
                            "434b",
                            "434c",
                            "434d",
                            "434e",
                            "434f",
                            "434g",
                            "435a",
                            "435b",
                            "441a",
                            "441b",
                            "451a",
                            "451b",
                            "451c",
                            "451d",
                            "451e",
                            "451g",
                            "451h",
                            "452a",
                            "452b",
                            "461b",
                            "461c",
                            "461d",
                            "461e",
                            "461f",
                            "462a",
                            "462b",
                            "462c",
                            "462d",
                            "462e",
                            "463a",
                            "463b",
                            "463c",
                            "463d",
                            "463e",
                            "464a",
                            "464b",
                            "465a",
                            "465b",
                            "465c",
                            "466a",
                            "466b",
                            "466c",
                            "467a",
                            "467b",
                            "467c",
                            "467d",
                            "468a",
                            "468b",
                            "471a",
                            "471b",
                            "472a",
                            "472b",
                            "472c",
                            "472d",
                            "473a",
                            "473b",
                            "473c",
                            "474a",
                            "474b",
                            "474c",
                            "475a",
                            "475b",
                            "476a",
                            "476b",
                            "477a",
                            "477b",
                            "477c",
                            "477d",
                            "478a",
                            "478b",
                            "478c",
                            "478d",
                            "479a",
                            "479b",
                            "480a",
                            "480b",
                            "481a",
                            "481b",
                            "482a",
                            "483a",
                            "484a",
                            "484b",
                            "485a",
                            "485b",
                            "486b",
                            "486c",
                            "486d",
                            "486e",
                            "487a",
                            "487b",
                            "488a",
                            "488b",
                            "521a",
                            "521b",
                            "522a",
                            "523a",
                            "523b",
                            "523c",
                            "523d",
                            "524a",
                            "524b",
                            "524c",
                            "524d",
                            "525a",
                            "525b",
                            "525c",
                            "525d",
                            "526a",
                            "526b",
                            "526c",
                            "526d",
                            "526e",
                            "531a",
                            "531b",
                            "531c",
                            "532a",
                            "532b",
                            "532c",
                            "533a",
                            "533b",
                            "533c",
                            "534a",
                            "534b",
                            "541b",
                            "541c",
                            "541d",
                            "542a",
                            "542b",
                            "543b",
                            "543c",
                            "543e",
                            "543f",
                            "543g",
                            "543h",
                            "544a",
                            "545a",
                            "545b",
                            "545c",
                            "545d",
                            "546a",
                            "546b",
                            "546c",
                            "546d",
                            "546e",
                            "551a",
                            "552a",
                            "553b",
                            "553c",
                            "554a",
                            "554b",
                            "554c",
                            "554d",
                            "554e",
                            "554f",
                            "554g",
                            "554h",
                            "554j",
                            "555a",
                            "556a",
                            "561b",
                            "561c",
                            "561d",
                            "561e",
                            "561f",
                            "562a",
                            "562b",
                            "563a",
                            "563b",
                            "563c",
                            "564a",
                            "564b",
                            "621a",
                            "621b",
                            "621c",
                            "621d",
                            "621e",
                            "621f",
                            "621g",
                            "622a",
                            "622c",
                            "622d",
                            "622e",
                            "622f",
                            "622g",
                            "623a",
                            "623b",
                            "623d",
                            "623e",
                            "623f",
                            "623g",
                            "624b",
                            "624c",
                            "624d",
                            "624e",
                            "624f",
                            "624g",
                            "625a",
                            "625b",
                            "625c",
                            "625d",
                            "625f",
                            "625g",
                            "625h",
                            "626a",
                            "626b",
                            "626c",
                            "627a",
                            "627b",
                            "627c",
                            "627d",
                            "627e",
                            "627f",
                            "628a",
                            "628b",
                            "628c",
                            "628d",
                            "628e",
                            "628f",
                            "628g",
                            "631a",
                            "632a",
                            "632b",
                            "632c",
                            "632d",
                            "632e",
                            "632f",
                            "632g",
                            "632h",
                            "632j",
                            "632k",
                            "633a",
                            "633b",
                            "633c",
                            "633d",
                            "634a",
                            "634b",
                            "634c",
                            "634d",
                            "635a",
                            "636a",
                            "636b",
                            "636c",
                            "636d",
                            "637a",
                            "637b",
                            "637c",
                            "637d",
                            "641a",
                            "641b",
                            "642a",
                            "642b",
                            "643a",
                            "644a",
                            "651a",
                            "651b",
                            "652a",
                            "652b",
                            "653a",
                            "654b",
                            "654c",
                            "655a",
                            "656b",
                            "656c",
                            "671a",
                            "671c",
                            "671d",
                            "672a",
                            "673a",
                            "673b",
                            "673c",
                            "674a",
                            "674b",
                            "674c",
                            "674d",
                            "674e",
                            "675a",
                            "675b",
                            "675c",
                            "676a",
                            "676b",
                            "676c",
                            "676d",
                            "676e",
                            "681a",
                            "681b",
                            "682a",
                            "683a",
                            "684a",
                            "684b",
                            "685a",
                            "691a",
                            "691b",
                            "691c",
                            "691d",
                            "691e",
                            "691f",
                            "692a",
                            "9999"
                          ],
                          "description": "Code PCS-ESE de l’emploi (nomenclature INSEE).",
                          "example": "388a"
                        },
                        "mealVoucherStatus": {
                          "type": "string",
                          "enum": [
                            "DEFAULT",
                            "DISABLED"
                          ],
                          "description": "- `DEFAULT` : Suit le paramétrage entreprise\n- `DISABLED` : Désactivé"
                        },
                        "remoteWorkAllowanceStatus": {
                          "type": "string",
                          "enum": [
                            "DEFAULT",
                            "DISABLED"
                          ],
                          "description": "- `DEFAULT` : Suit le paramétrage entreprise\n- `DISABLED` : Désactivé"
                        },
                        "remoteWorkWeeklyDays": {
                          "type": [
                            "integer",
                            "null"
                          ],
                          "minimum": 0,
                          "maximum": 7,
                          "description": "Jours de télétravail par semaine, quand l’indemnité de télétravail l’exige."
                        },
                        "mealAllowanceType": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "enum": [
                            "ON_SITE",
                            "OFF_SITE",
                            "TRAVEL_RESTAURANT",
                            null
                          ],
                          "description": "- `ON_SITE` : Repas sur le lieu de travail\n- `OFF_SITE` : Repas hors des locaux\n- `TRAVEL_RESTAURANT` : Repas au restaurant en déplacement"
                        },
                        "workPlace": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "description": "Lieu de travail effectif, s’il diffère de l’adresse de l’établissement. Code INSEE requis en France ; Mayotte non prise en charge.",
                          "required": [
                            "address",
                            "addressDetails",
                            "postalCode",
                            "city",
                            "countryCode",
                            "inseeCode"
                          ],
                          "properties": {
                            "address": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 250
                            },
                            "addressDetails": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "maxLength": 250
                            },
                            "postalCode": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 10
                            },
                            "city": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "countryCode": {
                              "type": "string",
                              "enum": [
                                "FR",
                                "GP",
                                "BL",
                                "MF",
                                "MQ",
                                "GF",
                                "RE",
                                "PM",
                                "YT",
                                "WF",
                                "PF",
                                "NC",
                                "MC",
                                "AF",
                                "AL",
                                "DZ",
                                "AD",
                                "AO",
                                "AG",
                                "AR",
                                "AM",
                                "AU",
                                "AT",
                                "AZ",
                                "BS",
                                "BH",
                                "BD",
                                "BB",
                                "BY",
                                "BE",
                                "BZ",
                                "BJ",
                                "BT",
                                "BO",
                                "BA",
                                "BW",
                                "BR",
                                "BN",
                                "BG",
                                "BF",
                                "BI",
                                "CV",
                                "KH",
                                "CM",
                                "CA",
                                "CF",
                                "TD",
                                "CL",
                                "CN",
                                "CO",
                                "KM",
                                "CD",
                                "CG",
                                "CR",
                                "CI",
                                "HR",
                                "CU",
                                "CY",
                                "CZ",
                                "DK",
                                "DJ",
                                "DM",
                                "DO",
                                "EC",
                                "EG",
                                "SV",
                                "GQ",
                                "ER",
                                "EE",
                                "SZ",
                                "ET",
                                "FJ",
                                "FI",
                                "GA",
                                "GM",
                                "GE",
                                "DE",
                                "GH",
                                "GR",
                                "GD",
                                "GT",
                                "GN",
                                "GW",
                                "GY",
                                "HT",
                                "HN",
                                "HU",
                                "IS",
                                "IN",
                                "ID",
                                "IR",
                                "IQ",
                                "IE",
                                "IL",
                                "IT",
                                "JM",
                                "JP",
                                "JO",
                                "KZ",
                                "KE",
                                "KI",
                                "KP",
                                "KR",
                                "KW",
                                "KG",
                                "LA",
                                "LV",
                                "LB",
                                "LS",
                                "LR",
                                "LY",
                                "LI",
                                "LT",
                                "LU",
                                "MG",
                                "MW",
                                "MY",
                                "MV",
                                "ML",
                                "MT",
                                "MH",
                                "MR",
                                "MU",
                                "MX",
                                "FM",
                                "MD",
                                "MN",
                                "ME",
                                "MA",
                                "MZ",
                                "MM",
                                "NA",
                                "NR",
                                "NP",
                                "NL",
                                "NZ",
                                "NI",
                                "NE",
                                "NG",
                                "NO",
                                "OM",
                                "PK",
                                "PW",
                                "PS",
                                "PA",
                                "PG",
                                "PY",
                                "PE",
                                "PH",
                                "PL",
                                "PT",
                                "QA",
                                "RO",
                                "RU",
                                "RW",
                                "KN",
                                "LC",
                                "VC",
                                "WS",
                                "SM",
                                "ST",
                                "SA",
                                "SN",
                                "RS",
                                "SC",
                                "SL",
                                "SG",
                                "SK",
                                "SI",
                                "SB",
                                "SO",
                                "ZA",
                                "SS",
                                "ES",
                                "LK",
                                "SD",
                                "SR",
                                "SE",
                                "CH",
                                "SY",
                                "TW",
                                "TJ",
                                "TZ",
                                "TH",
                                "TL",
                                "TG",
                                "TO",
                                "TT",
                                "TN",
                                "TR",
                                "TM",
                                "TV",
                                "UG",
                                "UA",
                                "AE",
                                "GB",
                                "US",
                                "UY",
                                "UZ",
                                "VU",
                                "VE",
                                "VN",
                                "YE",
                                "ZM",
                                "ZW"
                              ]
                            },
                            "inseeCode": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "pattern": "^(\\d{5}|2[ABab]\\d{3})$",
                              "description": "Code officiel géographique de la commune (2A / 2B pour la Corse)."
                            }
                          }
                        },
                        "applyJeiExoneration": {
                          "type": "boolean",
                          "description": "Appliquer l’exonération JEI."
                        },
                        "applyAcreExoneration": {
                          "type": "boolean",
                          "description": "Appliquer l’exonération ACRE."
                        },
                        "remunerationPercentage": {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 1000,
                          "description": "Rémunération en pourcentage de `remunerationReference`."
                        },
                        "remunerationReference": {
                          "type": "string",
                          "enum": [
                            "SMIC",
                            "SMC"
                          ],
                          "description": "- `SMIC` : SMIC\n- `SMC` : Minimum conventionnel (SMC)"
                        },
                        "apprenticeshipFormationYear": {
                          "type": "string",
                          "enum": [
                            "FIRST_YEAR",
                            "SECOND_YEAR",
                            "THIRD_YEAR"
                          ],
                          "description": "- `FIRST_YEAR` : Première année\n- `SECOND_YEAR` : Deuxième année\n- `THIRD_YEAR` : Troisième année"
                        }
                      }
                    }
                  },
                  "apprenticeshipCalendar": {
                    "type": "object",
                    "description": "Contrat d’apprentissage uniquement : calendrier de formation.",
                    "required": [
                      "schoolDays"
                    ],
                    "properties": {
                      "endDate": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "format": "date",
                        "description": "Date jusqu’à laquelle le calendrier est connu."
                      },
                      "schoolDays": {
                        "type": "array",
                        "maxItems": 1500,
                        "items": {
                          "type": "string",
                          "format": "date"
                        },
                        "description": "Jours passés en formation."
                      }
                    }
                  }
                }
              },
              "example": {
                "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
                "workerType": "EMPLOYEE_CDI",
                "startDate": "2026-11-02",
                "establishmentSiret": "55210055400013",
                "companyRoleName": "Développeuse backend",
                "companyTeamName": "Plateforme",
                "managerId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
                "trialPeriodEndDate": "2027-03-01",
                "dpaeDoneByPuncto": true,
                "amendment": {
                  "isCadre": true,
                  "quotity": {
                    "type": "HEURE",
                    "monthlyWorkingHours": 151.67,
                    "workingPercentage": 100,
                    "paidContractualOvertimeHours": 0,
                    "rttContractualOvertimeHours": 0,
                    "rcrContractualOvertimeHours": 0
                  },
                  "conventionalWorkerStatus": "04",
                  "workerOutsideFranceStatus": "99",
                  "conventionalPosition": {
                    "type": "CADRE",
                    "position": "2.1 (au moins 26 ans)"
                  },
                  "weekDaysWorked": 31,
                  "grossAnnualSalary": 48000,
                  "codePcsEse": "388a"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Contrat créé, ses valeurs résolues à sa date de début",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiContract"
                }
              }
            }
          },
          "400": {
            "description": "Contrat refusé, rien n’est enregistré : salaire sous le minimum, période d’essai invalide, motif de CDD manquant, années de formation incomplètes, statut cadre incohérent, DPAE sans NIR ni NIA, mutuelle ou prévoyance incompatible, désignation introuvable…",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Le salaire brut annuel doit être au moins 42 000 € (minimum applicable : 3 500 €/mois)"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "409": {
            "description": "Le collaborateur a déjà un contrat qui commence ce jour, ou création concurrente en cours",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "string",
                      "description": "Message lisible, en français."
                    },
                    "contractId": {
                      "type": "string",
                      "description": "Contrat du collaborateur qui commence à la même date. Absent quand une autre création est en cours dans l’entreprise : réessayez."
                    }
                  }
                },
                "example": {
                  "error": "Le collaborateur a déjà un contrat qui commence le 02/11/2026 (cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY)",
                  "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/contracts/{contractId}": {
      "get": {
        "operationId": "getContract",
        "tags": [
          "Contrats"
        ],
        "summary": "Consulter un contrat",
        "description": "Renvoie le contrat `{contractId}`, quels que soient son statut et ses dates.\n\nAvec `matchingBy`, `{contractId}` désigne un collaborateur : Puncto renvoie son contrat en vigueur à `matchingDate`, au format `ApiContractFull` (données personnelles et manager inclus ; `managerImageKey` toujours `null`). C’est ainsi qu’on passe de votre identifiant à celui de Puncto : seul l’identifiant Puncto du contrat sert ensuite à le modifier, le supprimer ou agir sur sa période d’essai.",
        "parameters": [
          {
            "name": "contractId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du contrat ; avec `matchingBy`, l’identifiant qu’il précise.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "matchingBy",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "BY_COLLABORATOR_FOREIGN_ERP_ID",
                "BY_PUNCTO_COLLABORATOR_ID",
                "BY_PUNCTO_CONTRACT_ID"
              ],
              "description": "Facultatif : nature de la valeur du chemin, pour chercher le contrat en vigueur d’un collaborateur. Ne pas combiner avec `referenceDate`.\n\n- `BY_COLLABORATOR_FOREIGN_ERP_ID` : `foreignErpId` du collaborateur\n- `BY_PUNCTO_COLLABORATOR_ID` : identifiant Puncto du collaborateur\n- `BY_PUNCTO_CONTRACT_ID` : déprécié : identifiant Puncto d’un contrat, dont le collaborateur est retenu. Renvoie son contrat en vigueur, qui peut en être un autre ; pour ce contrat-là, n’envoyez pas `matchingBy`"
            }
          },
          {
            "name": "matchingDate",
            "in": "query",
            "description": "Avec `matchingBy` seulement : date à laquelle chercher le contrat en vigueur. Par défaut, aujourd’hui.",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-10-01"
            }
          },
          {
            "name": "referenceDate",
            "in": "query",
            "description": "Date de résolution de `currentAmendment` et `establishmentId`. Par défaut, aujourd’hui, ou la date de début d’un contrat pas encore commencé.",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-10-01"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Contrat : `PublicApiContract` sans `matchingBy`, `ApiContractFull` avec",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/PublicApiContract"
                    },
                    {
                      "$ref": "#/components/schemas/ApiContractFull"
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Contrat introuvable ; avec `matchingBy`, collaborateur introuvable ou aucun contrat à cette date",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Contrat non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "put": {
        "operationId": "updateContract",
        "tags": [
          "Contrats"
        ],
        "summary": "Modifier un contrat",
        "description": "Modifie les termes du contrat en un seul avenant : salaire, poste, équipe, établissement, lieu de travail, classification, temps de travail, avantages, exonérations, prévoyance et mutuelle. `PATCH` est accepté sur la même route. Règles détaillées et exemples : guide [Avenants](/guides/avenants).\n\n- **Date d’effet** : `effectiveFrom`, le 1er de ce mois (`CURRENT_MONTH`) ou du suivant (`NEXT_MONTH`, par défaut). Pour un contrat pas encore commencé, c’est sa date de début ; pour un contrat commencé dans le mois, `CURRENT_MONTH` vaut sa date de début. Ou `effectiveDate`, un jour précis, si seuls le salaire, le poste et l’équipe changent.\n- **Idempotence** : un avenant existant à cette date est modifié, sinon un avenant est créé. Renvoyer la même requête ne crée pas de doublon.\n- **Termes omis** : conservés. Un terme changé se reporte sur les avenants déjà prévus, jusqu’au prochain qui le change ; la classification (`conventionalPosition`, `isCadre`, `conventionalWorkerStatus`) se reporte en bloc jusqu’au premier avenant prévu qui a la sienne.\n- **Paie close** : refusé si un mois est clôturé ou un bulletin validé pour le contrat à partir du mois d’effet, ou si une mutation tombe dans un mois clôturé de l’établissement de destination.\n- **Salaire** : CDI et CDD uniquement, un changement par mois, à la date du dernier avenant ou après, et au moins le minimum conventionnel (vérifié aussi quand seules la position ou la quotité changent). Après une augmentation en cours de mois, aucun autre avenant plus tard dans ce mois.\n- **Établissement** : `workPlace` omis est conservé, même lors d’une mutation. Si Puncto dépose la DPAE (`dpaeDoneByPuncto`), changer l’établissement du mois d’embauche est refusé une fois la DPAE déposée ou en cours de dépôt (changez-le à partir du mois suivant), et avant si le nouvel établissement n’a pas de code de service de santé au travail.\n- **Mutuelle et prévoyance** : si l’avenant change le statut cadre, les contrats en vigueur doivent couvrir le nouveau statut ; envoyez le nouveau contrat de prévoyance dans la même requête.\n\nLe manager se change avec `PUT /public/v1/collaborators/{collaboratorId}`. Les bulletins en brouillon sont recalculés à partir du mois d’effet.",
        "parameters": [
          {
            "name": "contractId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du contrat. Pour partir de votre identifiant, retrouvez-le avec `GET /public/v1/contracts?collaboratorForeignErpId=…`.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Au moins un terme à modifier. Une chaîne vide ou `null` ne compte que pour les termes qui acceptent `null`.",
                "properties": {
                  "effectiveFrom": {
                    "type": "string",
                    "enum": [
                      "CURRENT_MONTH",
                      "NEXT_MONTH"
                    ],
                    "default": "NEXT_MONTH",
                    "description": "Mois d’effet : le 1er de ce mois ou du mois suivant. Ne pas combiner avec `effectiveDate`."
                  },
                  "effectiveDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Date d’effet choisie, seulement quand la requête ne change que le salaire, le poste et l’équipe. Ne pas combiner avec `effectiveFrom`.",
                    "example": "2026-11-15"
                  },
                  "grossAnnualSalary": {
                    "type": "number",
                    "minimum": 1,
                    "description": "Salaire brut annuel en euros, temps partiel compris. CDI et CDD uniquement ; au moins le minimum conventionnel de la position et de la quotité."
                  },
                  "companyRoleId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Poste, par son identifiant Puncto. Ne pas combiner avec `companyRoleName`.",
                    "example": "crol_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "companyRoleName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "Poste, par son nom exact, créé s’il n’existe pas (une seule fois, même en requêtes simultanées). Ne pas combiner avec `companyRoleId`.",
                    "example": "Lead Developer"
                  },
                  "companyTeamId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "minLength": 1,
                    "description": "Équipe, par son identifiant Puncto ; `null` retire l’équipe. Ne pas combiner avec `companyTeamName`."
                  },
                  "companyTeamName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "Équipe, par son nom exact, créée si elle n’existe pas (une seule fois, même en requêtes simultanées). Ne pas combiner avec `companyTeamId`."
                  },
                  "establishmentId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Établissement de rattachement, par son identifiant Puncto. Ne pas combiner avec `establishmentSiret`.",
                    "example": "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "establishmentSiret": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Établissement de rattachement, par son SIRET (14 chiffres, espaces ignorés). Ne pas combiner avec `establishmentId`.",
                    "example": "55210055400021"
                  },
                  "workPlace": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Lieu de travail effectif, s’il diffère de l’adresse de l’établissement (télétravail, site client…). Déclaré en DSN, il détermine les jours fériés ; `null` revient à l’adresse de l’établissement. Mayotte n’est pas encore gérée.",
                    "required": [
                      "address",
                      "addressDetails",
                      "postalCode",
                      "city",
                      "countryCode",
                      "inseeCode"
                    ],
                    "properties": {
                      "address": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 250,
                        "description": "Adresse."
                      },
                      "addressDetails": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "maxLength": 250,
                        "description": "Complément d’adresse."
                      },
                      "postalCode": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 10,
                        "description": "Code postal."
                      },
                      "city": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100,
                        "description": "Ville."
                      },
                      "countryCode": {
                        "type": "string",
                        "enum": [
                          "FR",
                          "GP",
                          "BL",
                          "MF",
                          "MQ",
                          "GF",
                          "RE",
                          "PM",
                          "YT",
                          "WF",
                          "PF",
                          "NC",
                          "MC",
                          "AF",
                          "AL",
                          "DZ",
                          "AD",
                          "AO",
                          "AG",
                          "AR",
                          "AM",
                          "AU",
                          "AT",
                          "AZ",
                          "BS",
                          "BH",
                          "BD",
                          "BB",
                          "BY",
                          "BE",
                          "BZ",
                          "BJ",
                          "BT",
                          "BO",
                          "BA",
                          "BW",
                          "BR",
                          "BN",
                          "BG",
                          "BF",
                          "BI",
                          "CV",
                          "KH",
                          "CM",
                          "CA",
                          "CF",
                          "TD",
                          "CL",
                          "CN",
                          "CO",
                          "KM",
                          "CD",
                          "CG",
                          "CR",
                          "CI",
                          "HR",
                          "CU",
                          "CY",
                          "CZ",
                          "DK",
                          "DJ",
                          "DM",
                          "DO",
                          "EC",
                          "EG",
                          "SV",
                          "GQ",
                          "ER",
                          "EE",
                          "SZ",
                          "ET",
                          "FJ",
                          "FI",
                          "GA",
                          "GM",
                          "GE",
                          "DE",
                          "GH",
                          "GR",
                          "GD",
                          "GT",
                          "GN",
                          "GW",
                          "GY",
                          "HT",
                          "HN",
                          "HU",
                          "IS",
                          "IN",
                          "ID",
                          "IR",
                          "IQ",
                          "IE",
                          "IL",
                          "IT",
                          "JM",
                          "JP",
                          "JO",
                          "KZ",
                          "KE",
                          "KI",
                          "KP",
                          "KR",
                          "KW",
                          "KG",
                          "LA",
                          "LV",
                          "LB",
                          "LS",
                          "LR",
                          "LY",
                          "LI",
                          "LT",
                          "LU",
                          "MG",
                          "MW",
                          "MY",
                          "MV",
                          "ML",
                          "MT",
                          "MH",
                          "MR",
                          "MU",
                          "MX",
                          "FM",
                          "MD",
                          "MN",
                          "ME",
                          "MA",
                          "MZ",
                          "MM",
                          "NA",
                          "NR",
                          "NP",
                          "NL",
                          "NZ",
                          "NI",
                          "NE",
                          "NG",
                          "NO",
                          "OM",
                          "PK",
                          "PW",
                          "PS",
                          "PA",
                          "PG",
                          "PY",
                          "PE",
                          "PH",
                          "PL",
                          "PT",
                          "QA",
                          "RO",
                          "RU",
                          "RW",
                          "KN",
                          "LC",
                          "VC",
                          "WS",
                          "SM",
                          "ST",
                          "SA",
                          "SN",
                          "RS",
                          "SC",
                          "SL",
                          "SG",
                          "SK",
                          "SI",
                          "SB",
                          "SO",
                          "ZA",
                          "SS",
                          "ES",
                          "LK",
                          "SD",
                          "SR",
                          "SE",
                          "CH",
                          "SY",
                          "TW",
                          "TJ",
                          "TZ",
                          "TH",
                          "TL",
                          "TG",
                          "TO",
                          "TT",
                          "TN",
                          "TR",
                          "TM",
                          "TV",
                          "UG",
                          "UA",
                          "AE",
                          "GB",
                          "US",
                          "UY",
                          "UZ",
                          "VU",
                          "VE",
                          "VN",
                          "YE",
                          "ZM",
                          "ZW"
                        ],
                        "description": "Code pays ISO 3166-1 alpha-2 (`FR`, `GP`, `MQ`, `GF`, `RE`…)."
                      },
                      "inseeCode": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "pattern": "^(\\d{5}|2[AB]\\d{3})$",
                        "description": "Code INSEE de la commune (`2A`/`2B` pour la Corse, `97x` pour l’outre-mer). Requis pour une adresse française."
                      }
                    },
                    "example": {
                      "address": "12 rue Victor Hugo",
                      "addressDetails": null,
                      "postalCode": "69002",
                      "city": "Lyon",
                      "countryCode": "FR",
                      "inseeCode": "69382"
                    }
                  },
                  "isCadre": {
                    "type": "boolean",
                    "description": "Statut cadre. Omis avec une nouvelle `conventionalPosition`, il en découle (CADRE ou ETAM) ; envoyé, il doit lui correspondre."
                  },
                  "conventionalWorkerStatus": {
                    "type": "string",
                    "enum": [
                      "01",
                      "02",
                      "03",
                      "04",
                      "05",
                      "06",
                      "07",
                      "08",
                      "09",
                      "10"
                    ],
                    "description": "Statut catégoriel déclaré en DSN. `03` et `04` sont réservés aux cadres, `05` à `07` aux non-cadres. Omis, il est conservé s’il correspond au statut cadre, sinon déduit : `04` cadre (`03` cadre dirigeant), `05` non-cadre (`07` stagiaire).\n\n- `01` : 01 - agriculteur salarié de son exploitation\n- `02` : 02 - artisan ou commerçant salarié de son entreprise\n- `03` : 03 - cadre dirigeant (votant au collège employeur des élections prud'homales)\n- `04` : 04 - autres cadres au sens de la convention collective (ou du statut pour les régimes spéciaux)\n- `05` : 05 - profession intermédiaire (technicien, contremaître, agent de maîtrise, clergé)\n- `06` : 06 - employé administratif d'entreprise, de commerce, agent de service\n- `07` : 07 - ouvriers qualifiés et non qualifiés y compris ouvriers agricoles\n- `08` : 08 - agent de la fonction publique d'Etat\n- `09` : 09 - agent de la fonction publique hospitalière\n- `10` : 10 - agent de la fonction publique territoriale"
                  },
                  "conventionalPosition": {
                    "description": "Position de la classification Syntec. Fixe `isCadre` et `conventionalWorkerStatus` s’ils sont omis. Ne se retire pas : `null` équivaut à l’omettre.",
                    "oneOf": [
                      {
                        "type": "object",
                        "title": "Cadre",
                        "required": [
                          "type",
                          "position"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "CADRE"
                          },
                          "position": {
                            "type": "string",
                            "enum": [
                              "1.1",
                              "1.2",
                              "2.1 (moins 26 ans)",
                              "2.1 (au moins 26 ans)",
                              "2.2",
                              "2.3",
                              "3.1",
                              "3.2",
                              "3.3"
                            ]
                          }
                        }
                      },
                      {
                        "type": "object",
                        "title": "ETAM",
                        "required": [
                          "type",
                          "position"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "ETAM"
                          },
                          "position": {
                            "type": "string",
                            "enum": [
                              "1.1",
                              "1.2",
                              "2.1",
                              "2.2",
                              "2.3",
                              "3.1",
                              "3.2",
                              "3.3"
                            ]
                          }
                        }
                      }
                    ]
                  },
                  "codePcsEse": {
                    "type": "string",
                    "enum": [
                      "100x",
                      "210x",
                      "220x",
                      "231a",
                      "232a",
                      "233a",
                      "233b",
                      "233c",
                      "233d",
                      "311c",
                      "311d",
                      "311e",
                      "312a",
                      "331a",
                      "332a",
                      "332b",
                      "333a",
                      "333b",
                      "333c",
                      "333d",
                      "333e",
                      "333f",
                      "334a",
                      "335a",
                      "341a",
                      "341b",
                      "342b",
                      "342c",
                      "342d",
                      "342f",
                      "342g",
                      "342h",
                      "343a",
                      "344a",
                      "344b",
                      "344c",
                      "344d",
                      "351a",
                      "352a",
                      "352b",
                      "353a",
                      "353b",
                      "353c",
                      "354a",
                      "354b",
                      "354c",
                      "354e",
                      "354f",
                      "354g",
                      "371a",
                      "372a",
                      "372b",
                      "372c",
                      "372d",
                      "372e",
                      "372f",
                      "373a",
                      "373b",
                      "373c",
                      "373d",
                      "374a",
                      "374b",
                      "374c",
                      "374d",
                      "375a",
                      "375b",
                      "376a",
                      "376b",
                      "376c",
                      "376d",
                      "376e",
                      "376f",
                      "376g",
                      "377a",
                      "380a",
                      "381b",
                      "381c",
                      "382a",
                      "382b",
                      "382c",
                      "382d",
                      "383a",
                      "383b",
                      "383c",
                      "384a",
                      "384b",
                      "384c",
                      "385a",
                      "385b",
                      "385c",
                      "386b",
                      "386c",
                      "386d",
                      "386e",
                      "387a",
                      "387b",
                      "387c",
                      "387d",
                      "387e",
                      "387f",
                      "388a",
                      "388b",
                      "388c",
                      "388d",
                      "388e",
                      "389a",
                      "389b",
                      "389c",
                      "421a",
                      "421b",
                      "422a",
                      "422b",
                      "422c",
                      "422d",
                      "422e",
                      "423a",
                      "423b",
                      "424a",
                      "425a",
                      "431a",
                      "431b",
                      "431c",
                      "431d",
                      "431e",
                      "431f",
                      "432b",
                      "432d",
                      "433a",
                      "433b",
                      "433c",
                      "433d",
                      "434a",
                      "434b",
                      "434c",
                      "434d",
                      "434e",
                      "434f",
                      "434g",
                      "435a",
                      "435b",
                      "441a",
                      "441b",
                      "451a",
                      "451b",
                      "451c",
                      "451d",
                      "451e",
                      "451g",
                      "451h",
                      "452a",
                      "452b",
                      "461b",
                      "461c",
                      "461d",
                      "461e",
                      "461f",
                      "462a",
                      "462b",
                      "462c",
                      "462d",
                      "462e",
                      "463a",
                      "463b",
                      "463c",
                      "463d",
                      "463e",
                      "464a",
                      "464b",
                      "465a",
                      "465b",
                      "465c",
                      "466a",
                      "466b",
                      "466c",
                      "467a",
                      "467b",
                      "467c",
                      "467d",
                      "468a",
                      "468b",
                      "471a",
                      "471b",
                      "472a",
                      "472b",
                      "472c",
                      "472d",
                      "473a",
                      "473b",
                      "473c",
                      "474a",
                      "474b",
                      "474c",
                      "475a",
                      "475b",
                      "476a",
                      "476b",
                      "477a",
                      "477b",
                      "477c",
                      "477d",
                      "478a",
                      "478b",
                      "478c",
                      "478d",
                      "479a",
                      "479b",
                      "480a",
                      "480b",
                      "481a",
                      "481b",
                      "482a",
                      "483a",
                      "484a",
                      "484b",
                      "485a",
                      "485b",
                      "486b",
                      "486c",
                      "486d",
                      "486e",
                      "487a",
                      "487b",
                      "488a",
                      "488b",
                      "521a",
                      "521b",
                      "522a",
                      "523a",
                      "523b",
                      "523c",
                      "523d",
                      "524a",
                      "524b",
                      "524c",
                      "524d",
                      "525a",
                      "525b",
                      "525c",
                      "525d",
                      "526a",
                      "526b",
                      "526c",
                      "526d",
                      "526e",
                      "531a",
                      "531b",
                      "531c",
                      "532a",
                      "532b",
                      "532c",
                      "533a",
                      "533b",
                      "533c",
                      "534a",
                      "534b",
                      "541b",
                      "541c",
                      "541d",
                      "542a",
                      "542b",
                      "543b",
                      "543c",
                      "543e",
                      "543f",
                      "543g",
                      "543h",
                      "544a",
                      "545a",
                      "545b",
                      "545c",
                      "545d",
                      "546a",
                      "546b",
                      "546c",
                      "546d",
                      "546e",
                      "551a",
                      "552a",
                      "553b",
                      "553c",
                      "554a",
                      "554b",
                      "554c",
                      "554d",
                      "554e",
                      "554f",
                      "554g",
                      "554h",
                      "554j",
                      "555a",
                      "556a",
                      "561b",
                      "561c",
                      "561d",
                      "561e",
                      "561f",
                      "562a",
                      "562b",
                      "563a",
                      "563b",
                      "563c",
                      "564a",
                      "564b",
                      "621a",
                      "621b",
                      "621c",
                      "621d",
                      "621e",
                      "621f",
                      "621g",
                      "622a",
                      "622c",
                      "622d",
                      "622e",
                      "622f",
                      "622g",
                      "623a",
                      "623b",
                      "623d",
                      "623e",
                      "623f",
                      "623g",
                      "624b",
                      "624c",
                      "624d",
                      "624e",
                      "624f",
                      "624g",
                      "625a",
                      "625b",
                      "625c",
                      "625d",
                      "625f",
                      "625g",
                      "625h",
                      "626a",
                      "626b",
                      "626c",
                      "627a",
                      "627b",
                      "627c",
                      "627d",
                      "627e",
                      "627f",
                      "628a",
                      "628b",
                      "628c",
                      "628d",
                      "628e",
                      "628f",
                      "628g",
                      "631a",
                      "632a",
                      "632b",
                      "632c",
                      "632d",
                      "632e",
                      "632f",
                      "632g",
                      "632h",
                      "632j",
                      "632k",
                      "633a",
                      "633b",
                      "633c",
                      "633d",
                      "634a",
                      "634b",
                      "634c",
                      "634d",
                      "635a",
                      "636a",
                      "636b",
                      "636c",
                      "636d",
                      "637a",
                      "637b",
                      "637c",
                      "637d",
                      "641a",
                      "641b",
                      "642a",
                      "642b",
                      "643a",
                      "644a",
                      "651a",
                      "651b",
                      "652a",
                      "652b",
                      "653a",
                      "654b",
                      "654c",
                      "655a",
                      "656b",
                      "656c",
                      "671a",
                      "671c",
                      "671d",
                      "672a",
                      "673a",
                      "673b",
                      "673c",
                      "674a",
                      "674b",
                      "674c",
                      "674d",
                      "674e",
                      "675a",
                      "675b",
                      "675c",
                      "676a",
                      "676b",
                      "676c",
                      "676d",
                      "676e",
                      "681a",
                      "681b",
                      "682a",
                      "683a",
                      "684a",
                      "684b",
                      "685a",
                      "691a",
                      "691b",
                      "691c",
                      "691d",
                      "691e",
                      "691f",
                      "692a",
                      "9999"
                    ],
                    "description": "Code PCS-ESE de l’emploi, obligatoire en DSN. Ne se retire pas : `null` équivaut à l’omettre."
                  },
                  "quotity": {
                    "description": "Temps de travail. `type` détermine les autres champs, tous requis : `HEURE`, `FORFAIT_JOUR`, `FORFAIT_HEURE` (forfait hebdomadaire, modalité 2 Syntec) ou `NON_CONCERNE` (mandataires).",
                    "oneOf": [
                      {
                        "type": "object",
                        "title": "Heures",
                        "required": [
                          "type",
                          "monthlyWorkingHours",
                          "workingPercentage",
                          "paidContractualOvertimeHours",
                          "rttContractualOvertimeHours",
                          "rcrContractualOvertimeHours"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "HEURE"
                          },
                          "monthlyWorkingHours": {
                            "type": "number",
                            "minimum": 0,
                            "description": "Heures mensualisées, 151,67 pour un temps plein."
                          },
                          "workingPercentage": {
                            "type": "number",
                            "minimum": 1,
                            "maximum": 100,
                            "description": "Taux d’activité, en %."
                          },
                          "paidContractualOvertimeHours": {
                            "type": "number",
                            "minimum": 0,
                            "description": "Heures supplémentaires contractuelles payées, par semaine. Interdites à temps partiel."
                          },
                          "rttContractualOvertimeHours": {
                            "type": "number",
                            "minimum": 0,
                            "description": "Heures supplémentaires contractuelles compensées en RTT, par semaine. Nécessite des JRTT paramétrés."
                          },
                          "rcrContractualOvertimeHours": {
                            "type": "number",
                            "minimum": 0,
                            "description": "Heures supplémentaires contractuelles compensées en repos, par semaine."
                          }
                        }
                      },
                      {
                        "type": "object",
                        "title": "Forfait jours",
                        "required": [
                          "type",
                          "forfaitDailyAmount",
                          "monthlyWorkingDays",
                          "workingPercentage"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "FORFAIT_JOUR"
                          },
                          "forfaitDailyAmount": {
                            "type": "number",
                            "minimum": 0,
                            "description": "Jours du forfait annuel, 218 pour un temps plein."
                          },
                          "monthlyWorkingDays": {
                            "type": "number",
                            "minimum": 0,
                            "description": "Jours mensualisés, 21,67 pour un temps plein."
                          },
                          "workingPercentage": {
                            "type": "number",
                            "minimum": 1,
                            "maximum": 100
                          }
                        }
                      },
                      {
                        "type": "object",
                        "title": "Forfait heures",
                        "required": [
                          "type",
                          "period",
                          "forfaitHours",
                          "monthlyWorkingHours",
                          "annualWorkingDaysCap",
                          "workingPercentage"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "FORFAIT_HEURE"
                          },
                          "period": {
                            "type": "string",
                            "enum": [
                              "WEEKLY"
                            ],
                            "description": "Seul le forfait hebdomadaire est pris en charge."
                          },
                          "forfaitHours": {
                            "type": "number",
                            "exclusiveMinimum": 35,
                            "description": "Heures du forfait par semaine, 38,5 en modalité 2 Syntec."
                          },
                          "monthlyWorkingHours": {
                            "type": "number",
                            "minimum": 0
                          },
                          "annualWorkingDaysCap": {
                            "type": "number",
                            "minimum": 1,
                            "maximum": 365,
                            "description": "Plafond annuel de jours travaillés, 219 en modalité 2 Syntec."
                          },
                          "workingPercentage": {
                            "type": "number",
                            "const": 100,
                            "description": "Le forfait heures réduit n’est pas pris en charge."
                          }
                        }
                      },
                      {
                        "type": "object",
                        "title": "Non concerné",
                        "required": [
                          "type"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "NON_CONCERNE"
                          }
                        }
                      }
                    ]
                  },
                  "weekDaysWorked": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 127,
                    "description": "Jours travaillés, en somme de bits : lundi 1, mardi 2, mercredi 4, jeudi 8, vendredi 16, samedi 32, dimanche 64 (31 du lundi au vendredi). Seul, il déplace les jours du planning type en gardant ses horaires ; avec `workSchedule`, il doit en décrire les jours.",
                    "example": 31
                  },
                  "workSchedule": {
                    "type": "object",
                    "description": "Planning type de la semaine ; un jour absent n’est pas travaillé. Avec une quotité `HEURE`, le total des horaires doit lui correspondre.",
                    "required": [
                      "version",
                      "days"
                    ],
                    "properties": {
                      "version": {
                        "type": "integer",
                        "const": 1
                      },
                      "days": {
                        "type": "object",
                        "minProperties": 1,
                        "additionalProperties": false,
                        "properties": {
                          "MONDAY": {
                            "type": "object",
                            "required": [
                              "morning",
                              "afternoon"
                            ],
                            "properties": {
                              "morning": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              },
                              "afternoon": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              }
                            }
                          },
                          "TUESDAY": {
                            "type": "object",
                            "required": [
                              "morning",
                              "afternoon"
                            ],
                            "properties": {
                              "morning": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              },
                              "afternoon": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              }
                            }
                          },
                          "WEDNESDAY": {
                            "type": "object",
                            "required": [
                              "morning",
                              "afternoon"
                            ],
                            "properties": {
                              "morning": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              },
                              "afternoon": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              }
                            }
                          },
                          "THURSDAY": {
                            "type": "object",
                            "required": [
                              "morning",
                              "afternoon"
                            ],
                            "properties": {
                              "morning": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              },
                              "afternoon": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              }
                            }
                          },
                          "FRIDAY": {
                            "type": "object",
                            "required": [
                              "morning",
                              "afternoon"
                            ],
                            "properties": {
                              "morning": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              },
                              "afternoon": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              }
                            }
                          },
                          "SATURDAY": {
                            "type": "object",
                            "required": [
                              "morning",
                              "afternoon"
                            ],
                            "properties": {
                              "morning": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              },
                              "afternoon": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              }
                            }
                          },
                          "SUNDAY": {
                            "type": "object",
                            "required": [
                              "morning",
                              "afternoon"
                            ],
                            "properties": {
                              "morning": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              },
                              "afternoon": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "required": [
                                  "start",
                                  "end"
                                ],
                                "properties": {
                                  "start": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "09:00"
                                  },
                                  "end": {
                                    "type": "string",
                                    "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
                                    "example": "12:30"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  },
                  "mealVoucherStatus": {
                    "type": "string",
                    "enum": [
                      "DEFAULT",
                      "DISABLED"
                    ],
                    "description": "Titres-restaurant.\n\n- `DEFAULT` : Suit le paramétrage entreprise\n- `DISABLED` : Désactivé"
                  },
                  "remoteWorkAllowanceStatus": {
                    "type": "string",
                    "enum": [
                      "DEFAULT",
                      "DISABLED"
                    ],
                    "description": "Indemnité de télétravail.\n\n- `DEFAULT` : Suit le paramétrage entreprise\n- `DISABLED` : Désactivé"
                  },
                  "remoteWorkWeeklyDays": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0,
                    "maximum": 7,
                    "description": "Jours de télétravail par semaine, si l’établissement verse une indemnité forfaitaire par jour hebdomadaire."
                  },
                  "mealAllowanceType": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "ON_SITE",
                      "OFF_SITE",
                      "TRAVEL_RESTAURANT",
                      null
                    ],
                    "description": "Prime de panier.\n\n- `ON_SITE` : Repas sur le lieu de travail\n- `OFF_SITE` : Repas hors des locaux\n- `TRAVEL_RESTAURANT` : Repas au restaurant en déplacement"
                  },
                  "applyJeiExoneration": {
                    "type": "boolean",
                    "description": "Exonération Jeune entreprise innovante."
                  },
                  "applyAcreExoneration": {
                    "type": "boolean",
                    "description": "Exonération ACRE."
                  },
                  "prevoyanceOcContractId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "minLength": 1,
                    "description": "Contrat de prévoyance auquel affilier le salarié ; `null` met fin à l’affiliation. Doit être à cotisation par tranches, en vigueur à la date d’effet et couvrir la population du salarié (cadre ou non).",
                    "example": "ocon_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "hasMutuelleDispense": {
                    "type": "boolean",
                    "description": "Dispense de mutuelle : l’affiliation prend fin à la date d’effet. `true` exclut `mutuelleOcContractId` et `mutuelleForfaitChoice`."
                  },
                  "mutuelleOcContractId": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "minLength": 1,
                    "description": "Contrat de mutuelle auquel affilier le salarié ; `null` met fin à l’affiliation. Doit être à cotisation forfaitaire, en vigueur à la date d’effet et couvrir la population du salarié. Sans `mutuelleForfaitChoice`, la formule actuelle est conservée et doit exister dans ce contrat."
                  },
                  "mutuelleForfaitChoice": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "minLength": 1,
                    "description": "Formule de mutuelle du contrat en vigueur à la date d’effet (`UNIQUE`, `OPTION_<code>`, `CONDITION_<code>` ou, quand plusieurs forfaits partagent une option, `TIER_<code>__<libellé>`). Seule, elle change la formule sans changer de contrat."
                  },
                  "publicTransportEmployerRate": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0,
                    "maximum": 100,
                    "description": "Taux de prise en charge des transports en commun propre au contrat, en %. Vaut pour les prochaines saisies de frais, sans avenant ; `null` le retire."
                  },
                  "corporateOfficerSalaryMaintenance": {
                    "type": "boolean",
                    "description": "Mandat social uniquement : rémunération maintenue pendant les arrêts. Sans avenant."
                  }
                }
              },
              "example": {
                "effectiveFrom": "NEXT_MONTH",
                "companyRoleName": "Lead Developer",
                "conventionalPosition": {
                  "type": "CADRE",
                  "position": "3.1"
                },
                "grossAnnualSalary": 58000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Contrat, ses valeurs en vigueur résolues à la date d’effet",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiContract"
                }
              }
            }
          },
          "400": {
            "description": "Modification refusée : contrat clôturé, date d’effet, paie close, salaire, DPAE…",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "effectiveDate ne date que le salaire, le poste et l’équipe : les autres termes changent au 1er de ce mois ou du mois suivant, avec effectiveFrom (mealVoucherStatus)"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Contrat introuvable dans l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Contrat non trouvé"
                }
              }
            }
          },
          "409": {
            "description": "Une autre modification du contrat est en cours (ou, si l’avenant crée un poste ou une équipe, une autre création dans l’entreprise) : réessayez",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error",
                    "contractId"
                  ],
                  "properties": {
                    "error": {
                      "type": "string",
                      "description": "Message lisible, en français."
                    },
                    "contractId": {
                      "type": "string",
                      "description": "Identifiant Puncto du contrat."
                    }
                  }
                },
                "example": {
                  "error": "Une autre modification de ce contrat est en cours : réessayez dans quelques instants",
                  "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "delete": {
        "operationId": "deleteContract",
        "tags": [
          "Contrats"
        ],
        "summary": "Supprimer un contrat",
        "description": "Supprime définitivement le contrat et ses données ; le collaborateur est conservé. Refusé si le contrat ou une de ses paies est clôturé, ou si une DSN événementielle a été déclarée pour lui. Pour supprimer aussi le collaborateur : [Supprimer un collaborateur](/reference/collaborateurs/delete-collaborator).",
        "parameters": [
          {
            "name": "contractId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du contrat. Pour partir de votre identifiant, retrouvez-le avec `GET /public/v1/contracts?collaboratorForeignErpId=…`.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Contrat supprimé"
          },
          "400": {
            "description": "Suppression refusée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Une paie de ce contrat a déjà été clôturée, il ne peut plus être supprimé."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Contrat introuvable dans l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Contrat non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/absences": {
      "get": {
        "operationId": "listAbsences",
        "tags": [
          "Absences"
        ],
        "summary": "Lister les absences",
        "description": "Liste paginée des absences de l’entreprise, par date de début décroissante.\n\nUne prolongation d’arrêt de travail a `isProlongation` à `true` : son `workStoppage` est l’arrêt initial, avec l’avis de prolongation pour justificatif.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "type[]",
            "in": "query",
            "description": "Types d’absence à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "JNT",
                  "RTT",
                  "COR",
                  "RCR",
                  "PTO_N",
                  "PTO_N-1",
                  "PTO_N-2",
                  "UNPAID",
                  "FAMILY",
                  "PARENTAL",
                  "REST",
                  "SICK",
                  "SICK_AT",
                  "SICK_MP",
                  "SICK_ATJ",
                  "SENIORITY",
                  "INTERN_CP",
                  "PREGNANCY_EXAM"
                ],
                "description": "- `JNT` : Jours Non Travaillés (forfait jour)\n- `RTT` : RTT\n- `COR` : Contrepartie Obligatoire en Repos\n- `RCR` : Repos Compensateur\n- `PTO_N` : Congés payés\n- `PTO_N-1` : Congés payés N-1\n- `PTO_N-2` : Congés payés N-2\n- `UNPAID` : Congés sans solde\n- `FAMILY` : Congés familiaux\n- `PARENTAL` : Congés parentaux\n- `REST` : Repos\n- `SICK` : Maladie ordinaire\n- `SICK_AT` : Accident du travail\n- `SICK_MP` : Maladie professionnelle\n- `SICK_ATJ` : Accident de trajet\n- `SENIORITY` : Ancienneté\n- `INTERN_CP` : Congé payé stage\n- `PREGNANCY_EXAM` : Examens obligatoires de grossesse"
              }
            }
          },
          {
            "name": "status[]",
            "in": "query",
            "description": "Statuts à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "pending",
                  "validated",
                  "rejected",
                  "canceled",
                  "technical-cancel"
                ],
                "description": "- `pending` : En attente\n- `validated` : Accepté\n- `rejected` : Refusé\n- `canceled` : Annulé\n- `technical-cancel` : Annulation technique"
              }
            }
          },
          {
            "name": "contractId",
            "in": "query",
            "description": "Identifiant Puncto du contrat.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          },
          {
            "name": "minCreationDate",
            "in": "query",
            "description": "Absences créées à partir de cette date (ISO 8601).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "maxCreationDate",
            "in": "query",
            "description": "Absences créées jusqu’à cette date (ISO 8601).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page d’absences",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiAbsence"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur du filtre introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "post": {
        "operationId": "createAbsence",
        "tags": [
          "Absences"
        ],
        "summary": "Créer une absence",
        "description": "Crée une absence, validée d’emblée.\n\n- Refusée (`400`) notamment si elle chevauche une autre absence, dépasse le solde ou la durée légale d’un événement familial.\n- Sur un mois clôturé, la paie suivante la régularise.\n- Un congé payé est réparti entre `PTO_N`, `PTO_N-1` et `PTO_N-2` selon les soldes, en plusieurs absences si besoin : la réponse renvoie la première, `GET /public/v1/absences` les liste toutes.\n\nJustificatif : envoyez la requête en `multipart/form-data` avec un fichier `proofFile` (pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "contractMatching",
                  "type",
                  "startDate",
                  "endDate",
                  "onlyHalfDayAtStart",
                  "onlyHalfDayAtEnd"
                ],
                "properties": {
                  "foreignErpId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "Identifiant de l’absence dans votre système, unique parmi les absences de l’entreprise : un `foreignErpId` déjà utilisé renvoie `409`."
                  },
                  "contractMatching": {
                    "type": "object",
                    "description": "Désigne le contrat. Pour un collaborateur, Puncto retient son contrat actif à `eventDate`, à défaut à `startDate`.",
                    "required": [
                      "type",
                      "value"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "enum": [
                          "BY_PUNCTO_COLLABORATOR_ID",
                          "BY_PUNCTO_CONTRACT_ID"
                        ],
                        "description": "Clé de correspondance utilisée par `value`.\n\n- `BY_PUNCTO_COLLABORATOR_ID` : `value` est l’identifiant Puncto du collaborateur\n- `BY_PUNCTO_CONTRACT_ID` : `value` est l’identifiant Puncto du contrat (`GET /public/v1/contracts`), `eventDate` est ignorée"
                      },
                      "value": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Identifiant Puncto du collaborateur, ou du contrat avec `BY_PUNCTO_CONTRACT_ID`. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/collaborators?collaboratorForeignErpId=…`."
                      },
                      "eventDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date de l’événement, pour choisir le contrat quand le collaborateur en a plusieurs sur le mois.",
                        "example": "2026-10-05"
                      }
                    }
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "JNT",
                      "RTT",
                      "COR",
                      "RCR",
                      "PTO_N",
                      "PTO_N-1",
                      "PTO_N-2",
                      "UNPAID",
                      "FAMILY",
                      "REST",
                      "SENIORITY",
                      "INTERN_CP",
                      "PREGNANCY_EXAM"
                    ],
                    "description": "Les arrêts de travail (`SICK`, `SICK_AT`, `SICK_ATJ`, `SICK_MP`) et les congés parentaux (`PARENTAL`) sont refusés : saisissez-les dans Puncto.\n\n- `JNT` : Jours Non Travaillés (forfait jour)\n- `RTT` : RTT\n- `COR` : Contrepartie Obligatoire en Repos\n- `RCR` : Repos Compensateur\n- `PTO_N` : Congés payés\n- `PTO_N-1` : Congés payés N-1\n- `PTO_N-2` : Congés payés N-2\n- `UNPAID` : Congés sans solde\n- `FAMILY` : Congés familiaux\n- `REST` : Repos\n- `SENIORITY` : Ancienneté\n- `INTERN_CP` : Congé payé stage\n- `PREGNANCY_EXAM` : Examens obligatoires de grossesse"
                  },
                  "startDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Premier jour d’absence.",
                    "example": "2026-10-05"
                  },
                  "endDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Dernier jour d’absence, inclus.",
                    "example": "2026-10-05"
                  },
                  "onlyHalfDayAtStart": {
                    "type": "boolean",
                    "description": "Le premier jour, seul l’après-midi est pris."
                  },
                  "onlyHalfDayAtEnd": {
                    "type": "boolean",
                    "description": "Le dernier jour, seule la matinée est prise."
                  },
                  "familyEventType": {
                    "type": "string",
                    "enum": [
                      "mariage_pacs_salarie",
                      "mariage_pacs_enfant",
                      "deces_conjoint_pacs",
                      "deces_enfant_moins_25_oui",
                      "deces_enfant_moins_25_non_parent_oui",
                      "deces_enfant_moins_25_non_parent_non",
                      "deces_personne_charge_moins_25",
                      "deces_parent",
                      "deces_beau_frere_belle_soeur",
                      "deces_frere_soeur",
                      "deces_beau_parent",
                      "deces_autre_ascendant",
                      "deuil_enfant_moins_25",
                      "naissance_adoption",
                      "handicap_enfant"
                    ],
                    "description": "Événement familial. Requis quand `type` vaut `FAMILY`."
                  },
                  "childArrivalDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Date de naissance de l’enfant, requise pour un congé de naissance. Pour `PREGNANCY_EXAM`, date présumée de l’accouchement, facultative."
                  },
                  "pregnancyExamBeneficiary": {
                    "type": "string",
                    "enum": [
                      "PREGNANT_EMPLOYEE",
                      "PARTNER"
                    ],
                    "description": "Requis quand `type` vaut `PREGNANCY_EXAM`.\n\n- `PREGNANT_EMPLOYEE` : Salariée enceinte ou en parcours de PMA\n- `PARTNER` : Conjoint, partenaire de PACS ou concubin"
                  }
                }
              },
              "example": {
                "foreignErpId": "absence-123",
                "contractMatching": {
                  "type": "BY_PUNCTO_COLLABORATOR_ID",
                  "value": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                },
                "type": "RTT",
                "startDate": "2026-10-05",
                "endDate": "2026-10-05",
                "onlyHalfDayAtStart": false,
                "onlyHalfDayAtEnd": false
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Absence créée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiAbsence"
                }
              }
            }
          },
          "400": {
            "description": "Absence refusée (chevauchement, solde, durée légale…)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Une absence existe déjà sur cette période pour ce contrat"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur ou contrat introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Contrat non trouvé"
                }
              }
            }
          },
          "409": {
            "description": "`foreignErpId` déjà utilisé",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Une absence existe déjà avec le foreignErpId absence-123 (identifiant Puncto abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY)."
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/absences/{absenceId}": {
      "put": {
        "operationId": "updateAbsence",
        "tags": [
          "Absences"
        ],
        "summary": "Modifier une absence ou changer son statut",
        "description": "Modifie une absence ou change son statut, avec les contrôles de la création. Envoyez **soit** `status`, **soit** tous les détails de l’absence, jamais les deux.\n\n- Transitions : `pending` → `validated` ou `rejected`, `validated` → `canceled`. Une absence ne se supprime pas : annulez-la.\n- Un arrêt de travail ou un congé parental ne change que de statut.\n- Sur un mois clôturé, la paie suivante régularise ; les bulletins en brouillon sont recalculés.\n- Un congé payé réparti sur plusieurs compteurs forme plusieurs absences : modifiez chacune.\n\nJustificatif : envoyez la requête en `multipart/form-data` avec un fichier `proofFile` (pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip).",
        "parameters": [
          {
            "name": "absenceId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de l’absence.",
            "schema": {
              "type": "string",
              "example": "abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "validated",
                      "rejected",
                      "canceled"
                    ],
                    "description": "- `validated` : Accepté\n- `rejected` : Refusé\n- `canceled` : Annulé"
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "JNT",
                      "RTT",
                      "COR",
                      "RCR",
                      "PTO_N",
                      "PTO_N-1",
                      "PTO_N-2",
                      "UNPAID",
                      "FAMILY",
                      "REST",
                      "SENIORITY",
                      "INTERN_CP",
                      "PREGNANCY_EXAM"
                    ],
                    "description": "Les arrêts de travail (`SICK`, `SICK_AT`, `SICK_ATJ`, `SICK_MP`) et les congés parentaux (`PARENTAL`) sont refusés : saisissez-les dans Puncto.\n\n- `JNT` : Jours Non Travaillés (forfait jour)\n- `RTT` : RTT\n- `COR` : Contrepartie Obligatoire en Repos\n- `RCR` : Repos Compensateur\n- `PTO_N` : Congés payés\n- `PTO_N-1` : Congés payés N-1\n- `PTO_N-2` : Congés payés N-2\n- `UNPAID` : Congés sans solde\n- `FAMILY` : Congés familiaux\n- `REST` : Repos\n- `SENIORITY` : Ancienneté\n- `INTERN_CP` : Congé payé stage\n- `PREGNANCY_EXAM` : Examens obligatoires de grossesse"
                  },
                  "startDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Premier jour d’absence.",
                    "example": "2026-10-05"
                  },
                  "endDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Dernier jour d’absence, inclus.",
                    "example": "2026-10-05"
                  },
                  "onlyHalfDayAtStart": {
                    "type": "boolean",
                    "description": "Le premier jour, seul l’après-midi est pris."
                  },
                  "onlyHalfDayAtEnd": {
                    "type": "boolean",
                    "description": "Le dernier jour, seule la matinée est prise."
                  },
                  "familyEventType": {
                    "type": "string",
                    "enum": [
                      "mariage_pacs_salarie",
                      "mariage_pacs_enfant",
                      "deces_conjoint_pacs",
                      "deces_enfant_moins_25_oui",
                      "deces_enfant_moins_25_non_parent_oui",
                      "deces_enfant_moins_25_non_parent_non",
                      "deces_personne_charge_moins_25",
                      "deces_parent",
                      "deces_beau_frere_belle_soeur",
                      "deces_frere_soeur",
                      "deces_beau_parent",
                      "deces_autre_ascendant",
                      "deuil_enfant_moins_25",
                      "naissance_adoption",
                      "handicap_enfant"
                    ],
                    "description": "Événement familial. Requis quand `type` vaut `FAMILY`."
                  },
                  "childArrivalDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Date de naissance de l’enfant, requise pour un congé de naissance. Pour `PREGNANCY_EXAM`, date présumée de l’accouchement, facultative."
                  },
                  "pregnancyExamBeneficiary": {
                    "type": "string",
                    "enum": [
                      "PREGNANT_EMPLOYEE",
                      "PARTNER"
                    ],
                    "description": "Requis quand `type` vaut `PREGNANCY_EXAM`.\n\n- `PREGNANT_EMPLOYEE` : Salariée enceinte ou en parcours de PMA\n- `PARTNER` : Conjoint, partenaire de PACS ou concubin"
                  }
                }
              },
              "example": {
                "status": "validated"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Absence modifiée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiAbsence"
                }
              }
            }
          },
          "400": {
            "description": "Modification ou transition de statut refusée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Statut invalide pour cette absence"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Absence introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Absence non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "patch": {
        "operationId": "updateAbsenceStatus",
        "deprecated": true,
        "tags": [
          "Absences"
        ],
        "summary": "Modifier une absence (route historique)",
        "description": "**Route historique** : utilisez `PUT /public/v1/absences/{absenceId}`. Même corps, mêmes règles et mêmes réponses.",
        "parameters": [
          {
            "name": "absenceId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de l’absence.",
            "schema": {
              "type": "string",
              "example": "abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "validated",
                      "rejected",
                      "canceled"
                    ],
                    "description": "- `validated` : Accepté\n- `rejected` : Refusé\n- `canceled` : Annulé"
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "JNT",
                      "RTT",
                      "COR",
                      "RCR",
                      "PTO_N",
                      "PTO_N-1",
                      "PTO_N-2",
                      "UNPAID",
                      "FAMILY",
                      "REST",
                      "SENIORITY",
                      "INTERN_CP",
                      "PREGNANCY_EXAM"
                    ],
                    "description": "Les arrêts de travail (`SICK`, `SICK_AT`, `SICK_ATJ`, `SICK_MP`) et les congés parentaux (`PARENTAL`) sont refusés : saisissez-les dans Puncto.\n\n- `JNT` : Jours Non Travaillés (forfait jour)\n- `RTT` : RTT\n- `COR` : Contrepartie Obligatoire en Repos\n- `RCR` : Repos Compensateur\n- `PTO_N` : Congés payés\n- `PTO_N-1` : Congés payés N-1\n- `PTO_N-2` : Congés payés N-2\n- `UNPAID` : Congés sans solde\n- `FAMILY` : Congés familiaux\n- `REST` : Repos\n- `SENIORITY` : Ancienneté\n- `INTERN_CP` : Congé payé stage\n- `PREGNANCY_EXAM` : Examens obligatoires de grossesse"
                  },
                  "startDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Premier jour d’absence.",
                    "example": "2026-10-05"
                  },
                  "endDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Dernier jour d’absence, inclus.",
                    "example": "2026-10-05"
                  },
                  "onlyHalfDayAtStart": {
                    "type": "boolean",
                    "description": "Le premier jour, seul l’après-midi est pris."
                  },
                  "onlyHalfDayAtEnd": {
                    "type": "boolean",
                    "description": "Le dernier jour, seule la matinée est prise."
                  },
                  "familyEventType": {
                    "type": "string",
                    "enum": [
                      "mariage_pacs_salarie",
                      "mariage_pacs_enfant",
                      "deces_conjoint_pacs",
                      "deces_enfant_moins_25_oui",
                      "deces_enfant_moins_25_non_parent_oui",
                      "deces_enfant_moins_25_non_parent_non",
                      "deces_personne_charge_moins_25",
                      "deces_parent",
                      "deces_beau_frere_belle_soeur",
                      "deces_frere_soeur",
                      "deces_beau_parent",
                      "deces_autre_ascendant",
                      "deuil_enfant_moins_25",
                      "naissance_adoption",
                      "handicap_enfant"
                    ],
                    "description": "Événement familial. Requis quand `type` vaut `FAMILY`."
                  },
                  "childArrivalDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Date de naissance de l’enfant, requise pour un congé de naissance. Pour `PREGNANCY_EXAM`, date présumée de l’accouchement, facultative."
                  },
                  "pregnancyExamBeneficiary": {
                    "type": "string",
                    "enum": [
                      "PREGNANT_EMPLOYEE",
                      "PARTNER"
                    ],
                    "description": "Requis quand `type` vaut `PREGNANCY_EXAM`.\n\n- `PREGNANT_EMPLOYEE` : Salariée enceinte ou en parcours de PMA\n- `PARTNER` : Conjoint, partenaire de PACS ou concubin"
                  }
                }
              },
              "example": {
                "status": "validated"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Absence modifiée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiAbsence"
                }
              }
            }
          },
          "400": {
            "description": "Modification ou transition de statut refusée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Statut invalide pour cette absence"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Absence introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Absence non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "get": {
        "operationId": "getAbsence",
        "tags": [
          "Absences"
        ],
        "summary": "Consulter une absence",
        "description": "Renvoie une absence, au même format que la liste des absences.\n\nPour une prolongation d’arrêt de travail, `workStoppage` décrit l’arrêt initial (dernier jour travaillé, subrogation, dates d’accident ou de constatation), avec l’avis de prolongation pour justificatif.\n\nLes justificatifs (`familyProofFile`, `workStoppage.proofFile`) se téléchargent avec `GET /public/v1/documents/{documentId}/download`, leur `id` servant de `documentId`.",
        "parameters": [
          {
            "name": "absenceId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de l’absence.",
            "schema": {
              "type": "string",
              "example": "abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Absence",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiAbsence"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Absence introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Absence non trouvée"
                }
              }
            }
          }
        }
      }
    },
    "/public/v1/absences/actions/import": {
      "post": {
        "operationId": "importAbsences",
        "deprecated": true,
        "tags": [
          "Absences"
        ],
        "summary": "Importer des absences",
        "description": "**Route historique** : utilisez `POST /public/v1/absences` et `PUT /public/v1/absences/{absenceId}`.\n\nCrée ou met à jour des absences par lot, en une transaction, sans contrôle de chevauchement, de solde ni de durée légale, et sans arrêt de travail pour la DSN.\n\n- Collaborateur ou contrat introuvable : l’absence est ignorée et listée dans `errors`. **Vérifiez `errors` même en `200`.**\n- Un congé payé importé `pending` va en `PTO_N` ; les congés validés sont répartis entre `PTO_N`, `PTO_N-1` et `PTO_N-2` selon les soldes.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "absences"
                ],
                "properties": {
                  "disableIdempotency": {
                    "type": "boolean",
                    "default": false,
                    "description": "Rend `foreignErpId` facultatif : chaque élément est alors créé, même s’il a déjà été importé."
                  },
                  "absences": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "status",
                        "type",
                        "startDate",
                        "endDate",
                        "contractMatching"
                      ],
                      "properties": {
                        "foreignErpId": {
                          "type": "string",
                          "description": "Identifiant de l’élément dans votre système. Réimporter le même `foreignErpId` met à jour l’élément existant."
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "pending",
                            "validated",
                            "rejected",
                            "canceled"
                          ],
                          "description": "- `pending` : En attente\n- `validated` : Accepté\n- `rejected` : Refusé\n- `canceled` : Annulé"
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "JNT",
                            "RTT",
                            "COR",
                            "RCR",
                            "PTO_N",
                            "PTO_N-1",
                            "PTO_N-2",
                            "UNPAID",
                            "FAMILY",
                            "PARENTAL",
                            "REST",
                            "SICK",
                            "SICK_AT",
                            "SICK_MP",
                            "SICK_ATJ",
                            "SENIORITY",
                            "INTERN_CP",
                            "PREGNANCY_EXAM"
                          ],
                          "description": "- `JNT` : Jours Non Travaillés (forfait jour)\n- `RTT` : RTT\n- `COR` : Contrepartie Obligatoire en Repos\n- `RCR` : Repos Compensateur\n- `PTO_N` : Congés payés\n- `PTO_N-1` : Congés payés N-1\n- `PTO_N-2` : Congés payés N-2\n- `UNPAID` : Congés sans solde\n- `FAMILY` : Congés familiaux\n- `PARENTAL` : Congés parentaux\n- `REST` : Repos\n- `SICK` : Maladie ordinaire\n- `SICK_AT` : Accident du travail\n- `SICK_MP` : Maladie professionnelle\n- `SICK_ATJ` : Accident de trajet\n- `SENIORITY` : Ancienneté\n- `INTERN_CP` : Congé payé stage\n- `PREGNANCY_EXAM` : Examens obligatoires de grossesse"
                        },
                        "parentalLeaveType": {
                          "type": "string",
                          "enum": [
                            "BIRTH_ADDITIONAL_LEAVE"
                          ],
                          "description": "Requis quand `type` vaut `PARENTAL`.\n\n- `BIRTH_ADDITIONAL_LEAVE` : Congé supplémentaire de naissance ou d'adoption"
                        },
                        "pregnancyExamBeneficiary": {
                          "type": "string",
                          "enum": [
                            "PREGNANT_EMPLOYEE",
                            "PARTNER"
                          ],
                          "description": "Requis quand `type` vaut `PREGNANCY_EXAM`. 3 examens au plus par grossesse.\n\n- `PREGNANT_EMPLOYEE` : Salariée enceinte ou en parcours de PMA\n- `PARTNER` : Conjoint, partenaire de PACS ou concubin"
                        },
                        "isProlongation": {
                          "type": "boolean",
                          "default": false,
                          "description": "L’absence prolonge un arrêt précédent."
                        },
                        "onlyHalfDayAtStart": {
                          "type": "boolean",
                          "default": false,
                          "description": "Le premier jour, seul l’après-midi est pris."
                        },
                        "onlyHalfDayAtEnd": {
                          "type": "boolean",
                          "default": false,
                          "description": "Le dernier jour, seule la matinée est prise."
                        },
                        "startDate": {
                          "type": "string",
                          "format": "date",
                          "description": "Premier jour d’absence.",
                          "example": "2026-10-05"
                        },
                        "endDate": {
                          "type": "string",
                          "format": "date",
                          "description": "Dernier jour d’absence, inclus.",
                          "example": "2026-10-05"
                        },
                        "childArrivalDate": {
                          "type": "string",
                          "format": "date",
                          "description": "Date de naissance ou d’arrivée au foyer de l’enfant, requise pour `PARENTAL`. Pour `PREGNANCY_EXAM`, date présumée de l’accouchement, facultative."
                        },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Date de création de la demande. Par défaut, maintenant."
                        },
                        "contractMatching": {
                          "type": "object",
                          "description": "Désigne le collaborateur. Puncto retient son contrat actif à `eventDate`, à défaut sur le mois concerné.",
                          "required": [
                            "type",
                            "value"
                          ],
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "BY_COLLABORATOR_FOREIGN_ERP_ID",
                                "BY_PUNCTO_COLLABORATOR_ID"
                              ],
                              "description": "Clé de correspondance utilisée par `value`.\n\n- `BY_COLLABORATOR_FOREIGN_ERP_ID` : `value` est le `foreignErpId` du collaborateur\n- `BY_PUNCTO_COLLABORATOR_ID` : `value` est l’identifiant Puncto du collaborateur"
                            },
                            "value": {
                              "type": "string",
                              "description": "Identifiant du collaborateur."
                            },
                            "eventDate": {
                              "type": "string",
                              "format": "date",
                              "description": "Date de l’événement, pour choisir le contrat quand le collaborateur en a plusieurs sur le mois.",
                              "example": "2026-10-05"
                            }
                          }
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "absences": [
                  {
                    "foreignErpId": "absence-123",
                    "status": "validated",
                    "type": "RTT",
                    "startDate": "2026-10-05",
                    "endDate": "2026-10-05",
                    "contractMatching": {
                      "type": "BY_COLLABORATOR_FOREIGN_ERP_ID",
                      "value": "salarie-123"
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Bilan de l’import",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportResult"
                },
                "example": {
                  "createdCount": 1,
                  "modifiedCount": 0,
                  "errors": []
                }
              }
            }
          },
          "400": {
            "description": "`foreignErpId` manquant sans `disableIdempotency`, ou import annulé",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Une erreur est survenue lors de l’importation des absences (aucune donnée importée)"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/payroll-variables": {
      "get": {
        "operationId": "listPayrollVariables",
        "tags": [
          "Variables de paie"
        ],
        "summary": "Lister les variables de paie",
        "description": "Liste paginée des variables de paie de l’entreprise, toutes origines confondues (saisie, import, feuilles de temps, astreintes, intéressement, page Primes), du mois de paie le plus récent au plus ancien.\n\nLes variables récurrentes (abonnements annuels de transport, primes et avantages récurrents) n’y figurent pas : lisez-les avec `GET /public/v1/recurring-variables`.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Année du mois de paie.",
            "schema": {
              "type": "integer",
              "minimum": 2000,
              "maximum": 2100,
              "example": 2026
            }
          },
          {
            "name": "month",
            "in": "query",
            "description": "Mois de paie, de 1 (janvier) à 12.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12,
              "example": 10
            }
          },
          {
            "name": "type[]",
            "in": "query",
            "description": "Types de variable à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "PRIME",
                  "SALARY_DEDUCTION",
                  "TAX_FREE_INDEMNITY",
                  "IN_KIND_BENEFIT",
                  "OVERTIME",
                  "REMOTE_WORK_DAY",
                  "MEAL_ALLOWANCE_ADJUSTMENT",
                  "PROFIT_SHARING",
                  "ON_CALL",
                  "MEAL_VOUCHER_ADJUSTMENT",
                  "SALARY_ADVANCE",
                  "HOLIDAY_VOUCHER",
                  "PREVOYANCE_IJ"
                ],
                "description": "- `PRIME` : Prime\n- `SALARY_DEDUCTION` : Retenue sur salaire\n- `TAX_FREE_INDEMNITY` : Indemnité non soumise\n- `IN_KIND_BENEFIT` : Avantage en nature\n- `OVERTIME` : Heures supplémentaires\n- `REMOTE_WORK_DAY` : Jours de télétravail\n- `MEAL_ALLOWANCE_ADJUSTMENT` : Ajustement paniers\n- `PROFIT_SHARING` : Intéressement\n- `ON_CALL` : Astreinte\n- `MEAL_VOUCHER_ADJUSTMENT` : Ajustement titres restaurant\n- `SALARY_ADVANCE` : Acompte sur salaire\n- `HOLIDAY_VOUCHER` : Chèques-vacances\n- `PREVOYANCE_IJ` : IJ prévoyance"
              }
            }
          },
          {
            "name": "status[]",
            "in": "query",
            "description": "Statuts à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "PENDING",
                  "VALIDATED",
                  "REJECTED"
                ],
                "description": "- `PENDING` : En attente\n- `VALIDATED` : Accepté\n- `REJECTED` : Refusé"
              }
            }
          },
          {
            "name": "contractId",
            "in": "query",
            "description": "Identifiant Puncto du contrat.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          },
          {
            "name": "foreignErpId",
            "in": "query",
            "description": "Identifiant de la variable dans votre système.",
            "schema": {
              "type": "string",
              "example": "prime-2026-10-salarie-123"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de variables de paie",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiPayrollVariable"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur du filtre introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "post": {
        "operationId": "createPayrollVariable",
        "tags": [
          "Variables de paie"
        ],
        "summary": "Créer une variable de paie",
        "description": "Crée une variable de paie et recalcule les bulletins en brouillon concernés. Sur un mois de paie clôturé ou dont le bulletin est validé, c’est une saisie tardive, régularisée par la prochaine paie ouverte.\n\n`primeType` n’accepte que les primes saisissables : ni indemnité de fin de contrat, ni prime collective (vacances, PPV, intéressement).\n\nJustificatifs : envoyez la requête en `multipart/form-data` avec des fichiers `proofFiles[i]` (pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip). Ils sont requis pour une indemnité non soumise, sauf une note de frais ou un transport public.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "contractMatching",
                  "data"
                ],
                "properties": {
                  "foreignErpId": {
                    "type": "string",
                    "description": "Identifiant de l’élément dans votre système. Réimporter le même `foreignErpId` met à jour l’élément existant."
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "PENDING",
                      "VALIDATED",
                      "REJECTED"
                    ],
                    "description": "Par défaut `VALIDATED`. Seules les variables `VALIDATED` entrent dans le bulletin.\n\n- `PENDING` : En attente\n- `VALIDATED` : Accepté\n- `REJECTED` : Refusé"
                  },
                  "year": {
                    "type": "integer",
                    "minimum": 2000,
                    "maximum": 2100,
                    "description": "Année de paie. Absente, la variable va au prochain mois de paie ouvert.",
                    "example": 2026
                  },
                  "month": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 12,
                    "description": "Mois de paie, requis avec `year`.",
                    "example": 10
                  },
                  "contractMatching": {
                    "type": "object",
                    "description": "Contrat qui porte la variable : celui du collaborateur actif à `eventDate`, à défaut sur le mois de paie, ou le contrat lui-même avec `BY_PUNCTO_CONTRACT_ID` (utile quand le collaborateur a deux contrats dans le mois).",
                    "required": [
                      "type",
                      "value"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "enum": [
                          "BY_PUNCTO_COLLABORATOR_ID",
                          "BY_PUNCTO_CONTRACT_ID"
                        ],
                        "description": "Clé de correspondance utilisée par `value`.\n\n- `BY_PUNCTO_COLLABORATOR_ID` : `value` est l’identifiant Puncto du collaborateur\n- `BY_PUNCTO_CONTRACT_ID` : `value` est l’identifiant Puncto du contrat (`GET /public/v1/contracts`), `eventDate` est ignorée"
                      },
                      "value": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Identifiant Puncto du collaborateur, ou du contrat avec `BY_PUNCTO_CONTRACT_ID`. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/collaborators?collaboratorForeignErpId=…`."
                      },
                      "eventDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date de l’événement, pour choisir le contrat quand le collaborateur en a plusieurs sur le mois.",
                        "example": "2026-10-05"
                      }
                    }
                  },
                  "businessMealParticipants": {
                    "type": "array",
                    "description": "Participants d’un repas d’affaires (`expenseType` `MEALS`), requis, désignés comme `contractMatching`. Une liste vide les retire. Les titres restaurant du mois de chacun sont réduits dès l’enregistrement, **quel que soit le statut de la note** ; son contrat doit être en vigueur à la date de la dépense.",
                    "items": {
                      "type": "object",
                      "required": [
                        "type",
                        "value"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "BY_PUNCTO_COLLABORATOR_ID",
                            "BY_PUNCTO_CONTRACT_ID"
                          ],
                          "description": "- `BY_PUNCTO_COLLABORATOR_ID` : `value` est l’identifiant Puncto du collaborateur\n- `BY_PUNCTO_CONTRACT_ID` : `value` est l’identifiant Puncto du contrat"
                        },
                        "value": {
                          "type": "string",
                          "description": "Identifiant Puncto du participant ou de son contrat."
                        }
                      }
                    }
                  },
                  "data": {
                    "description": "Contenu de la variable. La forme dépend de `type`, et pour `TAX_FREE_INDEMNITY` de `indemnityType`.",
                    "oneOf": [
                      {
                        "title": "Prime",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amount",
                          "primeType",
                          "isAbsenceSensitive"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "PRIME",
                            "description": "Prime"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amount": {
                            "type": "number",
                            "description": "Montant brut, en euros."
                          },
                          "primeType": {
                            "type": "string",
                            "enum": [
                              "COOPTATION_BONUS",
                              "BUSINESS_BONUS",
                              "OTHER",
                              "HOME_OCCUPATION_ALLOWANCE"
                            ],
                            "description": "- `COOPTATION_BONUS` : Prime de cooptation\n- `BUSINESS_BONUS` : Prime business\n- `OTHER` : Autre prime brute\n- `HOME_OCCUPATION_ALLOWANCE` : Indemnité d'occupation du domicile"
                          },
                          "isAbsenceSensitive": {
                            "type": "boolean",
                            "description": "La prime est proratisée en fonction des absences du mois."
                          }
                        }
                      },
                      {
                        "title": "Heures supplémentaires",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "hours",
                          "overtimeDate"
                        ],
                        "description": "Réservées aux contrats à temps plein décomptés en heures.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "OVERTIME",
                            "description": "Heures supplémentaires"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "hours": {
                            "type": "number",
                            "exclusiveMinimum": 0,
                            "description": "Nombre d’heures."
                          },
                          "overtimeDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Jour où les heures ont été effectuées.",
                            "example": "2026-10-14"
                          },
                          "compensationMode": {
                            "type": "string",
                            "enum": [
                              "PAYMENT",
                              "REST"
                            ],
                            "description": "Compensation des heures. En repos, elles gardent leur rang dans la semaine pour leur majoration, ne sont pas payées au bulletin et leurs heures majorées sont créditées au compteur de repos compensateur (RCR) le dimanche de la semaine. Absent : heures payées.\n\n- `PAYMENT` : Paiement des heures supplémentaires\n- `REST` : Repos compensateur de remplacement",
                            "default": "PAYMENT"
                          }
                        }
                      },
                      {
                        "title": "Jours de télétravail",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "days"
                        ],
                        "description": "Correction des jours de télétravail du mois. L’établissement doit verser une indemnité par jour, non désactivée sur le contrat. Une seule par contrat et par mois.\n\nSi l’établissement décompte les jours à la main, `days` est le total du mois ; sinon, il s’ajoute aux jours déclarés par le collaborateur.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "REMOTE_WORK_DAY",
                            "description": "Jours de télétravail"
                          },
                          "name": {
                            "type": "string",
                            "const": "Jours de télétravail",
                            "description": "Libellé fixe : `Jours de télétravail`."
                          },
                          "days": {
                            "type": "number",
                            "minimum": -31,
                            "maximum": 31,
                            "multipleOf": 0.5,
                            "description": "Nombre de jours, par demi-journée. Négatif pour retirer des jours.",
                            "example": 8.5
                          }
                        }
                      },
                      {
                        "title": "Ajustement des primes de panier",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "mealAllowanceType",
                          "count"
                        ],
                        "description": "Repas à ajouter ou retirer aux primes de panier du mois. L’établissement doit verser ce type de repas.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "MEAL_ALLOWANCE_ADJUSTMENT",
                            "description": "Ajustement paniers"
                          },
                          "name": {
                            "type": "string",
                            "const": "Ajustement paniers",
                            "description": "Libellé fixe : `Ajustement paniers`."
                          },
                          "mealAllowanceType": {
                            "type": "string",
                            "enum": [
                              "ON_SITE",
                              "OFF_SITE",
                              "TRAVEL_RESTAURANT"
                            ],
                            "description": "- `ON_SITE` : Repas sur le lieu de travail\n- `OFF_SITE` : Repas hors des locaux\n- `TRAVEL_RESTAURANT` : Repas au restaurant en déplacement"
                          },
                          "count": {
                            "type": "integer",
                            "minimum": -31,
                            "maximum": 62,
                            "description": "Nombre de repas. Négatif pour en retirer."
                          },
                          "label": {
                            "type": "string",
                            "maxLength": 60,
                            "description": "Libellé de la ligne imprimée sur le bulletin, sous la ligne de son type de repas. « Régularisation prime de panier » par défaut. Imprimé seulement pour le type de repas décompté depuis les jours travaillés du contrat : ailleurs (saisie manuelle des repas, autre type), l’ajustement reste sur la ligne de son type et le libellé n’apparaît pas."
                          }
                        }
                      },
                      {
                        "title": "Ajustement des titres restaurant",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "count"
                        ],
                        "description": "Titres restaurant à ajouter ou retirer au mois. L’établissement doit en distribuer, sans désactivation sur le contrat.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "MEAL_VOUCHER_ADJUSTMENT",
                            "description": "Ajustement titres restaurant"
                          },
                          "name": {
                            "type": "string",
                            "const": "Ajustement titres restaurant",
                            "description": "Libellé fixe : `Ajustement titres restaurant`."
                          },
                          "count": {
                            "type": "integer",
                            "minimum": -31,
                            "maximum": 62,
                            "description": "Nombre de titres. Négatif pour en retirer."
                          },
                          "label": {
                            "type": "string",
                            "maxLength": 60,
                            "description": "Libellé de la ligne imprimée sur le bulletin, sous la ligne « Titres restaurant ». « Régularisation titres restaurant » par défaut."
                          }
                        }
                      },
                      {
                        "title": "Acompte sur salaire",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amount",
                          "paymentDate"
                        ],
                        "description": "Acompte versé dans le mois, déduit du virement de fin de mois. Toujours `VALIDATED` ; refusé sur un mois clôturé ou dont le bulletin est validé.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "SALARY_ADVANCE",
                            "description": "Acompte sur salaire"
                          },
                          "name": {
                            "type": "string",
                            "const": "Acompte sur salaire",
                            "description": "Libellé fixe : `Acompte sur salaire`."
                          },
                          "amount": {
                            "type": "number",
                            "exclusiveMinimum": 0,
                            "description": "Montant versé, en euros, avec 2 décimales au plus.",
                            "example": 300.5
                          },
                          "paymentDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Date de versement, dans le mois de paie.",
                            "example": "2026-10-15"
                          }
                        }
                      },
                      {
                        "title": "Retenue sur salaire",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amount",
                          "deductionType"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "SALARY_DEDUCTION",
                            "description": "Retenue sur salaire"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amount": {
                            "type": "number",
                            "description": "Montant, en euros."
                          },
                          "deductionType": {
                            "type": "string",
                            "enum": [
                              "LAST_MONTH_NEGATIVE_PAY_ADVANCE",
                              "NET_REDUCTION",
                              "BRUT_REDUCTION"
                            ],
                            "description": "- `LAST_MONTH_NEGATIVE_PAY_ADVANCE` : Avance de salaire négative du mois précédent\n- `NET_REDUCTION` : Retenue sur le net\n- `BRUT_REDUCTION` : Réduction de salaire brut"
                          }
                        }
                      },
                      {
                        "title": "Avantage en nature",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amount",
                          "benefitType"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "IN_KIND_BENEFIT",
                            "description": "Avantage en nature"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amount": {
                            "type": "number",
                            "description": "Valeur de l’avantage, en euros."
                          },
                          "benefitType": {
                            "type": "string",
                            "enum": [
                              "MEALS",
                              "HOUSING",
                              "VEHICLE",
                              "NTIC",
                              "OTHER"
                            ],
                            "description": "- `MEALS` : Repas\n- `HOUSING` : Logement\n- `VEHICLE` : Véhicule\n- `NTIC` : NTIC\n- `OTHER` : Autre"
                          },
                          "actualExpensesVehicle": {
                            "type": "object",
                            "description": "Véhicule évalué aux dépenses réelles (`benefitType: VEHICLE`). `amount` est alors l’usage personnel évalué par l’employeur : chaque bulletin en déduit l’abattement des véhicules électriques (50 %, dans la limite du plafond annuel suivi par salarié) puis la participation du salarié.",
                            "required": [
                              "isElectric",
                              "employeeMonthlyContribution",
                              "contributionWithheldFromPay",
                              "retainedDuringLeave"
                            ],
                            "properties": {
                              "isElectric": {
                                "type": "boolean",
                                "description": "Véhicule électrique."
                              },
                              "assignedOn": {
                                "type": "string",
                                "format": "date",
                                "description": "Date de mise à disposition. Requise pour un véhicule électrique.",
                                "example": "2026-11-02"
                              },
                              "isEcoScoreEligible": {
                                "type": "boolean",
                                "description": "Éco-score exigé pour l’abattement des véhicules électriques mis à disposition depuis le 1er février 2025."
                              },
                              "employeeMonthlyContribution": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Participation mensuelle du salarié, en euros, déduite après l’abattement."
                              },
                              "contributionWithheldFromPay": {
                                "type": "boolean",
                                "description": "La participation est retenue sur le net à payer. Sinon, le salarié la règle à part."
                              },
                              "retainedDuringLeave": {
                                "type": "boolean",
                                "description": "L’avantage est conservé pendant les congés."
                              }
                            }
                          }
                        }
                      },
                      {
                        "title": "Note de frais",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amountTotal",
                          "amountReimbursed",
                          "indemnityType",
                          "expenseDate",
                          "expenseType",
                          "vatAmounts"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "TAX_FREE_INDEMNITY",
                            "description": "Indemnité non soumise"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amountTotal": {
                            "type": "number",
                            "exclusiveMinimum": 0,
                            "description": "Montant TTC de la dépense, en euros."
                          },
                          "amountReimbursed": {
                            "type": "number",
                            "description": "Montant remboursé au salarié, en euros."
                          },
                          "indemnityType": {
                            "type": "string",
                            "const": "EXPENSE_NOTE"
                          },
                          "expenseDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Date de la dépense.",
                            "example": "2026-10-03"
                          },
                          "expenseType": {
                            "type": "string",
                            "enum": [
                              "HOTEL_LOGEMENT",
                              "MEALS",
                              "KILOMETRIC_INDEMNITIES",
                              "TRANSPORT",
                              "EQUIPMENT",
                              "SERVICES",
                              "OTHER"
                            ],
                            "description": "- `HOTEL_LOGEMENT` : Hôtel/Logement\n- `MEALS` : Repas\n- `KILOMETRIC_INDEMNITIES` : Indemnités kilométriques\n- `TRANSPORT` : Transport\n- `EQUIPMENT` : Équipement\n- `SERVICES` : Services\n- `OTHER` : Autre"
                          },
                          "vatAmounts": {
                            "type": "object",
                            "description": "Montants de TVA par taux, en euros.",
                            "required": [
                              "vatAmount2_1",
                              "vatAmount5_5",
                              "vatAmount10",
                              "vatAmount20"
                            ],
                            "properties": {
                              "vatAmount2_1": {
                                "type": "number",
                                "description": "TVA à 2,1 %"
                              },
                              "vatAmount5_5": {
                                "type": "number",
                                "description": "TVA à 5,5 %"
                              },
                              "vatAmount10": {
                                "type": "number",
                                "description": "TVA à 10 %"
                              },
                              "vatAmount20": {
                                "type": "number",
                                "description": "TVA à 20 %"
                              }
                            }
                          },
                          "kilometric": {
                            "type": "object",
                            "description": "Trajet, requis quand `expenseType` vaut `KILOMETRIC_INDEMNITIES`. `amountTotal` et `amountReimbursed` doivent valoir le barème fiscal de l’année de la dépense pour ce trajet seul.",
                            "required": [
                              "vehicleCategory",
                              "energyType",
                              "fiscalPower",
                              "departureAddress",
                              "arrivalAddress",
                              "distance",
                              "isRoundTrip"
                            ],
                            "properties": {
                              "vehicleCategory": {
                                "type": "string",
                                "enum": [
                                  "CAR",
                                  "MOTORCYCLE",
                                  "SCOOTER"
                                ],
                                "description": "- `CAR` : Voiture\n- `MOTORCYCLE` : Moto (plus de 50 cm³)\n- `SCOOTER` : Cyclomoteur (50 cm³ et moins)"
                              },
                              "energyType": {
                                "type": "string",
                                "enum": [
                                  "THERMIC_HYDROGEN_HYBRID",
                                  "ELECTRIC"
                                ],
                                "description": "- `THERMIC_HYDROGEN_HYBRID` : Thermique, hydrogène ou hybride\n- `ELECTRIC` : 100 % électrique"
                              },
                              "fiscalPower": {
                                "type": [
                                  "number",
                                  "null"
                                ],
                                "description": "Puissance fiscale du véhicule, en chevaux fiscaux.",
                                "example": 5
                              },
                              "departureAddress": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Adresse de départ."
                              },
                              "arrivalAddress": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Adresse d’arrivée."
                              },
                              "distance": {
                                "type": "number",
                                "exclusiveMinimum": 0,
                                "description": "Distance du trajet, en kilomètres.",
                                "example": 100
                              },
                              "isRoundTrip": {
                                "type": "boolean",
                                "description": "Aller-retour : la distance compte deux fois."
                              }
                            }
                          }
                        }
                      },
                      {
                        "title": "Transport personnel",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amountTotal",
                          "amountReimbursed",
                          "indemnityType",
                          "personalTransportType"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "TAX_FREE_INDEMNITY",
                            "description": "Indemnité non soumise"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amountTotal": {
                            "type": "number",
                            "description": "Montant total de la dépense, en euros."
                          },
                          "amountReimbursed": {
                            "type": "number",
                            "description": "Montant remboursé au salarié, en euros."
                          },
                          "indemnityType": {
                            "type": "string",
                            "const": "PERSONAL_TRANSPORT"
                          },
                          "personalTransportType": {
                            "type": "string",
                            "enum": [
                              "FORFAIT_MOBILITES_DURABLES",
                              "PRIME_TRANSPORT"
                            ],
                            "description": "- `FORFAIT_MOBILITES_DURABLES` : Forfait mobilités durables\n- `PRIME_TRANSPORT` : Prime de transport"
                          },
                          "primeTransportType": {
                            "type": "string",
                            "enum": [
                              "FUEL",
                              "ELECTRIC_VEHICLE_CHARGING"
                            ],
                            "description": "Requis quand `personalTransportType` vaut `PRIME_TRANSPORT`.\n\n- `FUEL` : Frais de carburant\n- `ELECTRIC_VEHICLE_CHARGING` : Frais d'alimentation de véhicules électriques"
                          },
                          "fmdTransportType": {
                            "type": "string",
                            "enum": [
                              "PERSONAL_BIKE",
                              "CARPOOLING",
                              "RENTED_OR_SHARED_VEHICLES",
                              "LOW_EMISSION_CAR_SHARING",
                              "MOTORIZED_PERSONAL_TRANSPORT_DEVICES",
                              "PUBLIC_TRANSPORT_WITHOUT_SUBSCRIPTION"
                            ],
                            "description": "Requis quand `personalTransportType` vaut `FORFAIT_MOBILITES_DURABLES`.\n\n- `PERSONAL_BIKE` : Vélo personnel, y compris vélo électrique\n- `CARPOOLING` : Covoiturage, en tant que passager et en tant que conducteur\n- `RENTED_OR_SHARED_VEHICLES` : Engins de déplacement personnels, cyclomoteurs et motocyclettes en location ou en libre-service\n- `LOW_EMISSION_CAR_SHARING` : Autopartage de véhicules à faibles émissions (notamment les véhicules alimentés totalement ou partiellement par : électricité, hydrogène, gaz naturel)\n- `MOTORIZED_PERSONAL_TRANSPORT_DEVICES` : Engins de déplacement personnel motorisés (électriques) des particuliers : trottinettes, monoroues, gyropodes, skateboard, hoverboard, etc.\n- `PUBLIC_TRANSPORT_WITHOUT_SUBSCRIPTION` : Transports publics (hors abonnement)"
                          }
                        }
                      },
                      {
                        "title": "Autre indemnité non soumise",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amountTotal",
                          "amountReimbursed",
                          "indemnityType"
                        ],
                        "description": "`SPORT_SUBSCRIPTION` n’est accepté que si l’entreprise prend en charge les abonnements sport.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "TAX_FREE_INDEMNITY",
                            "description": "Indemnité non soumise"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amountTotal": {
                            "type": "number",
                            "description": "Montant total de la dépense, en euros."
                          },
                          "amountReimbursed": {
                            "type": "number",
                            "description": "Montant remboursé au salarié, en euros."
                          },
                          "indemnityType": {
                            "type": "string",
                            "enum": [
                              "PUBLIC_TRANSPORT",
                              "SPORT_SUBSCRIPTION",
                              "OTHER"
                            ],
                            "description": "`PUBLIC_TRANSPORT` : abonnements de transport en commun seulement. Un forfait mobilités durables passe par `PERSONAL_TRANSPORT`.\n\n- `PUBLIC_TRANSPORT` : Transport public\n- `SPORT_SUBSCRIPTION` : Abonnement sport\n- `OTHER` : Autre"
                          },
                          "titleType": {
                            "type": "string",
                            "enum": [
                              "NAVIGO",
                              "IMAGINE_R",
                              "VELIB",
                              "TER_SNCF",
                              "OTHER"
                            ],
                            "description": "- `NAVIGO` : Navigo\n- `IMAGINE_R` : Imagine R\n- `VELIB` : Vélo (Vélib’, Vélo'v, V'Lille etc)\n- `TER_SNCF` : Abonnement TER / SNCF\n- `OTHER` : Autre (préciser)"
                          },
                          "periodicity": {
                            "type": "string",
                            "const": "MONTHLY",
                            "description": "Un abonnement annuel de transport se crée avec `POST /public/v1/recurring-variables`."
                          }
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "foreignErpId": "prime-2026-10-salarie-123",
                "year": 2026,
                "month": 10,
                "contractMatching": {
                  "type": "BY_PUNCTO_COLLABORATOR_ID",
                  "value": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                },
                "data": {
                  "type": "PRIME",
                  "name": "Prime sur objectifs",
                  "amount": 500,
                  "primeType": "BUSINESS_BONUS",
                  "isAbsenceSensitive": false
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Variable de paie créée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiPayrollVariable"
                }
              }
            }
          },
          "400": {
            "description": "Saisie invalide, ou mois clôturé qu’aucune paie ouverte ne peut régulariser",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Le fichier justificatif est requis"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur ou contrat introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Aucun contrat trouvé pour ce collaborateur sur cette période"
                }
              }
            }
          },
          "409": {
            "description": "`foreignErpId` déjà utilisé par une variable de paie ou récurrente",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Une variable existe déjà avec le foreignErpId prime-2026-10-salarie-123 : GET /public/v1/payroll-variables/prime-2026-10-salarie-123?matchingBy=BY_FOREIGN_ERP_ID donne son identifiant Puncto, avec lequel la modifier."
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/payroll-variables/{payrollVariableId}": {
      "get": {
        "operationId": "getPayrollVariable",
        "tags": [
          "Variables de paie"
        ],
        "summary": "Consulter une variable de paie",
        "description": "Renvoie une variable de paie, désignée par son identifiant Puncto ou par son `foreignErpId`.",
        "parameters": [
          {
            "name": "payrollVariableId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de la variable de paie, ou son `foreignErpId` avec `matchingBy=BY_FOREIGN_ERP_ID`.",
            "schema": {
              "type": "string",
              "example": "pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "matchingBy",
            "in": "query",
            "description": "Façon de lire `payrollVariableId`.",
            "schema": {
              "type": "string",
              "enum": [
                "BY_PUNCTO_ID",
                "BY_FOREIGN_ERP_ID"
              ],
              "description": "- `BY_PUNCTO_ID` : `payrollVariableId` est l’identifiant Puncto de la variable\n- `BY_FOREIGN_ERP_ID` : `payrollVariableId` est le `foreignErpId` de la variable",
              "default": "BY_PUNCTO_ID"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Variable de paie",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiPayrollVariable"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Variable de paie introuvable dans l’entreprise. Si l’identifiant désigne une variable récurrente, le message donne son identifiant Puncto et la route à utiliser.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Variable de paie non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "put": {
        "operationId": "updatePayrollVariable",
        "tags": [
          "Variables de paie"
        ],
        "summary": "Modifier une variable de paie",
        "description": "Modifie le contenu ou le statut d’une variable de paie, pas les deux dans la même requête. Les bulletins en brouillon concernés sont recalculés. Sur un mois de paie clôturé ou dont le bulletin est validé, c’est une saisie tardive, régularisée par la prochaine paie ouverte.\n\n- **`data`** : remplace le contenu et, avec `year`/`month`, le mois de paie. Le contrat ne change pas. Des jours de télétravail modifiés sont validés.\n- **`status` seul** : valide ou refuse la variable (par exemple une note de frais d’un collaborateur). Renvoyer le statut actuel ne change rien.\n\nRefusé :\n- **contenu** : astreinte, heures d’une feuille de temps, intéressement, variable de la page Primes, indemnité de fin de contrat du mois du solde de tout compte ;\n- **statut** : astreinte, acompte sur salaire, heures d’une feuille de temps, intéressement, prime de vacances ou chèques-vacances de la page Primes, indemnité de fin de contrat du mois du solde de tout compte (une PPV de la page Primes change bien de statut) ;\n- variable récurrente, abonnement annuel de transport compris : utilisez `PUT /public/v1/recurring-variables/{recurringVariableId}`.\n\nJustificatifs : envoyez la requête en `multipart/form-data` avec des fichiers `proofFiles[i]` (pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip). Ils sont requis pour une indemnité non soumise, sauf une note de frais ou un transport public. Les nouveaux fichiers s’ajoutent aux existants (10 au plus) ; `proofFileIdsToDelete` retire ceux à supprimer.",
        "parameters": [
          {
            "name": "payrollVariableId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de la variable de paie. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/payroll-variables/{payrollVariableId}?matchingBy=BY_FOREIGN_ERP_ID`.",
            "schema": {
              "type": "string",
              "example": "pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "PENDING",
                      "VALIDATED",
                      "REJECTED"
                    ],
                    "description": "Requis sans `data`. Avec `data`, il ne peut valoir que le statut actuel.\n\n- `PENDING` : En attente\n- `VALIDATED` : Accepté\n- `REJECTED` : Refusé"
                  },
                  "year": {
                    "type": "integer",
                    "minimum": 2000,
                    "maximum": 2100,
                    "description": "Année de paie. Absente, la variable garde son mois de paie.",
                    "example": 2026
                  },
                  "month": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 12,
                    "description": "Mois de paie, requis avec `year`.",
                    "example": 10
                  },
                  "proofFileIdsToDelete": {
                    "type": "array",
                    "description": "Identifiants (`documentId`) des justificatifs à retirer.",
                    "items": {
                      "type": "string"
                    }
                  },
                  "businessMealParticipants": {
                    "type": "array",
                    "description": "Participants d’un repas d’affaires (`expenseType` `MEALS`), requis, désignés comme `contractMatching`. Une liste vide les retire. Les titres restaurant du mois de chacun sont réduits dès l’enregistrement, **quel que soit le statut de la note** ; son contrat doit être en vigueur à la date de la dépense.",
                    "items": {
                      "type": "object",
                      "required": [
                        "type",
                        "value"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "BY_PUNCTO_COLLABORATOR_ID",
                            "BY_PUNCTO_CONTRACT_ID"
                          ],
                          "description": "- `BY_PUNCTO_COLLABORATOR_ID` : `value` est l’identifiant Puncto du collaborateur\n- `BY_PUNCTO_CONTRACT_ID` : `value` est l’identifiant Puncto du contrat"
                        },
                        "value": {
                          "type": "string",
                          "description": "Identifiant Puncto du participant ou de son contrat."
                        }
                      }
                    }
                  },
                  "data": {
                    "description": "Le nouveau contenu. Requis sans `status`.",
                    "oneOf": [
                      {
                        "title": "Prime",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amount",
                          "primeType",
                          "isAbsenceSensitive"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "PRIME",
                            "description": "Prime"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amount": {
                            "type": "number",
                            "description": "Montant brut, en euros."
                          },
                          "primeType": {
                            "type": "string",
                            "enum": [
                              "COOPTATION_BONUS",
                              "BUSINESS_BONUS",
                              "OTHER",
                              "HOME_OCCUPATION_ALLOWANCE"
                            ],
                            "description": "- `COOPTATION_BONUS` : Prime de cooptation\n- `BUSINESS_BONUS` : Prime business\n- `OTHER` : Autre prime brute\n- `HOME_OCCUPATION_ALLOWANCE` : Indemnité d'occupation du domicile"
                          },
                          "isAbsenceSensitive": {
                            "type": "boolean",
                            "description": "La prime est proratisée en fonction des absences du mois."
                          }
                        }
                      },
                      {
                        "title": "Heures supplémentaires",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "hours",
                          "overtimeDate"
                        ],
                        "description": "Réservées aux contrats à temps plein décomptés en heures.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "OVERTIME",
                            "description": "Heures supplémentaires"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "hours": {
                            "type": "number",
                            "exclusiveMinimum": 0,
                            "description": "Nombre d’heures."
                          },
                          "overtimeDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Jour où les heures ont été effectuées.",
                            "example": "2026-10-14"
                          },
                          "compensationMode": {
                            "type": "string",
                            "enum": [
                              "PAYMENT",
                              "REST"
                            ],
                            "description": "Compensation des heures. En repos, elles gardent leur rang dans la semaine pour leur majoration, ne sont pas payées au bulletin et leurs heures majorées sont créditées au compteur de repos compensateur (RCR) le dimanche de la semaine. Absent : heures payées.\n\n- `PAYMENT` : Paiement des heures supplémentaires\n- `REST` : Repos compensateur de remplacement",
                            "default": "PAYMENT"
                          }
                        }
                      },
                      {
                        "title": "Jours de télétravail",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "days"
                        ],
                        "description": "Correction des jours de télétravail du mois. L’établissement doit verser une indemnité par jour, non désactivée sur le contrat. Une seule par contrat et par mois.\n\nSi l’établissement décompte les jours à la main, `days` est le total du mois ; sinon, il s’ajoute aux jours déclarés par le collaborateur.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "REMOTE_WORK_DAY",
                            "description": "Jours de télétravail"
                          },
                          "name": {
                            "type": "string",
                            "const": "Jours de télétravail",
                            "description": "Libellé fixe : `Jours de télétravail`."
                          },
                          "days": {
                            "type": "number",
                            "minimum": -31,
                            "maximum": 31,
                            "multipleOf": 0.5,
                            "description": "Nombre de jours, par demi-journée. Négatif pour retirer des jours.",
                            "example": 8.5
                          }
                        }
                      },
                      {
                        "title": "Ajustement des primes de panier",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "mealAllowanceType",
                          "count"
                        ],
                        "description": "Repas à ajouter ou retirer aux primes de panier du mois. L’établissement doit verser ce type de repas.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "MEAL_ALLOWANCE_ADJUSTMENT",
                            "description": "Ajustement paniers"
                          },
                          "name": {
                            "type": "string",
                            "const": "Ajustement paniers",
                            "description": "Libellé fixe : `Ajustement paniers`."
                          },
                          "mealAllowanceType": {
                            "type": "string",
                            "enum": [
                              "ON_SITE",
                              "OFF_SITE",
                              "TRAVEL_RESTAURANT"
                            ],
                            "description": "- `ON_SITE` : Repas sur le lieu de travail\n- `OFF_SITE` : Repas hors des locaux\n- `TRAVEL_RESTAURANT` : Repas au restaurant en déplacement"
                          },
                          "count": {
                            "type": "integer",
                            "minimum": -31,
                            "maximum": 62,
                            "description": "Nombre de repas. Négatif pour en retirer."
                          },
                          "label": {
                            "type": "string",
                            "maxLength": 60,
                            "description": "Libellé de la ligne imprimée sur le bulletin, sous la ligne de son type de repas. « Régularisation prime de panier » par défaut. Imprimé seulement pour le type de repas décompté depuis les jours travaillés du contrat : ailleurs (saisie manuelle des repas, autre type), l’ajustement reste sur la ligne de son type et le libellé n’apparaît pas."
                          }
                        }
                      },
                      {
                        "title": "Ajustement des titres restaurant",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "count"
                        ],
                        "description": "Titres restaurant à ajouter ou retirer au mois. L’établissement doit en distribuer, sans désactivation sur le contrat.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "MEAL_VOUCHER_ADJUSTMENT",
                            "description": "Ajustement titres restaurant"
                          },
                          "name": {
                            "type": "string",
                            "const": "Ajustement titres restaurant",
                            "description": "Libellé fixe : `Ajustement titres restaurant`."
                          },
                          "count": {
                            "type": "integer",
                            "minimum": -31,
                            "maximum": 62,
                            "description": "Nombre de titres. Négatif pour en retirer."
                          },
                          "label": {
                            "type": "string",
                            "maxLength": 60,
                            "description": "Libellé de la ligne imprimée sur le bulletin, sous la ligne « Titres restaurant ». « Régularisation titres restaurant » par défaut."
                          }
                        }
                      },
                      {
                        "title": "Acompte sur salaire",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amount",
                          "paymentDate"
                        ],
                        "description": "Acompte versé dans le mois, déduit du virement de fin de mois. Toujours `VALIDATED` ; refusé sur un mois clôturé ou dont le bulletin est validé.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "SALARY_ADVANCE",
                            "description": "Acompte sur salaire"
                          },
                          "name": {
                            "type": "string",
                            "const": "Acompte sur salaire",
                            "description": "Libellé fixe : `Acompte sur salaire`."
                          },
                          "amount": {
                            "type": "number",
                            "exclusiveMinimum": 0,
                            "description": "Montant versé, en euros, avec 2 décimales au plus.",
                            "example": 300.5
                          },
                          "paymentDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Date de versement, dans le mois de paie.",
                            "example": "2026-10-15"
                          }
                        }
                      },
                      {
                        "title": "Retenue sur salaire",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amount",
                          "deductionType"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "SALARY_DEDUCTION",
                            "description": "Retenue sur salaire"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amount": {
                            "type": "number",
                            "description": "Montant, en euros."
                          },
                          "deductionType": {
                            "type": "string",
                            "enum": [
                              "LAST_MONTH_NEGATIVE_PAY_ADVANCE",
                              "NET_REDUCTION",
                              "BRUT_REDUCTION"
                            ],
                            "description": "- `LAST_MONTH_NEGATIVE_PAY_ADVANCE` : Avance de salaire négative du mois précédent\n- `NET_REDUCTION` : Retenue sur le net\n- `BRUT_REDUCTION` : Réduction de salaire brut"
                          }
                        }
                      },
                      {
                        "title": "Avantage en nature",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amount",
                          "benefitType"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "IN_KIND_BENEFIT",
                            "description": "Avantage en nature"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amount": {
                            "type": "number",
                            "description": "Valeur de l’avantage, en euros."
                          },
                          "benefitType": {
                            "type": "string",
                            "enum": [
                              "MEALS",
                              "HOUSING",
                              "VEHICLE",
                              "NTIC",
                              "OTHER"
                            ],
                            "description": "- `MEALS` : Repas\n- `HOUSING` : Logement\n- `VEHICLE` : Véhicule\n- `NTIC` : NTIC\n- `OTHER` : Autre"
                          },
                          "actualExpensesVehicle": {
                            "type": "object",
                            "description": "Véhicule évalué aux dépenses réelles (`benefitType: VEHICLE`). `amount` est alors l’usage personnel évalué par l’employeur : chaque bulletin en déduit l’abattement des véhicules électriques (50 %, dans la limite du plafond annuel suivi par salarié) puis la participation du salarié.",
                            "required": [
                              "isElectric",
                              "employeeMonthlyContribution",
                              "contributionWithheldFromPay",
                              "retainedDuringLeave"
                            ],
                            "properties": {
                              "isElectric": {
                                "type": "boolean",
                                "description": "Véhicule électrique."
                              },
                              "assignedOn": {
                                "type": "string",
                                "format": "date",
                                "description": "Date de mise à disposition. Requise pour un véhicule électrique.",
                                "example": "2026-11-02"
                              },
                              "isEcoScoreEligible": {
                                "type": "boolean",
                                "description": "Éco-score exigé pour l’abattement des véhicules électriques mis à disposition depuis le 1er février 2025."
                              },
                              "employeeMonthlyContribution": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Participation mensuelle du salarié, en euros, déduite après l’abattement."
                              },
                              "contributionWithheldFromPay": {
                                "type": "boolean",
                                "description": "La participation est retenue sur le net à payer. Sinon, le salarié la règle à part."
                              },
                              "retainedDuringLeave": {
                                "type": "boolean",
                                "description": "L’avantage est conservé pendant les congés."
                              }
                            }
                          }
                        }
                      },
                      {
                        "title": "Note de frais",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amountTotal",
                          "amountReimbursed",
                          "indemnityType",
                          "expenseDate",
                          "expenseType",
                          "vatAmounts"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "TAX_FREE_INDEMNITY",
                            "description": "Indemnité non soumise"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amountTotal": {
                            "type": "number",
                            "exclusiveMinimum": 0,
                            "description": "Montant TTC de la dépense, en euros."
                          },
                          "amountReimbursed": {
                            "type": "number",
                            "description": "Montant remboursé au salarié, en euros."
                          },
                          "indemnityType": {
                            "type": "string",
                            "const": "EXPENSE_NOTE"
                          },
                          "expenseDate": {
                            "type": "string",
                            "format": "date",
                            "description": "Date de la dépense.",
                            "example": "2026-10-03"
                          },
                          "expenseType": {
                            "type": "string",
                            "enum": [
                              "HOTEL_LOGEMENT",
                              "MEALS",
                              "KILOMETRIC_INDEMNITIES",
                              "TRANSPORT",
                              "EQUIPMENT",
                              "SERVICES",
                              "OTHER"
                            ],
                            "description": "- `HOTEL_LOGEMENT` : Hôtel/Logement\n- `MEALS` : Repas\n- `KILOMETRIC_INDEMNITIES` : Indemnités kilométriques\n- `TRANSPORT` : Transport\n- `EQUIPMENT` : Équipement\n- `SERVICES` : Services\n- `OTHER` : Autre"
                          },
                          "vatAmounts": {
                            "type": "object",
                            "description": "Montants de TVA par taux, en euros.",
                            "required": [
                              "vatAmount2_1",
                              "vatAmount5_5",
                              "vatAmount10",
                              "vatAmount20"
                            ],
                            "properties": {
                              "vatAmount2_1": {
                                "type": "number",
                                "description": "TVA à 2,1 %"
                              },
                              "vatAmount5_5": {
                                "type": "number",
                                "description": "TVA à 5,5 %"
                              },
                              "vatAmount10": {
                                "type": "number",
                                "description": "TVA à 10 %"
                              },
                              "vatAmount20": {
                                "type": "number",
                                "description": "TVA à 20 %"
                              }
                            }
                          },
                          "kilometric": {
                            "type": "object",
                            "description": "Trajet, requis quand `expenseType` vaut `KILOMETRIC_INDEMNITIES`. `amountTotal` et `amountReimbursed` doivent valoir le barème fiscal de l’année de la dépense pour ce trajet seul.",
                            "required": [
                              "vehicleCategory",
                              "energyType",
                              "fiscalPower",
                              "departureAddress",
                              "arrivalAddress",
                              "distance",
                              "isRoundTrip"
                            ],
                            "properties": {
                              "vehicleCategory": {
                                "type": "string",
                                "enum": [
                                  "CAR",
                                  "MOTORCYCLE",
                                  "SCOOTER"
                                ],
                                "description": "- `CAR` : Voiture\n- `MOTORCYCLE` : Moto (plus de 50 cm³)\n- `SCOOTER` : Cyclomoteur (50 cm³ et moins)"
                              },
                              "energyType": {
                                "type": "string",
                                "enum": [
                                  "THERMIC_HYDROGEN_HYBRID",
                                  "ELECTRIC"
                                ],
                                "description": "- `THERMIC_HYDROGEN_HYBRID` : Thermique, hydrogène ou hybride\n- `ELECTRIC` : 100 % électrique"
                              },
                              "fiscalPower": {
                                "type": [
                                  "number",
                                  "null"
                                ],
                                "description": "Puissance fiscale du véhicule, en chevaux fiscaux.",
                                "example": 5
                              },
                              "departureAddress": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Adresse de départ."
                              },
                              "arrivalAddress": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Adresse d’arrivée."
                              },
                              "distance": {
                                "type": "number",
                                "exclusiveMinimum": 0,
                                "description": "Distance du trajet, en kilomètres.",
                                "example": 100
                              },
                              "isRoundTrip": {
                                "type": "boolean",
                                "description": "Aller-retour : la distance compte deux fois."
                              }
                            }
                          }
                        }
                      },
                      {
                        "title": "Transport personnel",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amountTotal",
                          "amountReimbursed",
                          "indemnityType",
                          "personalTransportType"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "TAX_FREE_INDEMNITY",
                            "description": "Indemnité non soumise"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amountTotal": {
                            "type": "number",
                            "description": "Montant total de la dépense, en euros."
                          },
                          "amountReimbursed": {
                            "type": "number",
                            "description": "Montant remboursé au salarié, en euros."
                          },
                          "indemnityType": {
                            "type": "string",
                            "const": "PERSONAL_TRANSPORT"
                          },
                          "personalTransportType": {
                            "type": "string",
                            "enum": [
                              "FORFAIT_MOBILITES_DURABLES",
                              "PRIME_TRANSPORT"
                            ],
                            "description": "- `FORFAIT_MOBILITES_DURABLES` : Forfait mobilités durables\n- `PRIME_TRANSPORT` : Prime de transport"
                          },
                          "primeTransportType": {
                            "type": "string",
                            "enum": [
                              "FUEL",
                              "ELECTRIC_VEHICLE_CHARGING"
                            ],
                            "description": "Requis quand `personalTransportType` vaut `PRIME_TRANSPORT`.\n\n- `FUEL` : Frais de carburant\n- `ELECTRIC_VEHICLE_CHARGING` : Frais d'alimentation de véhicules électriques"
                          },
                          "fmdTransportType": {
                            "type": "string",
                            "enum": [
                              "PERSONAL_BIKE",
                              "CARPOOLING",
                              "RENTED_OR_SHARED_VEHICLES",
                              "LOW_EMISSION_CAR_SHARING",
                              "MOTORIZED_PERSONAL_TRANSPORT_DEVICES",
                              "PUBLIC_TRANSPORT_WITHOUT_SUBSCRIPTION"
                            ],
                            "description": "Requis quand `personalTransportType` vaut `FORFAIT_MOBILITES_DURABLES`.\n\n- `PERSONAL_BIKE` : Vélo personnel, y compris vélo électrique\n- `CARPOOLING` : Covoiturage, en tant que passager et en tant que conducteur\n- `RENTED_OR_SHARED_VEHICLES` : Engins de déplacement personnels, cyclomoteurs et motocyclettes en location ou en libre-service\n- `LOW_EMISSION_CAR_SHARING` : Autopartage de véhicules à faibles émissions (notamment les véhicules alimentés totalement ou partiellement par : électricité, hydrogène, gaz naturel)\n- `MOTORIZED_PERSONAL_TRANSPORT_DEVICES` : Engins de déplacement personnel motorisés (électriques) des particuliers : trottinettes, monoroues, gyropodes, skateboard, hoverboard, etc.\n- `PUBLIC_TRANSPORT_WITHOUT_SUBSCRIPTION` : Transports publics (hors abonnement)"
                          }
                        }
                      },
                      {
                        "title": "Autre indemnité non soumise",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amountTotal",
                          "amountReimbursed",
                          "indemnityType"
                        ],
                        "description": "`SPORT_SUBSCRIPTION` n’est accepté que si l’entreprise prend en charge les abonnements sport.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "TAX_FREE_INDEMNITY",
                            "description": "Indemnité non soumise"
                          },
                          "name": {
                            "type": "string",
                            "description": "Libellé affiché sur le bulletin."
                          },
                          "amountTotal": {
                            "type": "number",
                            "description": "Montant total de la dépense, en euros."
                          },
                          "amountReimbursed": {
                            "type": "number",
                            "description": "Montant remboursé au salarié, en euros."
                          },
                          "indemnityType": {
                            "type": "string",
                            "enum": [
                              "PUBLIC_TRANSPORT",
                              "SPORT_SUBSCRIPTION",
                              "OTHER"
                            ],
                            "description": "`PUBLIC_TRANSPORT` : abonnements de transport en commun seulement. Un forfait mobilités durables passe par `PERSONAL_TRANSPORT`.\n\n- `PUBLIC_TRANSPORT` : Transport public\n- `SPORT_SUBSCRIPTION` : Abonnement sport\n- `OTHER` : Autre"
                          },
                          "titleType": {
                            "type": "string",
                            "enum": [
                              "NAVIGO",
                              "IMAGINE_R",
                              "VELIB",
                              "TER_SNCF",
                              "OTHER"
                            ],
                            "description": "- `NAVIGO` : Navigo\n- `IMAGINE_R` : Imagine R\n- `VELIB` : Vélo (Vélib’, Vélo'v, V'Lille etc)\n- `TER_SNCF` : Abonnement TER / SNCF\n- `OTHER` : Autre (préciser)"
                          },
                          "periodicity": {
                            "type": "string",
                            "const": "MONTHLY",
                            "description": "Un abonnement annuel de transport se crée avec `POST /public/v1/recurring-variables`."
                          }
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "data": {
                  "type": "PRIME",
                  "name": "Prime sur objectifs",
                  "amount": 650,
                  "primeType": "BUSINESS_BONUS",
                  "isAbsenceSensitive": false
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Variable de paie modifiée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiPayrollVariable"
                }
              }
            }
          },
          "400": {
            "description": "Modification invalide, variable gérée ailleurs, ou mois clôturé qu’aucune paie ouverte ne peut régulariser",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Une astreinte se modifie depuis sa période d'astreinte, pas comme une variable de paie."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Variable de paie introuvable dans l’entreprise. Si l’identifiant désigne une variable récurrente, le message donne son identifiant Puncto et la route à utiliser.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Variable de paie non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "delete": {
        "operationId": "deletePayrollVariable",
        "tags": [
          "Variables de paie"
        ],
        "summary": "Supprimer une variable de paie",
        "description": "Supprime une variable de paie et ses justificatifs, et recalcule les bulletins en brouillon concernés. Sur un mois de paie clôturé ou dont le bulletin est validé, c’est une saisie tardive, régularisée par la prochaine paie ouverte.\n\nRefusé : heures d’une feuille de temps, intéressement, prime de vacances ou chèques-vacances de la page Primes, indemnité de fin de contrat du mois du solde de tout compte, acompte sur salaire d’un mois clôturé. Une PPV de la page Primes se supprime.",
        "parameters": [
          {
            "name": "payrollVariableId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de la variable de paie. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/payroll-variables/{payrollVariableId}?matchingBy=BY_FOREIGN_ERP_ID`.",
            "schema": {
              "type": "string",
              "example": "pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Variable de paie supprimée"
          },
          "400": {
            "description": "Variable gérée ailleurs, ou mois qu’aucune paie ouverte ne peut régulariser",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Cette variable de paie provient de la page Primes et ne peut pas être modifiée directement."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Variable de paie introuvable dans l’entreprise. Si l’identifiant désigne une variable récurrente, le message donne son identifiant Puncto et la route à utiliser.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Variable de paie non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/payroll-variables/actions/import": {
      "post": {
        "operationId": "importPayrollVariables",
        "tags": [
          "Variables de paie"
        ],
        "summary": "Importer des variables de paie",
        "deprecated": true,
        "description": "**Route historique** : pour une nouvelle intégration, créez et modifiez les variables une à une avec `POST /public/v1/payroll-variables` et `PUT /public/v1/payroll-variables/{payrollVariableId}`.\n\nCrée ou met à jour un lot de variables de paie en une seule transaction. Pour les clients qui l’utilisent encore :\n\n- Une variable invalide (collaborateur ou contrat introuvable, contrôle de saisie échoué) est ignorée et listée dans `errors` : **vérifiez `errors`, même avec une réponse `200`**.\n- Un `foreignErpId` présent plusieurs fois dans le lot est refusé à chaque occurrence.\n- Une variable renvoyée à l’identique, justificatif compris, n’est pas réécrite et compte dans `unchangedCount`. Si seul le justificatif change, il est remplacé. Dans les deux cas, ni recalcul ni saisie tardive.\n- Une variable importée garde son contrat : désignée sur un autre, elle est refusée (supprimez-la puis réimportez-la) ; désignée par son collaborateur sans `eventDate`, elle y reste tant qu’il couvre son mois de paie.\n- Jamais remplacées : astreintes, heures d’une feuille de temps, intéressement, prime de vacances ou chèques-vacances de la page Primes, indemnités de fin de contrat du mois du solde de tout compte, variables récurrentes. Un abonnement annuel de transport est refusé : créez-le avec `POST /public/v1/recurring-variables`.\n- `primeType` n’accepte que les primes saisissables : ni indemnité de fin de contrat, ni prime collective (vacances, PPV, intéressement).\n\nJustificatif : envoyez la requête en `multipart/form-data` avec un fichier `variables[i][proofFile]` (pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip). Sans fichier, le justificatif déjà enregistré est retiré.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "variables"
                ],
                "properties": {
                  "disableIdempotency": {
                    "type": "boolean",
                    "default": false,
                    "description": "Rend `foreignErpId` facultatif : chaque élément est alors créé, même s’il a déjà été importé."
                  },
                  "variables": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "status",
                        "year",
                        "month",
                        "contractMatching",
                        "data"
                      ],
                      "properties": {
                        "foreignErpId": {
                          "type": "string",
                          "description": "Identifiant de l’élément dans votre système. Réimporter le même `foreignErpId` met à jour l’élément existant."
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "PENDING",
                            "VALIDATED",
                            "REJECTED"
                          ],
                          "description": "Seules les variables `VALIDATED` entrent dans le bulletin.\n\n- `PENDING` : En attente\n- `VALIDATED` : Accepté\n- `REJECTED` : Refusé"
                        },
                        "year": {
                          "type": "integer",
                          "minimum": 2000,
                          "maximum": 2100,
                          "description": "Année de paie.",
                          "example": 2026
                        },
                        "month": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 12,
                          "description": "Mois de paie.",
                          "example": 10
                        },
                        "createdAt": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Date de création. Par défaut, maintenant ; une variable mise à jour garde la sienne."
                        },
                        "contractMatching": {
                          "type": "object",
                          "description": "Contrat qui porte la variable : celui du collaborateur actif à `eventDate`, à défaut sur le mois de paie, ou le contrat lui-même avec `BY_PUNCTO_CONTRACT_ID` (utile quand le collaborateur a deux contrats dans le mois).",
                          "required": [
                            "type",
                            "value"
                          ],
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "BY_COLLABORATOR_FOREIGN_ERP_ID",
                                "BY_PUNCTO_COLLABORATOR_ID",
                                "BY_PUNCTO_CONTRACT_ID"
                              ],
                              "description": "Clé de correspondance utilisée par `value`.\n\n- `BY_COLLABORATOR_FOREIGN_ERP_ID` : `value` est le `foreignErpId` du collaborateur\n- `BY_PUNCTO_COLLABORATOR_ID` : `value` est l’identifiant Puncto du collaborateur\n- `BY_PUNCTO_CONTRACT_ID` : `value` est l’identifiant Puncto du contrat"
                            },
                            "value": {
                              "type": "string",
                              "description": "Identifiant du collaborateur ou du contrat."
                            },
                            "eventDate": {
                              "type": "string",
                              "format": "date",
                              "description": "Date de l’événement, pour choisir parmi plusieurs contrats du mois. Ignorée avec `BY_PUNCTO_CONTRACT_ID`.",
                              "example": "2026-10-05"
                            }
                          }
                        },
                        "businessMealParticipants": {
                          "type": "array",
                          "description": "Participants d’un repas d’affaires (`expenseType` `MEALS`), désignés comme `contractMatching`. Les titres restaurant du mois de chacun sont réduits ; son contrat doit être en vigueur à la date de la dépense.\n\nLa réduction s’applique dès l’enregistrement, **quel que soit le statut de la note** : envoyez les participants avec une note `VALIDATED` et retirez-les d’une note refusée. Sur un mois clôturé, c’est une saisie tardive sur la paie de chaque participant.\n\nAbsent, les participants enregistrés sont conservés ; une liste vide les retire. Si la note change de mois de paie, ils la suivent avec leur réduction.",
                          "items": {
                            "type": "object",
                            "required": [
                              "type",
                              "value"
                            ],
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "BY_COLLABORATOR_FOREIGN_ERP_ID",
                                  "BY_PUNCTO_COLLABORATOR_ID",
                                  "BY_PUNCTO_CONTRACT_ID"
                                ],
                                "description": "- `BY_COLLABORATOR_FOREIGN_ERP_ID` : `value` est le `foreignErpId` du collaborateur\n- `BY_PUNCTO_COLLABORATOR_ID` : `value` est l’identifiant Puncto du collaborateur\n- `BY_PUNCTO_CONTRACT_ID` : `value` est l’identifiant Puncto du contrat"
                              },
                              "value": {
                                "type": "string",
                                "description": "Identifiant du participant ou de son contrat."
                              }
                            }
                          }
                        },
                        "data": {
                          "description": "Contenu de la variable. La forme dépend de `type`, et pour `TAX_FREE_INDEMNITY` de `indemnityType`.",
                          "oneOf": [
                            {
                              "title": "Prime",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "amount",
                                "primeType",
                                "isAbsenceSensitive"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "PRIME",
                                  "description": "Prime"
                                },
                                "name": {
                                  "type": "string",
                                  "description": "Libellé affiché sur le bulletin."
                                },
                                "amount": {
                                  "type": "number",
                                  "description": "Montant brut, en euros."
                                },
                                "primeType": {
                                  "type": "string",
                                  "enum": [
                                    "COOPTATION_BONUS",
                                    "BUSINESS_BONUS",
                                    "OTHER",
                                    "HOME_OCCUPATION_ALLOWANCE"
                                  ],
                                  "description": "- `COOPTATION_BONUS` : Prime de cooptation\n- `BUSINESS_BONUS` : Prime business\n- `OTHER` : Autre prime brute\n- `HOME_OCCUPATION_ALLOWANCE` : Indemnité d'occupation du domicile"
                                },
                                "isAbsenceSensitive": {
                                  "type": "boolean",
                                  "description": "La prime est proratisée en fonction des absences du mois."
                                }
                              }
                            },
                            {
                              "title": "Heures supplémentaires",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "hours",
                                "overtimeDate"
                              ],
                              "description": "Réservées aux contrats à temps plein décomptés en heures.",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "OVERTIME",
                                  "description": "Heures supplémentaires"
                                },
                                "name": {
                                  "type": "string",
                                  "description": "Libellé affiché sur le bulletin."
                                },
                                "hours": {
                                  "type": "number",
                                  "exclusiveMinimum": 0,
                                  "description": "Nombre d’heures."
                                },
                                "overtimeDate": {
                                  "type": "string",
                                  "format": "date",
                                  "description": "Jour où les heures ont été effectuées.",
                                  "example": "2026-10-14"
                                },
                                "compensationMode": {
                                  "type": "string",
                                  "enum": [
                                    "PAYMENT",
                                    "REST"
                                  ],
                                  "description": "Compensation des heures. En repos, elles gardent leur rang dans la semaine pour leur majoration, ne sont pas payées au bulletin et leurs heures majorées sont créditées au compteur de repos compensateur (RCR) le dimanche de la semaine. Absent : heures payées.\n\n- `PAYMENT` : Paiement des heures supplémentaires\n- `REST` : Repos compensateur de remplacement",
                                  "default": "PAYMENT"
                                }
                              }
                            },
                            {
                              "title": "Jours de télétravail",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "days"
                              ],
                              "description": "Correction des jours de télétravail du mois. L’établissement doit verser une indemnité par jour, non désactivée sur le contrat. Une seule par contrat et par mois.\n\nSi l’établissement décompte les jours à la main, `days` est le total du mois ; sinon, il s’ajoute aux jours déclarés par le collaborateur.",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "REMOTE_WORK_DAY",
                                  "description": "Jours de télétravail"
                                },
                                "name": {
                                  "type": "string",
                                  "const": "Jours de télétravail",
                                  "description": "Libellé fixe : `Jours de télétravail`."
                                },
                                "days": {
                                  "type": "number",
                                  "minimum": -31,
                                  "maximum": 31,
                                  "multipleOf": 0.5,
                                  "description": "Nombre de jours, par demi-journée. Négatif pour retirer des jours.",
                                  "example": 8.5
                                }
                              }
                            },
                            {
                              "title": "Ajustement des primes de panier",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "mealAllowanceType",
                                "count"
                              ],
                              "description": "Repas à ajouter ou retirer aux primes de panier du mois. L’établissement doit verser ce type de repas.",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "MEAL_ALLOWANCE_ADJUSTMENT",
                                  "description": "Ajustement paniers"
                                },
                                "name": {
                                  "type": "string",
                                  "const": "Ajustement paniers",
                                  "description": "Libellé fixe : `Ajustement paniers`."
                                },
                                "mealAllowanceType": {
                                  "type": "string",
                                  "enum": [
                                    "ON_SITE",
                                    "OFF_SITE",
                                    "TRAVEL_RESTAURANT"
                                  ],
                                  "description": "- `ON_SITE` : Repas sur le lieu de travail\n- `OFF_SITE` : Repas hors des locaux\n- `TRAVEL_RESTAURANT` : Repas au restaurant en déplacement"
                                },
                                "count": {
                                  "type": "integer",
                                  "minimum": -31,
                                  "maximum": 62,
                                  "description": "Nombre de repas. Négatif pour en retirer."
                                },
                                "label": {
                                  "type": "string",
                                  "maxLength": 60,
                                  "description": "Libellé de la ligne imprimée sur le bulletin, sous la ligne de son type de repas. « Régularisation prime de panier » par défaut. Imprimé seulement pour le type de repas décompté depuis les jours travaillés du contrat : ailleurs (saisie manuelle des repas, autre type), l’ajustement reste sur la ligne de son type et le libellé n’apparaît pas."
                                }
                              }
                            },
                            {
                              "title": "Ajustement des titres restaurant",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "count"
                              ],
                              "description": "Titres restaurant à ajouter ou retirer au mois. L’établissement doit en distribuer, sans désactivation sur le contrat.",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "MEAL_VOUCHER_ADJUSTMENT",
                                  "description": "Ajustement titres restaurant"
                                },
                                "name": {
                                  "type": "string",
                                  "const": "Ajustement titres restaurant",
                                  "description": "Libellé fixe : `Ajustement titres restaurant`."
                                },
                                "count": {
                                  "type": "integer",
                                  "minimum": -31,
                                  "maximum": 62,
                                  "description": "Nombre de titres. Négatif pour en retirer."
                                },
                                "label": {
                                  "type": "string",
                                  "maxLength": 60,
                                  "description": "Libellé de la ligne imprimée sur le bulletin, sous la ligne « Titres restaurant ». « Régularisation titres restaurant » par défaut."
                                }
                              }
                            },
                            {
                              "title": "Acompte sur salaire",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "amount",
                                "paymentDate"
                              ],
                              "description": "Acompte versé dans le mois, déduit du virement de fin de mois. Toujours `VALIDATED` ; refusé sur un mois clôturé ou dont le bulletin est validé.",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "SALARY_ADVANCE",
                                  "description": "Acompte sur salaire"
                                },
                                "name": {
                                  "type": "string",
                                  "const": "Acompte sur salaire",
                                  "description": "Libellé fixe : `Acompte sur salaire`."
                                },
                                "amount": {
                                  "type": "number",
                                  "exclusiveMinimum": 0,
                                  "description": "Montant versé, en euros, avec 2 décimales au plus.",
                                  "example": 300.5
                                },
                                "paymentDate": {
                                  "type": "string",
                                  "format": "date",
                                  "description": "Date de versement, dans le mois de paie.",
                                  "example": "2026-10-15"
                                }
                              }
                            },
                            {
                              "title": "Retenue sur salaire",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "amount",
                                "deductionType"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "SALARY_DEDUCTION",
                                  "description": "Retenue sur salaire"
                                },
                                "name": {
                                  "type": "string",
                                  "description": "Libellé affiché sur le bulletin."
                                },
                                "amount": {
                                  "type": "number",
                                  "description": "Montant, en euros."
                                },
                                "deductionType": {
                                  "type": "string",
                                  "enum": [
                                    "LAST_MONTH_NEGATIVE_PAY_ADVANCE",
                                    "NET_REDUCTION",
                                    "BRUT_REDUCTION"
                                  ],
                                  "description": "- `LAST_MONTH_NEGATIVE_PAY_ADVANCE` : Avance de salaire négative du mois précédent\n- `NET_REDUCTION` : Retenue sur le net\n- `BRUT_REDUCTION` : Réduction de salaire brut"
                                }
                              }
                            },
                            {
                              "title": "Avantage en nature",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "amount",
                                "benefitType"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "IN_KIND_BENEFIT",
                                  "description": "Avantage en nature"
                                },
                                "name": {
                                  "type": "string",
                                  "description": "Libellé affiché sur le bulletin."
                                },
                                "amount": {
                                  "type": "number",
                                  "description": "Valeur de l’avantage, en euros."
                                },
                                "benefitType": {
                                  "type": "string",
                                  "enum": [
                                    "MEALS",
                                    "HOUSING",
                                    "VEHICLE",
                                    "NTIC",
                                    "OTHER"
                                  ],
                                  "description": "- `MEALS` : Repas\n- `HOUSING` : Logement\n- `VEHICLE` : Véhicule\n- `NTIC` : NTIC\n- `OTHER` : Autre"
                                },
                                "actualExpensesVehicle": {
                                  "type": "object",
                                  "description": "Véhicule évalué aux dépenses réelles (`benefitType: VEHICLE`). `amount` est alors l’usage personnel évalué par l’employeur : chaque bulletin en déduit l’abattement des véhicules électriques (50 %, dans la limite du plafond annuel suivi par salarié) puis la participation du salarié.",
                                  "required": [
                                    "isElectric",
                                    "employeeMonthlyContribution",
                                    "contributionWithheldFromPay",
                                    "retainedDuringLeave"
                                  ],
                                  "properties": {
                                    "isElectric": {
                                      "type": "boolean",
                                      "description": "Véhicule électrique."
                                    },
                                    "assignedOn": {
                                      "type": "string",
                                      "format": "date",
                                      "description": "Date de mise à disposition. Requise pour un véhicule électrique.",
                                      "example": "2026-11-02"
                                    },
                                    "isEcoScoreEligible": {
                                      "type": "boolean",
                                      "description": "Éco-score exigé pour l’abattement des véhicules électriques mis à disposition depuis le 1er février 2025."
                                    },
                                    "employeeMonthlyContribution": {
                                      "type": "number",
                                      "minimum": 0,
                                      "description": "Participation mensuelle du salarié, en euros, déduite après l’abattement."
                                    },
                                    "contributionWithheldFromPay": {
                                      "type": "boolean",
                                      "description": "La participation est retenue sur le net à payer. Sinon, le salarié la règle à part."
                                    },
                                    "retainedDuringLeave": {
                                      "type": "boolean",
                                      "description": "L’avantage est conservé pendant les congés."
                                    }
                                  }
                                }
                              }
                            },
                            {
                              "title": "Note de frais",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "amountTotal",
                                "amountReimbursed",
                                "indemnityType",
                                "expenseDate",
                                "expenseType",
                                "vatAmounts"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "TAX_FREE_INDEMNITY",
                                  "description": "Indemnité non soumise"
                                },
                                "name": {
                                  "type": "string",
                                  "description": "Libellé affiché sur le bulletin."
                                },
                                "amountTotal": {
                                  "type": "number",
                                  "description": "Montant TTC de la dépense, en euros."
                                },
                                "amountReimbursed": {
                                  "type": "number",
                                  "description": "Montant remboursé au salarié, en euros."
                                },
                                "indemnityType": {
                                  "type": "string",
                                  "const": "EXPENSE_NOTE"
                                },
                                "expenseDate": {
                                  "type": "string",
                                  "format": "date",
                                  "description": "Date de la dépense.",
                                  "example": "2026-10-03"
                                },
                                "expenseType": {
                                  "type": "string",
                                  "enum": [
                                    "HOTEL_LOGEMENT",
                                    "MEALS",
                                    "KILOMETRIC_INDEMNITIES",
                                    "TRANSPORT",
                                    "EQUIPMENT",
                                    "SERVICES",
                                    "OTHER"
                                  ],
                                  "description": "- `HOTEL_LOGEMENT` : Hôtel/Logement\n- `MEALS` : Repas\n- `KILOMETRIC_INDEMNITIES` : Indemnités kilométriques\n- `TRANSPORT` : Transport\n- `EQUIPMENT` : Équipement\n- `SERVICES` : Services\n- `OTHER` : Autre"
                                },
                                "vatAmounts": {
                                  "type": "object",
                                  "description": "Montants de TVA par taux, en euros.",
                                  "required": [
                                    "vatAmount2_1",
                                    "vatAmount5_5",
                                    "vatAmount10",
                                    "vatAmount20"
                                  ],
                                  "properties": {
                                    "vatAmount2_1": {
                                      "type": "number",
                                      "description": "TVA à 2,1 %"
                                    },
                                    "vatAmount5_5": {
                                      "type": "number",
                                      "description": "TVA à 5,5 %"
                                    },
                                    "vatAmount10": {
                                      "type": "number",
                                      "description": "TVA à 10 %"
                                    },
                                    "vatAmount20": {
                                      "type": "number",
                                      "description": "TVA à 20 %"
                                    }
                                  }
                                },
                                "kilometric": {
                                  "type": "object",
                                  "description": "Trajet des indemnités kilométriques (`expenseType` `KILOMETRIC_INDEMNITIES`). Facultatif mais recommandé : envoyé, `amountTotal` et `amountReimbursed` doivent valoir le montant du barème fiscal de l’année de la dépense pour ce trajet seul ; absent, la note n’est pas contrôlée au barème.",
                                  "required": [
                                    "vehicleCategory",
                                    "energyType",
                                    "fiscalPower",
                                    "departureAddress",
                                    "arrivalAddress",
                                    "distance",
                                    "isRoundTrip"
                                  ],
                                  "properties": {
                                    "vehicleCategory": {
                                      "type": "string",
                                      "enum": [
                                        "CAR",
                                        "MOTORCYCLE",
                                        "SCOOTER"
                                      ],
                                      "description": "- `CAR` : Voiture\n- `MOTORCYCLE` : Moto (plus de 50 cm³)\n- `SCOOTER` : Cyclomoteur (50 cm³ et moins)"
                                    },
                                    "energyType": {
                                      "type": "string",
                                      "enum": [
                                        "THERMIC_HYDROGEN_HYBRID",
                                        "ELECTRIC"
                                      ],
                                      "description": "- `THERMIC_HYDROGEN_HYBRID` : Thermique, hydrogène ou hybride\n- `ELECTRIC` : 100 % électrique"
                                    },
                                    "fiscalPower": {
                                      "type": [
                                        "number",
                                        "null"
                                      ],
                                      "description": "Puissance fiscale du véhicule, en chevaux fiscaux.",
                                      "example": 5
                                    },
                                    "departureAddress": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "Adresse de départ."
                                    },
                                    "arrivalAddress": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "Adresse d’arrivée."
                                    },
                                    "distance": {
                                      "type": "number",
                                      "exclusiveMinimum": 0,
                                      "description": "Distance du trajet, en kilomètres.",
                                      "example": 100
                                    },
                                    "isRoundTrip": {
                                      "type": "boolean",
                                      "description": "Aller-retour : la distance compte deux fois."
                                    }
                                  }
                                }
                              }
                            },
                            {
                              "title": "Transport personnel",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "amountTotal",
                                "amountReimbursed",
                                "indemnityType",
                                "personalTransportType"
                              ],
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "TAX_FREE_INDEMNITY",
                                  "description": "Indemnité non soumise"
                                },
                                "name": {
                                  "type": "string",
                                  "description": "Libellé affiché sur le bulletin."
                                },
                                "amountTotal": {
                                  "type": "number",
                                  "description": "Montant total de la dépense, en euros."
                                },
                                "amountReimbursed": {
                                  "type": "number",
                                  "description": "Montant remboursé au salarié, en euros."
                                },
                                "indemnityType": {
                                  "type": "string",
                                  "const": "PERSONAL_TRANSPORT"
                                },
                                "personalTransportType": {
                                  "type": "string",
                                  "enum": [
                                    "FORFAIT_MOBILITES_DURABLES",
                                    "PRIME_TRANSPORT"
                                  ],
                                  "description": "- `FORFAIT_MOBILITES_DURABLES` : Forfait mobilités durables\n- `PRIME_TRANSPORT` : Prime de transport"
                                },
                                "primeTransportType": {
                                  "type": "string",
                                  "enum": [
                                    "FUEL",
                                    "ELECTRIC_VEHICLE_CHARGING"
                                  ],
                                  "description": "Requis quand `personalTransportType` vaut `PRIME_TRANSPORT`.\n\n- `FUEL` : Frais de carburant\n- `ELECTRIC_VEHICLE_CHARGING` : Frais d'alimentation de véhicules électriques"
                                },
                                "fmdTransportType": {
                                  "type": "string",
                                  "enum": [
                                    "PERSONAL_BIKE",
                                    "CARPOOLING",
                                    "RENTED_OR_SHARED_VEHICLES",
                                    "LOW_EMISSION_CAR_SHARING",
                                    "MOTORIZED_PERSONAL_TRANSPORT_DEVICES",
                                    "PUBLIC_TRANSPORT_WITHOUT_SUBSCRIPTION"
                                  ],
                                  "description": "Requis quand `personalTransportType` vaut `FORFAIT_MOBILITES_DURABLES`.\n\n- `PERSONAL_BIKE` : Vélo personnel, y compris vélo électrique\n- `CARPOOLING` : Covoiturage, en tant que passager et en tant que conducteur\n- `RENTED_OR_SHARED_VEHICLES` : Engins de déplacement personnels, cyclomoteurs et motocyclettes en location ou en libre-service\n- `LOW_EMISSION_CAR_SHARING` : Autopartage de véhicules à faibles émissions (notamment les véhicules alimentés totalement ou partiellement par : électricité, hydrogène, gaz naturel)\n- `MOTORIZED_PERSONAL_TRANSPORT_DEVICES` : Engins de déplacement personnel motorisés (électriques) des particuliers : trottinettes, monoroues, gyropodes, skateboard, hoverboard, etc.\n- `PUBLIC_TRANSPORT_WITHOUT_SUBSCRIPTION` : Transports publics (hors abonnement)"
                                }
                              }
                            },
                            {
                              "title": "Autre indemnité non soumise",
                              "type": "object",
                              "required": [
                                "type",
                                "name",
                                "amountTotal",
                                "amountReimbursed",
                                "indemnityType"
                              ],
                              "description": "`SPORT_SUBSCRIPTION` n’est accepté que si l’entreprise prend en charge les abonnements sport.",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "TAX_FREE_INDEMNITY",
                                  "description": "Indemnité non soumise"
                                },
                                "name": {
                                  "type": "string",
                                  "description": "Libellé affiché sur le bulletin."
                                },
                                "amountTotal": {
                                  "type": "number",
                                  "description": "Montant total de la dépense, en euros."
                                },
                                "amountReimbursed": {
                                  "type": "number",
                                  "description": "Montant remboursé au salarié, en euros."
                                },
                                "indemnityType": {
                                  "type": "string",
                                  "enum": [
                                    "PUBLIC_TRANSPORT",
                                    "SPORT_SUBSCRIPTION",
                                    "OTHER"
                                  ],
                                  "description": "`PUBLIC_TRANSPORT` : abonnements de transport en commun seulement. Un forfait mobilités durables passe par `PERSONAL_TRANSPORT`.\n\n- `PUBLIC_TRANSPORT` : Transport public\n- `SPORT_SUBSCRIPTION` : Abonnement sport\n- `OTHER` : Autre"
                                },
                                "titleType": {
                                  "type": "string",
                                  "enum": [
                                    "NAVIGO",
                                    "IMAGINE_R",
                                    "VELIB",
                                    "TER_SNCF",
                                    "OTHER"
                                  ],
                                  "description": "- `NAVIGO` : Navigo\n- `IMAGINE_R` : Imagine R\n- `VELIB` : Vélo (Vélib’, Vélo'v, V'Lille etc)\n- `TER_SNCF` : Abonnement TER / SNCF\n- `OTHER` : Autre (préciser)"
                                },
                                "periodicity": {
                                  "type": "string",
                                  "enum": [
                                    "MONTHLY",
                                    "ANNUAL"
                                  ],
                                  "description": "`ANNUAL` est refusé : créez un abonnement annuel avec `POST /public/v1/recurring-variables`.\n\n- `MONTHLY` : Mensuel\n- `ANNUAL` : Annuel"
                                }
                              }
                            }
                          ]
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "variables": [
                  {
                    "foreignErpId": "prime-2026-10-salarie-123",
                    "status": "VALIDATED",
                    "year": 2026,
                    "month": 10,
                    "contractMatching": {
                      "type": "BY_COLLABORATOR_FOREIGN_ERP_ID",
                      "value": "salarie-123"
                    },
                    "data": {
                      "type": "PRIME",
                      "name": "Prime sur objectifs",
                      "amount": 500,
                      "primeType": "BUSINESS_BONUS",
                      "isAbsenceSensitive": false
                    }
                  },
                  {
                    "foreignErpId": "teletravail-2026-10-salarie-123",
                    "status": "VALIDATED",
                    "year": 2026,
                    "month": 10,
                    "contractMatching": {
                      "type": "BY_COLLABORATOR_FOREIGN_ERP_ID",
                      "value": "salarie-123"
                    },
                    "data": {
                      "type": "REMOTE_WORK_DAY",
                      "name": "Jours de télétravail",
                      "days": 8
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Bilan de l’import",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ImportResult"
                    },
                    {
                      "type": "object",
                      "required": [
                        "unchangedCount"
                      ],
                      "properties": {
                        "unchangedCount": {
                          "type": "integer",
                          "description": "Variables renvoyées à l’identique, laissées telles quelles."
                        }
                      }
                    }
                  ]
                },
                "example": {
                  "createdCount": 0,
                  "modifiedCount": 1,
                  "unchangedCount": 12,
                  "errors": [
                    "Le collaborateur avec l’identifiant salarie-456 (matching par BY_COLLABORATOR_FOREIGN_ERP_ID) n’a pas été trouvé pour la variable de paie prime-2026-10-salarie-456 avec le type PRIME, le nom Prime sur objectifs"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`foreignErpId` manquant sans `disableIdempotency`, ou import annulé",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Une erreur est survenue lors de l’importation des variables de paie (aucune donnée importée)"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "description": "Conflit avec un autre import, rien n’est importé : renvoyez le lot. Un autre import de variables de paie de l’entreprise est en cours, ou un `foreignErpId` du lot vient d’être importé par un autre appel.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "importInProgress": {
                    "summary": "Import en cours",
                    "value": {
                      "error": "Un autre import de variables de paie est en cours pour cette entreprise : réessayez dans quelques instants."
                    }
                  },
                  "foreignErpIdImported": {
                    "summary": "foreignErpId importé pendant l’import",
                    "value": {
                      "error": "Une variable a été importée sous l'un de ces foreignErpId pendant cet import : renvoyez le lot (aucune donnée importée)."
                    }
                  }
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/on-call-types": {
      "get": {
        "operationId": "listOnCallTypes",
        "tags": [
          "Astreintes"
        ],
        "summary": "Lister les types d’astreinte",
        "description": "Liste paginée des types d’astreinte, par libellé, avec leur contrepartie brute par période (`PERIOD`) ou par heure (`HOUR`). Une période d’astreinte désigne son type par `onCallTypeId`.\n\nLes types se gèrent dans Puncto (Équipe › Astreintes). `400` si le module des astreintes n’est pas activé.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de types d’astreinte",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiOnCallType"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Astreintes non activées pour l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Les astreintes ne sont pas activées pour cette entreprise."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/on-call-periods": {
      "get": {
        "operationId": "listOnCallPeriods",
        "tags": [
          "Astreintes"
        ],
        "summary": "Lister les périodes d’astreinte",
        "description": "Liste paginée des périodes d’astreinte, du mois de paie le plus récent au plus ancien. Une période est une variable de paie `ON_CALL` : elle figure aussi dans `GET /public/v1/payroll-variables`.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Année du mois de paie.",
            "schema": {
              "type": "integer",
              "minimum": 2000,
              "maximum": 2100,
              "example": 2026
            }
          },
          {
            "name": "month",
            "in": "query",
            "description": "Mois de paie, de 1 (janvier) à 12.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12,
              "example": 11
            }
          },
          {
            "name": "contractId",
            "in": "query",
            "description": "Identifiant Puncto du contrat.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          },
          {
            "name": "foreignErpId",
            "in": "query",
            "description": "Identifiant de la période dans votre système.",
            "schema": {
              "type": "string",
              "example": "astreinte-2026-11-13-salarie-123"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de périodes d’astreinte",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiPayrollVariable"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "post": {
        "operationId": "createOnCallPeriod",
        "tags": [
          "Astreintes"
        ],
        "summary": "Créer une période d’astreinte",
        "description": "Crée une période d’astreinte : une variable de paie `ON_CALL` validée, rattachée au mois de paie de son début, avec le libellé et la contrepartie du type d’astreinte.\n\n- La période tient dans les dates du contrat, sans chevaucher une autre période du même contrat.\n- Une intervention tient dans la période et finit le jour où elle commence : découpez à minuit une intervention de nuit.\n- Contrat en heures : les interventions sont des heures supplémentaires, le contrat doit y être éligible (temps plein). Elles sont payées, ou compensées en repos compensateur de remplacement (`compensationMode`).\n- Forfait jours : une intervention peut créditer des jours de repos (`dayCount`), une journée au plus par jour.\n- Mois de paie clôturé : la paie suivante régularise, et un nouveau récapitulatif d’astreintes est remis au salarié.\n\nVoir le guide [Astreintes](/guides/astreintes).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "contractMatching",
                  "onCallTypeId",
                  "start",
                  "end",
                  "interventions"
                ],
                "properties": {
                  "foreignErpId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "Identifiant de l’élément dans votre système, unique dans l’entreprise pour les variables de paie, astreintes et variables récurrentes réunies : un `foreignErpId` déjà utilisé renvoie `409`."
                  },
                  "contractMatching": {
                    "type": "object",
                    "description": "Désigne le contrat. Pour un collaborateur, Puncto retient son contrat en vigueur à `eventDate`, à défaut au début de la période.",
                    "required": [
                      "type",
                      "value"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "enum": [
                          "BY_PUNCTO_COLLABORATOR_ID",
                          "BY_PUNCTO_CONTRACT_ID"
                        ],
                        "description": "Clé de correspondance utilisée par `value`.\n\n- `BY_PUNCTO_COLLABORATOR_ID` : `value` est l’identifiant Puncto du collaborateur\n- `BY_PUNCTO_CONTRACT_ID` : `value` est l’identifiant Puncto du contrat (`GET /public/v1/contracts`), `eventDate` est ignorée"
                      },
                      "value": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Identifiant Puncto du collaborateur, ou du contrat avec `BY_PUNCTO_CONTRACT_ID`. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/collaborators?collaboratorForeignErpId=…`."
                      },
                      "eventDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date de l’événement, pour choisir le contrat quand le collaborateur en a plusieurs sur le mois.",
                        "example": "2026-10-05"
                      }
                    }
                  },
                  "onCallTypeId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Identifiant Puncto du type d’astreinte (`GET /public/v1/on-call-types`). Un type désactivé n’est plus accepté pour une nouvelle période.",
                    "example": "octy_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "start": {
                    "type": "string",
                    "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d$",
                    "description": "Début de la période. Heure de Paris, sans fuseau : `YYYY-MM-DDTHH:mm`.",
                    "example": "2026-11-13T18:00"
                  },
                  "end": {
                    "type": "string",
                    "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d$",
                    "description": "Fin de la période, après son début. Heure de Paris, sans fuseau : `YYYY-MM-DDTHH:mm`.",
                    "example": "2026-11-16T08:00"
                  },
                  "periodCount": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "description": "Nombre de périodes indemnisées pour un type décompté à la période, deux décimales au plus, 1 par défaut. Ignoré pour un type à l’heure, payé sur la durée de la période."
                  },
                  "interventions": {
                    "type": "array",
                    "description": "Interventions pendant la période ; tableau vide s’il n’y en a pas.",
                    "items": {
                      "type": "object",
                      "required": [
                        "start",
                        "end",
                        "location"
                      ],
                      "properties": {
                        "start": {
                          "type": "string",
                          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d$",
                          "description": "Début de l’intervention, temps de déplacement compris. Heure de Paris, sans fuseau : `YYYY-MM-DDTHH:mm`.",
                          "example": "2026-11-14T10:00"
                        },
                        "end": {
                          "type": "string",
                          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d$",
                          "description": "Fin de l’intervention, le jour de son début (00h00 le lendemain au plus tard). Heure de Paris, sans fuseau : `YYYY-MM-DDTHH:mm`.",
                          "example": "2026-11-14T12:00"
                        },
                        "location": {
                          "type": "string",
                          "enum": [
                            "REMOTE",
                            "ON_SITE"
                          ],
                          "description": "- `REMOTE` : À distance\n- `ON_SITE` : Sur site"
                        },
                        "dayCount": {
                          "type": "string",
                          "enum": [
                            "NONE",
                            "HALF_DAY",
                            "FULL_DAY"
                          ],
                          "description": "Forfait jours uniquement, refusé sur un contrat en heures : jours de repos crédités au compteur de JNT. Par défaut, une demi-journée un jour de repos ou d’absence validée, aucun un jour travaillé.\n\n- `NONE` : Aucun (jour travaillé)\n- `HALF_DAY` : Demi-journée\n- `FULL_DAY` : Journée"
                        },
                        "compensationMode": {
                          "type": "string",
                          "enum": [
                            "PAYMENT",
                            "REST"
                          ],
                          "description": "Contrat en heures uniquement, `REST` refusé au forfait jours : `PAYMENT` (par défaut) paie l’intervention en heures supplémentaires, `REST` crédite ses heures, majoration comprise, au compteur de repos compensateur de remplacement (RCR).\n\n- `PAYMENT` : Paiement des heures supplémentaires\n- `REST` : Repos compensateur de remplacement"
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "foreignErpId": "astreinte-2026-11-13-salarie-123",
                "contractMatching": {
                  "type": "BY_PUNCTO_COLLABORATOR_ID",
                  "value": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                },
                "onCallTypeId": "octy_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
                "start": "2026-11-13T18:00",
                "end": "2026-11-16T08:00",
                "interventions": [
                  {
                    "start": "2026-11-14T10:00",
                    "end": "2026-11-14T12:00",
                    "location": "REMOTE"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Période créée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiPayrollVariable"
                }
              }
            }
          },
          "400": {
            "description": "Période refusée : astreintes non activées ou règle non respectée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Les astreintes ne sont pas activées pour cette entreprise."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur ou contrat introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Contrat non trouvé"
                }
              }
            }
          },
          "409": {
            "description": "`foreignErpId` déjà utilisé",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Le foreignErpId astreinte-2026-11-13-salarie-123 désigne déjà une autre variable."
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/on-call-periods/{onCallPeriodId}": {
      "get": {
        "operationId": "getOnCallPeriod",
        "tags": [
          "Astreintes"
        ],
        "summary": "Consulter une période d’astreinte",
        "parameters": [
          {
            "name": "onCallPeriodId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de la période (`payrollVariableId`), ou son `foreignErpId` avec `matchingBy=BY_FOREIGN_ERP_ID`.",
            "schema": {
              "type": "string",
              "example": "pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "matchingBy",
            "in": "query",
            "description": "Clé de correspondance de `onCallPeriodId`. Par défaut, l’identifiant Puncto.",
            "schema": {
              "type": "string",
              "enum": [
                "BY_PUNCTO_ID",
                "BY_FOREIGN_ERP_ID"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Période d’astreinte",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiPayrollVariable"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Période introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Période d’astreinte non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "put": {
        "operationId": "updateOnCallPeriod",
        "tags": [
          "Astreintes"
        ],
        "summary": "Modifier une période d’astreinte",
        "description": "Remplace une période d’astreinte, avec les règles de la création. Son contrat et son statut ne changent pas : pour changer de contrat, supprimez-la puis recréez-la.\n\nLa contrepartie est reprise du barème actuel à chaque appel, même à corps identique : **sur un mois clôturé, n’envoyez que les périodes réellement modifiées**, sinon un barème changé entre-temps crée une régularisation.\n\nVoir le guide [Astreintes](/guides/astreintes).",
        "parameters": [
          {
            "name": "onCallPeriodId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de la période (`payrollVariableId`). Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/on-call-periods/{onCallPeriodId}?matchingBy=BY_FOREIGN_ERP_ID`.",
            "schema": {
              "type": "string",
              "example": "pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "onCallTypeId",
                  "start",
                  "end",
                  "interventions"
                ],
                "properties": {
                  "onCallTypeId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Identifiant Puncto du type d’astreinte (`GET /public/v1/on-call-types`). Un type désactivé n’est plus accepté pour une nouvelle période.",
                    "example": "octy_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "start": {
                    "type": "string",
                    "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d$",
                    "description": "Début de la période. Heure de Paris, sans fuseau : `YYYY-MM-DDTHH:mm`.",
                    "example": "2026-11-13T18:00"
                  },
                  "end": {
                    "type": "string",
                    "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d$",
                    "description": "Fin de la période, après son début. Heure de Paris, sans fuseau : `YYYY-MM-DDTHH:mm`.",
                    "example": "2026-11-16T08:00"
                  },
                  "periodCount": {
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "description": "Nombre de périodes indemnisées pour un type décompté à la période, deux décimales au plus, 1 par défaut. Ignoré pour un type à l’heure, payé sur la durée de la période."
                  },
                  "interventions": {
                    "type": "array",
                    "description": "Interventions pendant la période ; tableau vide s’il n’y en a pas.",
                    "items": {
                      "type": "object",
                      "required": [
                        "start",
                        "end",
                        "location"
                      ],
                      "properties": {
                        "start": {
                          "type": "string",
                          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d$",
                          "description": "Début de l’intervention, temps de déplacement compris. Heure de Paris, sans fuseau : `YYYY-MM-DDTHH:mm`.",
                          "example": "2026-11-14T10:00"
                        },
                        "end": {
                          "type": "string",
                          "pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d$",
                          "description": "Fin de l’intervention, le jour de son début (00h00 le lendemain au plus tard). Heure de Paris, sans fuseau : `YYYY-MM-DDTHH:mm`.",
                          "example": "2026-11-14T12:00"
                        },
                        "location": {
                          "type": "string",
                          "enum": [
                            "REMOTE",
                            "ON_SITE"
                          ],
                          "description": "- `REMOTE` : À distance\n- `ON_SITE` : Sur site"
                        },
                        "dayCount": {
                          "type": "string",
                          "enum": [
                            "NONE",
                            "HALF_DAY",
                            "FULL_DAY"
                          ],
                          "description": "Forfait jours uniquement, refusé sur un contrat en heures : jours de repos crédités au compteur de JNT. Par défaut, une demi-journée un jour de repos ou d’absence validée, aucun un jour travaillé.\n\n- `NONE` : Aucun (jour travaillé)\n- `HALF_DAY` : Demi-journée\n- `FULL_DAY` : Journée"
                        },
                        "compensationMode": {
                          "type": "string",
                          "enum": [
                            "PAYMENT",
                            "REST"
                          ],
                          "description": "Contrat en heures uniquement, `REST` refusé au forfait jours : `PAYMENT` (par défaut) paie l’intervention en heures supplémentaires, `REST` crédite ses heures, majoration comprise, au compteur de repos compensateur de remplacement (RCR).\n\n- `PAYMENT` : Paiement des heures supplémentaires\n- `REST` : Repos compensateur de remplacement"
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "onCallTypeId": "octy_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
                "start": "2026-11-13T18:00",
                "end": "2026-11-16T08:00",
                "interventions": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Période modifiée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiPayrollVariable"
                }
              }
            }
          },
          "400": {
            "description": "Période refusée : astreintes non activées ou règle non respectée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Les astreintes ne sont pas activées pour cette entreprise."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Période introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Période d’astreinte non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "delete": {
        "operationId": "deleteOnCallPeriod",
        "tags": [
          "Astreintes"
        ],
        "summary": "Supprimer une période d’astreinte",
        "description": "Supprime une période d’astreinte. Sur un mois de paie clôturé, la suppression est régularisée par la paie suivante.",
        "parameters": [
          {
            "name": "onCallPeriodId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de la période (`payrollVariableId`). Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/on-call-periods/{onCallPeriodId}?matchingBy=BY_FOREIGN_ERP_ID`.",
            "schema": {
              "type": "string",
              "example": "pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Période supprimée"
          },
          "400": {
            "description": "Astreintes non activées pour l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Les astreintes ne sont pas activées pour cette entreprise."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Période introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Période d’astreinte non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/recurring-variables": {
      "get": {
        "operationId": "listRecurringVariables",
        "tags": [
          "Variables récurrentes"
        ],
        "summary": "Lister les variables récurrentes",
        "description": "Liste paginée des variables récurrentes de l’entreprise, de la plus ancienne à la plus récente : primes et avantages en nature mensuels, véhicules de fonction, abonnements annuels de transport public. `GET /public/v1/payroll-variables` ne les liste pas.\n\n`lockedThrough` est le dernier mois verrouillé (paie clôturée ou bulletin validé) que la variable a versé : dès lors, elle ne se supprime plus et seul son dernier mois de versement peut changer.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "contractId",
            "in": "query",
            "description": "Identifiant Puncto du contrat.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          },
          {
            "name": "status[]",
            "in": "query",
            "description": "Statuts à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "PENDING",
                  "VALIDATED",
                  "REJECTED"
                ],
                "description": "- `PENDING` : En attente\n- `VALIDATED` : Accepté\n- `REJECTED` : Refusé"
              }
            }
          },
          {
            "name": "type[]",
            "in": "query",
            "description": "Natures à garder (`data.type`). Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "PRIME",
                  "IN_KIND_BENEFIT",
                  "TAX_FREE_INDEMNITY"
                ],
                "description": "- `PRIME` : Prime\n- `IN_KIND_BENEFIT` : Avantage en nature\n- `TAX_FREE_INDEMNITY` : Indemnité non soumise"
              }
            }
          },
          {
            "name": "foreignErpId",
            "in": "query",
            "description": "Identifiant de la variable récurrente dans votre système.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de variables récurrentes",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiRecurringVariable"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur du filtre introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "post": {
        "operationId": "createRecurringVariable",
        "tags": [
          "Variables récurrentes"
        ],
        "summary": "Créer une variable récurrente",
        "description": "Crée une variable récurrente : prime (indemnité d’occupation du domicile ou autre), avantage en nature, véhicule de fonction dont Puncto calcule l’avantage chaque mois, ou abonnement annuel de transport public. Les brouillons de bulletin des mois concernés sont recalculés.\n\nElle se crée sur des mois encore ouverts, dans les dates du contrat. Son contenu ne se modifie plus : pour changer un montant, supprimez-la (tant qu’aucun mois verrouillé ne l’a versée) ou fixez son dernier mois de versement, puis créez-en une nouvelle.\n\nJustificatifs : envoyez la requête en `multipart/form-data` avec des fichiers `proofFiles[i]` (pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "contractMatching",
                  "data"
                ],
                "properties": {
                  "foreignErpId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "Identifiant de l’élément dans votre système, unique dans l’entreprise pour les variables de paie, astreintes et variables récurrentes réunies : un `foreignErpId` déjà utilisé renvoie `409`."
                  },
                  "contractMatching": {
                    "type": "object",
                    "description": "Contrat qui verse la variable. Désigné par le collaborateur : son contrat actif à `eventDate`, à défaut à la fin puis au début du premier mois de versement, et pour un abonnement annuel commencé avant l’embauche, son contrat actuel.",
                    "required": [
                      "type",
                      "value"
                    ],
                    "properties": {
                      "type": {
                        "type": "string",
                        "enum": [
                          "BY_PUNCTO_COLLABORATOR_ID",
                          "BY_PUNCTO_CONTRACT_ID"
                        ],
                        "description": "Clé de correspondance utilisée par `value`.\n\n- `BY_PUNCTO_COLLABORATOR_ID` : `value` est l’identifiant Puncto du collaborateur\n- `BY_PUNCTO_CONTRACT_ID` : `value` est l’identifiant Puncto du contrat (`GET /public/v1/contracts`), `eventDate` est ignorée"
                      },
                      "value": {
                        "type": "string",
                        "minLength": 1,
                        "description": "Identifiant Puncto du collaborateur, ou du contrat avec `BY_PUNCTO_CONTRACT_ID`. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/collaborators?collaboratorForeignErpId=…`."
                      },
                      "eventDate": {
                        "type": "string",
                        "format": "date",
                        "description": "Date de l’événement, pour choisir le contrat quand le collaborateur en a plusieurs sur le mois.",
                        "example": "2026-10-05"
                      }
                    }
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "PENDING",
                      "VALIDATED",
                      "REJECTED"
                    ],
                    "description": "Par défaut `VALIDATED`. Seule une variable `VALIDATED` est versée.\n\n- `PENDING` : En attente\n- `VALIDATED` : Accepté\n- `REJECTED` : Refusé"
                  },
                  "data": {
                    "description": "Ce que la variable verse chaque mois.",
                    "oneOf": [
                      {
                        "title": "Prime",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amount",
                          "primeType",
                          "isAbsenceSensitive"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "PRIME",
                            "description": "Prime"
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Libellé imprimé sur le bulletin."
                          },
                          "amount": {
                            "type": "number",
                            "exclusiveMinimum": 0,
                            "description": "Montant brut mensuel, en euros. Deux décimales au plus."
                          },
                          "primeType": {
                            "type": "string",
                            "enum": [
                              "HOME_OCCUPATION_ALLOWANCE",
                              "OTHER"
                            ],
                            "description": "- `HOME_OCCUPATION_ALLOWANCE` : Indemnité d'occupation du domicile\n- `OTHER` : Autre prime brute"
                          },
                          "isAbsenceSensitive": {
                            "type": "boolean",
                            "description": "La prime est proratisée selon les absences du mois."
                          }
                        }
                      },
                      {
                        "title": "Avantage en nature",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amount",
                          "benefitType"
                        ],
                        "not": {
                          "required": [
                            "vehicle"
                          ]
                        },
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "IN_KIND_BENEFIT",
                            "description": "Avantage en nature"
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Libellé imprimé sur le bulletin."
                          },
                          "amount": {
                            "type": "number",
                            "exclusiveMinimum": 0,
                            "description": "Valeur mensuelle de l’avantage, en euros. Deux décimales au plus."
                          },
                          "benefitType": {
                            "type": "string",
                            "enum": [
                              "MEALS",
                              "HOUSING",
                              "VEHICLE",
                              "NTIC",
                              "OTHER"
                            ],
                            "description": "Un véhicule (`VEHICLE`) sans `vehicle` est évalué aux dépenses réelles. Au forfait, il se déclare avec son `vehicle`.\n\n- `MEALS` : Repas\n- `HOUSING` : Logement\n- `VEHICLE` : Véhicule\n- `NTIC` : NTIC\n- `OTHER` : Autre"
                          },
                          "actualExpensesVehicle": {
                            "type": "object",
                            "description": "Véhicule évalué aux dépenses réelles (`benefitType: VEHICLE`). `amount` est alors l’usage personnel évalué par l’employeur : chaque bulletin en déduit l’abattement des véhicules électriques (50 %, dans la limite du plafond annuel suivi par salarié) puis la participation du salarié.",
                            "required": [
                              "isElectric",
                              "employeeMonthlyContribution",
                              "contributionWithheldFromPay",
                              "retainedDuringLeave"
                            ],
                            "properties": {
                              "isElectric": {
                                "type": "boolean",
                                "description": "Véhicule électrique."
                              },
                              "assignedOn": {
                                "type": "string",
                                "format": "date",
                                "description": "Date de mise à disposition. Requise pour un véhicule électrique.",
                                "example": "2026-11-02"
                              },
                              "isEcoScoreEligible": {
                                "type": "boolean",
                                "description": "Éco-score exigé pour l’abattement des véhicules électriques mis à disposition depuis le 1er février 2025."
                              },
                              "employeeMonthlyContribution": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Participation mensuelle du salarié, en euros, déduite après l’abattement."
                              },
                              "contributionWithheldFromPay": {
                                "type": "boolean",
                                "description": "La participation est retenue sur le net à payer. Sinon, le salarié la règle à part."
                              },
                              "retainedDuringLeave": {
                                "type": "boolean",
                                "description": "L’avantage est conservé pendant les congés."
                              }
                            }
                          }
                        }
                      },
                      {
                        "title": "Véhicule de fonction évalué au forfait",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "benefitType",
                          "vehicle"
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "IN_KIND_BENEFIT",
                            "description": "Avantage en nature"
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Libellé imprimé sur le bulletin."
                          },
                          "benefitType": {
                            "type": "string",
                            "const": "VEHICLE",
                            "description": "Véhicule"
                          },
                          "vehicle": {
                            "type": "object",
                            "description": "Véhicule mis à disposition : Puncto calcule l’avantage chaque mois au forfait (arrêté du 25 février 2025), participation du salarié déduite. `amount` est ignoré.",
                            "required": [
                              "assignedOn",
                              "ownership",
                              "isElectric",
                              "employerPaysFuel",
                              "employeeMonthlyContribution",
                              "retainedDuringLeave",
                              "retainedDuringAbsence"
                            ],
                            "properties": {
                              "assignedOn": {
                                "type": "string",
                                "format": "date",
                                "description": "Date de mise à disposition. Elle fixe le barème ; le premier mois de versement ne peut pas la précéder.",
                                "example": "2026-11-02"
                              },
                              "ownership": {
                                "type": "string",
                                "enum": [
                                  "OWNED",
                                  "LEASED"
                                ],
                                "description": "- `OWNED` : Acheté\n- `LEASED` : Loué"
                              },
                              "firstRegisteredOn": {
                                "type": "string",
                                "format": "date",
                                "description": "Première mise en circulation. Au-delà de cinq ans, taux réduit. Omise, le véhicule a moins de cinq ans."
                              },
                              "isElectric": {
                                "type": "boolean",
                                "description": "Véhicule électrique."
                              },
                              "isEcoScoreEligible": {
                                "type": "boolean",
                                "description": "Éco-score exigé pour l’abattement des véhicules électriques mis à disposition depuis le 1er février 2025."
                              },
                              "employerPaysFuel": {
                                "type": "boolean",
                                "description": "L’employeur paie le carburant."
                              },
                              "purchasePrice": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Prix d’achat TTC, en euros. Requis si `OWNED` ; pour un véhicule loué, prix payé par le loueur, qui plafonne le forfait."
                              },
                              "recommendedPrice": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Véhicule loué : prix TTC conseillé par le constructeur, en euros. Requis avec `purchasePrice`."
                              },
                              "annualCost": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Véhicule loué (`LEASED`, requis) : location, entretien et assurance de l’année, en euros, carburant compris quand l’employeur le paie."
                              },
                              "employeeMonthlyContribution": {
                                "type": "number",
                                "minimum": 0,
                                "description": "Participation mensuelle du salarié, en euros, déduite de l’avantage."
                              },
                              "contributionWithheldFromPay": {
                                "type": "boolean",
                                "description": "La participation est retenue chaque mois sur le net à payer. Sinon, le salarié la règle à part."
                              },
                              "retainedDuringLeave": {
                                "type": "boolean",
                                "description": "L’avantage est conservé pendant les congés."
                              },
                              "retainedDuringAbsence": {
                                "type": "boolean",
                                "description": "L’avantage est conservé pendant les absences."
                              }
                            }
                          }
                        }
                      },
                      {
                        "title": "Abonnement annuel de transport public",
                        "type": "object",
                        "required": [
                          "type",
                          "name",
                          "amountTotal",
                          "amountReimbursed",
                          "indemnityType",
                          "periodicity",
                          "startMonth"
                        ],
                        "description": "Remboursé par douzièmes sur douze mois à partir de `data.startMonth` : n’envoyez pas `startYear`, `startMonth` ni `frequency` à la racine. Un contrat ne rembourse qu’un abonnement à la fois.",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "TAX_FREE_INDEMNITY",
                            "description": "Indemnité non soumise"
                          },
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "description": "Libellé imprimé sur le bulletin."
                          },
                          "amountTotal": {
                            "type": "number",
                            "exclusiveMinimum": 0,
                            "description": "Montant de l’abonnement sur l’année, en euros."
                          },
                          "amountReimbursed": {
                            "type": "number",
                            "minimum": 0,
                            "description": "Part remboursée sur l’année, en euros, conforme au taux employeur paramétré."
                          },
                          "indemnityType": {
                            "type": "string",
                            "const": "PUBLIC_TRANSPORT",
                            "description": "Transport public"
                          },
                          "titleType": {
                            "type": "string",
                            "enum": [
                              "NAVIGO",
                              "IMAGINE_R",
                              "VELIB",
                              "TER_SNCF",
                              "OTHER"
                            ],
                            "description": "- `NAVIGO` : Navigo\n- `IMAGINE_R` : Imagine R\n- `VELIB` : Vélo (Vélib’, Vélo'v, V'Lille etc)\n- `TER_SNCF` : Abonnement TER / SNCF\n- `OTHER` : Autre (préciser)"
                          },
                          "periodicity": {
                            "type": "string",
                            "const": "ANNUAL",
                            "description": "Annuel"
                          },
                          "startMonth": {
                            "type": "string",
                            "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
                            "description": "Premier mois de l’abonnement (`YYYY-MM`). Il peut précéder l’embauche ou un mois clôturé : seuls les mois encore ouverts sont remboursés.",
                            "example": "2026-09"
                          }
                        }
                      }
                    ]
                  },
                  "frequency": {
                    "type": "string",
                    "enum": [
                      "MONTHLY"
                    ],
                    "description": "Périodicité des versements. Requise, sauf pour un abonnement annuel.\n\n- `MONTHLY` : Mensuelle"
                  },
                  "startYear": {
                    "type": "integer",
                    "minimum": 2000,
                    "maximum": 2100,
                    "description": "Année du premier mois de versement. Requise, sauf pour un abonnement annuel.",
                    "example": 2027
                  },
                  "startMonth": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 12,
                    "description": "Premier mois de versement. Requis, sauf pour un abonnement annuel.",
                    "example": 1
                  },
                  "endYear": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 2000,
                    "maximum": 2100,
                    "description": "Année du dernier mois de versement, avec `endMonth`.",
                    "example": 2027
                  },
                  "endMonth": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 1,
                    "maximum": 12,
                    "description": "Dernier mois de versement inclus, avec `endYear`. Omis, la variable court sans fin.",
                    "example": 1
                  }
                }
              },
              "example": {
                "foreignErpId": "teletravail-salarie-123",
                "contractMatching": {
                  "type": "BY_PUNCTO_COLLABORATOR_ID",
                  "value": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                },
                "data": {
                  "type": "PRIME",
                  "name": "Indemnité d’occupation du domicile",
                  "amount": 30,
                  "primeType": "HOME_OCCUPATION_ALLOWANCE",
                  "isAbsenceSensitive": false
                },
                "frequency": "MONTHLY",
                "startYear": 2026,
                "startMonth": 12
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Variable récurrente créée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiRecurringVariable"
                }
              }
            }
          },
          "400": {
            "description": "Saisie refusée : mois verrouillé, hors du contrat, abonnement annuel chevauchant un autre",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Un mois de cette période est déjà clôturé : la variable récurrente doit commencer après le dernier mois clôturé."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur ou contrat introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Aucun contrat trouvé pour ce collaborateur sur cette période"
                }
              }
            }
          },
          "409": {
            "description": "`foreignErpId` déjà utilisé par une variable récurrente ou de paie",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Une variable récurrente existe déjà avec le foreignErpId teletravail-salarie-123 : une variable récurrente ne se modifie pas, arrêtez-la ou supprimez-la, puis créez la nouvelle."
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/recurring-variables/{recurringVariableId}": {
      "get": {
        "operationId": "getRecurringVariable",
        "tags": [
          "Variables récurrentes"
        ],
        "summary": "Consulter une variable récurrente",
        "description": "Renvoie une variable récurrente, désignée par son identifiant Puncto ou par son `foreignErpId`.",
        "parameters": [
          {
            "name": "recurringVariableId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de la variable récurrente, ou son `foreignErpId` avec `matchingBy=BY_FOREIGN_ERP_ID`.",
            "schema": {
              "type": "string",
              "example": "rvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "matchingBy",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "BY_PUNCTO_ID",
                "BY_FOREIGN_ERP_ID"
              ],
              "description": "Ce que désigne `{recurringVariableId}`.\n\n- `BY_PUNCTO_ID` : `{recurringVariableId}` est l’identifiant Puncto (par défaut)\n- `BY_FOREIGN_ERP_ID` : `{recurringVariableId}` est le `foreignErpId` de la variable récurrente"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Variable récurrente",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiRecurringVariable"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Variable récurrente introuvable dans l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Variable récurrente non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "put": {
        "operationId": "updateRecurringVariable",
        "tags": [
          "Variables récurrentes"
        ],
        "summary": "Modifier une variable récurrente",
        "description": "Change le statut ou le dernier mois de versement d’une variable récurrente, un seul par requête. Les brouillons des mois concernés sont recalculés. Renvoyer les valeurs actuelles ne change rien.\n\nLe contenu (`data`, `frequency`, `startYear`, `startMonth`) ne se modifie pas : fixez le dernier mois de versement ou supprimez la variable, puis créez-en une nouvelle.\n\n- **Statut** : seule une variable `VALIDATED` est versée. Une variable déjà versée par un mois verrouillé (paie clôturée ou bulletin validé) reste validée. Une variable ne se valide que sur des mois ouverts : un abonnement annuel accepté tard ne rembourse que les mois encore ouverts.\n- **Dernier mois de versement** : pas avant le premier mois, pas au-delà du douzième mois d’un abonnement annuel, et sans ajouter ni retirer de versement à un mois verrouillé. Une fois qu’un mois verrouillé a versé la variable, c’est la seule modification possible.",
        "parameters": [
          {
            "name": "recurringVariableId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de la variable récurrente. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/recurring-variables/{recurringVariableId}?matchingBy=BY_FOREIGN_ERP_ID`.",
            "schema": {
              "type": "string",
              "example": "rvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "PENDING",
                      "VALIDATED",
                      "REJECTED"
                    ],
                    "description": "- `PENDING` : En attente\n- `VALIDATED` : Accepté\n- `REJECTED` : Refusé"
                  },
                  "endYear": {
                    "type": "integer",
                    "minimum": 2000,
                    "maximum": 2100,
                    "description": "Année du dernier mois de versement, avec `endMonth`.",
                    "example": 2027
                  },
                  "endMonth": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 12,
                    "description": "Dernier mois de versement inclus, avec `endYear`.",
                    "example": 1
                  }
                }
              },
              "example": {
                "endYear": 2027,
                "endMonth": 6
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Variable récurrente modifiée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiRecurringVariable"
                }
              }
            }
          },
          "400": {
            "description": "Modification refusée : contenu envoyé, statut et dernier mois ensemble, variable déjà versée par un mois verrouillé, ou dernier mois invalide (avant le premier, au-delà du douzième d’un abonnement annuel, sur un mois verrouillé)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Ce dernier mois de versement changerait un mois déjà clôturé : choisissez un mois après le dernier mois clôturé."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Variable récurrente introuvable dans l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Variable récurrente non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "delete": {
        "operationId": "deleteRecurringVariable",
        "tags": [
          "Variables récurrentes"
        ],
        "summary": "Supprimer une variable récurrente",
        "description": "Supprime une variable récurrente et ses justificatifs, et recalcule les brouillons des mois qu’elle versait. Refusé si elle est validée et déjà versée par un mois verrouillé (paie clôturée ou bulletin validé) : fixez plutôt son dernier mois de versement.",
        "parameters": [
          {
            "name": "recurringVariableId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto de la variable récurrente. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/recurring-variables/{recurringVariableId}?matchingBy=BY_FOREIGN_ERP_ID`.",
            "schema": {
              "type": "string",
              "example": "rvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Variable récurrente supprimée"
          },
          "400": {
            "description": "Variable déjà versée par un mois verrouillé",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Un mois de cette variable récurrente est déjà clôturé : elle ne peut plus être supprimée, renseignez plutôt son dernier mois de versement."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Variable récurrente introuvable dans l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Variable récurrente non trouvée"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/payslips": {
      "get": {
        "operationId": "listPayslips",
        "tags": [
          "Bulletins de paie"
        ],
        "summary": "Lister les bulletins de paie",
        "description": "Liste paginée des bulletins validés (remis aux collaborateurs), du mois le plus récent au plus ancien puis par nom, avec leurs totaux. Les lignes se lisent avec `GET /public/v1/payslips/{payslipId}`, le PDF avec `GET /public/v1/payslips/{payslipId}/pdf`.\n\nUn filtre sans correspondance renvoie une liste vide.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Année de la période de paie.",
            "schema": {
              "type": "integer",
              "minimum": 2000,
              "maximum": 2100,
              "example": 2026
            }
          },
          {
            "name": "month",
            "in": "query",
            "description": "Mois de la période de paie, de 1 (janvier) à 12.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12,
              "example": 9
            }
          },
          {
            "name": "contractId",
            "in": "query",
            "description": "Identifiant Puncto du contrat.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de bulletins",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiPayslipSummary"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/payslips/{payslipId}": {
      "get": {
        "operationId": "getPayslip",
        "tags": [
          "Bulletins de paie"
        ],
        "summary": "Consulter un bulletin de paie",
        "description": "Renvoie les lignes du bulletin telles qu’imprimées sur le PDF du collaborateur : revenus bruts, cotisations regroupées, indemnités non soumises, autres retenues et totaux.\n\n- Dans les revenus bruts, une retenue est un montant négatif.\n- Un mois de paie rouvert puis clôturé de nouveau remplace ses bulletins par de nouveaux identifiants : les anciens renvoient `404`.",
        "parameters": [
          {
            "name": "payslipId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du bulletin.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Bulletin de paie",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiPayslip"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Bulletin introuvable, non validé ou remplacé",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Bulletin de paie non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/payslips/{payslipId}/pdf": {
      "get": {
        "operationId": "downloadPayslipPdf",
        "tags": [
          "Bulletins de paie"
        ],
        "summary": "Télécharger le PDF d’un bulletin de paie",
        "description": "Renvoie le PDF remis au collaborateur, en pièce jointe (`Content-Disposition: attachment`).\n\nLe PDF est généré en arrière-plan à la clôture du mois : juste après, l’appel peut renvoyer `404` le temps de la génération.",
        "parameters": [
          {
            "name": "payslipId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du bulletin.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "PDF du bulletin",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Bulletin introuvable, non validé ou remplacé, ou PDF en cours de génération",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Le PDF de ce bulletin n’est pas encore disponible"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/contracts/{contractId}/trial-period": {
      "get": {
        "operationId": "getContractTrialPeriod",
        "tags": [
          "Contrats"
        ],
        "summary": "Consulter la période d’essai",
        "description": "Renvoie la période d’essai du contrat (initiale et renouvellement éventuel), sa fin effective et si elle peut être renouvelée, avec la date de fin maximale du renouvellement.\n\nLa fin effective est prolongée par les absences validées (recalcul chaque nuit) ou avancée par une validation anticipée. Sans période d’essai (stage, mandat social, période non renseignée), la liste est vide et la raison de l’impossibilité de renouveler est donnée.",
        "parameters": [
          {
            "name": "contractId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du contrat. Pour partir de votre identifiant, retrouvez-le avec `GET /public/v1/contracts?collaboratorForeignErpId=…`.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Période d’essai du contrat",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiContractTrialPeriodState"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Contrat introuvable dans l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Contrat non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/contracts/{contractId}/trial-period/actions/renew": {
      "post": {
        "operationId": "renewContractTrialPeriod",
        "tags": [
          "Contrats"
        ],
        "summary": "Renouveler la période d’essai",
        "description": "Renouvelle la période d’essai jusqu’à `endDate`. Par défaut et au plus, le renouvellement dure autant que la période initiale (`renewal.maxEndDate` de [Consulter la période d’essai](/reference/contrats/get-contract-trial-period)). Les absences validées pendant le renouvellement le prolongent ensuite.\n\nUne seule fois, pendant la période initiale (de son premier à son dernier jour). Refusé pour un CDD (art. L1242-10), un apprenti (art. L6222-18), un contrat clôturé ou une période déjà validée.\n\n`renewalProvidedInContract: true` atteste que le contrat de travail prévoit le renouvellement. Puncto ne vérifie ni cette clause ni l’accord écrit du salarié, à recueillir pendant la période initiale (un accord donné à l’embauche ne vaut pas).",
        "parameters": [
          {
            "name": "contractId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du contrat. Pour partir de votre identifiant, retrouvez-le avec `GET /public/v1/contracts?collaboratorForeignErpId=…`.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "renewalProvidedInContract"
                ],
                "properties": {
                  "endDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Fin du renouvellement, avant prolongation par les absences. Par défaut et au plus, `renewal.maxEndDate`.",
                    "example": "2026-10-01"
                  },
                  "renewalProvidedInContract": {
                    "type": "boolean",
                    "const": true,
                    "description": "Atteste que le contrat de travail prévoit le renouvellement. Doit valoir `true`."
                  }
                }
              },
              "example": {
                "renewalProvidedInContract": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Période d’essai du contrat après le renouvellement",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiContractTrialPeriodState"
                }
              }
            }
          },
          "400": {
            "description": "Renouvellement refusé : CDD, apprenti, déjà renouvelée ou validée, terminée, date au-delà du maximum…",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "La date sélectionnée dépasse la durée maximale autorisée (01/10/2026)"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Contrat introuvable dans l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Contrat non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/contracts/{contractId}/trial-period/actions/validate": {
      "post": {
        "operationId": "validateContractTrialPeriod",
        "tags": [
          "Contrats"
        ],
        "summary": "Valider la période d’essai",
        "description": "Valide la période d’essai par anticipation : elle prend fin à `validationDate`, le contrat devient définitif, et la période n’est plus prolongée ni renouvelable.\n\nLa date peut être passée, mais doit tomber entre le début du contrat (du renouvellement, pour une période renouvelée) et la fin prévue de la période. Refusé une fois la période terminée, dernier jour compris, ou déjà validée.",
        "parameters": [
          {
            "name": "contractId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du contrat. Pour partir de votre identifiant, retrouvez-le avec `GET /public/v1/contracts?collaboratorForeignErpId=…`.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "validationDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Date de la validation. Par défaut, aujourd’hui (jour calendaire de Paris).",
                    "example": "2026-11-16"
                  }
                }
              },
              "example": {
                "validationDate": "2026-11-16"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Période d’essai du contrat après la validation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiContractTrialPeriodState"
                }
              }
            }
          },
          "400": {
            "description": "Validation refusée : période terminée ou déjà validée, contrat clôturé, date hors de la période…",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "La période d’essai a déjà été validée"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Contrat introuvable dans l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Contrat non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/documents": {
      "get": {
        "operationId": "listDocuments",
        "tags": [
          "Documents"
        ],
        "summary": "Lister les documents",
        "description": "Liste paginée des documents de l’entreprise, du plus récent au plus ancien : documents envoyés par l’API ou dans Puncto (contrats signés, conventions de stage…) et documents générés par Puncto (bulletins, DPAE, DSN, documents de fin de contrat, documents comptables…). Téléchargez un fichier avec `GET /public/v1/documents/{documentId}/download`.\n\nLes fichiers techniques (retours DPAE, CRM), les factures Puncto et les archives d’export ne sont pas exposés. Un filtre collaborateur exclut les documents sans collaborateur.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "type[]",
            "in": "query",
            "description": "Types de document à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "PAYSLIP",
                  "PAYSLIP_ARCHIVED",
                  "DSN_MONTHLY",
                  "DSN_WORK_STOPPAGE",
                  "DSN_WORK_STOPPAGE_RESUMPTION",
                  "DSN_FCTU",
                  "DSN_SADV",
                  "EXPENSE_BILL",
                  "MEAL_VOUCHER_EXPORT",
                  "SEPA_PAYROLL",
                  "SEPA_SDTC",
                  "ABSENCE_PROOF",
                  "DPAE",
                  "ACCOUNTING_PAYROLL_OD",
                  "ACCOUNTING_PAYROLL_DSN_RECAP",
                  "ACCOUNTING_CONTRIBUTIONS_DETAIL",
                  "ACCOUNTING_CONTRIBUTIONS_RECAP",
                  "ACCOUNTING_PAYBOOK",
                  "ACCOUNTING_PAYROLL_LOG",
                  "ACCOUNTING_REST_RECAP",
                  "IDENTITY",
                  "VITALE",
                  "RIB",
                  "CONTRACT",
                  "INTERNSHIP_AGREEMENT",
                  "INTERNSHIP_CERTIFICATE",
                  "INTERNSHIP_CERTIFICATE_SIGNED",
                  "WORK_CERTIFICATE",
                  "WORK_CERTIFICATE_SIGNED",
                  "FINAL_SETTLEMENT_RECEIPT",
                  "FINAL_SETTLEMENT_RECEIPT_SIGNED",
                  "PROFIT_SHARING_STATEMENT",
                  "ON_CALL_STATEMENT",
                  "PROFIT_SHARING_AGREEMENT_RECEIPT",
                  "COMPANY_SETUP_CHECKLIST",
                  "FCTU_AER",
                  "ABSENCE_BATCH",
                  "VARIABLE_BATCH",
                  "OC_FICHE",
                  "BPIJ",
                  "SIGNATURE_AUDIT_TRAIL",
                  "OTHER"
                ],
                "description": "- `PAYSLIP` : Bulletin de paie\n- `PAYSLIP_ARCHIVED` : Bulletin de paie archivé\n- `DSN_MONTHLY` : DSN mensuelle\n- `DSN_WORK_STOPPAGE` : DSN arrêt de travail\n- `DSN_WORK_STOPPAGE_RESUMPTION` : DSN reprise anticipée\n- `DSN_FCTU` : DSN FCTU\n- `DSN_SADV` : DSN d'amorçage (SADV)\n- `EXPENSE_BILL` : Note de frais\n- `MEAL_VOUCHER_EXPORT` : Export ticket-restaurant\n- `SEPA_PAYROLL` : SEPA (paie)\n- `SEPA_SDTC` : SEPA (solde de tout compte)\n- `ABSENCE_PROOF` : Justificatif d'absence\n- `DPAE` : DPAE\n- `ACCOUNTING_PAYROLL_OD` : Opérations diverses de paie\n- `ACCOUNTING_PAYROLL_DSN_RECAP` : Récapitulatif DSN\n- `ACCOUNTING_CONTRIBUTIONS_DETAIL` : Détail des cotisations\n- `ACCOUNTING_CONTRIBUTIONS_RECAP` : Récapitulatif des cotisations\n- `ACCOUNTING_PAYBOOK` : Livre de paie\n- `ACCOUNTING_PAYROLL_LOG` : Journal de paie\n- `ACCOUNTING_REST_RECAP` : Récapitulatif congés\n- `IDENTITY` : Carte d'identité\n- `VITALE` : Carte vitale\n- `RIB` : RIB\n- `CONTRACT` : Contrat\n- `INTERNSHIP_AGREEMENT` : Convention de stage\n- `INTERNSHIP_CERTIFICATE` : Attestation de fin de stage\n- `INTERNSHIP_CERTIFICATE_SIGNED` : Attestation de fin de stage signée\n- `WORK_CERTIFICATE` : Certificat de travail\n- `WORK_CERTIFICATE_SIGNED` : Certificat de travail signé\n- `FINAL_SETTLEMENT_RECEIPT` : Reçu pour solde de tout compte\n- `FINAL_SETTLEMENT_RECEIPT_SIGNED` : Reçu pour solde de tout compte signé\n- `PROFIT_SHARING_STATEMENT` : Fiche distincte d'intéressement\n- `ON_CALL_STATEMENT` : Récapitulatif des astreintes\n- `PROFIT_SHARING_AGREEMENT_RECEIPT` : Récépissé de dépôt de l'accord d'intéressement\n- `COMPANY_SETUP_CHECKLIST` : Éléments à transmettre\n- `FCTU_AER` : Attestation France Travail\n- `ABSENCE_BATCH` : Import de congés\n- `VARIABLE_BATCH` : Import de variables\n- `OC_FICHE` : Fiche de paramétrage OC\n- `BPIJ` : Bordereau de paiement des IJ\n- `SIGNATURE_AUDIT_TRAIL` : Dossier de preuve de signature\n- `OTHER` : Autre"
              }
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          },
          {
            "name": "minCreationDate",
            "in": "query",
            "description": "Documents enregistrés à partir de cette date (ISO 8601).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "maxCreationDate",
            "in": "query",
            "description": "Documents enregistrés jusqu’à cette date (ISO 8601).",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "foreignErpId",
            "in": "query",
            "description": "Identifiant du document dans votre système, renseigné à son envoi.",
            "schema": {
              "type": "string",
              "example": "contrat-salarie-123"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de documents",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiDocument"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur du filtre introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "post": {
        "operationId": "uploadDocument",
        "tags": [
          "Documents"
        ],
        "summary": "Envoyer un document",
        "description": "Envoie un document (contrat ou avenant signé, convention de stage, DPAE faite hors de Puncto…) en `multipart/form-data`.\n\n- Rattaché à un collaborateur, il est visible tout de suite par les administrateurs et dans son espace, sans notification.\n- Un `foreignErpId` déjà utilisé dans l’entreprise renvoie `409` avec le `documentId` existant. Pour remplacer un fichier, utilisez `PUT /public/v1/documents/{documentId}`.\n\nVoir le guide [Documents](/guides/documents).",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "file",
                  "fileType"
                ],
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "Fichier du document, 20 Mo au plus. Extensions acceptées : pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip."
                  },
                  "fileType": {
                    "type": "string",
                    "enum": [
                      "DPAE",
                      "CONTRACT",
                      "INTERNSHIP_AGREEMENT",
                      "OTHER"
                    ],
                    "description": "Type de document. Les types `DPAE`, `CONTRACT`, `INTERNSHIP_AGREEMENT` concernent un collaborateur : `collaboratorId` est alors requis.\n\n- `DPAE` : DPAE\n- `CONTRACT` : Contrat\n- `INTERNSHIP_AGREEMENT` : Convention de stage\n- `OTHER` : Autre"
                  },
                  "displayFileName": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Nom affiché dans Puncto. Par défaut, le nom du fichier envoyé."
                  },
                  "collaboratorId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Identifiant Puncto du collaborateur.",
                    "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                  },
                  "foreignErpId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "Identifiant du document dans votre système, unique dans l’entreprise.",
                    "example": "contrat-salarie-123"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Document créé",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiDocument"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur introuvable dans l’entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "409": {
            "description": "Un document de l’entreprise porte déjà ce `foreignErpId`",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error",
                    "documentId"
                  ],
                  "properties": {
                    "error": {
                      "type": "string",
                      "description": "Message lisible, en français."
                    },
                    "documentId": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "Identifiant Puncto du document qui porte déjà ce `foreignErpId`."
                    }
                  }
                },
                "example": {
                  "error": "Un document existe déjà avec le foreignErpId \"contrat-salarie-123\"",
                  "documentId": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/documents/{documentId}": {
      "get": {
        "operationId": "getDocument",
        "tags": [
          "Documents"
        ],
        "summary": "Consulter un document",
        "description": "Renvoie les informations d’un document de la liste, ou d’un justificatif référencé par une absence ou une variable de paie. Téléchargez son fichier avec `GET /public/v1/documents/{documentId}/download`.",
        "parameters": [
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du document.",
            "schema": {
              "type": "string",
              "example": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Document",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiDocument"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Document introuvable dans l’entreprise ou non exposé par l’API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Document non trouvé"
                }
              }
            }
          }
        }
      },
      "put": {
        "operationId": "updateDocument",
        "tags": [
          "Documents"
        ],
        "summary": "Modifier un document",
        "description": "Remplace le fichier et/ou le nom d’un document envoyé par l’API, en `multipart/form-data` ; un champ omis ne change pas. Le collaborateur, le type et le `foreignErpId` restent.\n\n- L’ancien fichier est supprimé : envoyez chaque avenant signé comme un nouveau document.\n- Refusé (`400`) pour les documents générés par Puncto ou ajoutés dans l’application, les justificatifs de variables de paie et les fichiers liés à une DPAE.",
        "parameters": [
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du document.",
            "schema": {
              "type": "string",
              "example": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "minProperties": 1,
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "Nouveau fichier du document, 20 Mo au plus. Extensions acceptées : pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip."
                  },
                  "displayFileName": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Nouveau nom du document affiché dans Puncto."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Document modifié",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiDocument"
                }
              }
            }
          },
          "400": {
            "description": "Document que l’API n’a pas envoyé",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Seuls les documents envoyés par l’API peuvent être modifiés"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Document introuvable dans l’entreprise ou non exposé par l’API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Document non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      },
      "delete": {
        "operationId": "deleteDocument",
        "tags": [
          "Documents"
        ],
        "summary": "Supprimer un document",
        "description": "Supprime un document envoyé par l’API, et son fichier.\n\n- Refusé (`400`) pour les documents générés par Puncto ou ajoutés dans l’application, les justificatifs de variables de paie (supprimés avec leur variable) et les fichiers liés à une DPAE.\n- Un document envoyé sans `foreignErpId` par une clé d’API révoquée depuis ne peut plus être supprimé.",
        "parameters": [
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du document.",
            "schema": {
              "type": "string",
              "example": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Document supprimé"
          },
          "400": {
            "description": "Document que l’API n’a pas envoyé",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Seuls les documents envoyés par l’API peuvent être supprimés"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Document introuvable dans l’entreprise ou non exposé par l’API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Document non trouvé"
                }
              }
            }
          }
        }
      }
    },
    "/public/v1/documents/{documentId}/download": {
      "get": {
        "operationId": "downloadDocument",
        "tags": [
          "Documents"
        ],
        "summary": "Télécharger un document",
        "description": "Renvoie le fichier en pièce jointe (`Content-Disposition: attachment`), nommé d’après `fileName`, de type `mimeType`. Un fichier qui n’est plus disponible renvoie `404` (« Le fichier de ce document est introuvable »).",
        "parameters": [
          {
            "name": "documentId",
            "in": "path",
            "required": true,
            "description": "Identifiant Puncto du document.",
            "schema": {
              "type": "string",
              "example": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Fichier du document",
            "content": {
              "*/*": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Document introuvable dans l’entreprise ou non exposé par l’API",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Document non trouvé"
                }
              }
            }
          }
        }
      }
    },
    "/public/v1/company": {
      "get": {
        "operationId": "getCompany",
        "tags": [
          "Entreprise"
        ],
        "summary": "Consulter l’entreprise",
        "description": "Renvoie l’entreprise de la clé d’API : raison sociale, SIREN, code APE, convention collective (IDCC `1486`, Syntec), siège, effectifs moyens annuels, modules activés et règles de paie (en vigueur à la fin du mois courant).\n\nLes modules indiquent les données saisies dans Puncto : sans `isTimesheetEnabled`, par exemple, aucune feuille de temps n’est créée.",
        "responses": {
          "200": {
            "description": "Entreprise",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiCompany"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          }
        }
      }
    },
    "/public/v1/establishments": {
      "get": {
        "operationId": "listEstablishments",
        "tags": [
          "Entreprise"
        ],
        "summary": "Lister les établissements",
        "description": "Liste les établissements, du plus ancien au plus récent, avec SIRET, codes et adresse. Les contrats, avenants et mois de paie y renvoient par `establishmentId`.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page d’établissements",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiEstablishment"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/company-roles": {
      "get": {
        "operationId": "listCompanyRoles",
        "tags": [
          "Entreprise"
        ],
        "summary": "Lister les postes",
        "description": "Liste les postes de l’entreprise, par intitulé. Les avenants y renvoient par `companyRoleId`.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de postes",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiCompanyRole"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/company-teams": {
      "get": {
        "operationId": "listCompanyTeams",
        "tags": [
          "Entreprise"
        ],
        "summary": "Lister les équipes",
        "description": "Liste les équipes de l’entreprise, par nom. Les avenants y renvoient par `companyTeamId`.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page d’équipes",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiCompanyTeam"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/oc-contracts": {
      "get": {
        "operationId": "listOcContracts",
        "tags": [
          "Entreprise"
        ],
        "summary": "Lister les contrats de mutuelle et de prévoyance",
        "description": "Liste les contrats de mutuelle et de prévoyance de l’entreprise, par libellé, avec toutes leurs versions (de la plus récente à la plus ancienne).\n\nPour une mutuelle au forfait, le code `affiliationChoice` d’une formule se passe en `mutuelleForfaitChoice`, avec `mutuelleOcContractId`, sur un contrat de travail. Les affiliations des salariés sont dans `ocAffiliations` des contrats de travail.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "type[]",
            "in": "query",
            "description": "Types de contrat à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "MUTUELLE",
                  "PREVOYANCE"
                ],
                "description": "- `MUTUELLE` : Mutuelle\n- `PREVOYANCE` : Prévoyance"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de contrats de mutuelle et de prévoyance",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiOcContract"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/holidays-balances": {
      "get": {
        "operationId": "listHolidaysBalances",
        "tags": [
          "Temps et congés"
        ],
        "summary": "Lister les soldes de congés",
        "description": "Calcule à une date les compteurs de congés de chaque contrat en vigueur : congés payés N, N-1 et N-2, ancienneté, fractionnement, jours non travaillés des forfaits jours, RTT, repos compensateurs et congés de stage. Les absences validées sont décomptées, pas les demandes en attente. Rien n’est enregistré.\n\n- Un solde incalculable vaut `null`, avec sa raison dans `unavailableReason`, sans faire échouer la page.\n- Les mandats sociaux n’ont pas de compteurs et ne sont pas listés.\n- 50 contrats par page au plus ; date de calcul au plus tard la fin du douzième mois à venir.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 50 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "default": 50
            }
          },
          {
            "name": "calculationDate",
            "in": "query",
            "description": "Date de calcul des soldes. Par défaut, aujourd’hui (heure de Paris). Au plus tard la fin du douzième mois à venir (le 31/10/2027 pour une demande du 28/10/2026), sinon `422`.",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-10-15"
            }
          },
          {
            "name": "contractId",
            "in": "query",
            "description": "Identifiant Puncto du contrat. Page vide s’il n’est pas en vigueur à `calculationDate`.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de soldes de congés",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiHolidaysBalance"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Date de calcul antérieure au paramétrage de paie de l’entreprise dans Puncto",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Les soldes de congés ne peuvent pas être calculés avant le 01/01/2024, début du paramétrage de paie de l'entreprise."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur du filtre introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/remote-work-days": {
      "get": {
        "operationId": "listRemoteWorkDays",
        "tags": [
          "Temps et congés"
        ],
        "summary": "Lister les jours de télétravail",
        "description": "Liste les jours de télétravail déclarés par les collaborateurs, du plus récent au plus ancien. Les corrections saisies en variables de paie (`REMOTE_WORK_DAY`) n’y figurent pas : lisez-les avec les variables de paie.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "startDate",
            "in": "query",
            "description": "Jours de télétravail à partir de cette date, incluse.",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-09-01"
            }
          },
          {
            "name": "endDate",
            "in": "query",
            "description": "Jours de télétravail jusqu’à cette date, incluse. Ne peut pas précéder `startDate`.",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-09-30"
            }
          },
          {
            "name": "contractId",
            "in": "query",
            "description": "Identifiant Puncto du contrat.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de jours de télétravail",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiRemoteWorkDay"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur du filtre introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/timesheets": {
      "get": {
        "operationId": "listTimesheets",
        "tags": [
          "Temps et congés"
        ],
        "summary": "Lister les feuilles de temps",
        "description": "Liste les feuilles de temps hebdomadaires, de la plus récente à la plus ancienne : heures prévues, travaillées, supplémentaires et leur compensation.\n\nUne semaine appartient au mois de paie de son dimanche, celui que filtrent `year` et `month`. Seules les semaines déjà ouvertes dans Puncto (par le collaborateur, un responsable ou une relance) sont listées ; la lecture n’en crée aucune.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Année du mois de paie de rattachement.",
            "schema": {
              "type": "integer",
              "minimum": 2000,
              "maximum": 2100,
              "example": 2026
            }
          },
          {
            "name": "month",
            "in": "query",
            "description": "Mois de paie de rattachement, de 1 (janvier) à 12.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12,
              "example": 9
            }
          },
          {
            "name": "status[]",
            "in": "query",
            "description": "Statuts à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "DRAFT",
                  "TO_VALIDATE",
                  "VALIDATED"
                ],
                "description": "- `DRAFT` : Brouillon\n- `TO_VALIDATE` : À valider\n- `VALIDATED` : Validée"
              }
            }
          },
          {
            "name": "contractId",
            "in": "query",
            "description": "Identifiant Puncto du contrat.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de feuilles de temps",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiTimesheet"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur du filtre introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/forfait-jour-declarations": {
      "get": {
        "operationId": "listForfaitJourDeclarations",
        "tags": [
          "Temps et congés"
        ],
        "summary": "Lister les relevés forfait jours",
        "description": "Liste les relevés mensuels des collaborateurs au forfait jours, du plus récent au plus ancien : jours travaillés et d’absence par demi-journée, repos et charge de travail déclarés.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Année du relevé.",
            "schema": {
              "type": "integer",
              "minimum": 2000,
              "maximum": 2100,
              "example": 2026
            }
          },
          {
            "name": "month",
            "in": "query",
            "description": "Mois du relevé, de 1 (janvier) à 12.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12,
              "example": 9
            }
          },
          {
            "name": "status[]",
            "in": "query",
            "description": "Statuts à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "PENDING",
                  "CONFORM",
                  "ANOMALY"
                ],
                "description": "- `PENDING` : En attente\n- `CONFORM` : Conforme\n- `ANOMALY` : Anomalie"
              }
            }
          },
          {
            "name": "contractId",
            "in": "query",
            "description": "Identifiant Puncto du contrat.",
            "schema": {
              "type": "string",
              "example": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorId",
            "in": "query",
            "description": "Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.",
            "schema": {
              "type": "string",
              "example": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "collaboratorForeignErpId",
            "in": "query",
            "description": "Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.",
            "schema": {
              "type": "string",
              "example": "salarie-123"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de relevés forfait jours",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiForfaitJourDeclaration"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "description": "Collaborateur du filtre introuvable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "Collaborateur non trouvé"
                }
              }
            }
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/payroll-months": {
      "get": {
        "operationId": "listPayrollMonths",
        "tags": [
          "Déclarations"
        ],
        "summary": "Lister les mois de paie",
        "description": "Liste les mois de paie de chaque établissement, du plus récent au plus ancien, avec l’état de leur DSN mensuelle. Seuls les mois ouverts dans Puncto sont listés, pas ceux repris de votre ancien logiciel de paie.\n\nUn mois rouvert crée une nouvelle révision : l’ancienne passe à `SUPERSEDED` et `supersededById` désigne la nouvelle.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "Année du mois de paie.",
            "schema": {
              "type": "integer",
              "minimum": 2000,
              "maximum": 2100,
              "example": 2026
            }
          },
          {
            "name": "month",
            "in": "query",
            "description": "Mois de paie, de 1 (janvier) à 12.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12,
              "example": 9
            }
          },
          {
            "name": "establishmentId",
            "in": "query",
            "description": "Identifiant Puncto de l’établissement.",
            "schema": {
              "type": "string",
              "example": "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            }
          },
          {
            "name": "status[]",
            "in": "query",
            "description": "Statuts à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "STARTED",
                  "CLOSED",
                  "SUPERSEDED"
                ],
                "description": "- `STARTED` : Commencé\n- `CLOSED` : Clôturé\n- `SUPERSEDED` : Remplacé"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de mois de paie",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiPayrollMonth"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/declaration-trackings": {
      "get": {
        "operationId": "listDeclarationTrackings",
        "tags": [
          "Déclarations"
        ],
        "summary": "Lister le suivi des déclarations",
        "description": "Liste le suivi des déclarations déposées par Puncto pour une `source`, de la plus récente à la plus ancienne.\n\nPour les DSN mensuelles, seul le dernier suivi de chaque mois est listé (une déclaration redéposée après une erreur n’apparaît qu’une fois). `simplifiedStatus` résume l’étape du dépôt et les retours des organismes ; le fichier déclaré se télécharge avec `GET /public/v1/documents/{documentId}/download`.",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Numéro de page, à partir de 1.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "description": "Nombre d’éléments par page, 200 au plus.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "source",
            "in": "query",
            "required": true,
            "description": "Déclarations à lister.",
            "schema": {
              "type": "string",
              "enum": [
                "dsn",
                "dpae",
                "fctu",
                "arret"
              ],
              "description": "- `dsn` : DSN mensuelles, le dernier suivi de chaque mois de paie\n- `dpae` : DPAE\n- `fctu` : DSN de fin de contrat (FCTU)\n- `arret` : signalements d’arrêt de travail et de reprise anticipée"
            }
          },
          {
            "name": "statuses[]",
            "in": "query",
            "description": "Statuts simplifiés à garder. Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "in-progress",
                  "sent",
                  "confirmed",
                  "error"
                ],
                "description": "- `in-progress` : En cours\n- `sent` : Transmise\n- `confirmed` : Confirmée\n- `error` : Erreur"
              }
            }
          },
          {
            "name": "months[]",
            "in": "query",
            "description": "Mois de rattachement à garder, au format `YYYY-MM` (voir `period`). Répétez le paramètre pour en passer plusieurs.",
            "style": "form",
            "explode": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
                "example": "2026-09"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Page de suivis de déclarations",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data",
                    "meta"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/PublicApiDeclarationTracking"
                      }
                    },
                    "meta": {
                      "$ref": "#/components/schemas/PaginationMeta"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/ValidationError"
          }
        }
      }
    },
    "/public/v1/reports/gender-equality-index": {
      "get": {
        "operationId": "getGenderEqualityIndex",
        "tags": [
          "Rapports"
        ],
        "summary": "Obtenir les données de l’index de l’égalité professionnelle",
        "description": "Renvoie, par collaborateur, les données brutes nécessaires à l’index de l’égalité professionnelle (Egapro) sur une période de référence de 12 mois au plus. **Puncto ne calcule ni les indicateurs ni la note** : la déclaration, la période et les regroupements relèvent de l’employeur. Voir le guide [Index de l’égalité professionnelle](/guides/index-egalite).\n\n- **Collaborateurs** : tous ceux sous contrat sur la période, hors embauches en cours, exclus compris (`isCounted`, `exclusionReasons`). Le sexe est lu sur le premier chiffre du NIR, du NIA ou du NTT.\n- **Classification** à la date de référence (fin de la période ou dernier jour sous contrat) : âge, CSP (d’après le code PCS-ESE), position et coefficient Syntec, taux d’activité.\n- **Présence** en jours calendaires et en mois équivalent temps plein, suspensions du contrat comprises.\n- **Rémunération** lue sur les bulletins validés (le plus récent par contrat et par mois), ventilée par élément avec un traitement par défaut, et reconstituée en annuel équivalent temps plein.\n- **Évolutions** de salaire et **promotions**, d’après l’historique des avenants.\n- **Congés de maternité et d’adoption**, avec la date de retour et les augmentations associées.\n\nLes mois repris des DSN d’un précédent logiciel n’ont pas de bulletins lus : ils sont signalés (`period.dsnBackfillMonths`, avertissement `MONTHS_WITH_MISSING_PAYSLIPS`). 2 000 collaborateurs au plus.",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "description": "Premier mois de la période (`YYYY-MM`), avec `to`. Sans période : l’année civile précédente.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
              "example": "2025-01"
            }
          },
          {
            "name": "to",
            "in": "query",
            "description": "Dernier mois de la période (`YYYY-MM`), avec `from`. 12 mois au plus, jusqu’au mois en cours au plus tard.",
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
              "example": "2025-12"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Données de l’index sur la période",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicApiGenderEqualityIndex"
                }
              }
            }
          },
          "400": {
            "description": "Trop de collaborateurs pour un calcul en ligne",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "example": {
                  "error": "L'index porte sur 2150 collaborateurs, au-delà de la limite de 2000 d'un calcul en ligne : contactez Puncto."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "description": "Période de référence invalide",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                },
                "example": {
                  "errors": [
                    {
                      "message": "La période de référence ne peut pas dépasser 12 mois",
                      "rule": "reference_period",
                      "field": "to"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Clé d’API créée dans Puncto, Intégrations › API."
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Clé d’API absente, invalide ou révoquée",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "error": "Les endpoints de l’API publique sont réservés aux comptes application."
            }
          }
        }
      },
      "Forbidden": {
        "description": "Opération hors de l’accès de la clé d’API",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            },
            "example": {
              "error": "Opération interdite"
            }
          }
        }
      },
      "ValidationError": {
        "description": "Paramètres invalides",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "example": {
              "errors": [
                {
                  "message": "Le champ statut de l’absence doit être une valeur autorisée",
                  "rule": "enum",
                  "field": "status"
                }
              ]
            }
          }
        }
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "description": "Message lisible, en français."
          },
          "errorCode": {
            "type": "string",
            "description": "Code stable, sur certaines erreurs."
          }
        }
      },
      "ValidationError": {
        "type": "object",
        "required": [
          "errors"
        ],
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "message",
                "rule",
                "field"
              ],
              "properties": {
                "message": {
                  "type": "string"
                },
                "rule": {
                  "type": "string",
                  "description": "Règle de validation en échec."
                },
                "field": {
                  "type": "string",
                  "description": "Chemin du champ, par exemple `absences.0.type`."
                }
              }
            }
          }
        }
      },
      "PaginationMeta": {
        "type": "object",
        "required": [
          "total",
          "page",
          "perPage",
          "currentPage",
          "firstPage",
          "lastPage"
        ],
        "properties": {
          "total": {
            "type": "integer",
            "description": "Nombre total d’éléments."
          },
          "page": {
            "type": "integer",
            "description": "Page renvoyée."
          },
          "perPage": {
            "type": "integer"
          },
          "currentPage": {
            "type": "integer"
          },
          "firstPage": {
            "type": "integer"
          },
          "lastPage": {
            "type": "integer"
          }
        }
      },
      "ImportResult": {
        "type": "object",
        "required": [
          "createdCount",
          "modifiedCount",
          "errors"
        ],
        "properties": {
          "createdCount": {
            "type": "integer",
            "description": "Éléments créés."
          },
          "modifiedCount": {
            "type": "integer",
            "description": "Éléments existants mis à jour."
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Un message par élément ignoré ; les autres sont importés."
          }
        }
      },
      "CountryCode": {
        "type": "string",
        "enum": [
          "FR",
          "GP",
          "BL",
          "MF",
          "MQ",
          "GF",
          "RE",
          "PM",
          "YT",
          "WF",
          "PF",
          "NC",
          "MC",
          "AF",
          "AL",
          "DZ",
          "AD",
          "AO",
          "AG",
          "AR",
          "AM",
          "AU",
          "AT",
          "AZ",
          "BS",
          "BH",
          "BD",
          "BB",
          "BY",
          "BE",
          "BZ",
          "BJ",
          "BT",
          "BO",
          "BA",
          "BW",
          "BR",
          "BN",
          "BG",
          "BF",
          "BI",
          "CV",
          "KH",
          "CM",
          "CA",
          "CF",
          "TD",
          "CL",
          "CN",
          "CO",
          "KM",
          "CD",
          "CG",
          "CR",
          "CI",
          "HR",
          "CU",
          "CY",
          "CZ",
          "DK",
          "DJ",
          "DM",
          "DO",
          "EC",
          "EG",
          "SV",
          "GQ",
          "ER",
          "EE",
          "SZ",
          "ET",
          "FJ",
          "FI",
          "GA",
          "GM",
          "GE",
          "DE",
          "GH",
          "GR",
          "GD",
          "GT",
          "GN",
          "GW",
          "GY",
          "HT",
          "HN",
          "HU",
          "IS",
          "IN",
          "ID",
          "IR",
          "IQ",
          "IE",
          "IL",
          "IT",
          "JM",
          "JP",
          "JO",
          "KZ",
          "KE",
          "KI",
          "KP",
          "KR",
          "KW",
          "KG",
          "LA",
          "LV",
          "LB",
          "LS",
          "LR",
          "LY",
          "LI",
          "LT",
          "LU",
          "MG",
          "MW",
          "MY",
          "MV",
          "ML",
          "MT",
          "MH",
          "MR",
          "MU",
          "MX",
          "FM",
          "MD",
          "MN",
          "ME",
          "MA",
          "MZ",
          "MM",
          "NA",
          "NR",
          "NP",
          "NL",
          "NZ",
          "NI",
          "NE",
          "NG",
          "NO",
          "OM",
          "PK",
          "PW",
          "PS",
          "PA",
          "PG",
          "PY",
          "PE",
          "PH",
          "PL",
          "PT",
          "QA",
          "RO",
          "RU",
          "RW",
          "KN",
          "LC",
          "VC",
          "WS",
          "SM",
          "ST",
          "SA",
          "SN",
          "RS",
          "SC",
          "SL",
          "SG",
          "SK",
          "SI",
          "SB",
          "SO",
          "ZA",
          "SS",
          "ES",
          "LK",
          "SD",
          "SR",
          "SE",
          "CH",
          "SY",
          "TW",
          "TJ",
          "TZ",
          "TH",
          "TL",
          "TG",
          "TO",
          "TT",
          "TN",
          "TR",
          "TM",
          "TV",
          "UG",
          "UA",
          "AE",
          "GB",
          "US",
          "UY",
          "UZ",
          "VU",
          "VE",
          "VN",
          "YE",
          "ZM",
          "ZW"
        ]
      },
      "UeCodification": {
        "type": "string",
        "enum": [
          "01",
          "02",
          "03",
          "04"
        ]
      },
      "ApiCollaboratorIdentity": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/CollaboratorIdentityType"
          },
          "numero": {
            "type": "string"
          },
          "startDate": {
            "type": "string",
            "format": "date"
          }
        },
        "required": [
          "type",
          "numero",
          "startDate"
        ],
        "additionalProperties": false
      },
      "CollaboratorIdentityType": {
        "type": "string",
        "enum": [
          "NTT",
          "NIA",
          "NIR"
        ]
      },
      "ApiAddress": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "addr_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "address": {
            "type": "string"
          },
          "postalCode": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "addressDetails": {
            "type": [
              "string",
              "null"
            ]
          },
          "countryCode": {
            "$ref": "#/components/schemas/CountryCode"
          }
        },
        "required": [
          "id",
          "address",
          "postalCode",
          "city",
          "addressDetails",
          "countryCode"
        ],
        "additionalProperties": false
      },
      "MaritalStatus": {
        "type": "string",
        "enum": [
          "SINGLE",
          "MARRIED",
          "CIVIL_PARTNERSHIP",
          "COHABITING",
          "SEPARATED",
          "DIVORCED",
          "WIDOWED"
        ]
      },
      "OnboardingHandicapValue": {
        "type": "string",
        "enum": [
          "INVALIDITY_PENSION",
          "INVALIDITY_ATMP",
          "HANDICAPPED_WORKER",
          "BENEFICIARY_ARTICLE_L_394",
          "BENEFICIARY_ARTICLES_L_395_AND_L_396",
          "INVALIDITY_ALLOCATION_OR_PENSION",
          "INVALIDITY_CARD",
          "ADULT_HANDICAPPED_ALLOCATION"
        ]
      },
      "CollaboratorPaymentOption": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/VirementPaymentOption"
          },
          {
            "$ref": "#/components/schemas/CheckPaymentOption"
          },
          {
            "$ref": "#/components/schemas/CashPaymentOption"
          }
        ]
      },
      "VirementPaymentOption": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "virement"
          },
          "iban": {
            "type": "string"
          },
          "bic": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "iban",
          "bic"
        ],
        "additionalProperties": false
      },
      "CheckPaymentOption": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "check"
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": false
      },
      "CashPaymentOption": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "cash"
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": false
      },
      "SyntecPosition": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/SyntecCadrePosition"
          },
          {
            "$ref": "#/components/schemas/SyntecEtamPosition"
          }
        ]
      },
      "SyntecCadrePosition": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "CADRE"
          },
          "position": {
            "type": "string",
            "enum": [
              "1.1",
              "1.2",
              "2.1 (moins 26 ans)",
              "2.1 (au moins 26 ans)",
              "2.2",
              "2.3",
              "3.1",
              "3.2",
              "3.3"
            ]
          }
        },
        "required": [
          "type",
          "position"
        ],
        "additionalProperties": false
      },
      "SyntecEtamPosition": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "ETAM"
          },
          "position": {
            "type": "string",
            "enum": [
              "1.1",
              "1.2",
              "2.1",
              "2.2",
              "2.3",
              "3.1",
              "3.2",
              "3.3"
            ]
          }
        },
        "required": [
          "type",
          "position"
        ],
        "additionalProperties": false
      },
      "PublicApiCollaborator": {
        "type": "object",
        "properties": {
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "companyId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "comp_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "establishmentId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Établissement du contrat courant — null pour un collaborateur sans contrat"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "usageFirstName": {
            "type": [
              "string",
              "null"
            ]
          },
          "usageLastName": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "type": [
              "string",
              "null"
            ]
          },
          "phoneNumber": {
            "type": [
              "string",
              "null"
            ]
          },
          "birthDate": {
            "type": "string",
            "format": "date"
          },
          "birthCity": {
            "type": "string"
          },
          "birthDepartmentCode": {
            "type": "string",
            "description": "Pour les salariés nés dans les TOM : code 98\n\nPour les personnes nées à l'étranger : code 99"
          },
          "birthCountryCode": {
            "$ref": "#/components/schemas/CountryCode"
          },
          "nationality": {
            "$ref": "#/components/schemas/CountryCode"
          },
          "originUeCodification": {
            "$ref": "#/components/schemas/UeCodification"
          },
          "identity": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApiCollaboratorIdentity"
              },
              {
                "type": "null"
              }
            ],
            "description": "Identité sociale en vigueur (NIR, NIA ou NTT). Pour un collaborateur dont l'embauche n'a pas encore commencé, sa première identité, qui prend effet le 1er du mois de son entrée."
          },
          "socialSecurityNumber": {
            "type": [
              "string",
              "null"
            ],
            "description": "NIR ou NIA"
          },
          "ntt": {
            "type": [
              "string",
              "null"
            ],
            "description": "NTT = NIR temporaire en l'absence de NIA"
          },
          "sex": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "FEMALE",
              "MALE",
              null
            ],
            "description": "Sexe, déduit du premier chiffre du NIR, du NIA ou du NTT (impair : homme, pair : femme). Null quand il ne peut pas en être déduit."
          },
          "address": {
            "$ref": "#/components/schemas/ApiAddress"
          },
          "dependentChildrenCount": {
            "type": "number",
            "description": "Situation familiale"
          },
          "disabledDependentChildrenCount": {
            "type": "number",
            "description": "Parmi `dependentChildrenCount`, les enfants à charge handicapés"
          },
          "maritalStatus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MaritalStatus"
              },
              {
                "type": "null"
              }
            ],
            "description": "Null tant qu'elle n'est pas renseignée"
          },
          "isBoeth": {
            "type": "boolean"
          },
          "boethStatus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/OnboardingHandicapValue"
              },
              {
                "type": "null"
              }
            ]
          },
          "seniorityDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ]
          },
          "paymentOption": {
            "$ref": "#/components/schemas/CollaboratorPaymentOption"
          },
          "matriculeRh": {
            "type": "string"
          },
          "conventionalPosition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SyntecPosition"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position Syntec de l'avenant en vigueur du contrat courant (pour un contrat qui n'a pas encore commencé : de son premier avenant) — null sans contrat ni position"
          },
          "coefficient": {
            "type": [
              "number",
              "null"
            ]
          },
          "foreignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, unique dans l'entreprise"
          },
          "managerId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Manager du collaborateur, null s'il n'en a pas"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "collaboratorId",
          "companyId",
          "establishmentId",
          "firstName",
          "lastName",
          "usageFirstName",
          "usageLastName",
          "email",
          "phoneNumber",
          "birthDate",
          "birthCity",
          "birthDepartmentCode",
          "birthCountryCode",
          "nationality",
          "originUeCodification",
          "identity",
          "socialSecurityNumber",
          "ntt",
          "sex",
          "address",
          "dependentChildrenCount",
          "disabledDependentChildrenCount",
          "maritalStatus",
          "isBoeth",
          "boethStatus",
          "seniorityDate",
          "paymentOption",
          "matriculeRh",
          "conventionalPosition",
          "coefficient",
          "foreignErpId",
          "managerId",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false
      },
      "FamilyEventType": {
        "type": "string",
        "enum": [
          "deces_enfant_moins_25_non_parent_oui",
          "deces_enfant_moins_25_non_parent_non",
          "deces_enfant_moins_25_oui",
          "mariage_pacs_salarie",
          "mariage_pacs_enfant",
          "deces_conjoint_pacs",
          "deces_personne_charge_moins_25",
          "deces_parent",
          "deces_beau_frere_belle_soeur",
          "deces_frere_soeur",
          "deces_beau_parent",
          "deces_autre_ascendant",
          "deuil_enfant_moins_25",
          "naissance_adoption",
          "handicap_enfant"
        ]
      },
      "ParentalLeaveType": {
        "type": "string",
        "enum": [
          "BIRTH_ADDITIONAL_LEAVE",
          "PATERNITY",
          "MATERNITY",
          "ADOPTION"
        ]
      },
      "PregnancyExamBeneficiary": {
        "type": "string",
        "enum": [
          "PREGNANT_EMPLOYEE",
          "PARTNER"
        ]
      },
      "MaternityLeaveSituation": {
        "type": "string",
        "enum": [
          "FIRST_OR_SECOND",
          "THIRD_OR_MORE",
          "TWINS",
          "TRIPLETS_OR_MORE"
        ]
      },
      "AdoptionLeaveSituation": {
        "type": "string",
        "enum": [
          "ONE_CHILD",
          "THIRD_CHILD_OR_MORE",
          "MULTIPLE"
        ]
      },
      "ChildArrivalType": {
        "type": "string",
        "enum": [
          "BIRTH",
          "ADOPTION"
        ]
      },
      "ApiCompanyFile": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "displayFileName": {
            "type": "string"
          },
          "fileType": {
            "$ref": "#/components/schemas/FileType"
          },
          "file": {
            "$ref": "#/components/schemas/FileJson"
          },
          "collaborator": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "collaboratorId": {
                    "type": "string",
                    "description": "Identifiant Puncto",
                    "examples": [
                      "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                    ]
                  },
                  "firstName": {
                    "type": "string"
                  },
                  "lastName": {
                    "type": "string"
                  },
                  "imageKey": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "collaboratorId",
                  "firstName",
                  "lastName",
                  "imageKey"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "generatedByUserAccount": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "userAccountId": {
                    "type": "string",
                    "description": "Identifiant Puncto",
                    "examples": [
                      "uacc_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                    ]
                  },
                  "firstName": {
                    "type": "string"
                  },
                  "lastName": {
                    "type": "string"
                  }
                },
                "required": [
                  "userAccountId",
                  "firstName",
                  "lastName"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "displayFileName",
          "fileType",
          "file",
          "collaborator",
          "generatedByUserAccount",
          "createdAt"
        ],
        "additionalProperties": false
      },
      "FileType": {
        "type": "string",
        "enum": [
          "PAYSLIP",
          "PAYSLIP_ARCHIVED",
          "DSN_MONTHLY",
          "DSN_WORK_STOPPAGE",
          "DSN_WORK_STOPPAGE_RESUMPTION",
          "DSN_FCTU",
          "DSN_SADV",
          "CRM",
          "EXPENSE_BILL",
          "MEAL_VOUCHER_EXPORT",
          "SEPA_PAYROLL",
          "SEPA_SDTC",
          "ABSENCE_PROOF",
          "DPAE",
          "DPAE_RETURN",
          "ACCOUNTING_PAYROLL_OD",
          "ACCOUNTING_PAYROLL_DSN_RECAP",
          "ACCOUNTING_CONTRIBUTIONS_DETAIL",
          "ACCOUNTING_CONTRIBUTIONS_RECAP",
          "ACCOUNTING_PAYBOOK",
          "ACCOUNTING_PAYROLL_LOG",
          "ACCOUNTING_REST_RECAP",
          "IDENTITY",
          "VITALE",
          "RIB",
          "CONTRACT",
          "INTERNSHIP_AGREEMENT",
          "INTERNSHIP_CERTIFICATE",
          "INTERNSHIP_CERTIFICATE_SIGNED",
          "WORK_CERTIFICATE",
          "WORK_CERTIFICATE_SIGNED",
          "FINAL_SETTLEMENT_RECEIPT",
          "FINAL_SETTLEMENT_RECEIPT_SIGNED",
          "PROFIT_SHARING_STATEMENT",
          "ON_CALL_STATEMENT",
          "PROFIT_SHARING_AGREEMENT_RECEIPT",
          "BILLING_INVOICE",
          "COMPANY_SETUP_CHECKLIST",
          "FCTU_AER",
          "EXPORT",
          "ABSENCE_BATCH",
          "VARIABLE_BATCH",
          "OC_FICHE",
          "BPIJ",
          "SIGNATURE_AUDIT_TRAIL",
          "OTHER"
        ]
      },
      "FileJson": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "mimeType": {
            "$ref": "#/components/schemas/FileMimeType"
          }
        },
        "required": [
          "key",
          "mimeType"
        ],
        "additionalProperties": false
      },
      "FileMimeType": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/ImageMimeType"
          },
          {
            "$ref": "#/components/schemas/OtherMimeType"
          }
        ]
      },
      "ImageMimeType": {
        "type": "string",
        "enum": [
          "image/jpeg",
          "image/png",
          "image/webp",
          "image/heic"
        ]
      },
      "OtherMimeType": {
        "type": "string",
        "enum": [
          "application/pdf",
          "text/plain",
          "text/csv",
          "application/xml",
          "text/xml",
          "application/json",
          "application/octet-stream",
          "application/zip"
        ]
      },
      "ApiWorkStoppageDsnState": {
        "type": "object",
        "properties": {
          "declaredForecastEndDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de fin prévisionnelle (S21.G00.60.003) telle que le signalement d'arrêt l'a déclarée. Null tant qu'aucun signalement n'a abouti : c'est elle qui dit si une reprise est anticipée."
          },
          "isDsnDeclared": {
            "type": "boolean",
            "description": "Vrai quand un signalement d'arrêt a été déposé et validé (idFlux obtenu)."
          },
          "resumption": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApiWorkStoppageResumption"
              },
              {
                "type": "null"
              }
            ],
            "description": "Reprise anticipée déclarée sur cet arrêt, le cas échéant."
          },
          "pendingDeclaration": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApiPendingWorkStoppageDeclaration"
              },
              {
                "type": "null"
              }
            ],
            "description": "Signalement d'arrêt que l'automatisation doit encore déposer : aucune reprise ne peut être saisie avant lui. Null quand l'arrêt est déclaré, ou que l'automatisation ne le déclarera pas."
          }
        },
        "required": [
          "declaredForecastEndDate",
          "isDsnDeclared",
          "resumption",
          "pendingDeclaration"
        ],
        "additionalProperties": false
      },
      "ApiWorkStoppageResumption": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "wsre_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "resumptionDate": {
            "type": "string",
            "format": "date",
            "description": "Premier jour travaillé et payé suite à l'arrêt (S21.G00.60.010)."
          },
          "resumptionMotive": {
            "$ref": "#/components/schemas/DsnWorkStoppageRepriseType",
            "description": "Motif de la reprise (S21.G00.60.011)."
          },
          "signalementRequired": {
            "type": "boolean",
            "description": "Faux quand la reprise n'appelle pas de signalement : l'information passe par la DSN mensuelle."
          },
          "trackingStatus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DsnTrackingStatus"
              },
              {
                "type": "null"
              }
            ],
            "description": "Statut du signalement de reprise, null tant qu'aucun n'a été déclenché."
          }
        },
        "required": [
          "id",
          "resumptionDate",
          "resumptionMotive",
          "signalementRequired",
          "trackingStatus"
        ],
        "additionalProperties": false
      },
      "DsnWorkStoppageRepriseType": {
        "type": "string",
        "enum": [
          "01",
          "02",
          "03"
        ]
      },
      "DsnTrackingStatus": {
        "type": "string",
        "enum": [
          "queued",
          "dsn-file-error",
          "dsn-file-created",
          "dsnval-pending",
          "dsnval-error",
          "dsnval-ok",
          "dsn-api-error",
          "dsn-api-ok",
          "crm-error"
        ]
      },
      "ApiPendingWorkStoppageDeclaration": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "scheduled"
              },
              "scheduledAt": {
                "type": "string",
                "format": "date-time"
              }
            },
            "required": [
              "kind",
              "scheduledAt"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "missing-proof-file"
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          }
        ]
      },
      "ApiInputLockState": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "state": {
                "type": "string",
                "const": "OPEN"
              }
            },
            "required": [
              "state"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "state": {
                "type": "string",
                "const": "LATE"
              },
              "carrierYear": {
                "type": "number"
              },
              "carrierMonth": {
                "type": "number"
              },
              "complementary": {
                "type": "boolean"
              }
            },
            "required": [
              "state",
              "carrierYear",
              "carrierMonth",
              "complementary"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "state": {
                "type": "string",
                "const": "BLOCKED"
              }
            },
            "required": [
              "state"
            ],
            "additionalProperties": false
          }
        ],
        "description": "État d'une saisie (absence, variable de paie, feuille de temps) au regard des mois de paie qu'elle touche (cf. docs/architecture/IN-PERIOD-FOR-PERIOD.md, PR 5) :\n- `OPEN` : la paie du mois est ouverte, la saisie la modifie ;\n- `LATE` : la paie du mois est clôturée ; la saisie reste possible à sa date réelle et sera   régularisée sur la paie ouverte `carrierYear`/`carrierMonth`. `complementary` : le contrat   est terminé avant ce mois, la régularisation est portée par un bulletin complémentaire (PR 6) ;\n- `BLOCKED` : aucune paie ne peut porter la régularisation, la saisie est refusée."
      },
      "ApiLateInputRegularisation": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "CARRIED"
            ]
          },
          "carrierYear": {
            "type": "number"
          },
          "carrierMonth": {
            "type": "number"
          }
        },
        "required": [
          "status",
          "carrierYear",
          "carrierMonth"
        ],
        "additionalProperties": false,
        "description": "Régularisation d'une saisie tardive déjà faite sur l'entité (variable, absence), selon son dernier marqueur :\n- `PENDING` : à porter par la paie ouverte `carrierYear`/`carrierMonth` ;\n- `CARRIED` : portée par la paie clôturée `carrierYear`/`carrierMonth`."
      },
      "AbsenceType": {
        "type": "string",
        "enum": [
          "JNT",
          "RTT",
          "COR",
          "RCR",
          "PTO_N",
          "PTO_N-1",
          "PTO_N-2",
          "UNPAID",
          "FAMILY",
          "PARENTAL",
          "REST",
          "SICK",
          "SICK_AT",
          "SICK_MP",
          "SICK_ATJ",
          "SENIORITY",
          "INTERN_CP",
          "PREGNANCY_EXAM"
        ]
      },
      "AbsenceStatus": {
        "type": "string",
        "enum": [
          "pending",
          "validated",
          "rejected",
          "canceled",
          "technical-cancel"
        ]
      },
      "PublicApiAbsence": {
        "type": "object",
        "properties": {
          "startDate": {
            "type": "string",
            "format": "date"
          },
          "endDate": {
            "type": "string",
            "format": "date"
          },
          "duration": {
            "type": "number"
          },
          "durationExplanation": {
            "type": "string"
          },
          "familyEventType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FamilyEventType"
              },
              {
                "type": "null"
              }
            ]
          },
          "parentalLeaveType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ParentalLeaveType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Type de congé parental (congé de maternité, de paternité, d'adoption, supplémentaire de naissance), null pour toute autre absence."
          },
          "childArrivalDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ]
          },
          "pregnancyExamBeneficiary": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PregnancyExamBeneficiary"
              },
              {
                "type": "null"
              }
            ],
            "description": "Examens de grossesse : la salariée enceinte elle-même, ou son conjoint."
          },
          "maternityLeaveSituation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MaternityLeaveSituation"
              },
              {
                "type": "null"
              }
            ],
            "description": "Congé de maternité : rang de l'enfant ou naissance multiple, qui fixe la durée légale."
          },
          "actualBirthDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Congé de maternité : date réelle de l'accouchement, une fois connue."
          },
          "hasPathologicalPrenatalState": {
            "type": "boolean",
            "description": "Congé de maternité : état pathologique prénatal prescrit (14 jours de plus avant la naissance)."
          },
          "adoptionLeaveSituation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AdoptionLeaveSituation"
              },
              {
                "type": "null"
              }
            ],
            "description": "Congé d'adoption : nombre d'enfants à charge ou adoption multiple, qui fixe la durée légale."
          },
          "childArrivalType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ChildArrivalType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Congé de naissance : naissance ou adoption de l'enfant, purement informatif."
          },
          "familyProofFile": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApiCompanyFile"
              },
              {
                "type": "null"
              }
            ]
          },
          "workStoppage": {
            "type": "object",
            "properties": {
              "lastWorkedDay": {
                "type": "string",
                "format": "date"
              },
              "accidentDate": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "diseaseObservationDate": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "proofFile": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/ApiCompanyFile"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "withSubrogation": {
                "type": "boolean"
              },
              "isProlongation": {
                "type": "boolean",
                "description": "Nature de l'arrêt porté par cette absence : prolongation d'un arrêt initial ou arrêt initial."
              }
            },
            "required": [
              "lastWorkedDay",
              "accidentDate",
              "diseaseObservationDate",
              "proofFile",
              "withSubrogation",
              "isProlongation"
            ],
            "additionalProperties": false
          },
          "workStoppageDsn": {
            "$ref": "#/components/schemas/ApiWorkStoppageDsnState",
            "description": "État déclaratif de l'arrêt de travail porté par cette absence.\n\nRenseigné par les listes internes seulement : le calculer suppose de lire les suivis DSN et la reprise, ce que l'API publique ne fait pas. Son absence ne veut donc pas dire « rien à déclarer », mais « information non chargée ici »."
          },
          "foreignErpId": {
            "type": [
              "string",
              "null"
            ]
          },
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date à laquelle la demande d'absence a été posée."
          },
          "isLocked": {
            "type": "boolean",
            "description": "True when the absence can no longer be modified: one of its payroll months is closed and no open payslip can carry the regularisation (`lockState.state === 'BLOCKED'`)."
          },
          "lockState": {
            "$ref": "#/components/schemas/ApiInputLockState",
            "description": "État de saisie sur les mois couverts par l'absence (saisie tardive possible)"
          },
          "lateInputRegularisation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApiLateInputRegularisation"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dernière saisie tardive faite sur cette entité, `null` s'il n'y en a pas. Renseigné par les listes internes seulement : son absence veut dire « information non chargée ici »."
          },
          "isDsnLocked": {
            "type": "boolean",
            "description": "True when the DSN of the underlying work stoppage is being transmitted or already deposited. The absence can then no longer be edited, cancelled or deleted."
          },
          "id": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "type": {
            "$ref": "#/components/schemas/AbsenceType"
          },
          "status": {
            "$ref": "#/components/schemas/AbsenceStatus"
          },
          "onlyHalfDayAtStart": {
            "type": "boolean"
          },
          "onlyHalfDayAtEnd": {
            "type": "boolean"
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ]
          },
          "isProlongation": {
            "type": "boolean",
            "description": "Prolongation d'un arrêt de travail : `workStoppage` est alors l'arrêt initial, avec l'avis de prolongation pour justificatif."
          }
        },
        "required": [
          "collaboratorForeignErpId",
          "collaboratorId",
          "contractId",
          "createdAt",
          "duration",
          "durationExplanation",
          "endDate",
          "foreignErpId",
          "id",
          "isDsnLocked",
          "isLocked",
          "isProlongation",
          "lockState",
          "onlyHalfDayAtEnd",
          "onlyHalfDayAtStart",
          "parentalLeaveType",
          "startDate",
          "status",
          "type"
        ],
        "additionalProperties": false
      },
      "ContractActivationStatus": {
        "type": "string",
        "enum": [
          "C_INVITATION_SENT",
          "A_TO_BE_REALIZED",
          "B_ACTION_NEEDED",
          "E_ARCHIVED",
          "D_ACTIVE",
          "F_TO_CLOSE",
          "G_UPCOMING"
        ]
      },
      "WorkSchedule": {
        "type": "object",
        "properties": {
          "version": {
            "type": "number",
            "const": 1
          },
          "days": {
            "type": "object",
            "properties": {
              "MONDAY": {
                "$ref": "#/components/schemas/WorkScheduleDay"
              },
              "TUESDAY": {
                "$ref": "#/components/schemas/WorkScheduleDay"
              },
              "WEDNESDAY": {
                "$ref": "#/components/schemas/WorkScheduleDay"
              },
              "THURSDAY": {
                "$ref": "#/components/schemas/WorkScheduleDay"
              },
              "FRIDAY": {
                "$ref": "#/components/schemas/WorkScheduleDay"
              },
              "SATURDAY": {
                "$ref": "#/components/schemas/WorkScheduleDay"
              },
              "SUNDAY": {
                "$ref": "#/components/schemas/WorkScheduleDay"
              }
            },
            "additionalProperties": false,
            "description": "Un jour absent de la carte n'est pas travaillé."
          }
        },
        "required": [
          "version",
          "days"
        ],
        "additionalProperties": false
      },
      "WorkScheduleDay": {
        "type": "object",
        "properties": {
          "morning": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkScheduleTimeRange"
              },
              {
                "type": "null"
              }
            ]
          },
          "afternoon": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkScheduleTimeRange"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "morning",
          "afternoon"
        ],
        "additionalProperties": false
      },
      "WorkScheduleTimeRange": {
        "type": "object",
        "properties": {
          "start": {
            "$ref": "#/components/schemas/WorkScheduleTime"
          },
          "end": {
            "$ref": "#/components/schemas/WorkScheduleTime"
          }
        },
        "required": [
          "start",
          "end"
        ],
        "additionalProperties": false
      },
      "WorkScheduleTime": {
        "type": "string",
        "description": "Heure au format `HH:mm`, sur 24 h."
      },
      "ApiContractTrialPeriod": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifiant Puncto de la période d'essai",
            "examples": [
              "ctpe_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "type": {
            "$ref": "#/components/schemas/ContractTrialPeriodType",
            "description": "Période initiale ou renouvellement"
          },
          "initialEndDate": {
            "type": "string",
            "format": "date",
            "description": "Fin nominale : celle prévue au contrat, ou choisie au renouvellement"
          },
          "recalculatedEndDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fin prolongée des absences validées, ou date de la validation anticipée ; null avant le premier recalcul"
          },
          "recalculationDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date du dernier recalcul de la fin"
          },
          "validationDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de validation anticipée par l'employeur, null tant que la période n'est pas validée."
          },
          "notificationSentAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date d'envoi du rappel de fin de période d'essai à l'entreprise"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date d'enregistrement de la période dans Puncto"
          }
        },
        "required": [
          "id",
          "type",
          "initialEndDate",
          "recalculatedEndDate",
          "recalculationDate",
          "validationDate",
          "notificationSentAt",
          "createdAt"
        ],
        "additionalProperties": false
      },
      "ContractTrialPeriodType": {
        "type": "string",
        "enum": [
          "initial",
          "renewal"
        ]
      },
      "ApiManagerInfos": {
        "type": "object",
        "properties": {
          "managerId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "managerFirstName": {
            "type": "string"
          },
          "managerLastName": {
            "type": "string"
          },
          "managerImageKey": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "managerId",
          "managerFirstName",
          "managerLastName",
          "managerImageKey"
        ],
        "additionalProperties": false
      },
      "WorkPermitType": {
        "type": "string",
        "enum": [
          "VLS_TS",
          "CARTE_SEJOUR_SALARIE",
          "TALENT",
          "TALENT_FAMILLE",
          "VIE_PRIVEE_FAMILIALE",
          "CARTE_SEJOUR_ETUDIANT",
          "RECHERCHE_EMPLOI_CREATION_ENTREPRISE",
          "CARTE_SEJOUR_TRAVAILLEUR_TEMPORAIRE",
          "SALARIE_DETACHE_ICT",
          "MEMBRE_FAMILLE_CITOYEN_UE",
          "CARTE_RESIDENT",
          "CERTIFICAT_RESIDENCE_ALGERIEN",
          "PROTECTION_INTERNATIONALE",
          "RECEPISSE",
          "AUTORISATION_TRAVAIL",
          "OTHER"
        ]
      },
      "WorkerType": {
        "type": "string",
        "enum": [
          "EMPLOYEE_CDI",
          "EMPLOYEE_CDD",
          "PROFESSIONALIZATION_CONTRACT",
          "APPRENTICESHIP_CONTRACT",
          "INTERN",
          "CORPORATE_OFFICER"
        ]
      },
      "QuotityData": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "HEURE"
              },
              "monthlyWorkingHours": {
                "type": "number",
                "description": "e.g. 151.67 for a full-time employee"
              },
              "workingPercentage": {
                "type": "number"
              },
              "paidContractualOvertimeHours": {
                "type": "number",
                "description": "heures supplémentaires contractuelles payées\n\nsi ce champ est > 0 avec workingPercentage = 100, alors monthlyWorkingHours doit être supérieur à 151.67\n\nException : un stagiaire présent plus de 35 h (e.g. 37,5 h → 162,5 h) a un `monthlyWorkingHours` supérieur à 151.67 sans heures supplémentaires (cf. `getInternWeeklyHours`)."
              },
              "rttContractualOvertimeHours": {
                "type": "number",
                "description": "heures supplémentaires contractuelles converties en RTT\n\nce champ n'influence pas le calcul de `monthlyWorkingHours`"
              },
              "rcrContractualOvertimeHours": {
                "type": "number",
                "description": "heures supplémentaires contractuelles converties en RCR (repos compensateur de remplacement)\n\nce champ n'influence pas le calcul de `monthlyWorkingHours`"
              },
              "isCeilingProrated": {
                "type": "boolean",
                "description": "Proratisation du plafond de la sécurité sociale à hauteur de la quotité (DSN S21.G00.40.084). Absent : défaut de la quotité, voir `isQuotityCeilingProrated`."
              }
            },
            "required": [
              "type",
              "monthlyWorkingHours",
              "workingPercentage",
              "paidContractualOvertimeHours",
              "rttContractualOvertimeHours",
              "rcrContractualOvertimeHours"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "FORFAIT_JOUR"
              },
              "forfaitDailyAmount": {
                "type": "number",
                "description": "e.g. 218 for a full-time employee"
              },
              "monthlyWorkingDays": {
                "type": "number",
                "description": "e.g. 21.67 for a full-time employee"
              },
              "workingPercentage": {
                "type": "number"
              },
              "isCeilingProrated": {
                "type": "boolean",
                "description": "Proratisation du plafond de la sécurité sociale à hauteur de la quotité (DSN S21.G00.40.084). Absent : défaut de la quotité, voir `isQuotityCeilingProrated`."
              }
            },
            "required": [
              "type",
              "forfaitDailyAmount",
              "monthlyWorkingDays",
              "workingPercentage"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "FORFAIT_HEURE",
                "description": "Convention de forfait en heures (art. L. 3121-56 du code du travail).\n\nCas d'usage principal : la modalité 2 « réalisation de missions » de la convention Syntec (38h30 par semaine, plafonnées à 219 jours travaillés par an).\n\nContrairement au type `HEURE`, les heures supplémentaires ne sont pas saisies : le volume du forfait est la source de vérité et les heures supplémentaires structurelles en sont dérivées (cf. `getPaidContractualOvertimeHours`)."
              },
              "period": {
                "$ref": "#/components/schemas/ForfaitHeurePeriod",
                "description": "Période de référence du forfait. Seul `WEEKLY` est implémenté aujourd'hui."
              },
              "forfaitHours": {
                "type": "number",
                "description": "Volume du forfait sur sa période de référence, e.g. 38.5 pour un forfait 38h30 hebdomadaire"
              },
              "monthlyWorkingHours": {
                "type": "number",
                "description": "Dérivé de `forfaitHours`, e.g. 166.83 pour un forfait 38h30 hebdomadaire"
              },
              "annualWorkingDaysCap": {
                "type": "number",
                "description": "Plafond annuel de jours travaillés, e.g. 219 pour la modalité 2 Syntec"
              },
              "workingPercentage": {
                "type": "number",
                "const": 100,
                "description": "Le forfait heures réduit n'est pas encore supporté (cf. `zForfaitHeureQuotityData`)"
              }
            },
            "required": [
              "type",
              "period",
              "forfaitHours",
              "monthlyWorkingHours",
              "annualWorkingDaysCap",
              "workingPercentage"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "NON_CONCERNE"
              }
            },
            "required": [
              "type"
            ],
            "additionalProperties": false
          }
        ]
      },
      "ForfaitHeurePeriod": {
        "type": "string",
        "enum": [
          "WEEKLY",
          "MONTHLY",
          "YEARLY"
        ]
      },
      "ConventionalWorkerStatus": {
        "type": "string",
        "enum": [
          "01",
          "02",
          "03",
          "04",
          "05",
          "06",
          "07",
          "08",
          "09",
          "10"
        ]
      },
      "CodePcsEse": {
        "type": "string",
        "enum": [
          "100x",
          "210x",
          "220x",
          "231a",
          "232a",
          "233a",
          "233b",
          "233c",
          "233d",
          "311c",
          "311d",
          "311e",
          "312a",
          "331a",
          "332a",
          "332b",
          "333a",
          "333b",
          "333c",
          "333d",
          "333e",
          "333f",
          "334a",
          "335a",
          "341a",
          "341b",
          "342b",
          "342c",
          "342d",
          "342f",
          "342g",
          "342h",
          "343a",
          "344a",
          "344b",
          "344c",
          "344d",
          "351a",
          "352a",
          "352b",
          "353a",
          "353b",
          "353c",
          "354a",
          "354b",
          "354c",
          "354e",
          "354f",
          "354g",
          "371a",
          "372a",
          "372b",
          "372c",
          "372d",
          "372e",
          "372f",
          "373a",
          "373b",
          "373c",
          "373d",
          "374a",
          "374b",
          "374c",
          "374d",
          "375a",
          "375b",
          "376a",
          "376b",
          "376c",
          "376d",
          "376e",
          "376f",
          "376g",
          "377a",
          "380a",
          "381b",
          "381c",
          "382a",
          "382b",
          "382c",
          "382d",
          "383a",
          "383b",
          "383c",
          "384a",
          "384b",
          "384c",
          "385a",
          "385b",
          "385c",
          "386b",
          "386c",
          "386d",
          "386e",
          "387a",
          "387b",
          "387c",
          "387d",
          "387e",
          "387f",
          "388a",
          "388b",
          "388c",
          "388d",
          "388e",
          "389a",
          "389b",
          "389c",
          "421a",
          "421b",
          "422a",
          "422b",
          "422c",
          "422d",
          "422e",
          "423a",
          "423b",
          "424a",
          "425a",
          "431a",
          "431b",
          "431c",
          "431d",
          "431e",
          "431f",
          "432b",
          "432d",
          "433a",
          "433b",
          "433c",
          "433d",
          "434a",
          "434b",
          "434c",
          "434d",
          "434e",
          "434f",
          "434g",
          "435a",
          "435b",
          "441a",
          "441b",
          "451a",
          "451b",
          "451c",
          "451d",
          "451e",
          "451g",
          "451h",
          "452a",
          "452b",
          "461b",
          "461c",
          "461d",
          "461e",
          "461f",
          "462a",
          "462b",
          "462c",
          "462d",
          "462e",
          "463a",
          "463b",
          "463c",
          "463d",
          "463e",
          "464a",
          "464b",
          "465a",
          "465b",
          "465c",
          "466a",
          "466b",
          "466c",
          "467a",
          "467b",
          "467c",
          "467d",
          "468a",
          "468b",
          "471a",
          "471b",
          "472a",
          "472b",
          "472c",
          "472d",
          "473a",
          "473b",
          "473c",
          "474a",
          "474b",
          "474c",
          "475a",
          "475b",
          "476a",
          "476b",
          "477a",
          "477b",
          "477c",
          "477d",
          "478a",
          "478b",
          "478c",
          "478d",
          "479a",
          "479b",
          "480a",
          "480b",
          "481a",
          "481b",
          "482a",
          "483a",
          "484a",
          "484b",
          "485a",
          "485b",
          "486b",
          "486c",
          "486d",
          "486e",
          "487a",
          "487b",
          "488a",
          "488b",
          "521a",
          "521b",
          "522a",
          "523a",
          "523b",
          "523c",
          "523d",
          "524a",
          "524b",
          "524c",
          "524d",
          "525a",
          "525b",
          "525c",
          "525d",
          "526a",
          "526b",
          "526c",
          "526d",
          "526e",
          "531a",
          "531b",
          "531c",
          "532a",
          "532b",
          "532c",
          "533a",
          "533b",
          "533c",
          "534a",
          "534b",
          "541b",
          "541c",
          "541d",
          "542a",
          "542b",
          "543b",
          "543c",
          "543e",
          "543f",
          "543g",
          "543h",
          "544a",
          "545a",
          "545b",
          "545c",
          "545d",
          "546a",
          "546b",
          "546c",
          "546d",
          "546e",
          "551a",
          "552a",
          "553b",
          "553c",
          "554a",
          "554b",
          "554c",
          "554d",
          "554e",
          "554f",
          "554g",
          "554h",
          "554j",
          "555a",
          "556a",
          "561b",
          "561c",
          "561d",
          "561e",
          "561f",
          "562a",
          "562b",
          "563a",
          "563b",
          "563c",
          "564a",
          "564b",
          "621a",
          "621b",
          "621c",
          "621d",
          "621e",
          "621f",
          "621g",
          "622a",
          "622c",
          "622d",
          "622e",
          "622f",
          "622g",
          "623a",
          "623b",
          "623d",
          "623e",
          "623f",
          "623g",
          "624b",
          "624c",
          "624d",
          "624e",
          "624f",
          "624g",
          "625a",
          "625b",
          "625c",
          "625d",
          "625f",
          "625g",
          "625h",
          "626a",
          "626b",
          "626c",
          "627a",
          "627b",
          "627c",
          "627d",
          "627e",
          "627f",
          "628a",
          "628b",
          "628c",
          "628d",
          "628e",
          "628f",
          "628g",
          "631a",
          "632a",
          "632b",
          "632c",
          "632d",
          "632e",
          "632f",
          "632g",
          "632h",
          "632j",
          "632k",
          "633a",
          "633b",
          "633c",
          "633d",
          "634a",
          "634b",
          "634c",
          "634d",
          "635a",
          "636a",
          "636b",
          "636c",
          "636d",
          "637a",
          "637b",
          "637c",
          "637d",
          "641a",
          "641b",
          "642a",
          "642b",
          "643a",
          "644a",
          "651a",
          "651b",
          "652a",
          "652b",
          "653a",
          "654b",
          "654c",
          "655a",
          "656b",
          "656c",
          "671a",
          "671c",
          "671d",
          "672a",
          "673a",
          "673b",
          "673c",
          "674a",
          "674b",
          "674c",
          "674d",
          "674e",
          "675a",
          "675b",
          "675c",
          "676a",
          "676b",
          "676c",
          "676d",
          "676e",
          "681a",
          "681b",
          "682a",
          "683a",
          "684a",
          "684b",
          "685a",
          "691a",
          "691b",
          "691c",
          "691d",
          "691e",
          "691f",
          "692a",
          "9999"
        ]
      },
      "AmendmentRemuneration": {
        "type": "object",
        "properties": {
          "remunerationBasis": {
            "$ref": "#/components/schemas/RemunerationBasis"
          },
          "grossAnnualSalary": {
            "type": [
              "number",
              "null"
            ],
            "description": "`ANNUAL` : salaire brut annuel."
          },
          "hourlyRate": {
            "type": [
              "number",
              "null"
            ],
            "description": "`HOURLY` : taux horaire brut. `SMOOTHED_MONTHLY` : taux horaire contractuel, figé au début de la période de lissage."
          },
          "smoothedMonthlyAmount": {
            "type": [
              "number",
              "null"
            ],
            "description": "`SMOOTHED_MONTHLY` : montant mensuel lissé."
          },
          "smoothingPlannedHours": {
            "type": [
              "number",
              "null"
            ],
            "description": "`SMOOTHED_MONTHLY` : heures prévues de la période de lissage, figées à son début."
          },
          "remunerationPercentage": {
            "type": [
              "number",
              "null"
            ],
            "description": "`PERCENTAGE` : pourcentage de la référence, ex. `53` pour 53 %."
          },
          "remunerationReference": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RemunerationReference"
              },
              {
                "type": "null"
              }
            ],
            "description": "`PERCENTAGE` : référence du pourcentage."
          }
        },
        "required": [
          "remunerationBasis",
          "grossAnnualSalary",
          "hourlyRate",
          "smoothedMonthlyAmount",
          "smoothingPlannedHours",
          "remunerationPercentage",
          "remunerationReference"
        ],
        "additionalProperties": false,
        "description": "Rémunération d'un avenant : seuls les champs de sa forme (`remunerationBasis`) sont renseignés. Un pourcentage se calcule sur le SMIC ou le SMC en vigueur à la date de paie, il n'est jamais converti en montant stocké."
      },
      "RemunerationBasis": {
        "type": "string",
        "enum": [
          "ANNUAL",
          "HOURLY",
          "SMOOTHED_MONTHLY",
          "PERCENTAGE"
        ]
      },
      "RemunerationReference": {
        "type": "string",
        "enum": [
          "SMIC",
          "SMC"
        ]
      },
      "MealVoucherStatus": {
        "type": "string",
        "enum": [
          "DEFAULT",
          "DISABLED"
        ]
      },
      "RemoteWorkAllowanceStatus": {
        "type": "string",
        "enum": [
          "DEFAULT",
          "DISABLED"
        ]
      },
      "MealAllowanceType": {
        "type": "string",
        "enum": [
          "ON_SITE",
          "OFF_SITE",
          "TRAVEL_RESTAURANT"
        ]
      },
      "ContractWorkPlace": {
        "type": "object",
        "properties": {
          "address": {
            "type": "string"
          },
          "addressDetails": {
            "type": [
              "string",
              "null"
            ]
          },
          "postalCode": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "countryCode": {
            "$ref": "#/components/schemas/CountryCode"
          },
          "inseeCode": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "address",
          "addressDetails",
          "postalCode",
          "city",
          "countryCode",
          "inseeCode"
        ],
        "additionalProperties": false,
        "description": "Adresse du lieu de travail effectif d'un salarié qui ne travaille pas dans son établissement de rattachement (télétravail à domicile par exemple). Le code INSEE de la commune est requis pour une adresse française (S21.G00.85.011)."
      },
      "Territory": {
        "type": "string",
        "enum": [
          "METROPOLE",
          "ALSACE_MOSELLE",
          "GUADELOUPE",
          "MARTINIQUE",
          "GUYANE",
          "REUNION",
          "MAYOTTE"
        ]
      },
      "ApprenticeshipFormationLevel": {
        "type": "string",
        "enum": [
          "03",
          "04",
          "05",
          "06",
          "07",
          "08"
        ]
      },
      "ApprenticeshipFormationYearsPeriods": {
        "type": "object",
        "properties": {
          "FIRST_YEAR": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "startDate": {
                    "type": "string",
                    "format": "date"
                  },
                  "endDate": {
                    "type": "string",
                    "format": "date"
                  }
                },
                "required": [
                  "startDate",
                  "endDate"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "SECOND_YEAR": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "startDate": {
                    "type": "string",
                    "format": "date"
                  },
                  "endDate": {
                    "type": "string",
                    "format": "date"
                  }
                },
                "required": [
                  "startDate",
                  "endDate"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "THIRD_YEAR": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "startDate": {
                    "type": "string",
                    "format": "date"
                  },
                  "endDate": {
                    "type": "string",
                    "format": "date"
                  }
                },
                "required": [
                  "startDate",
                  "endDate"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "FIRST_YEAR",
          "SECOND_YEAR",
          "THIRD_YEAR"
        ],
        "additionalProperties": false
      },
      "ApiContractAmendment": {
        "type": "object",
        "properties": {
          "remunerationBasis": {
            "$ref": "#/components/schemas/RemunerationBasis"
          },
          "grossAnnualSalary": {
            "type": [
              "number",
              "null"
            ],
            "description": "`ANNUAL` : salaire brut annuel."
          },
          "hourlyRate": {
            "type": [
              "number",
              "null"
            ],
            "description": "`HOURLY` : taux horaire brut. `SMOOTHED_MONTHLY` : taux horaire contractuel, figé au début de la période de lissage."
          },
          "smoothedMonthlyAmount": {
            "type": [
              "number",
              "null"
            ],
            "description": "`SMOOTHED_MONTHLY` : montant mensuel lissé."
          },
          "smoothingPlannedHours": {
            "type": [
              "number",
              "null"
            ],
            "description": "`SMOOTHED_MONTHLY` : heures prévues de la période de lissage, figées à son début."
          },
          "remunerationPercentage": {
            "type": [
              "number",
              "null"
            ],
            "description": "`PERCENTAGE` : pourcentage de la référence, ex. `53` pour 53 %."
          },
          "remunerationReference": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RemunerationReference"
              },
              {
                "type": "null"
              }
            ],
            "description": "`PERCENTAGE` : référence du pourcentage."
          },
          "id": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "came_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "companyRoleId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "crol_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "companyTeamId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "ctea_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "establishmentId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "startDate": {
            "type": "string",
            "format": "date"
          },
          "renewsCddTerm": {
            "type": "boolean"
          },
          "postponesCddTerm": {
            "type": "boolean"
          },
          "previousCddEndDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ]
          },
          "isCadre": {
            "type": "boolean"
          },
          "mealVoucherStatus": {
            "$ref": "#/components/schemas/MealVoucherStatus"
          },
          "remoteWorkAllowanceStatus": {
            "$ref": "#/components/schemas/RemoteWorkAllowanceStatus"
          },
          "remoteWorkWeeklyDays": {
            "type": [
              "number",
              "null"
            ],
            "description": "Nombre de jours de télétravail par semaine prévus au contrat."
          },
          "mealAllowanceType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MealAllowanceType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Type de prime de panier versée au titre du contrat. `null` = pas de prime de panier."
          },
          "quotity": {
            "$ref": "#/components/schemas/QuotityData"
          },
          "workerOutsideFranceStatus": {
            "$ref": "#/components/schemas/WorkerOutsideFranceStatus"
          },
          "workPlace": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ContractWorkPlace"
              },
              {
                "type": "null"
              }
            ],
            "description": "Lieu de travail effectif, quand il diffère de l'établissement de rattachement."
          },
          "workTerritory": {
            "$ref": "#/components/schemas/Territory",
            "description": "Territoire du lieu de travail effectif, déduit de `workPlace` ou à défaut de l'adresse de l'établissement : il détermine les jours fériés applicables."
          },
          "conventionalWorkerStatus": {
            "$ref": "#/components/schemas/ConventionalWorkerStatus"
          },
          "conventionalPosition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SyntecPosition"
              },
              {
                "type": "null"
              }
            ]
          },
          "weekDaysWorked": {
            "type": "number",
            "description": "Bitset des jours travaillés, dérivé de `workSchedule` (voir `week_days.ts`)."
          },
          "workSchedule": {
            "$ref": "#/components/schemas/WorkSchedule",
            "description": "Planning type de l'avenant : jours seuls ou horaire (voir `work_schedule.ts`)."
          },
          "codePcsEse": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CodePcsEse"
              },
              {
                "type": "null"
              }
            ]
          },
          "applyJeiExoneration": {
            "type": "boolean"
          },
          "applyAcreExoneration": {
            "type": "boolean",
            "description": "ACRE du dirigeant assimilé salarié : exonération salariale et patronale 12 mois."
          },
          "apprenticeshipFormationYear": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApprenticeshipFormationYear"
              },
              {
                "type": "null"
              }
            ],
            "description": "Année de formation couverte par l'avenant (alternance uniquement)."
          }
        },
        "required": [
          "applyAcreExoneration",
          "applyJeiExoneration",
          "apprenticeshipFormationYear",
          "codePcsEse",
          "companyRoleId",
          "companyTeamId",
          "conventionalPosition",
          "conventionalWorkerStatus",
          "establishmentId",
          "grossAnnualSalary",
          "hourlyRate",
          "id",
          "isCadre",
          "mealAllowanceType",
          "mealVoucherStatus",
          "postponesCddTerm",
          "previousCddEndDate",
          "quotity",
          "remoteWorkAllowanceStatus",
          "remoteWorkWeeklyDays",
          "remunerationBasis",
          "remunerationPercentage",
          "remunerationReference",
          "renewsCddTerm",
          "smoothedMonthlyAmount",
          "smoothingPlannedHours",
          "startDate",
          "weekDaysWorked",
          "workPlace",
          "workSchedule",
          "workTerritory",
          "workerOutsideFranceStatus"
        ],
        "additionalProperties": false
      },
      "WorkerOutsideFranceStatus": {
        "type": "string",
        "enum": [
          "01",
          "02",
          "03",
          "99"
        ]
      },
      "ApprenticeshipFormationYear": {
        "type": "string",
        "enum": [
          "FIRST_YEAR",
          "SECOND_YEAR",
          "THIRD_YEAR"
        ]
      },
      "ApiContractFull": {
        "type": "object",
        "properties": {
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "usageFirstName": {
            "type": [
              "string",
              "null"
            ]
          },
          "usageLastName": {
            "type": [
              "string",
              "null"
            ]
          },
          "birthDate": {
            "type": "string",
            "format": "date"
          },
          "skipRemunerationMinimumCheck": {
            "type": "boolean",
            "description": "Réglé par Puncto dans le backoffice : aucun contrôle de salaire minimum pour cette personne."
          },
          "endDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ]
          },
          "activationStatus": {
            "$ref": "#/components/schemas/ContractActivationStatus"
          },
          "grossAnnualSalary": {
            "type": [
              "number",
              "null"
            ],
            "description": "active amendment informations"
          },
          "hourlyRate": {
            "type": [
              "number",
              "null"
            ]
          },
          "weekDaysWorked": {
            "type": [
              "number",
              "null"
            ]
          },
          "workSchedule": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkSchedule"
              },
              {
                "type": "null"
              }
            ],
            "description": "planning type de l'avenant en vigueur, jours seuls ou horaire"
          },
          "frontendGrossAnnualSalary": {
            "type": [
              "number",
              "null"
            ],
            "description": "active or upcoming amendment informations"
          },
          "frontendHourlyRate": {
            "type": [
              "number",
              "null"
            ]
          },
          "frontendWeekDaysWorked": {
            "type": [
              "number",
              "null"
            ]
          },
          "frontendWorkSchedule": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkSchedule"
              },
              {
                "type": "null"
              }
            ]
          },
          "applyJeiExoneration": {
            "type": "boolean"
          },
          "applyAcreExoneration": {
            "type": "boolean",
            "description": "ACRE du dirigeant assimilé salarié : exonération salariale et patronale 12 mois."
          },
          "trialPeriods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiContractTrialPeriod"
            }
          },
          "companyRoleId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "crol_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "companyTeamId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "ctea_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "manager": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApiManagerInfos"
              },
              {
                "type": "null"
              }
            ]
          },
          "imageKey": {
            "type": [
              "string",
              "null"
            ]
          },
          "foreignErpId": {
            "type": [
              "string",
              "null"
            ]
          },
          "seniorityDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ]
          },
          "emailPro": {
            "type": [
              "string",
              "null"
            ]
          },
          "address": {
            "type": "string"
          },
          "addressDetails": {
            "type": [
              "string",
              "null"
            ]
          },
          "postalCode": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "countryCode": {
            "$ref": "#/components/schemas/CountryCode"
          },
          "addressFull": {
            "type": "string"
          },
          "phoneNumber": {
            "type": [
              "string",
              "null"
            ]
          },
          "dependentChildrenCount": {
            "type": "number"
          },
          "disabledDependentChildrenCount": {
            "type": "number",
            "description": "Counted in `dependentChildrenCount`."
          },
          "maritalStatus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MaritalStatus"
              },
              {
                "type": "null"
              }
            ]
          },
          "birthCity": {
            "type": "string"
          },
          "birthCountryCode": {
            "$ref": "#/components/schemas/CountryCode"
          },
          "birthDepartmentCode": {
            "type": "string"
          },
          "nationality": {
            "$ref": "#/components/schemas/CountryCode"
          },
          "workPermitType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkPermitType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Titre valant autorisation de travail des salariés étrangers."
          },
          "workPermitNumber": {
            "type": [
              "string",
              "null"
            ]
          },
          "workPermitExpirationDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ]
          },
          "socialSecurityNumber": {
            "type": [
              "string",
              "null"
            ]
          },
          "ntt": {
            "type": [
              "string",
              "null"
            ]
          },
          "identityType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CollaboratorIdentityType"
              },
              {
                "type": "null"
              }
            ]
          },
          "identityStartDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ]
          },
          "nextOpenPayrollMonth": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "year": {
                    "type": "number"
                  },
                  "month": {
                    "type": "number"
                  }
                },
                "required": [
                  "year",
                  "month"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "startDate": {
            "type": "string",
            "format": "date"
          },
          "workerType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkerType"
              },
              {
                "type": "null"
              }
            ]
          },
          "paymentOption": {
            "$ref": "#/components/schemas/CollaboratorPaymentOption"
          },
          "conventionalPosition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SyntecPosition"
              },
              {
                "type": "null"
              }
            ]
          },
          "quotity": {
            "$ref": "#/components/schemas/QuotityData"
          },
          "isCadre": {
            "type": "boolean"
          },
          "conventionalWorkerStatus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConventionalWorkerStatus"
              },
              {
                "type": "null"
              }
            ]
          },
          "codePcsEse": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CodePcsEse"
              },
              {
                "type": "null"
              }
            ]
          },
          "establishmentId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "endOfContractId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "eoco_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "internshipStudies": {
            "type": [
              "string",
              "null"
            ]
          },
          "internshipSchool": {
            "type": [
              "string",
              "null"
            ]
          },
          "internshipTutorName": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nom et prénoms du tuteur du stagiaire."
          },
          "remuneration": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AmendmentRemuneration"
              },
              {
                "type": "null"
              }
            ],
            "description": "Rémunération de l'avenant en vigueur."
          },
          "internshipPaidLeaveDays": {
            "type": [
              "number",
              "null"
            ],
            "description": "Forfait de jours de congés payés stage accordés à la création du contrat."
          },
          "hasMutuelleDispense": {
            "type": "boolean"
          },
          "corporateOfficerSalaryMaintenance": {
            "type": "boolean",
            "description": "Mandataire social uniquement : rémunération maintenue pendant les arrêts (maladie, accident, paternité), sous déduction des IJSS."
          },
          "publicTransportEmployerRate": {
            "type": [
              "number",
              "null"
            ],
            "description": "Taux de prise en charge employeur (%) des transports en commun propre au contrat, `null` = taux de l'établissement."
          },
          "mealVoucherStatus": {
            "$ref": "#/components/schemas/MealVoucherStatus"
          },
          "remoteWorkAllowanceStatus": {
            "$ref": "#/components/schemas/RemoteWorkAllowanceStatus"
          },
          "remoteWorkWeeklyDays": {
            "type": [
              "number",
              "null"
            ],
            "description": "Nombre de jours de télétravail par semaine prévus au contrat."
          },
          "mealAllowanceType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MealAllowanceType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Type de prime de panier versée au titre du contrat. `null` = pas de prime de panier."
          },
          "workPlace": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ContractWorkPlace"
              },
              {
                "type": "null"
              }
            ],
            "description": "Lieu de travail effectif de l'avenant en vigueur, s'il diffère de l'établissement."
          },
          "workTerritory": {
            "$ref": "#/components/schemas/Territory",
            "description": "Territoire du lieu de travail effectif de l'avenant en vigueur."
          },
          "apprenticeshipFormationLevel": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApprenticeshipFormationLevel"
              },
              {
                "type": "null"
              }
            ],
            "description": "Niveau de diplôme préparé (alternance uniquement)."
          },
          "apprenticeshipFormationYearsPeriods": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApprenticeshipFormationYearsPeriods"
              },
              {
                "type": "null"
              }
            ],
            "description": "Périodes des années de formation (alternance uniquement)."
          },
          "amendments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiContractAmendment"
            }
          }
        },
        "required": [
          "activationStatus",
          "address",
          "addressDetails",
          "addressFull",
          "amendments",
          "applyAcreExoneration",
          "applyJeiExoneration",
          "apprenticeshipFormationLevel",
          "apprenticeshipFormationYearsPeriods",
          "birthCity",
          "birthCountryCode",
          "birthDate",
          "birthDepartmentCode",
          "city",
          "codePcsEse",
          "collaboratorId",
          "companyRoleId",
          "companyTeamId",
          "contractId",
          "conventionalPosition",
          "conventionalWorkerStatus",
          "corporateOfficerSalaryMaintenance",
          "countryCode",
          "dependentChildrenCount",
          "disabledDependentChildrenCount",
          "emailPro",
          "endDate",
          "endOfContractId",
          "establishmentId",
          "firstName",
          "foreignErpId",
          "frontendGrossAnnualSalary",
          "frontendHourlyRate",
          "frontendWeekDaysWorked",
          "frontendWorkSchedule",
          "grossAnnualSalary",
          "hasMutuelleDispense",
          "hourlyRate",
          "identityStartDate",
          "identityType",
          "imageKey",
          "internshipPaidLeaveDays",
          "internshipSchool",
          "internshipStudies",
          "internshipTutorName",
          "isCadre",
          "lastName",
          "manager",
          "maritalStatus",
          "mealAllowanceType",
          "mealVoucherStatus",
          "nationality",
          "nextOpenPayrollMonth",
          "ntt",
          "paymentOption",
          "phoneNumber",
          "postalCode",
          "publicTransportEmployerRate",
          "quotity",
          "remoteWorkAllowanceStatus",
          "remoteWorkWeeklyDays",
          "remuneration",
          "seniorityDate",
          "skipRemunerationMinimumCheck",
          "socialSecurityNumber",
          "startDate",
          "trialPeriods",
          "usageFirstName",
          "usageLastName",
          "weekDaysWorked",
          "workPermitExpirationDate",
          "workPermitNumber",
          "workPermitType",
          "workPlace",
          "workSchedule",
          "workTerritory",
          "workerType"
        ],
        "additionalProperties": false
      },
      "PublicApiPayslipSummary": {
        "type": "object",
        "properties": {
          "payslipId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "pays_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "year": {
            "type": "number"
          },
          "month": {
            "type": "number",
            "description": "1-12, 1 = janvier"
          },
          "paymentDate": {
            "type": "string",
            "format": "date",
            "description": "Date de paiement du salaire imprimée sur le bulletin"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "totals": {
            "type": "object",
            "properties": {
              "subTotalGrossSalary": {
                "type": "number"
              },
              "totalCotisationsCollaborator": {
                "type": "number"
              },
              "totalCotisationsEmployer": {
                "type": "number"
              },
              "netSocial": {
                "type": "number"
              },
              "netBeforeTaxes": {
                "type": "number"
              },
              "netAfterTaxes": {
                "type": "number"
              },
              "netImposable": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Net imposable du mois — distinct de la base PAS, qui peut être nulle (taux nul)."
              },
              "pas": {
                "type": "object",
                "properties": {
                  "base": {
                    "type": "number"
                  },
                  "rate": {
                    "type": "number"
                  },
                  "amount": {
                    "type": "number"
                  }
                },
                "required": [
                  "base",
                  "rate",
                  "amount"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "subTotalGrossSalary",
              "totalCotisationsCollaborator",
              "totalCotisationsEmployer",
              "netSocial",
              "netBeforeTaxes",
              "netAfterTaxes",
              "netImposable",
              "pas"
            ],
            "additionalProperties": false,
            "description": "Totaux imprimés en pied de bulletin"
          }
        },
        "required": [
          "payslipId",
          "collaboratorId",
          "collaboratorForeignErpId",
          "contractId",
          "year",
          "month",
          "paymentDate",
          "createdAt",
          "totals"
        ],
        "additionalProperties": false,
        "description": "Bulletin validé tel que l'API publique l'expose. Le contenu est la projection du bulletin : les lignes que le PDF remis au salarié imprime, pas le détail interne du calcul, qui évolue avec le moteur de paie."
      },
      "PayslipProjection": {
        "type": "object",
        "properties": {
          "period": {
            "type": "object",
            "properties": {
              "year": {
                "type": "number"
              },
              "month": {
                "type": "number"
              }
            },
            "required": [
              "year",
              "month"
            ],
            "additionalProperties": false
          },
          "collaborator": {
            "type": "object",
            "properties": {
              "firstName": {
                "type": "string"
              },
              "lastName": {
                "type": "string"
              },
              "matriculeRh": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "firstName",
              "lastName",
              "matriculeRh"
            ],
            "additionalProperties": false
          },
          "grossSalary": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PayslipChargeItem"
            },
            "description": "Bloc « Éléments de revenus bruts » ; les retenues y sont négatives."
          },
          "charges": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PayslipCharge"
            },
            "description": "Bloc « Cotisations et contributions sociales »."
          },
          "taxFreeIndemnitiesAndDeductions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PayslipCharge"
            },
            "description": "Blocs « Indemnités non soumises », « Intéressement » et « Autres retenues »."
          },
          "priorPeriodRegularisations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PriorPeriodRegularisationProjection"
            },
            "description": "Blocs « Régularisation MM/AAAA », entre les cotisations et les indemnités non soumises."
          },
          "totals": {
            "type": "object",
            "properties": {
              "subTotalGrossSalary": {
                "type": "number"
              },
              "totalCotisationsCollaborator": {
                "type": "number"
              },
              "totalCotisationsEmployer": {
                "type": "number"
              },
              "netSocial": {
                "type": "number"
              },
              "netBeforeTaxes": {
                "type": "number"
              },
              "netAfterTaxes": {
                "type": "number"
              },
              "netImposable": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Net imposable du mois — distinct de la base PAS, qui peut être nulle (taux nul)."
              },
              "pas": {
                "type": "object",
                "properties": {
                  "base": {
                    "type": "number"
                  },
                  "rate": {
                    "type": "number"
                  },
                  "amount": {
                    "type": "number"
                  }
                },
                "required": [
                  "base",
                  "rate",
                  "amount"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "subTotalGrossSalary",
              "totalCotisationsCollaborator",
              "totalCotisationsEmployer",
              "netSocial",
              "netBeforeTaxes",
              "netAfterTaxes",
              "netImposable",
              "pas"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "period",
          "collaborator",
          "grossSalary",
          "charges",
          "taxFreeIndemnitiesAndDeductions",
          "priorPeriodRegularisations",
          "totals"
        ],
        "additionalProperties": false,
        "description": "Projection du bulletin : exactement les lignes que le template imprime, en données pures. Le rendu (`payslip.tsx`, `gross-salary-rows.tsx`) est construit à partir d'elle, donc ce que relit un lecteur externe — LLM de contrôle, agent de diagnostic — est ce que le salarié a sous les yeux, sans réimplémenter la moindre règle d'affichage."
      },
      "PayslipChargeItem": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Libellé imprimé"
          },
          "base": {
            "type": "number",
            "description": "Base : montant en euros pour une cotisation, heures ou jours pour une ligne de rémunération"
          },
          "employeeRate": {
            "type": "number",
            "description": "Taux salarial : en % pour une cotisation (3.68 = 3,68 %), en €/h pour le salaire de base et les heures supplémentaires"
          },
          "employeeCharge": {
            "type": "number",
            "description": "Montant salarié, en euros"
          },
          "employerCharge": {
            "type": "number",
            "description": "Montant patronal, en euros"
          },
          "isTaxFreeIndemnity": {
            "type": "boolean",
            "description": "Ligne des indemnités non soumises"
          }
        },
        "required": [
          "name"
        ],
        "additionalProperties": false,
        "description": "Une ligne du bulletin, avec les colonnes imprimées ; une colonne vide est absente."
      },
      "PayslipCharge": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PayslipChargeItem"
                }
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "items",
              "name"
            ]
          },
          {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "name": {
                "type": "string"
              },
              "base": {
                "type": "number",
                "description": "Base : montant en euros pour une cotisation, heures ou jours pour une ligne de rémunération"
              },
              "employeeRate": {
                "type": "number",
                "description": "Taux salarial : en % pour une cotisation (3.68 = 3,68 %), en €/h pour le salaire de base et les heures supplémentaires"
              },
              "employeeCharge": {
                "type": "number",
                "description": "Montant salarié, en euros"
              },
              "employerCharge": {
                "type": "number",
                "description": "Montant patronal, en euros"
              },
              "isTaxFreeIndemnity": {
                "type": "boolean",
                "description": "Ligne des indemnités non soumises"
              }
            },
            "required": [
              "name"
            ]
          }
        ]
      },
      "PriorPeriodRegularisationProjection": {
        "type": "object",
        "properties": {
          "sourceYear": {
            "type": "number"
          },
          "sourceMonth": {
            "type": "number"
          },
          "title": {
            "type": "string",
            "description": "« Régularisation 02/2026 »"
          },
          "grossLines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PayslipChargeItem"
            },
            "description": "Écarts des lignes de revenus bruts, signés comme dans le bloc des revenus bruts"
          },
          "charges": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PayslipCharge"
            },
            "description": "Écarts des cotisations, groupés et libellés comme le bloc des cotisations"
          },
          "netItems": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PayslipChargeItem"
            },
            "description": "Écarts des indemnités non soumises et des retenues : `employeeCharge` est l'effet signé sur le net"
          },
          "totals": {
            "type": "object",
            "properties": {
              "gross": {
                "type": "number"
              },
              "collaboratorContributions": {
                "type": "number"
              },
              "employerContributions": {
                "type": "number"
              },
              "netBeforeTaxes": {
                "type": "number"
              }
            },
            "required": [
              "gross",
              "collaboratorContributions",
              "employerContributions",
              "netBeforeTaxes"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "sourceYear",
          "sourceMonth",
          "title",
          "grossLines",
          "charges",
          "netItems",
          "totals"
        ],
        "additionalProperties": false,
        "description": "Bloc « Régularisation MM/AAAA » d'une paie porteuse : écarts du mois source, aux taux du mois source."
      },
      "PublicApiPayslip": {
        "type": "object",
        "properties": {
          "payslipId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "pays_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "year": {
            "type": "number"
          },
          "month": {
            "type": "number",
            "description": "1-12, 1 = janvier"
          },
          "paymentDate": {
            "type": "string",
            "format": "date",
            "description": "Date de paiement du salaire imprimée sur le bulletin"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "projection": {
            "$ref": "#/components/schemas/PayslipProjection"
          }
        },
        "required": [
          "collaboratorForeignErpId",
          "collaboratorId",
          "contractId",
          "createdAt",
          "month",
          "paymentDate",
          "payslipId",
          "projection",
          "year"
        ],
        "additionalProperties": false
      },
      "DsnMotifRecours": {
        "type": "string",
        "enum": [
          "01",
          "02",
          "03",
          "04",
          "05",
          "06",
          "07",
          "08",
          "09",
          "10",
          "11",
          "12",
          "13",
          "14",
          "15"
        ]
      },
      "PublicApiEndOfContract": {
        "type": "object",
        "properties": {
          "endOfContractId": {
            "type": "string",
            "description": "Identifiant Puncto de la clôture",
            "examples": [
              "eoco_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Date de fin du contrat déclarée en DSN (S21.G00.62.001), préavis compris"
          },
          "lastWorkedDay": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dernier jour travaillé, antérieur à la date de fin quand le préavis n'est pas effectué"
          },
          "finalSettlementPayrollDate": {
            "type": "string",
            "format": "date",
            "description": "Date du mois de paie qui porte le solde de tout compte"
          },
          "terminationReason": {
            "$ref": "#/components/schemas/DsnContractTerminationReason",
            "description": "Motif de la rupture déclaré en DSN (S21.G00.62.002)"
          },
          "terminationInitiator": {
            "$ref": "#/components/schemas/TerminationInitiator",
            "description": "Initiative de la rupture"
          },
          "notificationDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de notification de la rupture (S21.G00.62.003)"
          },
          "layoffProcedureStartDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Licenciement : date de l'entretien préalable"
          },
          "terminationAgreementSignatureDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Rupture conventionnelle : date de signature de la convention (S21.G00.62.004)"
          },
          "plannedEndDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "CDD : terme prévu au moment de la clôture, null hors CDD"
          },
          "noticePeriodType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DsnPreavisType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Type de préavis déclaré en DSN (bloc S21.G00.63)"
          },
          "noticeSituation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/NoticePeriodSituation"
              },
              {
                "type": "null"
              }
            ],
            "description": "Aménagement du préavis : dispense, raccourcissement, prolongation ou refus"
          },
          "noticePeriodStartDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de début du préavis"
          },
          "noticePeriodEndDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de fin du préavis déclarée en DSN"
          },
          "permanentContractOutcome": {
            "$ref": "#/components/schemas/PermanentContractOutcome",
            "description": "CDD : issue de la proposition de CDI au terme"
          },
          "precarityBonusDue": {
            "type": "boolean",
            "description": "CDD : la clôture ouvre droit à l'indemnité de fin de contrat (prime de précarité)"
          },
          "leaveCarriedOver": {
            "type": "boolean",
            "description": "CDD poursuivi en CDI : les compteurs de congés sont repris par le CDI au lieu d'être soldés"
          },
          "dismissalIndemnityAmount": {
            "type": [
              "number",
              "null"
            ],
            "description": "Indemnité de licenciement calculée, en euros : le plus favorable du montant légal et du montant Syntec. Null quand aucun calcul n'a été fait."
          },
          "finalSettlementPaymentDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de paiement du solde de tout compte"
          },
          "mutuellePortability": {
            "type": "boolean",
            "description": "Portabilité de la mutuelle activée"
          },
          "prevoyancePortability": {
            "type": "boolean",
            "description": "Portabilité de la prévoyance activée"
          },
          "finalSettlementPayslipId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "pays_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Bulletin de paie du solde de tout compte, null tant qu'il n'existe pas"
          },
          "finalSettlementReceiptFileId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Document du reçu pour solde de tout compte, null tant qu'il n'est pas généré"
          },
          "workCertificateFileId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Document du certificat de travail, null tant qu'il n'est pas généré"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date d'enregistrement de la clôture dans Puncto"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification de la clôture"
          }
        },
        "required": [
          "endOfContractId",
          "endDate",
          "lastWorkedDay",
          "finalSettlementPayrollDate",
          "terminationReason",
          "terminationInitiator",
          "notificationDate",
          "layoffProcedureStartDate",
          "terminationAgreementSignatureDate",
          "plannedEndDate",
          "noticePeriodType",
          "noticeSituation",
          "noticePeriodStartDate",
          "noticePeriodEndDate",
          "permanentContractOutcome",
          "precarityBonusDue",
          "leaveCarriedOver",
          "dismissalIndemnityAmount",
          "finalSettlementPaymentDate",
          "mutuellePortability",
          "prevoyancePortability",
          "finalSettlementPayslipId",
          "finalSettlementReceiptFileId",
          "workCertificateFileId",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Clôture d'un contrat de travail : rupture, fin de CDD, fin de stage ou de mandat..."
      },
      "DsnContractTerminationReason": {
        "type": "string",
        "enum": [
          "011",
          "012",
          "014",
          "015",
          "020",
          "025",
          "026",
          "031",
          "033",
          "034",
          "035",
          "036",
          "037",
          "038",
          "039",
          "043",
          "058",
          "059",
          "065",
          "081",
          "64",
          "083",
          "084",
          "086",
          "087",
          "088",
          "089",
          "091",
          "092",
          "093",
          "094",
          "095",
          "096",
          "097",
          "098",
          "099",
          "100",
          "110",
          "111",
          "112",
          "113",
          "114",
          "115",
          "116",
          "117",
          "118",
          "119",
          "998",
          "999"
        ]
      },
      "TerminationInitiator": {
        "type": "string",
        "enum": [
          "COMPANY",
          "COLLABORATOR",
          "MUTUAL_AGREEMENT"
        ]
      },
      "DsnPreavisType": {
        "type": "string",
        "enum": [
          "01",
          "02",
          "03",
          "10",
          "50",
          "51",
          "60",
          "61",
          "90"
        ]
      },
      "NoticePeriodSituation": {
        "type": "string",
        "enum": [
          "EMPLOYER_WAIVER",
          "COLLABORATOR_REQUEST_ACCEPTED",
          "MUTUAL_EXTENSION",
          "COLLABORATOR_REFUSAL"
        ]
      },
      "PermanentContractOutcome": {
        "type": "string",
        "enum": [
          "NONE",
          "CONTINUED",
          "REFUSED"
        ]
      },
      "PublicApiOcAffiliation": {
        "type": "object",
        "properties": {
          "ocAffiliationId": {
            "type": "string",
            "description": "Identifiant Puncto de l'affiliation",
            "examples": [
              "ocaf_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "ocContractId": {
            "type": "string",
            "description": "Contrat de mutuelle ou de prévoyance de l'entreprise auquel le salarié est affilié",
            "examples": [
              "ocon_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "type": {
            "$ref": "#/components/schemas/OcContractType",
            "description": "Mutuelle ou prévoyance"
          },
          "ocContractLabel": {
            "type": "string",
            "description": "Libellé du contrat de mutuelle ou de prévoyance"
          },
          "startDate": {
            "type": "string",
            "format": "date",
            "description": "Date de début de l'affiliation"
          },
          "endDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de fin de l'affiliation, null si elle n'a pas de fin prévue"
          },
          "affiliationChoice": {
            "type": [
              "string",
              "null"
            ],
            "description": "Formule de mutuelle choisie parmi celles du contrat : `UNIQUE`, `OPTION_<code>`, `CONDITION_<code>` ou, quand plusieurs forfaits partagent une option, `TIER_<code>__<libellé>`. Null sans formule (prévoyance notamment)."
          },
          "forfaitLabel": {
            "type": [
              "string",
              "null"
            ],
            "description": "Libellé de la formule choisie (à défaut, son code), null sans formule"
          }
        },
        "required": [
          "ocAffiliationId",
          "ocContractId",
          "type",
          "ocContractLabel",
          "startDate",
          "endDate",
          "affiliationChoice",
          "forfaitLabel"
        ],
        "additionalProperties": false,
        "description": "Affiliation d'un contrat de travail à un contrat de mutuelle ou de prévoyance de l'entreprise, sur une période."
      },
      "OcContractType": {
        "type": "string",
        "enum": [
          "MUTUELLE",
          "PREVOYANCE"
        ]
      },
      "PublicApiContract": {
        "type": "object",
        "properties": {
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto du contrat",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto du collaborateur",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "dsnContractNumber": {
            "type": "string",
            "description": "Numéro du contrat déclaré en DSN (S21.G00.40.009)"
          },
          "workerType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkerType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Type de contrat, null pour un contrat en cours de création"
          },
          "activationStatus": {
            "$ref": "#/components/schemas/ContractActivationStatus",
            "description": "Statut du contrat dans Puncto"
          },
          "startDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de début du contrat, null pour un contrat en cours de création"
          },
          "endDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de fin du contrat : terme prévu (CDD, stage, alternance, mandat), remplacé par la date de fin effective une fois le contrat clôturé. Null pour un contrat sans terme."
          },
          "cddMotifRecours": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DsnMotifRecours"
              },
              {
                "type": "null"
              }
            ],
            "description": "CDD : motif de recours déclaré en DSN (S21.G00.40.021)"
          },
          "dpaeDoneByPuncto": {
            "type": "boolean",
            "description": "La DPAE du contrat est effectuée par Puncto"
          },
          "hasMutuelleDispense": {
            "type": "boolean",
            "description": "Le salarié est dispensé d'adhésion à la mutuelle"
          },
          "corporateOfficerSalaryMaintenance": {
            "type": "boolean",
            "description": "Mandataire social : rémunération maintenue pendant les arrêts, sous déduction des IJSS"
          },
          "publicTransportEmployerRate": {
            "type": [
              "number",
              "null"
            ],
            "description": "Taux de prise en charge employeur (%) des abonnements de transport en commun propre au contrat, null quand les taux de l'établissement s'appliquent"
          },
          "internshipStudies": {
            "type": [
              "string",
              "null"
            ],
            "description": "Stage : formation suivie"
          },
          "internshipSchool": {
            "type": [
              "string",
              "null"
            ],
            "description": "Stage : établissement d'enseignement"
          },
          "internshipPaidLeaveDays": {
            "type": [
              "number",
              "null"
            ],
            "description": "Stage : forfait de jours de congés payés accordés, null s'il n'est pas accordé"
          },
          "apprenticeshipFormationLevel": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApprenticeshipFormationLevel"
              },
              {
                "type": "null"
              }
            ],
            "description": "Alternance : niveau du diplôme préparé"
          },
          "apprenticeshipFormationYearsPeriods": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApprenticeshipFormationYearsPeriods"
              },
              {
                "type": "null"
              }
            ],
            "description": "Alternance : périodes des années de formation"
          },
          "referenceDate": {
            "type": "string",
            "format": "date",
            "description": "Date à laquelle `currentAmendment` et `establishmentId` sont résolus : la date demandée, sinon la date du jour (la date de début pour un contrat qui n'a pas encore commencé)"
          },
          "establishmentId": {
            "type": "string",
            "description": "Établissement de rattachement en vigueur à `referenceDate` (avant le premier avenant : celui du premier avenant)",
            "examples": [
              "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "currentAmendment": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ApiContractAmendment"
              },
              {
                "type": "null"
              }
            ],
            "description": "Avenant en vigueur à `referenceDate`, null avant le premier avenant"
          },
          "amendments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiContractAmendment"
            },
            "description": "Tous les avenants du contrat, avenants à venir compris, du plus ancien au plus récent"
          },
          "trialPeriods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiContractTrialPeriod"
            },
            "description": "Périodes d'essai (initiale puis renouvellement), par date de fin croissante"
          },
          "endOfContract": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicApiEndOfContract"
              },
              {
                "type": "null"
              }
            ],
            "description": "Clôture du contrat, null tant que le contrat n'est pas clôturé"
          },
          "ocAffiliations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiOcAffiliation"
            },
            "description": "Affiliations mutuelle et prévoyance du contrat, par date de début croissante"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création du contrat dans Puncto"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification du contrat (hors avenants, périodes d'essai et clôture)"
          }
        },
        "required": [
          "contractId",
          "collaboratorId",
          "collaboratorForeignErpId",
          "dsnContractNumber",
          "workerType",
          "activationStatus",
          "startDate",
          "endDate",
          "cddMotifRecours",
          "dpaeDoneByPuncto",
          "hasMutuelleDispense",
          "corporateOfficerSalaryMaintenance",
          "publicTransportEmployerRate",
          "internshipStudies",
          "internshipSchool",
          "internshipPaidLeaveDays",
          "apprenticeshipFormationLevel",
          "apprenticeshipFormationYearsPeriods",
          "referenceDate",
          "establishmentId",
          "currentAmendment",
          "amendments",
          "trialPeriods",
          "endOfContract",
          "ocAffiliations",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Contrat de travail tel que l'API publique l'expose : le contrat, l'historique complet de ses avenants, ses périodes d'essai, sa clôture et ses affiliations mutuelle et prévoyance.\n\nLes valeurs en vigueur (`currentAmendment`, `establishmentId`) sont résolues à `referenceDate`. Aucune donnée personnelle du collaborateur n'y figure : elles sont exposées par les ressources collaborateurs."
      },
      "PublicApiCreatedCollaborator": {
        "type": "object",
        "properties": {
          "collaborator": {
            "$ref": "#/components/schemas/PublicApiCollaborator",
            "description": "Collaborateur créé"
          },
          "contract": {
            "$ref": "#/components/schemas/PublicApiContract",
            "description": "Premier contrat du collaborateur, ses valeurs en vigueur résolues à sa date de début"
          }
        },
        "required": [
          "collaborator",
          "contract"
        ],
        "additionalProperties": false,
        "description": "Collaborateur embauché par l'API publique (`POST /public/v1/collaborators`) avec son premier contrat"
      },
      "PayrollVariableStatus": {
        "type": "string",
        "enum": [
          "PENDING",
          "VALIDATED",
          "REJECTED"
        ]
      },
      "PublicApiPayrollVariableData": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariablePrimeData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableSalaryDeductionData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableInKindBenefitData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableOvertimeData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableMonthlyOvertimeData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableRemoteWorkDayData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableMealAllowanceAdjustmentData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableMealVoucherAdjustmentData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableSalaryAdvanceData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableProfitSharingData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableHolidayVoucherData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariablePrevoyanceIjData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableOnCallData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableExpenseNoteData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariablePersonalTransportData"
          },
          {
            "$ref": "#/components/schemas/PublicApiPayrollVariableOtherTaxFreeIndemnityData"
          }
        ],
        "description": "Contenu d'une variable de paie : sa forme dépend de `type`, et pour `TAX_FREE_INDEMNITY` de `indemnityType`."
      },
      "PublicApiPayrollVariablePrimeData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "PRIME",
            "description": "Prime"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "amount": {
            "type": "number",
            "description": "Montant brut, en euros"
          },
          "base": {
            "type": "number",
            "description": "Base imprimée sur le bulletin, quand la prime en a une (jours d'une indemnité de fin de contrat, par exemple)"
          },
          "primeType": {
            "$ref": "#/components/schemas/PrimeType",
            "description": "Type de prime, qui détermine sa déclaration en DSN"
          },
          "isAbsenceSensitive": {
            "type": "boolean",
            "description": "La prime est proratisée en fonction des absences du mois"
          },
          "attachmentPeriod": {
            "$ref": "#/components/schemas/PublicApiPayrollVariableAttachmentPeriod",
            "description": "Période de rattachement DSN, quand elle ne se déduit pas du mois de paie (régularisation du dixième des congés payés)"
          }
        },
        "required": [
          "type",
          "name",
          "amount",
          "primeType",
          "isAbsenceSensitive"
        ],
        "additionalProperties": false,
        "description": "Prime brute"
      },
      "PrimeType": {
        "type": "string",
        "enum": [
          "HOLIDAY_BONUS",
          "END_OF_CONTRACT_BONUS",
          "LEGAL_DISMISSAL_BONUS",
          "SYNTEC_DISMISSAL_BONUS",
          "PPV",
          "JNT_COMPENSATION_BONUS",
          "RTT_COMPENSATION_BONUS",
          "COR_COMPENSATION_BONUS",
          "RCR_COMPENSATION_BONUS",
          "CP_COMPENSATION_BONUS",
          "CP_TENTH_REGULARISATION_BONUS",
          "NOTICE_PERIOD_COMPENSATION_BONUS",
          "PAID_NOTICE_PERIOD_COMPENSATION_BONUS",
          "PRECARIOUSNESS_BONUS_AMOUNT",
          "BUSINESS_BONUS",
          "COOPTATION_BONUS",
          "HOME_OCCUPATION_ALLOWANCE",
          "ON_CALL_INDEMNITY",
          "SUNDAY_HOLIDAY_MAJORATION",
          "OTHER"
        ]
      },
      "PublicApiPayrollVariableAttachmentPeriod": {
        "type": "object",
        "properties": {
          "startDate": {
            "type": "string",
            "format": "date",
            "description": "Premier jour de la période"
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Dernier jour de la période"
          }
        },
        "required": [
          "startDate",
          "endDate"
        ],
        "additionalProperties": false,
        "description": "Période de rattachement d'une prime déclarée en DSN (S21.G00.52.003 et .004)"
      },
      "PublicApiPayrollVariableSalaryDeductionData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "SALARY_DEDUCTION",
            "description": "Retenue sur salaire"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "amount": {
            "type": "number",
            "description": "Montant retenu, en euros"
          },
          "deductionType": {
            "$ref": "#/components/schemas/SalaryDeductionType",
            "description": "Nature de la retenue : sur le net, sur le brut, ou avance de salaire négative du mois précédent"
          }
        },
        "required": [
          "type",
          "name",
          "amount",
          "deductionType"
        ],
        "additionalProperties": false,
        "description": "Retenue sur salaire"
      },
      "SalaryDeductionType": {
        "type": "string",
        "enum": [
          "LAST_MONTH_NEGATIVE_PAY_ADVANCE",
          "NET_REDUCTION",
          "BRUT_REDUCTION"
        ]
      },
      "PublicApiPayrollVariableInKindBenefitData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "IN_KIND_BENEFIT",
            "description": "Avantage en nature"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "amount": {
            "type": "number",
            "description": "Valeur de l'avantage, en euros"
          },
          "benefitType": {
            "$ref": "#/components/schemas/InKindBenefitType",
            "description": "Nature de l'avantage"
          },
          "actualExpensesVehicle": {
            "$ref": "#/components/schemas/PublicApiActualExpensesVehicle",
            "description": "Véhicule évalué aux dépenses réelles : `amount` est alors l'usage personnel évalué, avant abattement et participation"
          }
        },
        "required": [
          "type",
          "name",
          "amount",
          "benefitType"
        ],
        "additionalProperties": false,
        "description": "Avantage en nature"
      },
      "InKindBenefitType": {
        "type": "string",
        "enum": [
          "MEALS",
          "HOUSING",
          "VEHICLE",
          "NTIC",
          "OTHER"
        ]
      },
      "PublicApiActualExpensesVehicle": {
        "type": "object",
        "properties": {
          "isElectric": {
            "type": "boolean",
            "description": "Véhicule électrique"
          },
          "assignedOn": {
            "type": "string",
            "description": "Date de mise à disposition (`AAAA-MM-JJ`), requise pour un véhicule électrique"
          },
          "isEcoScoreEligible": {
            "type": "boolean",
            "description": "Éco-score requis pour l'abattement des véhicules électriques mis à disposition depuis le 1er février 2025"
          },
          "employeeMonthlyContribution": {
            "type": "number",
            "description": "Participation mensuelle du salarié, en euros, déduite de l'avantage après l'abattement"
          },
          "contributionWithheldFromPay": {
            "type": "boolean",
            "description": "La participation du salarié est retenue sur son net à payer"
          },
          "retainedDuringLeave": {
            "type": "boolean",
            "description": "L'avantage est conservé pendant les congés"
          }
        },
        "required": [
          "isElectric",
          "employeeMonthlyContribution",
          "contributionWithheldFromPay",
          "retainedDuringLeave"
        ],
        "additionalProperties": false,
        "description": "Véhicule évalué aux dépenses réelles : l'employeur évalue l'usage personnel, Puncto en déduit l'abattement électrique et la participation"
      },
      "PublicApiPayrollVariableOvertimeData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "OVERTIME",
            "description": "Heures supplémentaires"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "hours": {
            "type": "number",
            "description": "Nombre d'heures supplémentaires"
          },
          "overtimeDate": {
            "type": "string",
            "format": "date",
            "description": "Jour où les heures ont été effectuées : il détermine leur semaine, donc leur taux de majoration"
          }
        },
        "required": [
          "type",
          "name",
          "hours",
          "overtimeDate"
        ],
        "additionalProperties": false,
        "description": "Heures supplémentaires payées"
      },
      "PublicApiPayrollVariableMonthlyOvertimeData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "OVERTIME",
            "description": "Heures supplémentaires"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "hours": {
            "type": "number",
            "description": "Nombre d'heures supplémentaires"
          },
          "majorationRate": {
            "type": "number",
            "enum": [
              25,
              50,
              100
            ],
            "description": "Taux de majoration, en % : 25, 50 ou 100 (dimanche, jour férié, nuit)"
          }
        },
        "required": [
          "type",
          "name",
          "hours",
          "majorationRate"
        ],
        "additionalProperties": false,
        "description": "Heures supplémentaires du mois à un taux donné, transmises sans date par une intégration"
      },
      "PublicApiPayrollVariableRemoteWorkDayData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "REMOTE_WORK_DAY",
            "description": "Jours de télétravail"
          },
          "name": {
            "type": "string",
            "const": "Jours de télétravail",
            "description": "Libellé fixe"
          },
          "days": {
            "type": "number",
            "description": "Nombre de jours, par demi-journée, négatif pour retirer des jours au décompte automatique"
          }
        },
        "required": [
          "type",
          "name",
          "days"
        ],
        "additionalProperties": false,
        "description": "Correction du décompte des jours de télétravail du mois, indemnisés par l'établissement. Quand l'établissement décompte les jours à la main, c'est le nombre de jours du mois."
      },
      "PublicApiPayrollVariableMealAllowanceAdjustmentData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "MEAL_ALLOWANCE_ADJUSTMENT",
            "description": "Ajustement des primes de panier"
          },
          "name": {
            "type": "string",
            "const": "Ajustement paniers",
            "description": "Libellé fixe"
          },
          "mealAllowanceType": {
            "$ref": "#/components/schemas/MealAllowanceType",
            "description": "Situation du repas, qui fixe la limite d'exonération par repas"
          },
          "count": {
            "type": "number",
            "description": "Nombre de repas, négatif pour en retirer"
          },
          "label": {
            "type": "string",
            "description": "Libellé de la ligne du bulletin (60 caractères au plus), « Régularisation prime de panier » par défaut"
          }
        },
        "required": [
          "type",
          "name",
          "mealAllowanceType",
          "count"
        ],
        "additionalProperties": false,
        "description": "Correction du nombre de primes de panier d'un type donné pour le mois"
      },
      "PublicApiPayrollVariableMealVoucherAdjustmentData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "MEAL_VOUCHER_ADJUSTMENT",
            "description": "Ajustement des titres restaurant"
          },
          "name": {
            "type": "string",
            "const": "Ajustement titres restaurant",
            "description": "Libellé fixe"
          },
          "count": {
            "type": "number",
            "description": "Nombre de titres, négatif pour en retirer"
          },
          "label": {
            "type": "string",
            "description": "Libellé de la ligne du bulletin (60 caractères au plus), « Régularisation titres restaurant » par défaut"
          }
        },
        "required": [
          "type",
          "name",
          "count"
        ],
        "additionalProperties": false,
        "description": "Correction du nombre de titres restaurant du mois"
      },
      "PublicApiPayrollVariableSalaryAdvanceData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "SALARY_ADVANCE",
            "description": "Acompte sur salaire"
          },
          "name": {
            "type": "string",
            "const": "Acompte sur salaire",
            "description": "Libellé fixe"
          },
          "amount": {
            "type": "number",
            "description": "Montant versé, en euros"
          },
          "paymentDate": {
            "type": "string",
            "format": "date",
            "description": "Date de versement de l'acompte, dans le mois de paie"
          }
        },
        "required": [
          "type",
          "name",
          "amount",
          "paymentDate"
        ],
        "additionalProperties": false,
        "description": "Acompte sur salaire versé pendant le mois : imprimé sous le net payé, il est déduit du virement de fin de mois sans entrer dans le calcul de la paie."
      },
      "PublicApiPayrollVariableProfitSharingData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "PROFIT_SHARING",
            "description": "Intéressement"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "amount": {
            "type": "number",
            "description": "Montant attribué, en euros"
          },
          "paidAmount": {
            "type": "number",
            "description": "Part versée sur la paie, en euros"
          },
          "peeAmount": {
            "type": "number",
            "description": "Part placée sur le plan d'épargne entreprise (PEE), en euros"
          },
          "perAmount": {
            "type": "number",
            "description": "Part placée sur le plan d'épargne retraite (PER), en euros"
          }
        },
        "required": [
          "type",
          "name",
          "amount",
          "paidAmount",
          "peeAmount",
          "perAmount"
        ],
        "additionalProperties": false,
        "description": "Prime d'intéressement d'un bénéficiaire, créée par la validation d'un versement d'intéressement"
      },
      "PublicApiPayrollVariableHolidayVoucherData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "HOLIDAY_VOUCHER",
            "description": "Chèques-vacances"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "voucherValue": {
            "type": "number",
            "description": "Valeur des titres remis, en euros"
          },
          "employerAmount": {
            "type": "number",
            "description": "Participation de l'employeur, en euros"
          },
          "employeeAmount": {
            "type": "number",
            "description": "Part payée par le salarié, en euros"
          },
          "exemptAmount": {
            "type": "number",
            "description": "Part de la participation employeur exonérée de cotisations sociales, en euros"
          },
          "taxableExemptAmount": {
            "type": "number",
            "description": "Part de `exemptAmount` au-delà de l'exonération annuelle d'impôt sur le revenu, en euros"
          },
          "subjectAmount": {
            "type": "number",
            "description": "Part de la participation employeur soumise à cotisations sociales, en euros"
          },
          "taxExemptSubjectAmount": {
            "type": "number",
            "description": "Part de `subjectAmount` sous l'exonération annuelle d'impôt sur le revenu, en euros"
          }
        },
        "required": [
          "type",
          "name",
          "voucherValue",
          "employerAmount",
          "employeeAmount",
          "exemptAmount",
          "taxableExemptAmount",
          "subjectAmount",
          "taxExemptSubjectAmount"
        ],
        "additionalProperties": false,
        "description": "Chèques-vacances remis le mois de la variable, créée par une attribution de chèques-vacances"
      },
      "PublicApiPayrollVariablePrevoyanceIjData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "PREVOYANCE_IJ",
            "description": "IJ de prévoyance"
          },
          "name": {
            "type": "string",
            "const": "IJ prévoyance",
            "description": "Libellé"
          },
          "startDate": {
            "type": "string",
            "format": "date",
            "description": "Premier jour indemnisé du mois"
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Dernier jour indemnisé du mois"
          },
          "grossAmount": {
            "type": "number",
            "description": "IJ brute de ces jours, en euros"
          },
          "employerRate": {
            "type": "number",
            "description": "Part de l'IJ financée par l'employeur, en % : elle est soumise à cotisations comme du salaire"
          }
        },
        "required": [
          "type",
          "name",
          "startDate",
          "endDate",
          "grossAmount",
          "employerRate"
        ],
        "additionalProperties": false,
        "description": "Part d'un bordereau de paiement prévoyance sur le mois qu'elle indemnise : IJ complémentaires versées par l'organisme de prévoyance à l'employeur, qui les reverse sur le bulletin"
      },
      "PublicApiPayrollVariableOnCallData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "ON_CALL",
            "description": "Astreinte"
          },
          "name": {
            "type": "string",
            "description": "Libellé du type d'astreinte à la saisie"
          },
          "onCallTypeId": {
            "type": "string",
            "description": "Type d'astreinte de l'entreprise",
            "examples": [
              "octy_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "start": {
            "type": "string",
            "description": "Début, heure légale française `YYYY-MM-DDTHH:mm`"
          },
          "end": {
            "type": "string",
            "description": "Fin, heure légale française `YYYY-MM-DDTHH:mm`"
          },
          "units": {
            "type": "number",
            "description": "Nombre d'unités indemnisées : heures de la période (unité `HOUR`) ou nombre de périodes (unité `PERIOD`)"
          },
          "compensation": {
            "$ref": "#/components/schemas/PublicApiPayrollVariableOnCallCompensation",
            "description": "Contrepartie de l'astreinte"
          },
          "interventions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiPayrollVariableOnCallIntervention"
            },
            "description": "Interventions pendant la période"
          }
        },
        "required": [
          "type",
          "name",
          "onCallTypeId",
          "start",
          "end",
          "units",
          "compensation",
          "interventions"
        ],
        "additionalProperties": false,
        "description": "Période d'astreinte, sur le mois de paie de son début"
      },
      "PublicApiPayrollVariableOnCallCompensation": {
        "type": "object",
        "properties": {
          "mode": {
            "type": "string",
            "const": "FIXED_PER_UNIT",
            "description": "Montant fixe par unité"
          },
          "unit": {
            "$ref": "#/components/schemas/OnCallUnit",
            "description": "Unité indemnisée : la période entière ou l'heure"
          },
          "amount": {
            "type": "number",
            "description": "Montant brut par unité, en euros"
          }
        },
        "required": [
          "mode",
          "unit",
          "amount"
        ],
        "additionalProperties": false,
        "description": "Contrepartie d'un type d'astreinte, copiée sur la période à sa saisie"
      },
      "OnCallUnit": {
        "type": "string",
        "enum": [
          "PERIOD",
          "HOUR"
        ]
      },
      "PublicApiPayrollVariableOnCallIntervention": {
        "type": "object",
        "properties": {
          "start": {
            "type": "string",
            "description": "Début, heure légale française `YYYY-MM-DDTHH:mm`, temps de déplacement compris"
          },
          "end": {
            "type": "string",
            "description": "Fin, heure légale française `YYYY-MM-DDTHH:mm`"
          },
          "location": {
            "$ref": "#/components/schemas/OnCallInterventionLocation",
            "description": "Intervention à distance ou sur site"
          },
          "dayCount": {
            "$ref": "#/components/schemas/OnCallDayCount",
            "description": "Décompte au forfait jours, absent pour un contrat en heures où l'intervention est payée en heures supplémentaires"
          },
          "compensationMode": {
            "$ref": "#/components/schemas/TimesheetCompensationMode",
            "description": "Contrat en heures : `REST` quand l'intervention est compensée en repos (compteur RCR, majoration comprise) au lieu d'être payée"
          }
        },
        "required": [
          "start",
          "end",
          "location"
        ],
        "additionalProperties": false,
        "description": "Intervention pendant une période d'astreinte"
      },
      "OnCallInterventionLocation": {
        "type": "string",
        "enum": [
          "REMOTE",
          "ON_SITE"
        ]
      },
      "OnCallDayCount": {
        "type": "string",
        "enum": [
          "NONE",
          "HALF_DAY",
          "FULL_DAY"
        ]
      },
      "TimesheetCompensationMode": {
        "type": "string",
        "enum": [
          "PAYMENT",
          "REST"
        ]
      },
      "PublicApiPayrollVariableExpenseNoteData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "TAX_FREE_INDEMNITY",
            "description": "Indemnité non soumise à cotisations"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "amountTotal": {
            "type": "number",
            "description": "Montant TTC de la dépense, en euros"
          },
          "amountReimbursed": {
            "type": "number",
            "description": "Montant remboursé au salarié, en euros"
          },
          "indemnityType": {
            "type": "string",
            "const": "EXPENSE_NOTE",
            "description": "Note de frais"
          },
          "expenseDate": {
            "type": "string",
            "format": "date",
            "description": "Date de la dépense"
          },
          "expenseType": {
            "$ref": "#/components/schemas/ExpenseNoteType",
            "description": "Nature de la dépense"
          },
          "vatAmounts": {
            "$ref": "#/components/schemas/PublicApiPayrollVariableVatAmounts",
            "description": "Montants de TVA de la dépense"
          },
          "kilometric": {
            "$ref": "#/components/schemas/PublicApiPayrollVariableKilometricData",
            "description": "Trajet des indemnités kilométriques"
          }
        },
        "required": [
          "type",
          "name",
          "amountTotal",
          "amountReimbursed",
          "indemnityType",
          "expenseDate",
          "expenseType",
          "vatAmounts"
        ],
        "additionalProperties": false,
        "description": "Note de frais, remboursée hors cotisations"
      },
      "ExpenseNoteType": {
        "type": "string",
        "enum": [
          "HOTEL_LOGEMENT",
          "MEALS",
          "KILOMETRIC_INDEMNITIES",
          "TRANSPORT",
          "EQUIPMENT",
          "SERVICES",
          "OTHER"
        ]
      },
      "PublicApiPayrollVariableVatAmounts": {
        "type": "object",
        "properties": {
          "vatAmount2_1": {
            "type": "number",
            "description": "TVA à 2,1 %"
          },
          "vatAmount5_5": {
            "type": "number",
            "description": "TVA à 5,5 %"
          },
          "vatAmount10": {
            "type": "number",
            "description": "TVA à 10 %"
          },
          "vatAmount20": {
            "type": "number",
            "description": "TVA à 20 %"
          }
        },
        "required": [
          "vatAmount2_1",
          "vatAmount5_5",
          "vatAmount10",
          "vatAmount20"
        ],
        "additionalProperties": false,
        "description": "Montants de TVA d'une note de frais, par taux, en euros"
      },
      "PublicApiPayrollVariableKilometricData": {
        "type": "object",
        "properties": {
          "vehicleCategory": {
            "$ref": "#/components/schemas/MileageAllowanceVehicleCategory",
            "description": "Catégorie du véhicule"
          },
          "energyType": {
            "$ref": "#/components/schemas/MileageAllowanceEnergyType",
            "description": "Énergie du véhicule"
          },
          "fiscalPower": {
            "type": [
              "number",
              "null"
            ],
            "description": "Puissance fiscale du véhicule, en chevaux fiscaux"
          },
          "departureAddress": {
            "type": "string",
            "description": "Adresse de départ"
          },
          "arrivalAddress": {
            "type": "string",
            "description": "Adresse d'arrivée"
          },
          "distance": {
            "type": "number",
            "description": "Distance du trajet, en kilomètres"
          },
          "isRoundTrip": {
            "type": "boolean",
            "description": "Aller-retour : la distance compte deux fois"
          }
        },
        "required": [
          "vehicleCategory",
          "energyType",
          "fiscalPower",
          "departureAddress",
          "arrivalAddress",
          "distance",
          "isRoundTrip"
        ],
        "additionalProperties": false,
        "description": "Trajet d'une note de frais d'indemnités kilométriques, valorisé au barème fiscal de l'année de la dépense"
      },
      "MileageAllowanceVehicleCategory": {
        "type": "string",
        "enum": [
          "CAR",
          "MOTORCYCLE",
          "SCOOTER"
        ]
      },
      "MileageAllowanceEnergyType": {
        "type": "string",
        "enum": [
          "THERMIC_HYDROGEN_HYBRID",
          "ELECTRIC"
        ]
      },
      "PublicApiPayrollVariablePersonalTransportData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "TAX_FREE_INDEMNITY",
            "description": "Indemnité non soumise à cotisations"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "amountTotal": {
            "type": "number",
            "description": "Montant total des frais, en euros"
          },
          "amountReimbursed": {
            "type": "number",
            "description": "Montant pris en charge par l'employeur, en euros"
          },
          "indemnityType": {
            "type": "string",
            "const": "PERSONAL_TRANSPORT",
            "description": "Transport personnel"
          },
          "personalTransportType": {
            "$ref": "#/components/schemas/PersonalTransportType",
            "description": "Forfait mobilités durables ou prime de transport"
          },
          "primeTransportType": {
            "$ref": "#/components/schemas/PrimeTransportType",
            "description": "Nature de la prime de transport, présente quand `personalTransportType` vaut `PRIME_TRANSPORT`"
          },
          "fmdTransportType": {
            "$ref": "#/components/schemas/FmdTransportType",
            "description": "Mode de transport du forfait, présent quand `personalTransportType` vaut `FORFAIT_MOBILITES_DURABLES`"
          }
        },
        "required": [
          "type",
          "name",
          "amountTotal",
          "amountReimbursed",
          "indemnityType",
          "personalTransportType"
        ],
        "additionalProperties": false,
        "description": "Frais de transport personnel : forfait mobilités durables ou prime de transport"
      },
      "PersonalTransportType": {
        "type": "string",
        "enum": [
          "FORFAIT_MOBILITES_DURABLES",
          "PRIME_TRANSPORT"
        ]
      },
      "PrimeTransportType": {
        "type": "string",
        "enum": [
          "FUEL",
          "ELECTRIC_VEHICLE_CHARGING"
        ]
      },
      "FmdTransportType": {
        "type": "string",
        "enum": [
          "PERSONAL_BIKE",
          "CARPOOLING",
          "RENTED_OR_SHARED_VEHICLES",
          "LOW_EMISSION_CAR_SHARING",
          "MOTORIZED_PERSONAL_TRANSPORT_DEVICES",
          "PUBLIC_TRANSPORT_WITHOUT_SUBSCRIPTION"
        ]
      },
      "PublicApiPayrollVariableOtherTaxFreeIndemnityData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "TAX_FREE_INDEMNITY",
            "description": "Indemnité non soumise à cotisations"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "amountTotal": {
            "type": "number",
            "description": "Montant total des frais, en euros"
          },
          "amountReimbursed": {
            "type": "number",
            "description": "Montant pris en charge par l'employeur, en euros"
          },
          "indemnityType": {
            "type": "string",
            "enum": [
              "PUBLIC_TRANSPORT",
              "PERSONAL_TRANSPORT",
              "SPORT_SUBSCRIPTION",
              "OTHER"
            ],
            "description": "Nature de l'indemnité"
          },
          "titleType": {
            "$ref": "#/components/schemas/TransportTitleType",
            "description": "Titre de transport public, qui fixe le taux de prise en charge de l'employeur"
          },
          "periodicity": {
            "$ref": "#/components/schemas/TaxFreeIndemnityPeriodicity",
            "description": "Mensuelle sur une variable de paie : un abonnement annuel est une variable récurrente"
          },
          "startMonth": {
            "type": "string",
            "description": "Premier mois d'un abonnement annuel, `YYYY-MM`"
          }
        },
        "required": [
          "type",
          "name",
          "amountTotal",
          "amountReimbursed",
          "indemnityType"
        ],
        "additionalProperties": false,
        "description": "Autre indemnité non soumise : transport public, abonnement sport ou autre"
      },
      "TransportTitleType": {
        "type": "string",
        "enum": [
          "NAVIGO",
          "IMAGINE_R",
          "VELIB",
          "TER_SNCF",
          "OTHER"
        ]
      },
      "TaxFreeIndemnityPeriodicity": {
        "type": "string",
        "enum": [
          "MONTHLY",
          "ANNUAL"
        ]
      },
      "PublicApiFileReference": {
        "type": "object",
        "properties": {
          "documentId": {
            "type": "string",
            "description": "Identifiant Puncto du document",
            "examples": [
              "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "displayFileName": {
            "type": "string",
            "description": "Nom du document affiché dans Puncto"
          },
          "fileType": {
            "$ref": "#/components/schemas/FileType",
            "description": "Type de document"
          },
          "mimeType": {
            "$ref": "#/components/schemas/FileMimeType",
            "description": "Type MIME du fichier"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date d'enregistrement du document dans Puncto"
          }
        },
        "required": [
          "documentId",
          "displayFileName",
          "fileType",
          "mimeType",
          "createdAt"
        ],
        "additionalProperties": false,
        "description": "Document stocké dans Puncto, tel que les autres ressources de l'API publique le référencent (justificatifs, pièces jointes...). Son contenu se télécharge avec `GET /public/v1/documents/{documentId}/download`."
      },
      "PublicApiPayrollVariableOrigin": {
        "type": "string",
        "enum": [
          "ENTRY",
          "VARIABLE_BATCH",
          "TIMESHEET",
          "ON_CALL_PERIOD",
          "PROFIT_SHARING",
          "HOLIDAY_BONUS",
          "HOLIDAY_VOUCHER_ATTRIBUTION",
          "VALUE_SHARING_BONUS",
          "PREVOYANCE_IJ_SLIP"
        ]
      },
      "PublicApiPayrollVariable": {
        "type": "object",
        "properties": {
          "payrollVariableId": {
            "type": "string",
            "description": "Identifiant Puncto de la variable de paie",
            "examples": [
              "pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "foreignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant de la variable dans votre système, null si elle n'en a pas"
          },
          "contractId": {
            "type": "string",
            "description": "Contrat qui porte la variable",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Collaborateur titulaire du contrat",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "year": {
            "type": "number",
            "description": "Année du mois de paie"
          },
          "month": {
            "type": "number",
            "description": "Mois de paie, de 1 (janvier) à 12"
          },
          "status": {
            "$ref": "#/components/schemas/PayrollVariableStatus",
            "description": "Seules les variables `VALIDATED` entrent dans le bulletin"
          },
          "data": {
            "$ref": "#/components/schemas/PublicApiPayrollVariableData",
            "description": "Contenu de la variable"
          },
          "proofFiles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiFileReference"
            },
            "description": "Justificatifs, dans leur ordre d'ajout"
          },
          "businessMealParticipantContractIds": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Identifiant Puncto",
              "examples": [
                "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
              ]
            },
            "description": "Note de frais de repas d'affaires : contrats des participants, dont les titres restaurant du mois sont réduits dès l'enregistrement de la note, quel que soit son statut"
          },
          "origin": {
            "$ref": "#/components/schemas/PublicApiPayrollVariableOrigin",
            "description": "Parcours de Puncto qui a créé la variable :\n- `ENTRY` : saisie dans Puncto ou importée par l'API ; aussi les indemnités générées par la clôture d'un contrat (celles du mois du solde de tout compte se modifient depuis la clôture) et le report d'un net négatif, généré à la clôture du mois sur le mois suivant (retenue `LAST_MONTH_NEGATIVE_PAY_ADVANCE`) ;\n- `VARIABLE_BATCH` : import d'un fichier de variables dans Puncto, modifiable comme une saisie ;\n- `TIMESHEET` : heures supplémentaires payées d'une feuille de temps validée, modifiables seulement depuis la feuille ;\n- `ON_CALL_PERIOD` : période d'astreinte, modifiable par l'import des périodes d'astreinte ;\n- `PROFIT_SHARING` : versement d'intéressement, modifiable seulement depuis ce versement ;\n- `HOLIDAY_BONUS`, `HOLIDAY_VOUCHER_ATTRIBUTION` : prime de vacances ou chèques-vacances de la page Primes, modifiables seulement depuis cette page ;\n- `VALUE_SHARING_BONUS` : versement de prime de partage de la valeur (PPV) de la page Primes ; comme dans l'application, la variable peut changer de statut ou être supprimée ;\n- `PREVOYANCE_IJ_SLIP` : part d'un bordereau de paiement prévoyance, modifiable seulement depuis ce bordereau."
          },
          "isLocked": {
            "type": "boolean",
            "description": "Plus aucune modification n'est possible : le mois de paie est clôturé et aucune paie ouverte ne peut porter la régularisation (`lockState.state` vaut `BLOCKED`)"
          },
          "lockState": {
            "$ref": "#/components/schemas/ApiInputLockState",
            "description": "Effet d'une modification de la variable : sur la paie du mois, ou en saisie tardive régularisée par une paie ultérieure"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création de la variable"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification de la variable"
          }
        },
        "required": [
          "payrollVariableId",
          "foreignErpId",
          "contractId",
          "collaboratorId",
          "collaboratorForeignErpId",
          "year",
          "month",
          "status",
          "data",
          "proofFiles",
          "businessMealParticipantContractIds",
          "origin",
          "isLocked",
          "lockState",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Variable de paie mensuelle d'un contrat. Les échéanciers (abonnements annuels de transport, primes et avantages récurrents) ne sont pas des variables mensuelles : ils se lisent avec `GET /public/v1/recurring-variables`."
      },
      "PublicApiTrialPeriodRenewal": {
        "type": "object",
        "properties": {
          "isPossible": {
            "type": "boolean",
            "description": "La période d'essai peut être renouvelée maintenant"
          },
          "refusalReason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Raison pour laquelle le renouvellement est impossible, en français ; null s'il est possible"
          },
          "maxEndDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fin nominale la plus tardive du renouvellement, et sa valeur par défaut : même durée que la période initiale, comptée à partir du lendemain de la fin actuelle. Null si le renouvellement est impossible."
          },
          "projectedEndDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fin du renouvellement à `maxEndDate`, prolongée des absences validées déjà connues pendant le renouvellement. Null si le renouvellement est impossible."
          }
        },
        "required": [
          "isPossible",
          "refusalReason",
          "maxEndDate",
          "projectedEndDate"
        ],
        "additionalProperties": false,
        "description": "Renouvellement de la période d'essai : possible ou non, et jusqu'à quelle date."
      },
      "PublicApiContractTrialPeriodState": {
        "type": "object",
        "properties": {
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto du contrat",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto du collaborateur",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "workerType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkerType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Type de contrat, null pour un contrat en cours de création"
          },
          "contractStartDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de début du contrat, null pour un contrat en cours de création"
          },
          "trialPeriods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiContractTrialPeriod"
            },
            "description": "Périodes d'essai du contrat (initiale puis renouvellement), par date de fin croissante ; vide sans période d'essai"
          },
          "endDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fin effective de la période d'essai : celle de la dernière période, prolongée des absences ou avancée par une validation anticipée. Null sans période d'essai."
          },
          "validationDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de la validation anticipée de la dernière période, null si elle n'a pas été validée"
          },
          "isRenewed": {
            "type": "boolean",
            "description": "La période d'essai a été renouvelée"
          },
          "isOver": {
            "type": "boolean",
            "description": "La période d'essai est terminée : `endDate` est passée (jour calendaire de Paris)"
          },
          "renewal": {
            "$ref": "#/components/schemas/PublicApiTrialPeriodRenewal",
            "description": "Renouvellement de la période d'essai"
          }
        },
        "required": [
          "contractId",
          "collaboratorId",
          "collaboratorForeignErpId",
          "workerType",
          "contractStartDate",
          "trialPeriods",
          "endDate",
          "validationDate",
          "isRenewed",
          "isOver",
          "renewal"
        ],
        "additionalProperties": false,
        "description": "Période d'essai d'un contrat : la période initiale et son éventuel renouvellement, leur fin effective, et la possibilité de la renouveler."
      },
      "PublicApiDocument": {
        "type": "object",
        "properties": {
          "documentId": {
            "type": "string",
            "description": "Identifiant Puncto du document",
            "examples": [
              "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "foreignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du document dans votre système, renseigné à l'envoi par l'API ; null sinon"
          },
          "displayFileName": {
            "type": "string",
            "description": "Nom du document affiché dans Puncto"
          },
          "fileName": {
            "type": "string",
            "description": "Nom du fichier téléchargé, extension comprise : le nom du document, suivi de l'extension du fichier s'il ne se termine pas déjà par une extension"
          },
          "fileType": {
            "$ref": "#/components/schemas/FileType",
            "description": "Type de document"
          },
          "mimeType": {
            "$ref": "#/components/schemas/FileMimeType",
            "description": "Type MIME du fichier, `application/octet-stream` pour un format que Puncto ne connaît pas (docx, xlsx...)"
          },
          "collaboratorId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Collaborateur concerné, null pour un document de l'entreprise"
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné ou sans collaborateur"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date d'enregistrement du document dans Puncto"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de la dernière modification, par exemple le remplacement du fichier par un nouvel envoi"
          }
        },
        "required": [
          "documentId",
          "foreignErpId",
          "displayFileName",
          "fileName",
          "fileType",
          "mimeType",
          "collaboratorId",
          "collaboratorForeignErpId",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Document de l'entreprise tel que l'API publique l'expose : document envoyé par l'API ou dans Puncto (contrat signé, convention de stage...), ou généré par Puncto (bulletins, documents de fin de contrat, DPAE, DSN, documents comptables...). Son contenu se télécharge avec `GET /public/v1/documents/{documentId}/download`."
      },
      "PublicApiCompanyYearEffectif": {
        "type": "object",
        "properties": {
          "year": {
            "type": "number",
            "description": "Année"
          },
          "effectif": {
            "type": "number",
            "description": "Effectif moyen de l'année"
          }
        },
        "required": [
          "year",
          "effectif"
        ],
        "additionalProperties": false,
        "description": "Effectif moyen annuel de l'entreprise (art. L130-1 CSS), tel que calculé par l'Urssaf"
      },
      "PublicApiCompanyModules": {
        "type": "object",
        "properties": {
          "isForfaitJourDeclarationEnabled": {
            "type": "boolean",
            "description": "Relevés mensuels de suivi du forfait jours"
          },
          "isSportSubscriptionEnabled": {
            "type": "boolean",
            "description": "Prise en charge des abonnements sportifs"
          },
          "isRemoteWorkEnabled": {
            "type": "boolean",
            "description": "Déclaration des jours de télétravail par les collaborateurs"
          },
          "isTimesheetEnabled": {
            "type": "boolean",
            "description": "Feuilles de temps hebdomadaires"
          },
          "isProfitSharingEnabled": {
            "type": "boolean",
            "description": "Intéressement"
          },
          "isOnCallEnabled": {
            "type": "boolean",
            "description": "Astreintes"
          }
        },
        "required": [
          "isForfaitJourDeclarationEnabled",
          "isSportSubscriptionEnabled",
          "isRemoteWorkEnabled",
          "isTimesheetEnabled",
          "isProfitSharingEnabled",
          "isOnCallEnabled"
        ],
        "additionalProperties": false,
        "description": "Modules optionnels de Puncto activés pour l'entreprise"
      },
      "PublicApiCompanyPayrollRules": {
        "type": "object",
        "properties": {
          "validFrom": {
            "type": "string",
            "format": "date",
            "description": "Date d'entrée en vigueur de ces règles"
          },
          "solidarityDayAsMandatoryHoliday": {
            "type": "boolean",
            "description": "Forfaits jours : la journée de solidarité est obligatoirement chômée"
          },
          "isJei": {
            "type": "boolean",
            "description": "L'entreprise a le statut de Jeune Entreprise Innovante"
          },
          "uncappedPaternityComplement": {
            "type": "boolean",
            "description": "Le complément employeur du congé de paternité est versé sans les plafonds Syntec : salaire maintenu comme pour un arrêt maladie, sous déduction des IJSS"
          },
          "ptoEndOfPeriod": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DateWithoutYear"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dernier jour de la période de référence des congés payés, null pour le 31 mai"
          },
          "jntEndOfPeriod": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DateWithoutYear"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dernier jour de la période des jours non travaillés (forfait jours), null pour le 31 décembre"
          },
          "jrttSettings": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicApiCompanyJrttSettings"
              },
              {
                "type": "null"
              }
            ],
            "description": "Acquisition de JRTT, null quand l'entreprise n'en attribue pas"
          },
          "overtimeMajorationRates": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PublicApiCompanyOvertimeMajorationRate"
                }
              },
              {
                "type": "null"
              }
            ],
            "description": "Taux de majoration des heures supplémentaires de l'entreprise, null pour les taux légaux"
          },
          "forfaitHeureAgreement": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicApiCompanyForfaitHeureAgreement"
              },
              {
                "type": "null"
              }
            ],
            "description": "Accord de forfait en heures, null pour les conditions de la modalité 2 Syntec"
          }
        },
        "required": [
          "validFrom",
          "solidarityDayAsMandatoryHoliday",
          "isJei",
          "uncappedPaternityComplement",
          "ptoEndOfPeriod",
          "jntEndOfPeriod",
          "jrttSettings",
          "overtimeMajorationRates",
          "forfaitHeureAgreement"
        ],
        "additionalProperties": false,
        "description": "Règles de paie de l'entreprise en vigueur à la fin du mois courant"
      },
      "DateWithoutYear": {
        "type": "object",
        "properties": {
          "month": {
            "type": "number"
          },
          "day": {
            "type": "number"
          }
        },
        "required": [
          "month",
          "day"
        ],
        "additionalProperties": false
      },
      "PublicApiCompanyJrttSettings": {
        "type": "object",
        "properties": {
          "method": {
            "type": "string",
            "const": "MANUAL",
            "description": "Mode de calcul : `MANUAL`, un nombre de jours fixé par heure supplémentaire contractuelle"
          },
          "accrualTiming": {
            "type": "string",
            "const": "MONTHLY",
            "description": "Rythme d'acquisition : `MONTHLY`, un douzième chaque mois complet"
          },
          "amountPerHour": {
            "type": "number",
            "description": "Jours de JRTT acquis par an pour chaque heure supplémentaire contractuelle compensée en RTT"
          }
        },
        "required": [
          "method",
          "accrualTiming",
          "amountPerHour"
        ],
        "additionalProperties": false,
        "description": "Acquisition de jours de réduction du temps de travail (JRTT)"
      },
      "PublicApiCompanyOvertimeMajorationRate": {
        "type": "object",
        "properties": {
          "rate": {
            "type": "number",
            "description": "Taux de majoration, en %"
          },
          "fromHour": {
            "type": "number",
            "description": "Première heure de la semaine concernée (numéro d'heure dans la semaine, incluse)"
          },
          "toHour": {
            "type": [
              "number",
              "null"
            ],
            "description": "Dernière heure de la semaine concernée (incluse), null pour une tranche sans limite"
          }
        },
        "required": [
          "rate",
          "fromHour",
          "toHour"
        ],
        "additionalProperties": false,
        "description": "Tranche de majoration des heures supplémentaires"
      },
      "PublicApiCompanyForfaitHeureAgreement": {
        "type": "object",
        "properties": {
          "allowNonCadre": {
            "type": "boolean",
            "description": "Le forfait en heures est ouvert aux ETAM"
          },
          "requiresAnnualSocialSecurityCeiling": {
            "type": "boolean",
            "description": "La rémunération annuelle doit atteindre au moins le plafond annuel de la Sécurité sociale"
          },
          "minimumConventionalSalaryRatio": {
            "type": "number",
            "description": "Rémunération minimale, en multiple du minimum conventionnel de la position (1,15 en modalité 2)"
          }
        },
        "required": [
          "allowNonCadre",
          "requiresAnnualSocialSecurityCeiling",
          "minimumConventionalSalaryRatio"
        ],
        "additionalProperties": false,
        "description": "Accord d'entreprise ouvrant le forfait annuel en heures au-delà de la modalité 2 Syntec"
      },
      "PublicApiCompany": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "string",
            "description": "Identifiant Puncto de l'entreprise",
            "examples": [
              "comp_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "name": {
            "type": "string",
            "description": "Raison sociale"
          },
          "siren": {
            "type": "string",
            "description": "SIREN"
          },
          "apenCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Code APE (NAF) de l'entreprise"
          },
          "codeCcn": {
            "type": "string",
            "description": "IDCC de la convention collective : `1486`, Syntec"
          },
          "companyCreationDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de création de l'entreprise"
          },
          "mainEstablishmentId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Établissement siège, null tant que l'entreprise n'est pas configurée"
          },
          "effectifs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiCompanyYearEffectif"
            },
            "description": "Effectifs moyens annuels, de l'année la plus récente à la plus ancienne"
          },
          "modules": {
            "$ref": "#/components/schemas/PublicApiCompanyModules",
            "description": "Modules optionnels activés"
          },
          "payrollRules": {
            "$ref": "#/components/schemas/PublicApiCompanyPayrollRules",
            "description": "Règles de paie en vigueur"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date d'enregistrement de l'entreprise dans Puncto"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification de l'entreprise"
          }
        },
        "required": [
          "companyId",
          "name",
          "siren",
          "apenCode",
          "codeCcn",
          "companyCreationDate",
          "mainEstablishmentId",
          "effectifs",
          "modules",
          "payrollRules",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "L'entreprise de la clé d'API : identité, effectifs, modules activés et règles de paie"
      },
      "PublicApiEstablishment": {
        "type": "object",
        "properties": {
          "establishmentId": {
            "type": "string",
            "description": "Identifiant Puncto de l'établissement",
            "examples": [
              "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "name": {
            "type": "string",
            "description": "Nom de l'établissement"
          },
          "nic": {
            "type": "string",
            "description": "NIC : les 5 derniers chiffres du SIRET"
          },
          "siret": {
            "type": "string",
            "description": "SIRET : SIREN de l'entreprise suivi du NIC"
          },
          "apetCode": {
            "type": "string",
            "description": "Code APET de l'établissement"
          },
          "urssafCode": {
            "type": "string",
            "description": "Code Urssaf de l'établissement"
          },
          "healthServiceCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Code du service de santé au travail, déclaré dans les DPAE"
          },
          "address": {
            "$ref": "#/components/schemas/ApiAddress",
            "description": "Adresse de l'établissement"
          },
          "isMain": {
            "type": "boolean",
            "description": "Établissement siège de l'entreprise"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date d'enregistrement de l'établissement dans Puncto"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification de l'établissement"
          }
        },
        "required": [
          "establishmentId",
          "name",
          "nic",
          "siret",
          "apetCode",
          "urssafCode",
          "healthServiceCode",
          "address",
          "isMain",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Établissement de l'entreprise"
      },
      "PublicApiCompanyRole": {
        "type": "object",
        "properties": {
          "companyRoleId": {
            "type": "string",
            "description": "Identifiant Puncto du poste",
            "examples": [
              "crol_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "name": {
            "type": "string",
            "description": "Intitulé du poste"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Description du poste"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création du poste dans Puncto"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification du poste"
          }
        },
        "required": [
          "companyRoleId",
          "name",
          "description",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Poste du référentiel de l'entreprise, porté par les avenants des contrats"
      },
      "PublicApiCompanyTeam": {
        "type": "object",
        "properties": {
          "companyTeamId": {
            "type": "string",
            "description": "Identifiant Puncto de l'équipe",
            "examples": [
              "ctea_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "name": {
            "type": "string",
            "description": "Nom de l'équipe"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Description de l'équipe"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création de l'équipe dans Puncto"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification de l'équipe"
          }
        },
        "required": [
          "companyTeamId",
          "name",
          "description",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Équipe du référentiel de l'entreprise, portée par les avenants des contrats"
      },
      "OcContractTarget": {
        "type": "string",
        "enum": [
          "CADRE",
          "NON_CADRE",
          "ALL"
        ]
      },
      "PublicApiOcContractVersion": {
        "type": "object",
        "properties": {
          "renewalId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "ocre_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Identifiant Puncto du renouvellement, null pour la version initiale du contrat"
          },
          "status": {
            "$ref": "#/components/schemas/OcContractVersionStatus",
            "description": "Version en cours, à venir ou terminée"
          },
          "startDate": {
            "type": "string",
            "format": "date",
            "description": "Date de début de la version"
          },
          "endDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de fin de la version, null si elle n'a pas de fin prévue"
          },
          "organismCode": {
            "type": "string",
            "description": "Code de l'organisme assureur (S21.G00.15.002)"
          },
          "delegationCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Code de l'organisme délégataire de gestion (S21.G00.15.003)"
          },
          "populationCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Code population du contrat (S21.G00.70.005)"
          },
          "cotisationType": {
            "type": "string",
            "enum": [
              "FORFAIT",
              "TRANCHES"
            ],
            "description": "Mode de cotisation : `FORFAIT` (mutuelle au forfait) ou `TRANCHES` (prévoyance par tranches)"
          },
          "periodicity": {
            "$ref": "#/components/schemas/OcPeriodicity",
            "description": "Périodicité de la cotisation"
          },
          "prorationMode": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/OcProrationMode"
              },
              {
                "type": "null"
              }
            ],
            "description": "Proratisation de la cotisation en cas d'entrée ou de sortie en cours de mois, null par tranches"
          },
          "forfaitChoices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiOcForfaitChoice"
            },
            "description": "Formules proposées au salarié, vide pour une cotisation par tranches"
          },
          "tranches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiOcTranche"
            },
            "description": "Tranches cotisées, vide pour une cotisation au forfait"
          }
        },
        "required": [
          "renewalId",
          "status",
          "startDate",
          "endDate",
          "organismCode",
          "delegationCode",
          "populationCode",
          "cotisationType",
          "periodicity",
          "prorationMode",
          "forfaitChoices",
          "tranches"
        ],
        "additionalProperties": false,
        "description": "Version d'un contrat de mutuelle ou de prévoyance : le contrat initial ou un renouvellement"
      },
      "OcContractVersionStatus": {
        "type": "string",
        "enum": [
          "ACTIVE",
          "FUTURE",
          "PAST"
        ]
      },
      "OcPeriodicity": {
        "type": "string",
        "enum": [
          "Mensuel",
          "Trimestriel"
        ]
      },
      "OcProrationMode": {
        "type": "string",
        "enum": [
          "JOURS_REELS",
          "TRENTIEME",
          "AUCUNE"
        ]
      },
      "PublicApiOcForfaitChoice": {
        "type": "object",
        "properties": {
          "affiliationChoice": {
            "type": "string",
            "description": "Code de la formule, à passer en `mutuelleForfaitChoice` à la création d'un contrat de travail : `UNIQUE`, `OPTION_<code>`, `CONDITION_<code>` ou, quand plusieurs forfaits partagent une option, `TIER_<code>__<libellé>`"
          },
          "label": {
            "type": "string",
            "description": "Libellé de la formule"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mode de calcul de la cotisation, null pour un montant fixe (par exemple « 1,5 % du PMSS »)"
          },
          "monthlyAmount": {
            "type": "number",
            "description": "Cotisation mensuelle totale (part salariale et part patronale), en euros : au tarif du jour pour la version en cours, de son début pour une version à venir, de sa fin pour une version terminée"
          },
          "employerSharePercent": {
            "type": "number",
            "description": "Part patronale de la cotisation, en %"
          }
        },
        "required": [
          "affiliationChoice",
          "label",
          "description",
          "monthlyAmount",
          "employerSharePercent"
        ],
        "additionalProperties": false,
        "description": "Formule d'une mutuelle au forfait, que le salarié choisit à son affiliation"
      },
      "PublicApiOcTranche": {
        "type": "object",
        "properties": {
          "tranche": {
            "type": "string",
            "enum": [
              "TRANCHE_A",
              "TRANCHE_B",
              "TRANCHE_C"
            ],
            "description": "Tranche : `TRANCHE_A`, `TRANCHE_B` (tranche 2 en mode TA/T2U) ou `TRANCHE_C`"
          },
          "label": {
            "type": "string",
            "description": "Libellé de la tranche"
          },
          "totalRate": {
            "type": "number",
            "description": "Taux de cotisation total (part salariale et part patronale), en % du salaire de la tranche"
          },
          "employerSharePercent": {
            "type": "number",
            "description": "Part patronale de la cotisation, en %"
          }
        },
        "required": [
          "tranche",
          "label",
          "totalRate",
          "employerSharePercent"
        ],
        "additionalProperties": false,
        "description": "Tranche de salaire d'une prévoyance cotisant par tranches"
      },
      "PublicApiOcContract": {
        "type": "object",
        "properties": {
          "ocContractId": {
            "type": "string",
            "description": "Identifiant Puncto du contrat, à passer en `mutuelleOcContractId` ou `prevoyanceOcContractId` à la création d'un contrat de travail",
            "examples": [
              "ocon_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "label": {
            "type": "string",
            "description": "Libellé du contrat"
          },
          "type": {
            "$ref": "#/components/schemas/OcContractType",
            "description": "Mutuelle ou prévoyance"
          },
          "contractTarget": {
            "$ref": "#/components/schemas/OcContractTarget",
            "description": "Salariés couverts : cadres, non-cadres ou tous"
          },
          "contractReference": {
            "type": "string",
            "description": "Numéro du contrat chez l'organisme (S21.G00.15.001)"
          },
          "versions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiOcContractVersion"
            },
            "description": "Versions du contrat, de la plus récente à la plus ancienne"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date d'enregistrement du contrat dans Puncto"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification du contrat (hors renouvellements)"
          }
        },
        "required": [
          "ocContractId",
          "label",
          "type",
          "contractTarget",
          "contractReference",
          "versions",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Contrat de mutuelle ou de prévoyance souscrit par l'entreprise"
      },
      "PublicApiHolidaysBalanceCounters": {
        "type": "object",
        "properties": {
          "pto": {
            "$ref": "#/components/schemas/PublicApiHolidayCounter",
            "description": "Congés payés en cours d'acquisition (période N)"
          },
          "ptoN1": {
            "$ref": "#/components/schemas/PublicApiHolidayCounter",
            "description": "Congés payés acquis sur la période précédente (N-1)"
          },
          "ptoN2": {
            "$ref": "#/components/schemas/PublicApiHolidayCounter",
            "description": "Congés payés acquis il y a deux périodes (N-2)"
          },
          "seniority": {
            "$ref": "#/components/schemas/PublicApiHolidayCounter",
            "description": "Congés d'ancienneté"
          },
          "splitDays": {
            "$ref": "#/components/schemas/PublicApiHolidayCounter",
            "description": "Jours de fractionnement"
          },
          "jnt": {
            "$ref": "#/components/schemas/PublicApiHolidayCounter",
            "description": "Jours non travaillés des forfaits jours (JNT)"
          },
          "rtt": {
            "$ref": "#/components/schemas/PublicApiHolidayCounter",
            "description": "Jours de réduction du temps de travail (RTT)"
          },
          "cor": {
            "$ref": "#/components/schemas/PublicApiHolidayCounter",
            "description": "Contrepartie obligatoire en repos (COR)"
          },
          "rcr": {
            "$ref": "#/components/schemas/PublicApiHolidayCounter",
            "description": "Repos compensateur de remplacement (RCR)"
          },
          "internshipPto": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicApiHolidayCounter"
              },
              {
                "type": "null"
              }
            ],
            "description": "Congés payés d'un stage, null tant qu'aucun jour n'est acquis ni pris"
          }
        },
        "required": [
          "pto",
          "ptoN1",
          "ptoN2",
          "seniority",
          "splitDays",
          "jnt",
          "rtt",
          "cor",
          "rcr",
          "internshipPto"
        ],
        "additionalProperties": false,
        "description": "Compteurs de congés d'un contrat à la date de calcul ; un compteur que le contrat n'acquiert pas vaut 0 jour acquis et 0 jour pris"
      },
      "PublicApiHolidayCounter": {
        "type": "object",
        "properties": {
          "earned": {
            "type": "number",
            "description": "Jours acquis"
          },
          "used": {
            "type": "number",
            "description": "Jours pris"
          }
        },
        "required": [
          "earned",
          "used"
        ],
        "additionalProperties": false,
        "description": "Compteur de congés sur sa période"
      },
      "PublicApiHolidaysBalancePeriods": {
        "type": "object",
        "properties": {
          "pto": {
            "$ref": "#/components/schemas/PublicApiHolidaysBalancePeriod",
            "description": "Période des congés payés en cours d'acquisition (N)"
          },
          "ptoN1": {
            "$ref": "#/components/schemas/PublicApiHolidaysBalancePeriod",
            "description": "Période des congés payés N-1"
          },
          "ptoN2": {
            "$ref": "#/components/schemas/PublicApiHolidaysBalancePeriod",
            "description": "Période des congés payés N-2"
          },
          "seniority": {
            "$ref": "#/components/schemas/PublicApiHolidaysBalancePeriod",
            "description": "Période des congés d'ancienneté"
          },
          "splitDays": {
            "$ref": "#/components/schemas/PublicApiHolidaysBalancePeriod",
            "description": "Période des jours de fractionnement"
          },
          "jnt": {
            "$ref": "#/components/schemas/PublicApiHolidaysBalancePeriod",
            "description": "Période des jours non travaillés (forfait jours)"
          }
        },
        "required": [
          "pto",
          "ptoN1",
          "ptoN2",
          "seniority",
          "splitDays",
          "jnt"
        ],
        "additionalProperties": false,
        "description": "Périodes de référence des compteurs, selon les règles de paie de l'entreprise à la date de calcul"
      },
      "PublicApiHolidaysBalancePeriod": {
        "type": "object",
        "properties": {
          "startDate": {
            "type": "string",
            "format": "date",
            "description": "Premier jour de la période"
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Dernier jour de la période"
          }
        },
        "required": [
          "startDate",
          "endDate"
        ],
        "additionalProperties": false,
        "description": "Période d'un compteur de congés"
      },
      "PublicApiHolidaysBalance": {
        "type": "object",
        "properties": {
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto du contrat",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto du collaborateur",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "calculationDate": {
            "type": "string",
            "format": "date",
            "description": "Date à laquelle les soldes sont calculés"
          },
          "balance": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicApiHolidaysBalanceCounters"
              },
              {
                "type": "null"
              }
            ],
            "description": "Compteurs de congés, null quand ils ne peuvent pas être calculés (voir `unavailableReason`)"
          },
          "periods": {
            "$ref": "#/components/schemas/PublicApiHolidaysBalancePeriods",
            "description": "Périodes de référence des compteurs"
          },
          "unavailableReason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Raison pour laquelle `balance` vaut null, null sinon"
          }
        },
        "required": [
          "contractId",
          "collaboratorId",
          "collaboratorForeignErpId",
          "calculationDate",
          "balance",
          "periods",
          "unavailableReason"
        ],
        "additionalProperties": false,
        "description": "Soldes de congés d'un contrat, simulés à une date : les absences validées sont décomptées, les demandes en attente ne le sont pas. La simulation n'enregistre rien."
      },
      "RemoteWorkDayPeriod": {
        "type": "string",
        "enum": [
          "FULL",
          "MORNING",
          "AFTERNOON"
        ]
      },
      "PublicApiRemoteWorkDay": {
        "type": "object",
        "properties": {
          "remoteWorkDayId": {
            "type": "string",
            "description": "Identifiant Puncto du jour de télétravail",
            "examples": [
              "rwda_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto du collaborateur",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto du contrat",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Jour télétravaillé"
          },
          "period": {
            "$ref": "#/components/schemas/RemoteWorkDayPeriod",
            "description": "Journée complète, matin ou après-midi"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de la déclaration"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification de la déclaration"
          }
        },
        "required": [
          "remoteWorkDayId",
          "collaboratorId",
          "collaboratorForeignErpId",
          "contractId",
          "date",
          "period",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Jour de télétravail déclaré par un collaborateur"
      },
      "TimesheetStatus": {
        "type": "string",
        "enum": [
          "DRAFT",
          "TO_VALIDATE",
          "VALIDATED"
        ]
      },
      "PublicApiTimesheetDay": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Jour"
          },
          "kind": {
            "$ref": "#/components/schemas/TimesheetDayKind",
            "description": "Nature de la journée : travaillée, non travaillée, hors contrat, fériée ou absence"
          },
          "expectedMinutes": {
            "type": "number",
            "description": "Minutes prévues par le planning du contrat, 0 pour une journée non travaillée"
          },
          "expectedMorningMinutes": {
            "type": [
              "number",
              "null"
            ],
            "description": "Minutes prévues le matin, null sur les feuilles créées avant l'ajout de ce détail"
          },
          "expectedAfternoonMinutes": {
            "type": [
              "number",
              "null"
            ],
            "description": "Minutes prévues l'après-midi, null sur les feuilles créées avant l'ajout de ce détail"
          },
          "workedMinutes": {
            "type": "number",
            "description": "Minutes travaillées saisies"
          },
          "morning": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkScheduleTimeRange"
              },
              {
                "type": "null"
              }
            ],
            "description": "Plage travaillée le matin, null si le matin n'est pas travaillé"
          },
          "afternoon": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkScheduleTimeRange"
              },
              {
                "type": "null"
              }
            ],
            "description": "Plage travaillée l'après-midi, null si l'après-midi n'est pas travaillé"
          },
          "absenceType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AbsenceType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Type de l'absence du jour, null sans absence"
          },
          "absencePeriod": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TimesheetAbsencePeriod"
              },
              {
                "type": "null"
              }
            ],
            "description": "Partie de la journée couverte par l'absence, null sans absence"
          }
        },
        "required": [
          "date",
          "kind",
          "expectedMinutes",
          "expectedMorningMinutes",
          "expectedAfternoonMinutes",
          "workedMinutes",
          "morning",
          "afternoon",
          "absenceType",
          "absencePeriod"
        ],
        "additionalProperties": false,
        "description": "Journée d'une feuille de temps"
      },
      "TimesheetDayKind": {
        "type": "string",
        "enum": [
          "WORKED",
          "NOT_WORKED",
          "OUT_OF_CONTRACT",
          "PUBLIC_HOLIDAY",
          "ABSENCE"
        ]
      },
      "TimesheetAbsencePeriod": {
        "type": "string",
        "enum": [
          "FULL",
          "MORNING",
          "AFTERNOON"
        ]
      },
      "PublicApiTimesheet": {
        "type": "object",
        "properties": {
          "timesheetId": {
            "type": "string",
            "description": "Identifiant Puncto de la feuille de temps",
            "examples": [
              "tshe_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto du collaborateur",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto du contrat",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "weekStartDate": {
            "type": "string",
            "format": "date",
            "description": "Lundi de la semaine"
          },
          "year": {
            "type": "number",
            "description": "Année du mois de paie de rattachement : celui du dimanche de la semaine"
          },
          "month": {
            "type": "number",
            "description": "Mois de paie de rattachement (1-12) : celui du dimanche de la semaine"
          },
          "status": {
            "$ref": "#/components/schemas/TimesheetStatus",
            "description": "Brouillon, à valider ou validée"
          },
          "days": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiTimesheetDay"
            },
            "description": "Les sept jours de la semaine"
          },
          "contractWeeklyMinutes": {
            "type": "number",
            "description": "Durée hebdomadaire du contrat, en minutes"
          },
          "expectedMinutes": {
            "type": "number",
            "description": "Minutes prévues sur la semaine"
          },
          "workedMinutes": {
            "type": "number",
            "description": "Minutes travaillées sur la semaine"
          },
          "overtimeMinutes": {
            "type": "number",
            "description": "Minutes au-delà de la durée hebdomadaire du contrat"
          },
          "compensationMode": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TimesheetCompensationMode"
              },
              {
                "type": "null"
              }
            ],
            "description": "Compensation des heures supplémentaires choisie à la validation : paiement ou repos compensateur ; null avant la validation ou sans heures supplémentaires"
          },
          "restHours": {
            "type": [
              "number",
              "null"
            ],
            "description": "Heures de repos créditées (majoration comprise) quand `compensationMode` vaut `REST`"
          },
          "payrollVariableId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "pvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Variable de paie des heures supplémentaires payées, créée à la validation, null sinon"
          },
          "submittedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de soumission par le collaborateur"
          },
          "validatedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de validation"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création de la feuille de temps"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification de la feuille de temps"
          }
        },
        "required": [
          "timesheetId",
          "collaboratorId",
          "collaboratorForeignErpId",
          "contractId",
          "weekStartDate",
          "year",
          "month",
          "status",
          "days",
          "contractWeeklyMinutes",
          "expectedMinutes",
          "workedMinutes",
          "overtimeMinutes",
          "compensationMode",
          "restHours",
          "payrollVariableId",
          "submittedAt",
          "validatedAt",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Feuille de temps hebdomadaire d'un contrat en heures"
      },
      "ForfaitJourDeclarationStatus": {
        "type": "string",
        "enum": [
          "PENDING",
          "CONFORM",
          "ANOMALY"
        ]
      },
      "ForfaitJourDeclarationWorkloadStatus": {
        "type": "string",
        "enum": [
          "NORMAL",
          "HIGH",
          "OVERWORK"
        ]
      },
      "PublicApiForfaitJourDay": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Jour"
          },
          "morningDayType": {
            "$ref": "#/components/schemas/ForfaitJourDayType",
            "description": "Nature du matin"
          },
          "afternoonDayType": {
            "$ref": "#/components/schemas/ForfaitJourDayType",
            "description": "Nature de l'après-midi"
          }
        },
        "required": [
          "date",
          "morningDayType",
          "afternoonDayType"
        ],
        "additionalProperties": false,
        "description": "Demi-journées d'un jour du relevé forfait jours"
      },
      "ForfaitJourDayType": {
        "type": "string",
        "enum": [
          "JT",
          "JF",
          "CP",
          "JNT",
          "CSS",
          "MO",
          "AT",
          "MP",
          "ATJ",
          "FAM",
          "AN",
          "REP",
          "HC"
        ]
      },
      "PublicApiForfaitJourDeclaration": {
        "type": "object",
        "properties": {
          "forfaitJourDeclarationId": {
            "type": "string",
            "description": "Identifiant Puncto du relevé",
            "examples": [
              "fjde_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto du collaborateur",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto du contrat",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "year": {
            "type": "number",
            "description": "Année du relevé"
          },
          "month": {
            "type": "number",
            "description": "Mois du relevé (1-12)"
          },
          "status": {
            "$ref": "#/components/schemas/ForfaitJourDeclarationStatus",
            "description": "En attente, conforme ou anomalie"
          },
          "isCalendarAccurate": {
            "type": "boolean",
            "description": "Le collaborateur confirme que le calendrier du mois est exact"
          },
          "calendarComment": {
            "type": [
              "string",
              "null"
            ],
            "description": "Commentaire du collaborateur sur le calendrier"
          },
          "isRestRespected": {
            "type": "boolean",
            "description": "Le collaborateur confirme avoir respecté les temps de repos"
          },
          "restComment": {
            "type": [
              "string",
              "null"
            ],
            "description": "Commentaire du collaborateur sur les temps de repos"
          },
          "workloadStatus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ForfaitJourDeclarationWorkloadStatus"
              },
              {
                "type": "null"
              }
            ],
            "description": "Charge de travail ressentie, null avant la soumission"
          },
          "workloadComment": {
            "type": [
              "string",
              "null"
            ],
            "description": "Commentaire du collaborateur sur sa charge de travail"
          },
          "workedDaysCount": {
            "type": "number",
            "description": "Jours travaillés du mois"
          },
          "sickDaysCount": {
            "type": "number",
            "description": "Jours d'arrêt maladie du mois"
          },
          "unpaidDaysCount": {
            "type": "number",
            "description": "Jours de congé sans solde du mois"
          },
          "familyDaysCount": {
            "type": "number",
            "description": "Jours de congés familiaux du mois"
          },
          "parentalLeaveDaysCount": {
            "type": "number",
            "description": "Jours de congé parental du mois"
          },
          "days": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiForfaitJourDay"
            },
            "description": "Jours du mois, par demi-journée"
          },
          "submittedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de soumission par le collaborateur, null tant qu'il ne l'a pas soumis"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création du relevé"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification du relevé"
          }
        },
        "required": [
          "forfaitJourDeclarationId",
          "collaboratorId",
          "collaboratorForeignErpId",
          "contractId",
          "year",
          "month",
          "status",
          "isCalendarAccurate",
          "calendarComment",
          "isRestRespected",
          "restComment",
          "workloadStatus",
          "workloadComment",
          "workedDaysCount",
          "sickDaysCount",
          "unpaidDaysCount",
          "familyDaysCount",
          "parentalLeaveDaysCount",
          "days",
          "submittedAt",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Relevé mensuel de suivi d'un collaborateur au forfait jours"
      },
      "PayrollMonthStatus": {
        "type": "string",
        "enum": [
          "STARTED",
          "CLOSED",
          "SUPERSEDED"
        ]
      },
      "PublicApiPayrollMonthDsn": {
        "type": "object",
        "properties": {
          "declarationTrackingId": {
            "type": "string",
            "description": "Identifiant Puncto du suivi, celui de `GET /public/v1/declaration-trackings?source=dsn`",
            "examples": [
              "dtra_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/DsnTrackingStatus",
            "description": "Étape du dépôt de la déclaration"
          },
          "simplifiedStatus": {
            "$ref": "#/components/schemas/DeclarationSimplifiedStatus",
            "description": "Statut simplifié : en cours, transmise, confirmée ou en erreur"
          },
          "crmStatus": {
            "$ref": "#/components/schemas/DeclarationCrmStatus",
            "description": "Synthèse des comptes rendus des organismes (CRM) : `ok`, `error` (anomalie à traiter), `handled` (anomalies traitées), null sans retour"
          },
          "idFlux": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du dépôt attribué par net-entreprises, null avant le dépôt"
          },
          "documentId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Fichier de la déclaration, téléchargeable avec `GET /public/v1/documents/{documentId}/download`, null tant qu'il n'est pas généré"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création du suivi"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière mise à jour du suivi"
          }
        },
        "required": [
          "declarationTrackingId",
          "status",
          "simplifiedStatus",
          "crmStatus",
          "idFlux",
          "documentId",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "DSN mensuelle d'un mois de paie"
      },
      "DeclarationSimplifiedStatus": {
        "type": "string",
        "enum": [
          "in-progress",
          "sent",
          "confirmed",
          "error"
        ]
      },
      "DeclarationCrmStatus": {
        "type": [
          "string",
          "null"
        ],
        "enum": [
          "ok",
          "error",
          "handled",
          null
        ]
      },
      "PublicApiPayrollMonth": {
        "type": "object",
        "properties": {
          "payrollMonthId": {
            "type": "string",
            "description": "Identifiant Puncto du mois de paie",
            "examples": [
              "pmon_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "establishmentId": {
            "type": "string",
            "description": "Établissement du mois de paie",
            "examples": [
              "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "year": {
            "type": "number",
            "description": "Année"
          },
          "month": {
            "type": "number",
            "description": "Mois (1-12)"
          },
          "status": {
            "$ref": "#/components/schemas/PayrollMonthStatus",
            "description": "`STARTED` : en cours ; `CLOSED` : clôturé, bulletins validés ; `SUPERSEDED` : révision remplacée après une réouverture"
          },
          "revision": {
            "type": "number",
            "description": "Numéro de révision : 1, puis augmenté de 1 à chaque réouverture du mois"
          },
          "closedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de clôture, null tant que le mois n'est pas clôturé"
          },
          "reopenedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "description": "Révision ouverte par une réouverture : date de la réouverture, null sinon"
          },
          "reopenReason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Révision ouverte par une réouverture : motif saisi, null sinon"
          },
          "supersededById": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "pmon_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Révision remplacée (`SUPERSEDED`) : identifiant de la révision qui la remplace, null sinon"
          },
          "dsn": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicApiPayrollMonthDsn"
              },
              {
                "type": "null"
              }
            ],
            "description": "DSN mensuelle de la révision, null tant qu'elle n'est pas lancée"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création du mois de paie"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification du mois de paie"
          }
        },
        "required": [
          "payrollMonthId",
          "establishmentId",
          "year",
          "month",
          "status",
          "revision",
          "closedAt",
          "reopenedAt",
          "reopenReason",
          "supersededById",
          "dsn",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Mois de paie d'un établissement"
      },
      "DeclarationTrackingType": {
        "type": "string",
        "enum": [
          "DSN",
          "DPAE",
          "FCTU",
          "ARRET"
        ]
      },
      "ArretDeclarationKind": {
        "type": "string",
        "enum": [
          "STOPPAGE",
          "RESUMPTION"
        ],
        "description": "Un même arrêt de travail peut donner lieu à deux signalements distincts : l'arrêt lui-même (nature 04) puis, en cas de reprise anticipée, la reprise (nature 05). Les deux vivent dans le même onglet, d'où ce discriminant."
      },
      "DpaeTrackingStatus": {
        "type": "string",
        "enum": [
          "queued",
          "dpae-file-error",
          "dpae-file-created",
          "dpae-api-error",
          "dpae-api-ok",
          "return-error",
          "completed"
        ]
      },
      "PublicApiDeclarationTracking": {
        "type": "object",
        "properties": {
          "declarationTrackingId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "dtra_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "trac_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              }
            ],
            "description": "Identifiant Puncto du suivi"
          },
          "type": {
            "$ref": "#/components/schemas/DeclarationTrackingType",
            "description": "Déclaration suivie : `DSN` (mensuelle), `DPAE`, `FCTU` (fin de contrat) ou `ARRET` (signalement)"
          },
          "kind": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ArretDeclarationKind"
              },
              {
                "type": "null"
              }
            ],
            "description": "Signalement (`ARRET`) : arrêt de travail ou reprise anticipée, null pour les autres déclarations"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DsnTrackingStatus"
              },
              {
                "$ref": "#/components/schemas/DpaeTrackingStatus"
              }
            ],
            "description": "Étape du dépôt de la déclaration"
          },
          "simplifiedStatus": {
            "$ref": "#/components/schemas/DeclarationSimplifiedStatus",
            "description": "Statut simplifié : en cours, transmise, confirmée ou en erreur"
          },
          "crmStatus": {
            "$ref": "#/components/schemas/DeclarationCrmStatus",
            "description": "Synthèse des comptes rendus des organismes (CRM) : `ok`, `error` (anomalie à traiter), `handled` (anomalies traitées), null sans retour et pour une DPAE"
          },
          "idFlux": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du dépôt attribué par net-entreprises, null avant le dépôt"
          },
          "period": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mois de rattachement (`YYYY-MM`) : mois de paie d'une DSN mensuelle, mois d'embauche d'une DPAE, mois de fin de contrat d'une FCTU, mois du dernier jour travaillé d'un signalement. C'est le mois que filtre `months[]`"
          },
          "payrollMonthId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "pmon_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "DSN mensuelle : mois de paie déclaré"
          },
          "collaboratorId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Collaborateur concerné, null pour une DSN mensuelle"
          },
          "contractId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Contrat concerné (DPAE, FCTU, signalement), null pour une DSN mensuelle"
          },
          "endOfContractId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "eoco_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "FCTU : clôture du contrat déclarée"
          },
          "absenceId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Signalement : absence portant l'arrêt de travail"
          },
          "documentId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Fichier de la déclaration, téléchargeable avec `GET /public/v1/documents/{documentId}/download`, null tant qu'il n'est pas généré"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création du suivi"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière mise à jour du suivi"
          }
        },
        "required": [
          "declarationTrackingId",
          "type",
          "kind",
          "status",
          "simplifiedStatus",
          "crmStatus",
          "idFlux",
          "period",
          "payrollMonthId",
          "collaboratorId",
          "contractId",
          "endOfContractId",
          "absenceId",
          "documentId",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Suivi d'une déclaration effectuée par Puncto : DSN mensuelle, DPAE, DSN de fin de contrat (FCTU), signalement d'arrêt de travail ou de reprise anticipée."
      },
      "PublicApiOnCallCompensation": {
        "type": "object",
        "properties": {
          "mode": {
            "type": "string",
            "const": "FIXED_PER_UNIT",
            "description": "Mode de calcul de la contrepartie : un montant fixe par unité, seul mode disponible"
          },
          "unit": {
            "$ref": "#/components/schemas/OnCallUnit",
            "description": "Unité décomptée : la période entière (`PERIOD`, une nuit, un week-end...), dont le nombre est importé avec la période, ou l'heure d'astreinte (`HOUR`), calculée sur la durée de la période"
          },
          "amount": {
            "type": "number",
            "description": "Montant brut par unité, en euros"
          }
        },
        "required": [
          "mode",
          "unit",
          "amount"
        ],
        "additionalProperties": false,
        "description": "Contrepartie d'un type d'astreinte : un montant brut fixe par unité décomptée."
      },
      "PublicApiOnCallType": {
        "type": "object",
        "properties": {
          "onCallTypeId": {
            "type": "string",
            "description": "Identifiant Puncto du type d'astreinte, à passer en `onCallTypeId` à l'import des périodes",
            "examples": [
              "octy_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "label": {
            "type": "string",
            "description": "Libellé, unique dans l'entreprise : utilisable en `onCallTypeLabel` à l'import des périodes"
          },
          "compensation": {
            "$ref": "#/components/schemas/PublicApiOnCallCompensation",
            "description": "Contrepartie copiée sur chaque période à son import : modifier le barème ne change pas les périodes déjà enregistrées"
          },
          "isActive": {
            "type": "boolean",
            "description": "Un type désactivé ne sert plus aux nouvelles périodes ; celles déjà importées le gardent"
          },
          "isUsed": {
            "type": "boolean",
            "description": "Au moins une période d'astreinte utilise ce type"
          }
        },
        "required": [
          "onCallTypeId",
          "label",
          "compensation",
          "isActive",
          "isUsed"
        ],
        "additionalProperties": false,
        "description": "Type d'astreinte du barème de l'entreprise (« Nuit semaine », « Week-end »...)."
      },
      "PublicApiRecurringVariableData": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/PublicApiRecurringPrimeData"
          },
          {
            "$ref": "#/components/schemas/PublicApiRecurringInKindBenefitData"
          },
          {
            "$ref": "#/components/schemas/PublicApiAnnualPublicTransportData"
          }
        ],
        "description": "Ce que l'échéancier verse chaque mois : une prime, un avantage en nature ou un abonnement annuel"
      },
      "PublicApiRecurringPrimeData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "PRIME",
            "description": "Prime"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "amount": {
            "type": "number",
            "description": "Montant brut mensuel, en euros"
          },
          "primeType": {
            "$ref": "#/components/schemas/PrimeType",
            "description": "Type de prime : `HOME_OCCUPATION_ALLOWANCE` (indemnité d'occupation du domicile) ou `OTHER`, seuls types qu'un échéancier verse"
          },
          "isAbsenceSensitive": {
            "type": "boolean",
            "description": "La prime est proratisée selon les absences du mois"
          }
        },
        "required": [
          "type",
          "name",
          "amount",
          "primeType",
          "isAbsenceSensitive"
        ],
        "additionalProperties": false,
        "description": "Prime versée chaque mois, au même montant"
      },
      "PublicApiRecurringInKindBenefitData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "IN_KIND_BENEFIT",
            "description": "Avantage en nature"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "amount": {
            "type": "number",
            "description": "Valeur mensuelle de l'avantage, en euros. Pour un véhicule au forfait, valeur calculée par Puncto pour le premier mois de versement : chaque bulletin la recalcule pour son mois. Pour un véhicule aux dépenses réelles, usage personnel évalué avant abattement et participation"
          },
          "benefitType": {
            "$ref": "#/components/schemas/InKindBenefitType",
            "description": "Nature de l'avantage"
          },
          "vehicle": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicApiVehicleBenefit"
              },
              {
                "type": "null"
              }
            ],
            "description": "Véhicule évalué au forfait, null pour les autres avantages"
          },
          "actualExpensesVehicle": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicApiActualExpensesVehicle"
              },
              {
                "type": "null"
              }
            ],
            "description": "Véhicule évalué aux dépenses réelles, null pour les autres avantages"
          }
        },
        "required": [
          "type",
          "name",
          "amount",
          "benefitType",
          "vehicle",
          "actualExpensesVehicle"
        ],
        "additionalProperties": false,
        "description": "Avantage en nature versé chaque mois"
      },
      "PublicApiVehicleBenefit": {
        "type": "object",
        "properties": {
          "assignedOn": {
            "type": "string",
            "format": "date",
            "description": "Date de mise à disposition du salarié : elle choisit le barème du forfait"
          },
          "ownership": {
            "$ref": "#/components/schemas/VehicleBenefitOwnership",
            "description": "Véhicule acheté (`OWNED`) ou loué (`LEASED`) par l'employeur"
          },
          "firstRegisteredOn": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Première mise en circulation, null si non renseignée (véhicule de moins de cinq ans)"
          },
          "isElectric": {
            "type": "boolean",
            "description": "Véhicule électrique"
          },
          "isEcoScoreEligible": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Éco-score requis pour l'abattement des véhicules électriques mis à disposition depuis le 1er février 2025, null si non renseigné"
          },
          "employerPaysFuel": {
            "type": "boolean",
            "description": "L'employeur paie le carburant"
          },
          "purchasePrice": {
            "type": [
              "number",
              "null"
            ],
            "description": "Prix d'achat TTC, en euros, null si non renseigné"
          },
          "recommendedPrice": {
            "type": [
              "number",
              "null"
            ],
            "description": "Véhicule loué : prix TTC conseillé par le constructeur, en euros, null si non renseigné"
          },
          "annualCost": {
            "type": [
              "number",
              "null"
            ],
            "description": "Véhicule loué : coût annuel (location, entretien, assurance), en euros, null si non renseigné"
          },
          "employeeMonthlyContribution": {
            "type": "number",
            "description": "Participation mensuelle du salarié, en euros, déduite de l'avantage"
          },
          "contributionWithheldFromPay": {
            "type": "boolean",
            "description": "La participation du salarié est retenue sur son net à payer"
          },
          "retainedDuringLeave": {
            "type": "boolean",
            "description": "L'avantage est conservé pendant les congés"
          },
          "retainedDuringAbsence": {
            "type": "boolean",
            "description": "L'avantage est conservé pendant les absences"
          }
        },
        "required": [
          "assignedOn",
          "ownership",
          "firstRegisteredOn",
          "isElectric",
          "isEcoScoreEligible",
          "employerPaysFuel",
          "purchasePrice",
          "recommendedPrice",
          "annualCost",
          "employeeMonthlyContribution",
          "contributionWithheldFromPay",
          "retainedDuringLeave",
          "retainedDuringAbsence"
        ],
        "additionalProperties": false,
        "description": "Véhicule de fonction évalué au forfait (arrêté du 25 février 2025) : chaque bulletin réévalue l'avantage pour son mois, la participation du salarié déduite."
      },
      "VehicleBenefitOwnership": {
        "type": "string",
        "enum": [
          "OWNED",
          "LEASED"
        ]
      },
      "PublicApiAnnualPublicTransportData": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "const": "TAX_FREE_INDEMNITY",
            "description": "Indemnité non soumise"
          },
          "name": {
            "type": "string",
            "description": "Libellé imprimé sur le bulletin"
          },
          "amountTotal": {
            "type": "number",
            "description": "Prix de l'abonnement sur l'année, en euros"
          },
          "amountReimbursed": {
            "type": "number",
            "description": "Prise en charge de l'employeur sur l'année, en euros"
          },
          "indemnityType": {
            "type": "string",
            "const": "PUBLIC_TRANSPORT",
            "description": "Transport public"
          },
          "titleType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TransportTitleType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Titre de transport, null si non renseigné"
          },
          "periodicity": {
            "type": "string",
            "const": "ANNUAL",
            "description": "Abonnement annuel"
          },
          "startMonth": {
            "type": "string",
            "description": "Premier mois réel de l'abonnement, `YYYY-MM`"
          }
        },
        "required": [
          "type",
          "name",
          "amountTotal",
          "amountReimbursed",
          "indemnityType",
          "titleType",
          "periodicity",
          "startMonth"
        ],
        "additionalProperties": false,
        "description": "Abonnement annuel de transport public, remboursé par douzièmes à partir de son premier mois. Il s'importe avec les variables de paie (`periodicity: 'ANNUAL'`)."
      },
      "RecurringVariableFrequency": {
        "type": "string",
        "const": "MONTHLY"
      },
      "PublicApiYearMonth": {
        "type": "object",
        "properties": {
          "year": {
            "type": "number",
            "description": "Année"
          },
          "month": {
            "type": "number",
            "description": "Mois, de 1 (janvier) à 12"
          }
        },
        "required": [
          "year",
          "month"
        ],
        "additionalProperties": false,
        "description": "Mois de paie"
      },
      "PublicApiRecurringVariable": {
        "type": "object",
        "properties": {
          "recurringVariableId": {
            "type": "string",
            "description": "Identifiant Puncto de la variable récurrente",
            "examples": [
              "rvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "foreignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant de la variable récurrente dans votre système, null si elle n'a pas été importée"
          },
          "contractId": {
            "type": "string",
            "description": "Contrat qui verse la variable",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorId": {
            "type": "string",
            "description": "Collaborateur titulaire du contrat",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "data": {
            "$ref": "#/components/schemas/PublicApiRecurringVariableData",
            "description": "Ce que la variable verse chaque mois"
          },
          "frequency": {
            "$ref": "#/components/schemas/RecurringVariableFrequency",
            "description": "Périodicité des versements"
          },
          "status": {
            "$ref": "#/components/schemas/PayrollVariableStatus",
            "description": "Seule une variable validée (`VALIDATED`) est versée ; une variable en attente (`PENDING`) attend un administrateur"
          },
          "startYear": {
            "type": "number",
            "description": "Année du premier mois de versement"
          },
          "startMonth": {
            "type": "number",
            "description": "Premier mois de versement, de 1 à 12"
          },
          "endYear": {
            "type": [
              "number",
              "null"
            ],
            "description": "Année du dernier mois de versement, null tant que la variable court sans fin"
          },
          "endMonth": {
            "type": [
              "number",
              "null"
            ],
            "description": "Dernier mois de versement inclus, de 1 à 12, null tant que la variable court sans fin"
          },
          "lockedThrough": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicApiYearMonth"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dernier mois de la période déjà verrouillé (paie clôturée ou bulletin validé), null si aucun ou si la variable n'est pas validée. Une variable verrouillée ne se supprime plus et ne se modifie plus : seul son dernier mois de versement peut encore être fixé, après ce mois"
          },
          "proofFiles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiFileReference"
            },
            "description": "Justificatifs joints dans Puncto"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de création dans Puncto"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de dernière modification dans Puncto"
          }
        },
        "required": [
          "recurringVariableId",
          "foreignErpId",
          "contractId",
          "collaboratorId",
          "collaboratorForeignErpId",
          "data",
          "frequency",
          "status",
          "startYear",
          "startMonth",
          "endYear",
          "endMonth",
          "lockedThrough",
          "proofFiles",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false,
        "description": "Variable récurrente : un échéancier que chaque bulletin de sa période lit, sans variable de paie saisie mois par mois. Il n'est jamais modifié une fois qu'un mois verrouillé l'a versé : on l'arrête à un dernier mois de versement et on en crée un nouveau."
      },
      "PublicApiGenderEqualityCompany": {
        "type": "object",
        "properties": {
          "companyId": {
            "type": "string",
            "description": "Identifiant Puncto de l'entreprise",
            "examples": [
              "comp_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "name": {
            "type": "string",
            "description": "Raison sociale"
          },
          "siren": {
            "type": "string",
            "description": "SIREN"
          }
        },
        "required": [
          "companyId",
          "name",
          "siren"
        ],
        "additionalProperties": false,
        "description": "Entreprise de la clé d'API"
      },
      "PublicApiGenderEqualityPeriod": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string",
            "description": "Premier mois de la période, au format `YYYY-MM`"
          },
          "to": {
            "type": "string",
            "description": "Dernier mois de la période, au format `YYYY-MM`"
          },
          "startDate": {
            "type": "string",
            "format": "date",
            "description": "Premier jour de la période"
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Dernier jour de la période"
          },
          "monthCount": {
            "type": "number",
            "description": "Nombre de mois de la période, de 1 à 12"
          },
          "dayCount": {
            "type": "number",
            "description": "Nombre de jours calendaires de la période"
          },
          "isTwelveMonths": {
            "type": "boolean",
            "description": "La période couvre 12 mois consécutifs, la durée retenue par l'index"
          },
          "monthsWithMissingPayslips": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Mois de la période (`YYYY-MM`) où au moins un CDI ou CDD en vigueur d'un collaborateur listé n'a pas de bulletin validé lu : paie pas encore clôturée (bulletins encore en brouillon, même si un solde de tout compte est déjà validé), mois repris des DSN écartés par `includeDsnBackfill=false`, ou bulletin manquant. La rémunération de ces mois est incomplète."
          },
          "dsnBackfillMonths": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Mois de la période (`YYYY-MM`) repris des DSN d'un précédent logiciel de paie (un bulletin validé de l'entreprise au moins est repris pour ce mois), que `includeDsnBackfill` les lise ou non. Puncto n'en connaît que les arrêts de travail : les congés sans solde et parentaux d'éducation de ces mois ne sont pas déduits de la présence et ne prolongent pas les congés de maternité."
          }
        },
        "required": [
          "from",
          "to",
          "startDate",
          "endDate",
          "monthCount",
          "dayCount",
          "isTwelveMonths",
          "monthsWithMissingPayslips",
          "dsnBackfillMonths"
        ],
        "additionalProperties": false,
        "description": "Période de référence du rapport"
      },
      "PublicApiGenderEqualityOptions": {
        "type": "object",
        "properties": {
          "includeDsnBackfill": {
            "type": "boolean",
            "description": "Les bulletins repris des DSN d'un précédent logiciel de paie sont lus, comme les bulletins calculés par Puncto"
          }
        },
        "required": [
          "includeDsnBackfill"
        ],
        "additionalProperties": false,
        "description": "Options appliquées au calcul"
      },
      "PublicApiGenderEqualityHeadcount": {
        "type": "object",
        "properties": {
          "listedEmployees": {
            "type": "number",
            "description": "Collaborateurs listés dans `employees` : tous ceux qui ont un contrat sur la période"
          },
          "countedEmployees": {
            "type": "number",
            "description": "Collaborateurs retenus dans l'effectif de l'index (`isCounted`)"
          },
          "countedWomen": {
            "type": "number",
            "description": "Femmes retenues dans l'effectif"
          },
          "countedMen": {
            "type": "number",
            "description": "Hommes retenus dans l'effectif"
          },
          "unknownSex": {
            "type": "number",
            "description": "Collaborateurs listés dont le sexe est inconnu"
          },
          "excludedByReason": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiGenderEqualityExclusionCount"
            },
            "description": "Collaborateurs listés exclus, par motif, dans l'ordre des motifs"
          },
          "companyYearEffectifs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiGenderEqualityCompanyYearEffectif"
            },
            "description": "Effectifs annuels moyens enregistrés pour les années de la période"
          }
        },
        "required": [
          "listedEmployees",
          "countedEmployees",
          "countedWomen",
          "countedMen",
          "unknownSex",
          "excludedByReason",
          "companyYearEffectifs"
        ],
        "additionalProperties": false,
        "description": "Synthèse de l'effectif listé"
      },
      "PublicApiGenderEqualityExclusionCount": {
        "type": "object",
        "properties": {
          "reason": {
            "$ref": "#/components/schemas/GenderEqualityExclusionReason",
            "description": "Motif d'exclusion"
          },
          "count": {
            "type": "number",
            "description": "Collaborateurs listés concernés par ce motif (un collaborateur peut en cumuler plusieurs)"
          }
        },
        "required": [
          "reason",
          "count"
        ],
        "additionalProperties": false,
        "description": "Nombre de collaborateurs listés exclus pour un motif"
      },
      "GenderEqualityExclusionReason": {
        "type": "string",
        "enum": [
          "APPRENTICE",
          "PROFESSIONALIZATION_CONTRACT",
          "INTERN",
          "CORPORATE_OFFICER",
          "EXPATRIATE",
          "ABSENT_MORE_THAN_HALF_PERIOD",
          "UNKNOWN_SEX"
        ]
      },
      "PublicApiGenderEqualityCompanyYearEffectif": {
        "type": "object",
        "properties": {
          "year": {
            "type": "number",
            "description": "Année"
          },
          "effectif": {
            "type": "number",
            "description": "Effectif annuel moyen au sens de la sécurité sociale (calcul Urssaf), et non l'effectif du code du travail qui détermine les indicateurs applicables : à titre indicatif"
          }
        },
        "required": [
          "year",
          "effectif"
        ],
        "additionalProperties": false,
        "description": "Effectif annuel moyen de l'entreprise enregistré dans Puncto"
      },
      "PublicApiGenderEqualityEmployee": {
        "type": "object",
        "properties": {
          "collaboratorId": {
            "type": "string",
            "description": "Identifiant Puncto du collaborateur",
            "examples": [
              "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "collaboratorForeignErpId": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné"
          },
          "matriculeRh": {
            "type": "string",
            "description": "Matricule RH"
          },
          "firstName": {
            "type": "string",
            "description": "Prénom"
          },
          "lastName": {
            "type": "string",
            "description": "Nom de naissance"
          },
          "sex": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GenderEqualitySex"
              },
              {
                "type": "null"
              }
            ],
            "description": "Sexe, lu sur le premier chiffre du NIR, du NIA ou du NTT ; null s'il est inconnu"
          },
          "identityType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CollaboratorIdentityType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Type de l'identifiant qui donne le sexe, null sans identifiant"
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "Date de naissance"
          },
          "referenceDate": {
            "type": "string",
            "format": "date",
            "description": "Date de référence : dernier jour de la période, ou dernier jour sous contrat retenu s'il est antérieur. L'âge et la classification y sont appréciés."
          },
          "age": {
            "type": "number",
            "description": "Âge à la date de référence"
          },
          "ageBracket": {
            "$ref": "#/components/schemas/GenderEqualityAgeBracket",
            "description": "Tranche d'âge à la date de référence"
          },
          "contracts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiGenderEqualityContract"
            },
            "description": "Contrats du collaborateur qui chevauchent la période, du plus ancien au plus récent"
          },
          "referenceContractId": {
            "type": "string",
            "description": "Contrat de référence : le contrat retenu en vigueur à la date de référence, le dernier commencé",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "workerType": {
            "$ref": "#/components/schemas/WorkerType",
            "description": "Type du contrat de référence"
          },
          "establishmentId": {
            "type": "string",
            "description": "Établissement à la date de référence",
            "examples": [
              "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "companyRoleId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "crol_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Poste à la date de référence"
          },
          "companyRoleName": {
            "type": [
              "string",
              "null"
            ],
            "description": "Intitulé du poste à la date de référence"
          },
          "companyTeamId": {
            "anyOf": [
              {
                "type": "string",
                "description": "Identifiant Puncto",
                "examples": [
                  "ctea_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Équipe à la date de référence"
          },
          "isCadre": {
            "type": "boolean",
            "description": "Statut cadre à la date de référence"
          },
          "conventionalWorkerStatus": {
            "$ref": "#/components/schemas/ConventionalWorkerStatus",
            "description": "Statut catégoriel conventionnel (DSN S21.G00.40.002) à la date de référence"
          },
          "codePcsEse": {
            "type": [
              "string",
              "null"
            ],
            "description": "Code PCS-ESE à la date de référence, null s'il n'est pas renseigné"
          },
          "csp": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GenderEqualityCsp"
              },
              {
                "type": "null"
              }
            ],
            "description": "CSP de l'index : premier chiffre du code PCS-ESE (2 et 3 ingénieurs et cadres, 4 techniciens et agents de maîtrise, 5 employés, 6 ouvriers), à défaut statut catégoriel conventionnel (03-04 cadres, 05 professions intermédiaires, 06 employés, 07 ouvriers), à défaut statut cadre. Null si rien ne permet de la déduire."
          },
          "cspSource": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GenderEqualityCspSource"
              },
              {
                "type": "null"
              }
            ],
            "description": "Donnée dont la CSP est déduite"
          },
          "conventionalPosition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SyntecPosition"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position Syntec à la date de référence, null si elle n'est pas renseignée"
          },
          "coefficient": {
            "type": [
              "number",
              "null"
            ],
            "description": "Coefficient Syntec de la position. Les grilles ETAM et cadres ne se comparent pas."
          },
          "workerOutsideFranceStatus": {
            "$ref": "#/components/schemas/WorkerOutsideFranceStatus",
            "description": "Situation de travail hors de France ; `02` (expatrié) exclut le collaborateur"
          },
          "quotityType": {
            "$ref": "#/components/schemas/QuotityType",
            "description": "Forme du temps de travail à la date de référence"
          },
          "workingPercentage": {
            "type": "number",
            "description": "Taux d'activité à la date de référence, en %"
          },
          "presence": {
            "$ref": "#/components/schemas/PublicApiGenderEqualityPresence",
            "description": "Présence sur la période"
          },
          "isCounted": {
            "type": "boolean",
            "description": "Le collaborateur entre dans l'effectif de l'index : aucun motif d'exclusion"
          },
          "exclusionReasons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GenderEqualityExclusionReason"
            },
            "description": "Motifs d'exclusion de l'effectif"
          },
          "remuneration": {
            "$ref": "#/components/schemas/PublicApiGenderEqualityRemuneration",
            "description": "Rémunération sur la période"
          },
          "salaryChanges": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiGenderEqualitySalaryChange"
            },
            "description": "Évolutions du salaire contractuel en équivalent temps plein prenant effet pendant la période, lues sur l'historique des avenants. Une simple modification du temps de travail, au salaire proratisé, n'en est pas une."
          },
          "promotions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiGenderEqualityPromotion"
            },
            "description": "Promotions prenant effet pendant la période : passage d'ETAM à cadre, coefficient Syntec supérieur dans la même grille, ou à défaut de position, passage au statut cadre"
          },
          "raisedDuringPeriod": {
            "type": "boolean",
            "description": "Au moins une augmentation pendant la période, promotions comprises. Puncto ne distingue pas les augmentations individuelles des augmentations générales."
          },
          "raisedWithoutPromotionDuringPeriod": {
            "type": "boolean",
            "description": "Au moins une augmentation pendant la période sans promotion à la même date"
          },
          "promotedDuringPeriod": {
            "type": "boolean",
            "description": "Au moins une promotion pendant la période, hors reclassement dû à l'âge"
          },
          "maternityLeaves": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiGenderEqualityMaternityLeave"
            },
            "description": "Congés de maternité ou d'adoption qui chevauchent la période ou s'achèvent la veille de son début, y compris pour une salariée exclue de l'effectif"
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GenderEqualityEmployeeWarning"
            },
            "description": "Points d'attention :\n- `NO_VALIDATED_PAYSLIP` : aucun bulletin validé sur la période ;\n- `UNCOVERED_CONTRACT_DAYS` : des jours sous contrat ne sont couverts par aucun bulletin validé ;\n- `DSN_BACKFILL_PAYSLIPS` : des bulletins repris des DSN sont utilisés ;\n- `REMUNERATION_TO_REVIEW` : des éléments de rémunération sont à arbitrer ;\n- `MISSING_PCS_ESE` : code PCS-ESE absent ;\n- `MISSING_CONVENTIONAL_POSITION` : position Syntec absente ;\n- `LEGACY_MATERNITY_LEAVE` : congé de maternité repéré par le seul motif de son arrêt ;\n- `MATERNITY_RETURN_IN_DSN_BACKFILL_MONTH` : retour de congé de maternité ou d'adoption pendant un mois repris des DSN."
          }
        },
        "required": [
          "collaboratorId",
          "collaboratorForeignErpId",
          "matriculeRh",
          "firstName",
          "lastName",
          "sex",
          "identityType",
          "birthDate",
          "referenceDate",
          "age",
          "ageBracket",
          "contracts",
          "referenceContractId",
          "workerType",
          "establishmentId",
          "companyRoleId",
          "companyRoleName",
          "companyTeamId",
          "isCadre",
          "conventionalWorkerStatus",
          "codePcsEse",
          "csp",
          "cspSource",
          "conventionalPosition",
          "coefficient",
          "workerOutsideFranceStatus",
          "quotityType",
          "workingPercentage",
          "presence",
          "isCounted",
          "exclusionReasons",
          "remuneration",
          "salaryChanges",
          "promotions",
          "raisedDuringPeriod",
          "raisedWithoutPromotionDuringPeriod",
          "promotedDuringPeriod",
          "maternityLeaves",
          "warnings"
        ],
        "additionalProperties": false,
        "description": "Collaborateur ayant au moins un contrat sur la période, hors contrats en cours d'embauche. La classification est lue sur le contrat de référence à la date de référence."
      },
      "GenderEqualitySex": {
        "type": "string",
        "enum": [
          "FEMALE",
          "MALE"
        ]
      },
      "GenderEqualityAgeBracket": {
        "type": "string",
        "enum": [
          "UNDER_30",
          "FROM_30_TO_39",
          "FROM_40_TO_49",
          "FROM_50"
        ]
      },
      "PublicApiGenderEqualityContract": {
        "type": "object",
        "properties": {
          "contractId": {
            "type": "string",
            "description": "Identifiant Puncto du contrat",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "workerType": {
            "$ref": "#/components/schemas/WorkerType",
            "description": "Type de contrat"
          },
          "activationStatus": {
            "$ref": "#/components/schemas/ContractActivationStatus",
            "description": "Statut du contrat dans Puncto"
          },
          "startDate": {
            "type": "string",
            "format": "date",
            "description": "Date de début du contrat"
          },
          "endDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de fin du contrat (fin effective une fois clôturé), null pour un contrat sans terme"
          },
          "isEligible": {
            "type": "boolean",
            "description": "Contrat de salarié pris en compte par l'index : CDI ou CDD"
          },
          "isRetained": {
            "type": "boolean",
            "description": "Contrat dont sont lues la présence, la rémunération et les évolutions : les CDI et CDD du collaborateur, ou à défaut, pour un collaborateur exclu, tous ses contrats de la période"
          }
        },
        "required": [
          "contractId",
          "workerType",
          "activationStatus",
          "startDate",
          "endDate",
          "isEligible",
          "isRetained"
        ],
        "additionalProperties": false,
        "description": "Contrat d'un collaborateur sur la période"
      },
      "GenderEqualityCsp": {
        "type": "string",
        "enum": [
          "WORKERS",
          "EMPLOYEES",
          "TECHNICIANS_SUPERVISORS",
          "ENGINEERS_EXECUTIVES"
        ]
      },
      "GenderEqualityCspSource": {
        "type": "string",
        "enum": [
          "PCS_ESE",
          "CONVENTIONAL_WORKER_STATUS",
          "IS_CADRE"
        ]
      },
      "QuotityType": {
        "type": "string",
        "enum": [
          "FORFAIT_JOUR",
          "FORFAIT_HEURE",
          "HEURE",
          "NON_CONCERNE"
        ]
      },
      "PublicApiGenderEqualityPresence": {
        "type": "object",
        "properties": {
          "periodDays": {
            "type": "number",
            "description": "Jours calendaires de la période"
          },
          "contractDays": {
            "type": "number",
            "description": "Jours de la période sous contrat retenu"
          },
          "suspensionDays": {
            "type": "number",
            "description": "Jours sous contrat suspendus : arrêts maladie et accidents, congés parentaux et congés sans solde acceptés ; congés de maternité ou d'adoption, et congés de paternité ou supplémentaires de naissance qui portent un arrêt de travail (motifs DSN 03 et 20), ni refusés ni annulés (ceux repris des DSN restent en attente). Une demi-journée d'absence compte pour 0,5. Pour les mois repris des DSN (`period.dsnBackfillMonths`), seuls les arrêts de travail sont connus."
          },
          "sicknessDays": {
            "type": "number",
            "description": "Dont jours d'arrêt maladie, d'accident du travail ou de trajet et de maladie professionnelle"
          },
          "maternityOrAdoptionLeaveDays": {
            "type": "number",
            "description": "Dont jours de congé de maternité ou d'adoption"
          },
          "otherParentalLeaveDays": {
            "type": "number",
            "description": "Dont jours d'autres congés parentaux (paternité, congé supplémentaire de naissance)"
          },
          "unpaidLeaveDays": {
            "type": "number",
            "description": "Dont jours de congé sans solde"
          },
          "presentDays": {
            "type": "number",
            "description": "Jours de présence : jours sous contrat moins jours suspendus"
          },
          "coveredDays": {
            "type": "number",
            "description": "Jours sous contrat dont le mois porte un bulletin validé du contrat"
          },
          "fteMonths": {
            "type": "number",
            "description": "Mois en équivalent temps plein couverts par les bulletins : pour chaque jour couvert, le taux d'activité de l'avenant en vigueur divisé par le nombre de jours du mois. Douze mois pleins à temps plein valent 12, à 80 % 9,6."
          },
          "fteRatio": {
            "type": "number",
            "description": "`fteMonths` rapporté au nombre de mois de la période"
          },
          "averageWorkingPercentage": {
            "type": [
              "number",
              "null"
            ],
            "description": "Taux d'activité moyen des jours sous contrat, en %, null sans jour sous contrat"
          }
        },
        "required": [
          "periodDays",
          "contractDays",
          "suspensionDays",
          "sicknessDays",
          "maternityOrAdoptionLeaveDays",
          "otherParentalLeaveDays",
          "unpaidLeaveDays",
          "presentDays",
          "coveredDays",
          "fteMonths",
          "fteRatio",
          "averageWorkingPercentage"
        ],
        "additionalProperties": false,
        "description": "Présence sur la période, en jours calendaires, sur les contrats retenus. Une dispense de travail de femme enceinte (motif DSN 07), reprise des DSN en congé familial, n'est pas déduite : ses jours restent des jours de présence."
      },
      "PublicApiGenderEqualityRemuneration": {
        "type": "object",
        "properties": {
          "payslipCount": {
            "type": "number",
            "description": "Bulletins validés lus : le plus récent de chaque contrat et de chaque mois"
          },
          "dsnBackfillPayslipCount": {
            "type": "number",
            "description": "Dont bulletins repris des DSN d'un précédent logiciel de paie"
          },
          "payslipMonths": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Mois (`YYYY-MM`) des bulletins lus"
          },
          "grossTotal": {
            "type": "number",
            "description": "Rémunération brute cumulée des bulletins"
          },
          "hoursWorked": {
            "type": "number",
            "description": "Heures travaillées cumulées des bulletins"
          },
          "elements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiGenderEqualityRemunerationElement"
            },
            "description": "Éléments de rémunération, cumulés par nature (et par prime). La somme des éléments `isPartOfGross` vaut `grossTotal`, à l'arrondi près."
          },
          "includedTotal": {
            "type": "number",
            "description": "Somme des éléments `INCLUDED` : rémunération reconstituée, absences neutralisées"
          },
          "neutralizedTotal": {
            "type": "number",
            "description": "Somme des éléments `NEUTRALIZED` : effet des absences sur la rémunération versée"
          },
          "includedPaidTotal": {
            "type": "number",
            "description": "Rémunération retenue effectivement versée : `includedTotal + neutralizedTotal`"
          },
          "excludedTotal": {
            "type": "number",
            "description": "Somme des éléments `EXCLUDED`"
          },
          "toReviewTotal": {
            "type": "number",
            "description": "Somme des éléments `TO_REVIEW`, laissés hors des totaux"
          },
          "fteAnnualIncludedRemuneration": {
            "type": [
              "number",
              "null"
            ],
            "description": "Rémunération annuelle reconstituée en équivalent temps plein : `includedTotal / fteMonths × 12`. Null sans mois couvert."
          },
          "contractualAnnualSalaryAtReferenceDate": {
            "type": [
              "number",
              "null"
            ],
            "description": "Salaire brut annuel contractuel à la date de référence, au temps de travail du contrat. Null pour une rémunération horaire."
          },
          "contractualFteAnnualSalaryAtStart": {
            "type": [
              "number",
              "null"
            ],
            "description": "Salaire brut annuel contractuel en équivalent temps plein au premier jour sous contrat de la période (salaire annuel × 100 / taux d'activité)"
          },
          "contractualFteAnnualSalaryAtReferenceDate": {
            "type": [
              "number",
              "null"
            ],
            "description": "Salaire brut annuel contractuel en équivalent temps plein à la date de référence"
          }
        },
        "required": [
          "payslipCount",
          "dsnBackfillPayslipCount",
          "payslipMonths",
          "grossTotal",
          "hoursWorked",
          "elements",
          "includedTotal",
          "neutralizedTotal",
          "includedPaidTotal",
          "excludedTotal",
          "toReviewTotal",
          "fteAnnualIncludedRemuneration",
          "contractualAnnualSalaryAtReferenceDate",
          "contractualFteAnnualSalaryAtStart",
          "contractualFteAnnualSalaryAtReferenceDate"
        ],
        "additionalProperties": false,
        "description": "Rémunération sur la période, lue sur les bulletins validés des contrats retenus"
      },
      "PublicApiGenderEqualityRemunerationElement": {
        "type": "object",
        "properties": {
          "element": {
            "$ref": "#/components/schemas/GenderEqualityRemunerationElement",
            "description": "Nature de l'élément"
          },
          "primeType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PrimeType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Prime (`PRIME`) : type Puncto de la prime, retrouvé par son libellé sur les anciens bulletins ; `OTHER` pour une prime libre. Null pour les autres éléments et les primes reprises d'une DSN."
          },
          "dsnCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Prime reprise d'une DSN : code de type S21.G00.52.001. Null sinon."
          },
          "label": {
            "type": "string",
            "description": "Libellé : celui du type de prime ou du code DSN, le libellé libre d'une prime `OTHER`"
          },
          "isPartOfGross": {
            "type": "boolean",
            "description": "L'élément fait partie de la rémunération brute du bulletin"
          },
          "treatment": {
            "$ref": "#/components/schemas/GenderEqualityRemunerationTreatment",
            "description": "Traitement par défaut dans l'index"
          },
          "amount": {
            "type": "number",
            "description": "Montant cumulé sur la période, en euros : les retenues sont négatives"
          }
        },
        "required": [
          "element",
          "primeType",
          "dsnCode",
          "label",
          "isPartOfGross",
          "treatment",
          "amount"
        ],
        "additionalProperties": false,
        "description": "Élément de rémunération cumulé sur la période"
      },
      "GenderEqualityRemunerationElement": {
        "type": "string",
        "enum": [
          "BASE_SALARY",
          "PRIME",
          "IN_KIND_BENEFIT",
          "OVERTIME",
          "ABSENCE_DEDUCTION",
          "ABSENCE_INDEMNITY",
          "SICKNESS_DEDUCTION",
          "THERAPEUTIC_PART_TIME_DEDUCTION",
          "PUBLIC_TRANSPORT_REINTEGRATION",
          "PERSONAL_TRANSPORT_REINTEGRATION",
          "REMOTE_WORK_ALLOWANCE_REINTEGRATION",
          "MEAL_ALLOWANCE_REINTEGRATION",
          "HOLIDAY_VOUCHER",
          "UNCLASSIFIED_GROSS",
          "VALUE_SHARING_BONUS",
          "PROFIT_SHARING",
          "CONTRACT_END_INDEMNITY",
          "PRIOR_PERIOD_REGULARISATION"
        ]
      },
      "GenderEqualityRemunerationTreatment": {
        "type": "string",
        "enum": [
          "INCLUDED",
          "NEUTRALIZED",
          "EXCLUDED",
          "TO_REVIEW"
        ]
      },
      "PublicApiGenderEqualitySalaryChange": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Date d'effet du nouveau salaire"
          },
          "contractId": {
            "type": "string",
            "description": "Contrat qui porte le nouveau salaire",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "previousContractId": {
            "type": "string",
            "description": "Contrat qui portait l'ancien salaire : un autre contrat quand l'évolution accompagne un changement de contrat",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "fromFteAnnualSalary": {
            "type": "number",
            "description": "Salaire annuel en équivalent temps plein avant l'évolution"
          },
          "toFteAnnualSalary": {
            "type": "number",
            "description": "Salaire annuel en équivalent temps plein après l'évolution"
          },
          "changeAmount": {
            "type": "number",
            "description": "Écart en euros, négatif pour une baisse"
          },
          "changePercent": {
            "type": "number",
            "description": "Écart en %, négatif pour une baisse"
          },
          "isRaise": {
            "type": "boolean",
            "description": "Augmentation : le salaire en équivalent temps plein progresse"
          },
          "isPromotion": {
            "type": "boolean",
            "description": "Une promotion prend effet à la même date"
          },
          "isContractChange": {
            "type": "boolean",
            "description": "L'évolution accompagne un changement de contrat (CDD suivi d'un CDI par exemple)"
          }
        },
        "required": [
          "date",
          "contractId",
          "previousContractId",
          "fromFteAnnualSalary",
          "toFteAnnualSalary",
          "changeAmount",
          "changePercent",
          "isRaise",
          "isPromotion",
          "isContractChange"
        ],
        "additionalProperties": false,
        "description": "Évolution du salaire contractuel en équivalent temps plein, d'un avenant au suivant : un écart de plus de 0,50 €, et de plus de 0,1 % quand le temps de travail change (le salaire proratisé et le taux d'activité sont arrondis, 85,71 % pour 30 h sur 35 h)"
      },
      "PublicApiGenderEqualityPromotion": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Date d'effet de la nouvelle classification"
          },
          "contractId": {
            "type": "string",
            "description": "Contrat qui porte la nouvelle classification",
            "examples": [
              "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
            ]
          },
          "from": {
            "$ref": "#/components/schemas/PublicApiGenderEqualityClassification",
            "description": "Classification avant la promotion"
          },
          "to": {
            "$ref": "#/components/schemas/PublicApiGenderEqualityClassification",
            "description": "Classification après la promotion"
          },
          "isAgeBasedReclassification": {
            "type": "boolean",
            "description": "Passage de la position cadre 2.1 « moins de 26 ans » à 2.1 « au moins 26 ans », dû à l'âge : listé, mais pas compté dans `promotedDuringPeriod`"
          },
          "hasSalaryIncrease": {
            "type": "boolean",
            "description": "Le salaire en équivalent temps plein augmente à la même date"
          }
        },
        "required": [
          "date",
          "contractId",
          "from",
          "to",
          "isAgeBasedReclassification",
          "hasSalaryIncrease"
        ],
        "additionalProperties": false,
        "description": "Promotion : passage à une classification supérieure"
      },
      "PublicApiGenderEqualityClassification": {
        "type": "object",
        "properties": {
          "conventionalPosition": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SyntecPosition"
              },
              {
                "type": "null"
              }
            ],
            "description": "Position Syntec, null si elle n'est pas renseignée"
          },
          "coefficient": {
            "type": [
              "number",
              "null"
            ],
            "description": "Coefficient Syntec de la position, null sans position. Les grilles ETAM et cadres ne se comparent pas."
          },
          "isCadre": {
            "type": "boolean",
            "description": "Statut cadre"
          },
          "codePcsEse": {
            "type": [
              "string",
              "null"
            ],
            "description": "Code PCS-ESE, null s'il n'est pas renseigné"
          }
        },
        "required": [
          "conventionalPosition",
          "coefficient",
          "isCadre",
          "codePcsEse"
        ],
        "additionalProperties": false,
        "description": "Classification conventionnelle à une date"
      },
      "PublicApiGenderEqualityMaternityLeave": {
        "type": "object",
        "properties": {
          "kind": {
            "$ref": "#/components/schemas/GenderEqualityLeaveKind",
            "description": "Maternité ou adoption"
          },
          "detection": {
            "$ref": "#/components/schemas/GenderEqualityLeaveDetection",
            "description": "Repérage : absence « Congé de maternité », ou motif DSN 02 / 09 de l'arrêt de travail seul (congés repris des DSN avant le 28/10/2026, congés d'adoption)"
          },
          "absenceIds": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Identifiant Puncto",
              "examples": [
                "abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
              ]
            },
            "description": "Identifiants Puncto des absences qui composent le congé, prolongations comprises"
          },
          "startDate": {
            "type": "string",
            "format": "date",
            "description": "Premier jour du congé"
          },
          "endDate": {
            "type": "string",
            "format": "date",
            "description": "Dernier jour du congé de maternité ou d'adoption. Un nouveau congé de maternité ou d'adoption qui suit le congé parental ou sans solde, sans reprise du travail, fait partie du même congé : c'est alors le dernier jour de ce nouveau congé."
          },
          "extensionEndDate": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Dernier jour du congé parental ou sans solde qui le prolonge sans interruption, null sans prolongation"
          },
          "returnDate": {
            "type": "string",
            "format": "date",
            "description": "Jour de retour : lendemain du congé, prolongation comprise. Dans un mois repris des DSN, un congé parental ou sans solde qui prolongerait le congé n'est pas connu (avertissement `MATERNITY_RETURN_IN_DSN_BACKFILL_MONTH`)."
          },
          "returnedDuringPeriod": {
            "type": "boolean",
            "description": "La salariée reprend le travail pendant la période, sous un contrat retenu"
          },
          "raisesInCompanyDuringLeave": {
            "type": "number",
            "description": "Augmentations de salaire d'autres collaborateurs (CDI et CDD) prenant effet pendant le congé, prolongation comprise. Celles des contrats terminés plus de 24 mois avant le début de la période ne sont pas comptées."
          },
          "raisesInSameCspDuringLeave": {
            "type": "number",
            "description": "Dont augmentations de collaborateurs de la même CSP que la salariée"
          },
          "raisedSinceLeaveStart": {
            "type": "boolean",
            "description": "La salariée est augmentée entre le début du congé et la fin de la période"
          },
          "firstRaiseDateSinceLeaveStart": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "description": "Date de sa première augmentation depuis le début du congé, null sans augmentation"
          }
        },
        "required": [
          "kind",
          "detection",
          "absenceIds",
          "startDate",
          "endDate",
          "extensionEndDate",
          "returnDate",
          "returnedDuringPeriod",
          "raisesInCompanyDuringLeave",
          "raisesInSameCspDuringLeave",
          "raisedSinceLeaveStart",
          "firstRaiseDateSinceLeaveStart"
        ],
        "additionalProperties": false,
        "description": "Congé de maternité ou d'adoption"
      },
      "GenderEqualityLeaveKind": {
        "type": "string",
        "enum": [
          "MATERNITY",
          "ADOPTION"
        ]
      },
      "GenderEqualityLeaveDetection": {
        "type": "string",
        "enum": [
          "MATERNITY_LEAVE_ABSENCE",
          "WORK_STOPPAGE_MOTIVE"
        ]
      },
      "GenderEqualityEmployeeWarning": {
        "type": "string",
        "enum": [
          "NO_VALIDATED_PAYSLIP",
          "UNCOVERED_CONTRACT_DAYS",
          "DSN_BACKFILL_PAYSLIPS",
          "REMUNERATION_TO_REVIEW",
          "MISSING_PCS_ESE",
          "MISSING_CONVENTIONAL_POSITION",
          "LEGACY_MATERNITY_LEAVE",
          "MATERNITY_RETURN_IN_DSN_BACKFILL_MONTH"
        ]
      },
      "PublicApiGenderEqualityWarning": {
        "type": "object",
        "properties": {
          "code": {
            "$ref": "#/components/schemas/GenderEqualityWarningCode",
            "description": "Code stable :\n- `REFERENCE_PERIOD_NOT_12_MONTHS` : la période ne couvre pas 12 mois ;\n- `MONTHS_WITH_MISSING_PAYSLIPS` : des contrats en vigueur n'ont pas de bulletin validé (`period.monthsWithMissingPayslips`) ;\n- `DSN_BACKFILL_PAYSLIPS` : des bulletins repris des DSN sont utilisés ;\n- `DSN_BACKFILL_MONTHS` : des mois repris des DSN n'ont pas de congés sans solde ni parentaux d'éducation connus (`period.dsnBackfillMonths`) ;\n- `UNKNOWN_SEX` : des collaborateurs n'ont pas de sexe connu ;\n- `MISSING_PCS_ESE` : des collaborateurs retenus n'ont pas de code PCS-ESE ;\n- `REMUNERATION_TO_REVIEW` : des collaborateurs retenus ont des éléments de rémunération à arbitrer."
          },
          "message": {
            "type": "string",
            "description": "Message lisible, en français"
          }
        },
        "required": [
          "code",
          "message"
        ],
        "additionalProperties": false,
        "description": "Point d'attention sur l'ensemble du rapport"
      },
      "GenderEqualityWarningCode": {
        "type": "string",
        "enum": [
          "REFERENCE_PERIOD_NOT_12_MONTHS",
          "MONTHS_WITH_MISSING_PAYSLIPS",
          "DSN_BACKFILL_PAYSLIPS",
          "DSN_BACKFILL_MONTHS",
          "UNKNOWN_SEX",
          "MISSING_PCS_ESE",
          "REMUNERATION_TO_REVIEW"
        ]
      },
      "PublicApiGenderEqualityIndex": {
        "type": "object",
        "properties": {
          "company": {
            "$ref": "#/components/schemas/PublicApiGenderEqualityCompany",
            "description": "Entreprise"
          },
          "period": {
            "$ref": "#/components/schemas/PublicApiGenderEqualityPeriod",
            "description": "Période de référence"
          },
          "options": {
            "$ref": "#/components/schemas/PublicApiGenderEqualityOptions",
            "description": "Options appliquées"
          },
          "headcount": {
            "$ref": "#/components/schemas/PublicApiGenderEqualityHeadcount",
            "description": "Synthèse de l'effectif"
          },
          "employees": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiGenderEqualityEmployee"
            },
            "description": "Collaborateurs ayant un contrat sur la période, exclus compris, triés par nom puis prénom"
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PublicApiGenderEqualityWarning"
            },
            "description": "Points d'attention sur l'ensemble du rapport"
          }
        },
        "required": [
          "company",
          "period",
          "options",
          "headcount",
          "employees",
          "warnings"
        ],
        "additionalProperties": false,
        "description": "Données brutes de l'index de l'égalité professionnelle sur une période de référence : un collaborateur par ligne, avec tout ce dont le calcul des indicateurs a besoin. Puncto ne calcule ni les indicateurs ni la note : la déclaration, le choix de la période et des regroupements restent de la responsabilité de l'employeur."
      }
    }
  }
}
