Skip to content
Navigation

Lister le suivi des déclarations

Liste le suivi des déclarations déposées par Puncto pour une source, de la plus récente à la plus ancienne.

Pour 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.

GET
https://api.puncto.fr/public/v1/declaration-trackings

Authentification

  • bearerAuth
    HTTP
    requis

Query parameters

  • source
    dsn
    ou
    dpae
    ou
    fctu
    ou
    arret
    requis

    Déclarations à lister.

  • page
    optionnel
    integer

    Numéro de page, à partir de 1.

    minimum: 1 · default: 1
  • perPage
    optionnel
    integer

    Nombre d’éléments par page, 200 au plus.

    maximum: 200 · minimum: 1 · default: 50
  • statuses[]
    optionnel
    tableau de
    string

    Statuts simplifiés à garder. Répétez le paramètre pour en passer plusieurs.

  • months[]
    optionnel
    tableau de
    string

    Mois de rattachement à garder, au format YYYY-MM (voir period). Répétez le paramètre pour en passer plusieurs.

Retour

200

Page de suivis de déclarations

JSON
  • data
    tableau de
    object
    requis
    • declarationTrackingId
      requis

      Identifiant Puncto du suivi

      One of the following:

      • string
      • string
    • type
      DSN
      ou
      DPAE
      ou
      FCTU
      ou
      ARRET
      requis

      Déclaration suivie : DSN (mensuelle), DPAE, FCTU (fin de contrat) ou ARRET (signalement)

    • kind
      requis

      Signalement (ARRET) : arrêt de travail ou reprise anticipée, null pour les autres déclarations

      One of the following:

      • ArretDeclarationKind
      • null
    • status
      requis

      Étape du dépôt de la déclaration

      One of the following:

      • DsnTrackingStatus
      • DpaeTrackingStatus
    • simplifiedStatus
      in-progress
      ou
      sent
      ou
      confirmed
      ou
      error
      requis

      Statut simplifié : en cours, transmise, confirmée ou en erreur

    • crmStatus
      ok
      ou
      error
      ou
      handled
      ou
      null
      requis

      Synthèse des comptes rendus des organismes (CRM) : ok, error (anomalie à traiter), handled (anomalies traitées), null sans retour et pour une DPAE

    • idFlux
      string | null
      requis

      Identifiant du dépôt attribué par net-entreprises, null avant le dépôt

    • period
      string | null
      requis

      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
      requis

      DSN mensuelle : mois de paie déclaré

      One of the following:

      • string
      • null
    • collaboratorId
      requis

      Collaborateur concerné, null pour une DSN mensuelle

      One of the following:

      • string
      • null
    • contractId
      requis

      Contrat concerné (DPAE, FCTU, signalement), null pour une DSN mensuelle

      One of the following:

      • string
      • null
    • endOfContractId
      requis

      FCTU : clôture du contrat déclarée

      One of the following:

      • string
      • null
    • absenceId
      requis

      Signalement : absence portant l'arrêt de travail

      One of the following:

      • string
      • null
    • documentId
      requis

      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é

      One of the following:

      • string
      • null
    • createdAt
      string
      requis

      Date de création du suivi

      format: date-time
    • updatedAt
      string
      requis

      Date de dernière mise à jour du suivi

      format: date-time
  • meta
    object
    requis
    • total
      integer
      requis

      Nombre total d’éléments.

    • page
      integer
      requis

      Page renvoyée.

    • perPage
      integer
      requis
    • currentPage
      integer
      requis
    • firstPage
      integer
      requis
    • lastPage
      integer
      requis

401

Clé d’API absente, invalide ou révoquée
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

403

Opération hors de l’accès de la clé d’API
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

422

Paramètres invalides
JSON
  • errors
    tableau de
    object
    requis
    • message
      string
      requis
    • rule
      string
      requis

      Règle de validation en échec.

    • field
      string
      requis

      Chemin du champ, par exemple absences.0.type.

Type to search…

↑↓ navigate↵ selectEsc close