OPALE:10.0:Dématérialisation avec eDoc

eDoc

Les imprimés d'écran ci-dessous proviennent du site eDOC : http://www.edoc.fr Merci de vous y référer pour plus de détails.

Pourquoi choisir MAPPING avec eDoc

Coffre-fort numérique

Collecteur de documents

Signature électronique

Dématérialisation des processus RH

Dématérialisation Fiscale

Dématérialisation des processus achats

Guichet Chorus

Intégration avec Mapping

Prérequis

Voici les prérequis nécessaires à l'envoi à E-DOC :

• Adresse IP et port accessible à partir du serveur IBM i du client
• Mapping M-PS i Opale 2018 minimum
• Mapping M-PS i paramétré en unicode
• Mapping M-PS i en mode XPS
• Avoir un fichier XPS avec les métadonnées du document à envoyer

Introduction

Afin de communiquer avec E-Doc, Mapping génère un fichier ZIP contenant un ou plusieurs documents au format PDF ainsi qu'un fichier XML listant tous les fichiers PDF inclus dans le ZIP avec toutes leurs métadonnées (Métadonnées nécessaires à E-Doc ainsi qu'à Chorus, le cas échéant). Une fois traités par E-Doc, les document seront ensuite visualisables via l'accès privé du client sur le portail EdocFactory. Les documents devant être visualisés ou stockés peuvent être de toutes sortes (bulletins de paie, factures, commandes, etc.). Les factures pour les administrations publiques sont aussi dématérialisées et envoyées vers le portail gouvernemental Chorus Pro. Mapping génère ce fichier ZIP et l'envoie à E-Doc via SFTP grâce à une commande unique : MAPEDOC.

Détails de la commande MAPEDOC

La commande MAPEDOC est une commande MAPPING utilisée pour envoyer un ou plusieurs documents à E-DOC.

