Transmettre un rapport e-reporting
POST/api/v1/workspaces/:workspace_id/e_reportings/:id/submit
Construit le rapport à partir des données de sa période, le valide contre les règles de conformité de la réforme et le dépose. La transmission elle-même est asynchrone : un 201 signifie que le dépôt est enregistré et pris en charge, pas que l'administration a répondu - le verdict arrive plus tard sur deposit_outcome. Rejouer l'appel sur un rapport déjà entre les mains de l'administration répond 200 avec transmitted=false et ne dépose rien : rejouer est donc sans danger. Un rapport que l'administration a déjà accepté est refusé : ce qui a été déclaré ne se corrige que par une transmission rectificative. Un 409 signifie qu'un autre traitement dépose ce rapport au même instant, ou qu'une transmission rectificative a trouvé une ligne de la période verrouillée par un autre traitement - rien n'a été transmis et l'appel peut être rejoué. Un 422 distingue deux situations sur code : validation_failed est un verdict sur la déclaration et le remède est de la corriger, tandis que schematron_engine_unavailable signale que le moteur de conformité n'a pas pu s'exécuter - rien n'a été jugé, et le même rapport est redéposé à l'identique une fois le moteur revenu.
Request
Responses
- 200
- 201
- 401
- 403
- 404
- 409
- 422
Le rapport était déjà entre les mains de l'administration ; rien n'a été déposé à nouveau. Chaque nouvel appel répond ceci.
Le rapport a été construit, validé et déposé. Le verdict de l'administration arrive plus tard et se lit sur deposit_outcome.
La requête ne comportait pas de jeton d'accès (bearer token) OAuth 2.0 valide.
Le client OAuth authentifié n'a pas accès à cet espace de travail, un tel espace de travail n'existe pas, ou son jeton ne porte pas la portée write exigée par cet endpoint.
Aucun rapport e-reporting ne porte cet identifiant dans cet espace de travail.
Un autre traitement dépose ce rapport au même instant et cet appel n'a pas pu converger dessus, ou une transmission rectificative a trouvé une ligne de la période verrouillée par un autre traitement. Rien n'a été transmis ; réessayez dans un instant.
Le rapport ne peut pas être transmis. Avec code=validation_failed, c'est un verdict sur la déclaration - elle ne porte aucune donnée pour sa période, une partie n'a pas d'identifiant dans un référentiel accepté, une règle de conformité est violée, ou l'administration l'a déjà accepté - et il faut la corriger avant de rejouer l'appel. Avec code=schematron_engine_unavailable, le moteur de conformité n'a pas pu s'exécuter : rien n'a été jugé et le rapport n'est pas en cause, le même appel est donc rejoué à l'identique.