Liste des mйta-donnйes utiles au couple type / sous-type 4.8. CreerDossier – Crйation de dossier Remarque : il existe encore un Web-Service dйprйciй et obsolиte de crйation de « dossier PES » (hйritage de i-parapheur 2.1.5). Celui- ci n'est plus supportй ni maintenu а partir de la version 3.1 de i-parapheur. Le code disparaotra lors du passage version 4 vers version 5 : merci de migrer vers le service plus gйnйrique et complet prйsentй dans ce chapitre. CreerDossier – Ce web-service crйe un dossier selon les paramиtres fournis en entrйe, en contrфle la cohйrence, et le soumet а validation (il rйalise l’йmission en circuit de validation).
L’opйration de crйation de dossier est dite « atomique » : l'application mйtier fournit dans un seul appel SOAP l'ensemble des йlйments constituant un "dossier" au sens i-Parapheur du terme. Concernant le document principal, s'il est au format XML, l'application doit impйrativement l'accompagner d'un « visuel PDF » (voir le champ dйdiй а valoriser). Ce PDF fait partie du dossier сrйй, et sera utilisй par i-Parapheur pour prйsenter le document principal de faзon intelligible par le signataire. Il est possible (optionnel) de fournir en outre des documents annexes, des mйta-donnйes complйmentaires, et observation (publique, privйe) а l'attention de l'acteur en charge de la validation. 4.8.1.
Donnйes en entrйe ( Obligatoire ) Un type + un sous-type : йquivalent а un circuit de validation (cf. supra) ( Obligatoire ) DossierID (identifiant unique) : nom du dossier, il servira d'ID pour les requktes suivantes. Caractиres interdits : : & " Ј \ * / ? % | + ; (Option) Titre du dossier : йlйment affichй et visible en IHM (Option) adresse e-mail de l'йmetteur а notifier сфtй applicatif mйtier (Option, fortement dйconseillйe ) circuit de validation complet, qui shunte le circuit dйduit de la typologie. N’est utile que si il y a un moteur de workflow externe ( Obligatoire ) Document principal :
format PDF obligatoire pour ACTES, XML (PESv2) si flux HELIOS (comptabilitй publique DGFiP), ou document bureautique (PDF, TXT, ODT, RTF, ODS, ODP, DOC, XLS, PPT, JPG, PNG, GIF, DOCX, XLSX, PPTX) A noter que les formats DOCX/XLSX/PPTX sont acceptйs а discrйtion de l'exploitant de la plateforme. (Option) nom du fichier , si diffйrent du nom du dossier: les mkmes caractиres interdits que pour "dossierID". (Option) signature йlectronique dйtachйe PKCS7 si besoin, pour co-signature Si fichier XML et signature XAdES, fournir le chemin XPATH pour bloc а signer. - Visuel PDF (document format PDF) de visualisation si document principal est XML.
(Option) documents supplйmentaires а signer, si typologie adaptйe (Option) documents annexes, йventuellement avec signature ; ne seront pas signйs (Option) mйta-donnйes compatibles avec dictionnaire de mйta-donnйes i-Parapheur (Option) annotation publique et/ou privйe ( Obligatoire ) Visibilitй du dossier : publique, service, ou confidentiel (Option) date limite de signature (Option, DEPRECIE) mйta-donnйes pour tйlйtransmission ACTES А noter que : en cas de document principal au format XML (par exemple PESv2, ou EBICS SEPA), l’application i-Parapheur n'effectue pas de validation sur le XML selon le schйma XSD rйfйrent. 4.8.2.
Donnйes en sortie OK, ou KO avec message textuel d'erreur (le plus explicite possible). 4.9. GetHistoDossier – Interrogation d'histogramme de dossier GetHistoDossier – donne au demandeur le journal d’йvйnement du dossier passй en paramиtre. Manuel de spйcifications web-services SOAP i-Parapheur - Version 4.x page 16 / 25