Input file xps . . . . . . .    _______________________________________________________________________________ Chemin + nom du fichier XPS du document à envoyer à E-Doc
Name of the PDF  . . . . . .    _______________________________________________________________________________ Nom du fichier PDF à générer : L'utilisation des [[]] est possible afin d'éclater le fichier XPS en plusieurs PDFs 
Id Flux  . . . . . . . . . .    _______________________________________________________________________________ Numéro du flux : Utilisé par E-doc. Sa valeur sera présente dans le fichier XML généré. (dans la partie header du fichier XML) 
Emetteur Flux  . . . . . . .    _______________________________________________________________________________ Emetteur Flux : Utilisé par E-doc. Sa valeur sera présente dans le fichier XML généré. (dans la partie header du fichier XML) 
Title  . . . . . . . . . . .    _______________________________________________________________________________ Title : Utilisé par E-doc. Sa valeur sera présente dans le fichier XML généré. (dans la partie header du fichier XML) 
Comment  . . . . . . . . . .    _______________________________________________________________________________ Comment : Utilisé par E-doc. Sa valeur sera présente dans le fichier XML généré. (dans la partie header du fichier XML) 
DocFamily  . . . . . . . . .    _______________________________________________________________________________ DocFamily : Utilisé par E-doc. Sa valeur (DOSSIER_FINANCIER ou DOSSIER_RH sera présente dans le fichier XML généré. (dans la partie header du fichier XML)  
Customer Name  . . . . . . .    _______________________________________________________________________________ Customer Name : Utilisé par E-doc. Sa valeur sera présente dans le fichier XML généré. (dans la partie header du fichier XML) - par défaut égal à MAPPING 
Customer ID  . . . . . . . .    _______________________________________________________________________________ Customer ID : Utilisé par E-doc. Sa valeur sera présente dans le fichier XML généré. (dans la partie header du fichier XML) - Par défaut égal à 519 
User . . . . . . . . . . . .    _______________________________________________________________________________ User : Nom d'utilisateur de connexion au SFTP E-Doc
Server IP  . . . . . . . . .    _______________________________________________________________________________ Server IP : Adresse IP du serveur SFTP E-Doc, où seront envoyées les données 
Server Port  . . . . . . . . .    _____________________________________________________________________________ Server Port : Port utilisé pour la connexion SFTP E-Doc 
Directory  . . . . . . . .    _________________________________________________________________________________ Directory : Répertoire de dépot du serveur SFTP (où Mapping va déposer le fichier ZIP)
XML CodePage  . . . . . . . . .    ____________________________________________________________________________ XML CodePage : Code page du fichier XML a généré 

Métadonnéees nécessaires

Pour E-doc

Voici la liste des métadonnées nécessaires à eDoc :

Nom de la métadonnée	Description
DoId	Donneur d’ordre, mettre ici le code client unique, par exemple MP001 (CustomerID).
EtId	Etablissement, mettre ici le code unique qui identifie l’établissement. En absence d’établissements remettre le code du DoId.
IdDestinataire	Identifiant unique du destinataire pour cet ET. Apparaitra dans la colonne « Destinataire » de l’interface eDoc.
Type_IUN	Type du destinataire (de 1 à 7), indique si c’est un NIR ou un SIRET.
IUN	Identifiant Unique National pour le destinataire. N° de NIR pour un salarié, n° SIRET pour une personne morale.
RIC	RIC du coffre tier (s’il existe).
Type_Document	Identifiant indiquant le type de document. Apparaitra dans la colonne « Type de Document » de l’interface eDoc.
Date_Document	Date du document (facture…).
Description	Description du document (Titre du document). Apparaîtra dans la colonne « Description » de l’interface eDoc.
ED_Destinataire	Identifiant du destinataire (ex : SIRET).
ED_DestinataireMode	Mode de diffusion de ce document pour les destinataires. Absent si émetteur = destinataire.
ED_Emetteur	Indique si l’archivage doit être fait côté émetteur. Egale à la valeur de DoId ou de EtId.
ED_EmetteurMode	Dans le cas ou « ED_Emetteur » est présent ce champ doit contenir "Archivage" ou "Stockage".

Voici la liste des renseignements avancés concernant les métadonnées eDoc :

Voici quelques consignes pour renseigner la valeur de ces données. Il y a rejet du flux si une valeur obligatoire est absente.

Nom	Obligatoire	Instructions
DoId	Oui	Identifiant de client eDoc.
EtId	Oui	Identifiant d’établissement.
IdDestinataire	Oui	Matricule du salarié ; cas de la famille de document DOSSIER_RH. SIRET (société) ; cas de la famille de document DOSSIER_FINANCIER.
Type_IUN	Oui	Valeur de 1 à 7 (incluses). Passage en erreur si différent.
IUN	Oui	Numéro NIR (pour un salarié comme destinataire). SIRET (Pour une société comme destinatrice).
RIC	Non	Identifiant d’un coffre tiers.
Type_Document	Oui	RàS
Date_Document	Oui	RàS
Description	Non	RàS
ED_Destinataire	Non	Identifiant unique. SIRET (pour une société).
ED_DestinataireMode	Non	Si la famille de document est DOSSIER_FINANCIER ou DOSSIER_RH_NUL, alors sa valeur contient « emailPj », « emailLien », « Stockage » ou bien « Archivage ». Passage en erreur si différent. Si la famille de document est DOSSIER_RH, il faut la supprimer. Elle est supprimée automatiquement dans ce cas. Si ED_Emetteur = ED_Destinataire, il faut la supprimer. Elle est supprimée automatiquement dans ce cas.
ED_Emetteur	Non	Contient soit la même valeur que DoId soit la valeur de EtId. Sinon elle doit être supprimée. Elle est supprimée automatiquement dans ce cas.
ED_EmetteurMode	Non	A supprimer s’il n’y a pas d’ED_Emetteur. Elle est supprimée automatiquement dans ce cas. Sinon, sa valeur vaut « Archivage » ou « Stockage ». Passage en erreur si différent.

Pour Chorus

Ces métadonnées sont nécessaires pour Chorus. Leurs noms sont à définir par l’utilisateur et eDoc doit être configuré pour transmettre ces métadonnées vers Chorus. La casse (majuscule / minuscule) est importante.

Nom de la métadonnée	Description
Chorus_SiretEmetteur	Siret Emetteur
Chorus_SiretDestinataire	Siret Destinataire (payeur)
Chorus_NoFacture	N° facture
Chorus_DateFacture	Date de factur
Chorus_MontantHt	Montant HT
Chorus_MontantTtc	Montant TTC
Chorus_MontantTva	Montant TVA
Chorus_MontantNaP	Net à payer
Chorus_NoEngagement	N° d’engagement
Chorus_CodeService	Code service (Selon les organismes d’état)

Comment ajouter des métadonnées

Comme vu ci-dessus, Mapping utilise un fichier XPS comportant des métadonnées (Indexes). Ces métadonnées doivent être ajoutées dans le fichier XPS. Pour ce faire, 2 méthodes sont possibles sur Mapping M-PS i.

M-Designer

Les métadonnées peuvent être ajoutées par la maquette M-Designer. Pour ce faire, il faut ajouter des zones de type Metadata/Index ayant pour noms d'index les noms des métadonnées et pour valeur, soit une valeur en dur, soit une valeur provenant du fichier d'entrée (XML ou texte paginé).

Programme MAP_XPS

Il est également possible d'ajouter les métadonnées au fichier XPS en post-composition via le programme MAP_XPS. Voici un exemple pour ajouter au fichier XPS MonFichierXPS.xps l'index DoID avec pour valeur "MAVALEURDOID"

PGM(MAP_XPS) PARM('-infile:/home/maptopale/MonFichierXPS.xps' '-addCriteria:DoId=MAVALEURDOID')

Configuration du compteur

Cette partie est fournie uniquement à titre d'information.

Afin de numéroter les envois auprès d’eDoc, nous utilisons un compteur global. Aussi, nous avons créé une DTAARA MAPEDOCCNT pour la gestion de ce compteur.

Remarque : Le compteur n’est qu’un simple indicateur d’unicité des envois pour eDoc, le désordre et les trous sont tolérés.

Il n’est pas incrémenté avant la création du fichier ZIP final. Ainsi, les échecs avant l’utilisation du compteur n'entraînent pas l’incrémentation :

• Une erreur à la lecture du flux d'entrée
• Une erreur à la génération des PDF
• Une erreur à la vérification des index eDoc
• Une erreur à la génération du XML eDoc

Par contre, si des erreurs se produisent après l'incrémentation, le compteur garde sa valeur modifiée :

• Une erreur à la création du fichier ZIP de sortie (dans le répertoire Temp mapping)
• Une erreur à la suppression des fichiers temporaires
• Une erreur à l'envoi par SFTP (ce n'est pas le connecteur qui le fait, il faut utiliser une boite SFTP pour cela)