41
Pablo A 226 Spécifications fonctionnelles EDI échanges Opérateurs de détaxe - Pablo Version 2.0 du 29/03/2018 Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 1/41

A 226 Spécifications fonctionnelles EDI · Pablo_Specifications_EDI_Operateur_V2.0.1.odt SUIVI DES MODIFICATIONS Versions Rédactions Descriptions Vérification Date 2.0.0 Pablo

  • Upload
    others

  • View
    3

  • Download
    0

Embed Size (px)

Citation preview

  • Pablo

    A 226

    Spécifications fonctionnelles EDIéchanges Opérateurs de détaxe - Pablo

    Version 2.0 du 29/03/2018

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 1/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    SUIVI DES MODIFICATIONS

    Versions Rédactions Descriptions Vérification Date

    2.0.0 Pablo Refonte Bve CID 22/01/18

    2.0.1 CID Mise a jour champ facultatif Pablo 29/03/18

    LISTE DE DIFFUSION

    Organisations Noms Validation Info

    DGDDI - C1 X

    DGDDI - CID X

    Opérateurs de détaxe X

    DOCUMENTS DE REFERENCE

    Versions Titres

    ABREVIATIONS UTILISEESTermes Descriptions Translation

    BVE Bordereau de vente à l’exportation Tax refund form

    EDI échange de données informatisé

    PABLO Projet qui vise à dématérialiser le visa douanier sur les BVE

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 2/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    SOMMAIRE1 INTRODUCTION.........................................................................................................5

    1.1 GÉNÉRALITÉS...............................................................................................................51.2 LES ACTEURS................................................................................................................5

    1.2.1 Pablo.....................................................................................................................................51.2.2 Opérateurs EDI......................................................................................................................51.2.3 Mareva..................................................................................................................................5

    1.3 PRINCIPES DES ÉCHANGES............................................................................................51.4 PÉRIODICITÉ DES ÉCHANGES........................................................................................6

    1.4.1 Message d’intégration............................................................................................................61.4.2 Message d’apurement............................................................................................................61.4.3 Message « live status »..........................................................................................................71.4.4 Divers...................................................................................................................................7

    2 MODÉLISATION XML..................................................................................................82.1 PRINCIPES DE CONSTRUCTION......................................................................................82.2 ENCODAGE DES XML.....................................................................................................82.3 DÉFINITION DU SCHÉMA XML........................................................................................8

    2.3.1 Les types primitifs..................................................................................................................82.3.2 Les types simples particuliers..................................................................................................8

    3 DESCRIPTION DU MACRO-PROCESSUS.....................................................................113.1 SCHÉMA......................................................................................................................113.2 MESSAGES UTILISÉS...................................................................................................11

    4 ERREUR GLOBALE PABLO.........................................................................................124.1 CONTEXTE..................................................................................................................124.2 SCHÉMA......................................................................................................................12

    5 PROCESSUS “ENVOI LISTE DE BVE”..........................................................................135.1 CONTEXTE..................................................................................................................135.2 SCHÉMA......................................................................................................................135.3 DESCRIPTION DU PROCESSUS.....................................................................................145.4 MODÈLE GÉNÉRALE DES MESSAGES « ALLER ».............................................................155.5 EXEMPLE XML MODÈLE GÉNÉRALE DES MESSAGES.......................................................155.6 MODÈLE DU MESSAGE « A_E_C01 ».............................................................................165.7 EXEMPLE XML « A_E_C01 ».........................................................................................175.8 MODÈLE DU MESSAGE « R_AR_C02 »...........................................................................185.9 EXEMPLE XML « R_AR_C02 »......................................................................................185.10 MODÈLE DU MESSAGE « R_EC_C03 ».........................................................................195.11 EXEMPLE XML « R_EC_C03 ».....................................................................................19

    6 PROCESSUS « SUPPRESSION LISTE DE BVE »...........................................................206.1 CONTEXTE..................................................................................................................206.2 SCHÉMA......................................................................................................................206.3 DESCRIPTION DU PROCESSUS.....................................................................................216.4 MODÈLE DU MESSAGE « A_E_S01 ».............................................................................226.5 EXEMPLE XML « A_E_S01 »..........................................................................................226.6 MODÈLE DU MESSAGE « R_AR_S02 »...........................................................................23

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 3/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    6.7 EXEMPLE XML « R_AR_S02 ».......................................................................................236.8 MODÈLE DU MESSAGE « R_EC_S03 »...........................................................................246.9 EXEMPLE XML « R_EC_S03 »........................................................................................24

    7 PROCESSUS «APUREMENT LISTE BVE »....................................................................257.1 CONTEXTE..................................................................................................................257.2 SCHÉMA......................................................................................................................257.3 DESCRIPTION DU PROCESSUS.....................................................................................257.4 MODÈLE DU MESSAGE « R_E_A01 ».............................................................................267.5 EXEMPLE XML « R_E_A01 »..........................................................................................277.6 MODÈLE DU MESSAGE « A_AR_A02 » ..........................................................................287.7 EXEMPLE XML « A_AR_A02 »........................................................................................287.8 MODÈLE DU MESSAGE « A_EC_A03 »...........................................................................297.9 EXEMPLE XML « A_EC_A03 »........................................................................................29

    8 PROCESSUS « INFORMATION STATUTS BVE »...........................................................308.1 CONTEXTE..................................................................................................................308.2 SCHÉMA......................................................................................................................308.3 DESCRIPTION DU PROCESSUS.....................................................................................308.4 MODÈLE DU MESSAGE « R_E_IS »................................................................................318.5 EXEMPLE XML « R_E_IS »............................................................................................31

    9 ANNEXES DU DOCUMENT.........................................................................................329.1 SCHÉMA DÉFINITION XML - XSD..................................................................................329.2 MESSAGE XML : EXEMPLES D’IMPLÉMENTATION...........................................................33

    9.2.1 Erreur globale (Message Mareva)..........................................................................................339.2.2 Exemple Message Erreur Globale Pablo..................................................................................33

    9.3 LES DIFFÉRENTS MESSAGES D’ERREUR ET D’AVERTISSEMENT.......................................349.3.1 Les erreurs et avertissements liés à l’apurement....................................................................349.3.2 Les échecs de création / Integration errors............................................................................369.3.3 Les échecs de suppression / Deletion errors...........................................................................399.3.4 Les codes motifs..................................................................................................................399.3.5 Les erreurs globales.............................................................................................................39

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 4/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    1 INTRODUCTION1.1 GÉNÉRALITÉS

    Ce guide est à destination des services informatiques douaniers et des opérateurs EDIpartenaires.Il comporte toutes les spécifications nécessaires au traitement des messages EDI dans le cadrede Pablo.

    Ce document présente l’ensemble des messages fonctionnels qui devront être échangés entre lessystèmes d’information mis en place par les opérateurs de détaxe et celui de la douane : PABLO.

    1.2 LES ACTEURS

    1.2.1 PABLO

    Système informatique permettant aux services douaniers de dématérialiser le cachetdélivré à la détaxe dans le cadre de la procédure de vente à l’exportation (remboursement de laTVA).

    1.2.2 OPÉRATEURS EDI

    Opérateurs de détaxe. Ils transmettent à la douane les bordereaux de vente en détaxePablo établis par leurs magasins partenaires.Cet échange s’effectue en EDI, au travers de la plate-forme MAREVA.

    1.2.3 MAREVA

    MAREVA est le système d’échange inter applicatif entre la douane et ses partenaires. Ilutilise des mécanismes de type EDI.Les dialogues entre les acteurs reposent sur les standards suivants :

    • SMTP pour le protocole de transport ;• XML pour le format des données échangées.

    Des informations concernant le protocole MAREVA sont disponibles sur le portail des opérateursProdou@ne : https://pro.douane.gouv.fr/ => rubrique : Guichet EDI.

    1.3 PRINCIPES DES ÉCHANGES

    Une unité d’échange est composé de la façon suivante :

    • Un en-tête décrivant la transaction (gérée par le protocole MAREVA) ;• Les données applicatives appelées « message fonctionnel ».

    Cette structure ainsi que les informations sur les erreurs de structure sont détaillées dans ledocument Système d’échanges applicatifs EDI avec la Douane – MAREVA – Spécifications pourles partenaires disponibles sur le portail ProDouane.

    Chaque émetteur doit fournir ses données d’identification dans l’entête décrivant la transaction.

    Chaque message envoyé ou reçu en utilisant le protocole MAREVA doit être suivi d’un accusé deréception technique . Celui-ci indique que la transmission du message entre les systèmes s’estdéroulée correctement.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 5/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    En plus de ces messages techniques, PABLO met en place un accusé de réceptionfonctionnel qui indique si l’intégration du message s’est correctement déroulée.

    Voici la cinématique des différents messages fonctionnels :

    • Le sens ALLER est celui de l’opérateur vers la douane• Le sens RETOUR est celui de la douane vers l’opérateur

    Ainsi, un message ALLER sera suivi d’au moins un message RETOUR qui constituera l’accusé deréception fonctionnel.

    Si l’intégration du message s’est correctement déroulée, il y aura un seul message RETOUR detype AR.Si l’intégration du message a totalement échouée, il y aura un seul message RETOUR de typeEC.Mais si l’intégration du message a été partiellement effectuée, il y aura deux messages RETOUR,un de type AR et un de type EC, pour indiquer ce qui a réussi et ce qui a échoué.

    1.4 PÉRIODICITÉ DES ÉCHANGES

    1.4.1 MESSAGE D’INTÉGRATION

    Les opérateurs doivent faire en sorte de transmettre le plus rapidement possible les BVEédités chez leurs commerçants partenaires au travers du message d’intégration Pablo.

    En cas d’indisponibilité de la plate-forme d’échange Mareva ou de Pablo, les bordereaux àl’intégration (ou à la suppression) seront normalement placés dans une file d’attente, l’accuséd’intégration sera envoyé au moment de la prise en charge du message par Pablo. Il n’est pasnécessaire de ré-émettre systématique un bordereau à l’intégration au risque d’obtenir unmessage d’erreur EC302.

    1.4.2 MESSAGE D’APUREMENT

    Les messages liés à l’apurement des BVE (type « R_E_A01 ») sont transmis quotidiennement parla douane et contiennent tous les BVE confirmés et annulés dans la journée précédente.

    L’envoi est réalisé à J+1, à partir de 0h45. (J=date de confirmation/annulation des BVE).

    À réception de l’accusé de réception fonctionnel transmis par l’opérateur (type « A_AR_A02 » ou« A_EC_A03 » en réponse à un « R_E_A01 »), le système Pablo se chargera d’apurer lesbordereaux dans le système. En raison de contraintes techniques, cette opération d’apurementdes bordereaux est activée sur le créneau suivant : 22h30 – 5h30

    Tant que le système n’aura pas reçu l’accusé de réception fonctionnel pour tous les bordereaux dece message, il continuera d’émettre un message d’apurement avec ces bordereaux.

    Ainsi, le message d’apurement peut contenir des BVE confirmés et annulés dans la journéeprécédente mais aussi des BVE n’ayant pas obtenu l’accusé de réception fonctionnel du messaged’apurement précédent.

    Enfin, durant le créneau alloué aux opérations d’apurement, le processusd’intégration/suppression (type « A_E_C01 » et « A_E_S01 ») reste opérationnel. Les deuxopérations ne sont toutefois pas parallélisées.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 6/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    1.4.3 MESSAGE « LIVE STATUS »

    La douane peut envoyer, sur demande de l’opérateur de détaxe , un message d’informationconcernant l’évolution du statut de ses bordereaux. Cet envoi a lieu toutes les 5 minutes enfonction du besoin.

    1.4.4 DIVERS

    Lorsque l’opérateur n’a pas envoyé de message 24 ou 48 heures après le dernier envoi, uncourriel est adressé sur la messagerie électronique personnelle du contact identifié pourl’opérateur, l’informant de l’absence de transmission d’information.L’envoi du courriel est manuel.L’opérateur devra en outre retransmettre les messages non envoyés pendant la coupure.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 7/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    2 MODÉLISATION XML2.1 PRINCIPES DE CONSTRUCTION

    Chaque schéma décrit un type de message donné. Nous définissons donc 9 types deschémas distincts (ex :A_E_C01, etc – description infra- ). Ces schémas décrivent la structure duXML et les types des données à saisir.

    Nous définissons également des types de données simples qui précisent le format desinformations basé sur un type de données primitif défini. L’utilisation de ces schémas permettra àl’expéditeur de valider avant l’envoi la structure générale des fichiers XML.

    2.2 ENCODAGE DES XML

    L'encodage attendu des fichiers XML est l' « ISO-8859-1 ».

    2.3 DÉFINITION DU SCHÉMA XML

    Un xsd est mis en place pour les flux « ALLER » (A_E_C01, A_E_S01, A_AR_A02 ou A_E_A03),il permet de définir la structure et le type de contenu des différents flux XML.Ce schéma permet notamment de vérifier la validité de ce document.Cf : Annexe

    2.3.1 LES TYPES PRIMITIFS

    Chaque balise du flux XML est typé sur la base d’un type primitif.

    Type Définition

    TypeAlphanumeric Chaîne de caractères de type Alphanumérique non vide.

    TypeAlphanumeric500 Chaîne de 500 caractères maximum, basé sur « TypeAlphanumeric ».

    TypeAlphanumeric200 Chaîne de 200 caractères maximum, basé sur « TypeAlphanumeric ».

    TypeAlphanumeric50 Chaîne de 50 caractères maximum, basé sur « TypeAlphanumeric ».

    TypeAlphanumeric30 Chaîne de 30 caractères maximum, basé sur « TypeAlphanumeric ».

    TypeAlphanumeric20to24 Chaîne de 20 à 24 caractères, basé sur « TypeAlphanumeric ».

    TypeAlphanumeric500 Chaîne de 500 caractères maximum, basé sur « TypeAlphanumeric ».

    TypeDateJJMMAA Date au format « JJ/MM/AA ».

    TypeDateJJMMAAAA Date au format « JJ/MM/AAAA ».

    TypeDateAAAAMMJJTHHMMSSCCC

    Date au format « AAAA-MM-JJTHH:MM:SS.CCC±00:00 »

    TypeTimeHHMMSS Heure au format « HH:MM:SS »

    TypeNumeric Nombre

    TypeMontant Nombre décimal avec 2 chiffres après la virgule

    2.3.2 LES TYPES SIMPLES PARTICULIERS

    Présentation des types de données simples non-exhaustive .

    Le type IDENTIFIANT_BVE

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 8/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    Ce type définit l’identifiant du BVE . Nous laissons la liberté aux opérateurs d’utiliser un codecompris entre 20 et 24 caractères alphanumériques. Il doit être unique durant toute la durée de viedu BVE (3 ans plus l’année en cours). C’est à partir de ce code que doit être établi le code àbarres du bordereau selon la norme code 128.

    Les opérateurs mettant en place ce nouveau dispositif devront préfixer leur code d’un identifiantopérateur (sur deux positions). La longueur du code, préfixe compris, ne dépassera pas 24caractères. Le choix du préfixe devra faire l’objet d’une validation par la douane.

    Opérateurs Préfixe Identifiants

    Exemple opérateur dedétaxe A

    De 80 à 89

    Les opérateurs disposant déjà d’un dispositif d’identification des BVE par code à barrescontinueront à utiliser leur codification, pour peu que celle-ci soit compatible avec Pablo (format,longueur et préfixe)

    Le type TDATE_EMISSION

    Ce type définit l’horodatage de l’émission du bordereau basé sur le fuseau horaire de Paris (priseen compte éventuelle de l’heure d’été). Il doit être égale ou anterieur à maximum 3 mois + moisen cours à la date actuelle.

    Données

    Exemple dated’émission

    2017-11-23T10:50:00.458+02:00

    Le type TPASSEPORT

    Ce type défini le numéro de passeport du voyageur.Le numéro de passeport est obligatoire et doit être inférieur ou égal à 30 caractèresalphanumériques.

    Le type TDATE_NAISSANCE

    Ce type définit la date de naissance du voyageur. Il doit être au format JJ/MM/AAAA.Le voyageur doit avoir plus de 16 ans et moins de 120 ans.

    Le type TPAYS_RESIDENCE et TNATIONALITE

    Composé de 2 caractères basé selon la norme ISO 3166-1 "alpha-2"

    RESIDENCE Données

    Argentine AR

    Mont Athos G1

    La liste des codes ISO éligibles/non éligibles à la détaxe en France est disponible sousProDouane.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 9/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    Le type TTYPE_IDENTIFIANT

    Le type d’identifiant permet de préciser la nature de l’identifiant utilisé par l’opérateur pourdésigner le commerçant ayant effectué la vente en détaxe.

    Ce type contient 3 valeurs possibles :

    Nature de l’identifiant Type identifiant vendeur

    Numéro SIRET 1

    Numéro SIREN 2

    Numéro TVA 3

    Le type TIDENTIFIANT

    Le type TIDENTIFIANT est un champ de saisie contenant 9 caractères numérique s’il s’agit d’unnuméro SIREN, 13 caractères alpha-numérique s’il s’agit d’un numéro de TVA ou 14 caractèresnumérique s’il s’agit d’un numéro SIRET. Il doit être valide et repris dans la base SIRENE.

    Le type TTAUX_TVA

    Le type TTAUX_TVA est une valeur numérique décimal qui définit le taux de TVA. Il doit êtreinférieur à 1 et en cours de validité.Le séparateur décimal doit être un point (« . »).

    Les types TMONTANT_TTC, TMONTANT_TVA, TMONTANT_REMB OURSEMENT, TMONTANT_TOTAL_TVA et TMONTANT_TOTAL_TTC.

    Ces types sont des valeurs numériques qui définissent le format des montants en euros (TTC,TVA, Remboursement).Le nombre doit être un décimal à deux chiffres. Le séparateur décimal doit être un point («. »).

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 10/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    3 DESCRIPTION DU MACRO-PROCESSUS3.1 SCHÉMA

    Voici la liste des Macro-processus Pablo identifiés. Une description détaillée est proposéedans la suite du document :

    Processus

    Erreur Globale PABLO

    Envoi Liste BVE

    Suppression Liste BVE

    Apurement Liste BVE

    Information Statuts BVE

    3.2 MESSAGES UTILISÉS

    Description des messages utilisés dans le processus :

    libellé Description

    A_E_C01 Message de creation de BVE transmis par les OPÉRATE URS EDI.

    R_AR_C02 Message de rapport ‘Accusé de réception RÉUSSITE’ suite à un message de création de BVE.

    R_EC_C03 Message de rapport ‘Échec de l’intégration de BVE’ suite à un message de création de BVE.

    A_E_S01 Message de suppression de BVE.

    R_AR_S02 Message de rapport ‘Accusé de réception RÉUSSITE’ suite à un message de suppression de BVE.

    R_EC_S03 Message de rapport ‘Échec de la suppression de BVE’ suite à un message de suppression de BVE.

    R_E_A01 Message d’apurement des BVE.

    A_AR_A02 Message de rapport ‘Accusé de réception RÉUSSITE’ suite à un message d’apurement de BVE.

    A_EC_A03 Message de rapport ‘Échec de l’apurement des BVE’ suite à un message d’apurement desBVE.

    R_E_IS Message d’information de changement de statut « au fil de l’eau »

    En cas de difficulté majeure du système Pablo, celui-ci peut envoyer un message de typeErreur Globale.Dans ce cas, aucun autre message ne sera transmis par PABLO à l’opérateur qui doit considérerque l’intégralité des BVE transmis sont en échec.Comme tout message issu de la douane, ce message d’erreur globale doit être apurétechniquement pour MAREVA.

    Afin d’éviter la saturation du système, il est convenu que chaque message envoyé (unitéd’échange) contiendra au maximum 1.000 BVE.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 11/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    4 ERREUR GLOBALE PABLO4.1 CONTEXTE

    Lorsque le message ne peut être traité suite à une mauvaise structuration du message ouune erreur interne au dispositif Pablo, un message d’erreur globale Pablo est transmis àl’opérateur pour notifier que le message n’a pas été traité d’une part et d’autre part pour détailler leproblème rencontré.

    Ce message doit être apuré techniquement (pour MAREVA) par l’opérateur.

    4.2 SCHÉMA

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 12/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    5 PROCESSUS “ENVOI LISTE DE BVE”5.1 CONTEXTE

    Une intégration sans erreur d’un message ALLER renvoi un accusé de réceptionfonctionnel de type AR contenant la liste de tous les BVE

    Une intégration partiellement réussie d’un message ALLER se traduit par le renvoi à l’émetteur dedeux messages RETOUR :

    • un accusé de réception fonctionnel de type AR contenant la liste de tous les BVE intégrésnormalement.

    • Un message de notification d’échec (EC) contenant la liste de tous les BVE qui n’ont pasété intégrés au système ainsi que leur code erreur associé.

    L’échec total d’un message ALLER se traduit par un message de notification d’échec reprenant laliste de tous les BVE de l’envoi s’il a été possible d’identifier les BVE au niveau de la douane.Sinon, un message d’erreur globale est envoyé.

    5.2 SCHÉMA

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 13/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    5.3 DESCRIPTION DU PROCESSUS

    Transmettre liste BVE : L’opérateur de détaxe transmet la liste des BVE intégrés par sesmagasins partenaires.Cette transmission de BVE s’effectue au travers d’un message A_E_C01.

    Recevoir messages : La messagerie applicative MAREVA réceptionne le(s) message(s) del’opérateur.

    Vérifier messages : Le système Pablo effectue un contrôle du contenu des messages. Si lemessage est valide, il traite les BVE contenu dans ce message.En cas d’invalidité, une notification est envoyée à l’opérateur.

    Notifier traitement OK : Les BVE valides sont intégrés dans le système. Le message R_AR_C02est transmis à l’opérateur. Il liste les BVE correctement traités.

    Notifier traitement KO : Les BVE non valides sont rejetés et le message R_EC_C03 est transmisà l’opérateur. Il liste les BVE rejetés, en mentionnant la raison de leur invalidité.

    Réceptionner notifications : MAREVA reçoit les notifications de Pablo (R_EC_C03 en casd’erreur et R_AR_C02 en cas de bonne intégration).Ces messages sont envoyés à l’opérateur.

    Traiter notifications : L’opérateur reçoit les messages de MAREVA. Pour les BVE contenus dansle message R_AR_C02, le processus est terminé.

    Si un BVE ne reçoit pas l’accusé de réception fonctionnel de t ype R_AR_C02, celui-ci devraêtre renvoyé après correction des erreurs éventuelles sauf si l’erreur rencontrée est due àune intégration déjà effective du BVE.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 14/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    5.4 MODÈLE GÉNÉRAL DES MESSAGES « ALLER »

    Modèle propre au protocole MAREVA + (Message A_E_C01, A_E_S01, A_AR_A02 ou A_E_A03 défini dans les points suivants).

    5.5 EXEMPLE XML MODÈLE GÉNÉRAL DES MESSAGES

    Données fictives utilisées dans l’exemple (les champs encadrés en pointillés sur le modèle sont facultatifs):

    1234567891011100000000123456

    01/01/0000:00:00

    Pablo

    MessageXXXXXXXXX123456789XXXXXXXXXXXXXxx

    ...

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 15/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    5.6 MODÈLE DU MESSAGE « A_E_C01 »

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 16/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    5.7 EXEMPLE XML « A_E_C01 »

    Données fictives utilisées dans l’exemple (les champs encadrés en pointillés sur le modèle sont facultatifs :

    123456789ABCDE2018-01-01T12:59:03.160+02:00

    A1B2C3D4E56F7G8H901/01/2030DOEJOHN01/01/1950JPJPRue du pavé[email protected]

    112346578901234la boutique [email protected]

    Chaussure Femmes51A23SD89123456789250.1960256.0050.176

    256.0050.176256.001Ticket Service3

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 17/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    5.8 MODÈLE DU MESSAGE « R_AR_C02 »

    5.9 EXEMPLE XML « R_AR_C02 »

    Confirmation de création de 3 BVE dans la base Pablo de la douane.

    13013311208362885318

    13013311208362885325

    13013311208362885339

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 18/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    5.10 MODÈLE DU MESSAGE « R_EC_C03 »

    5.11 EXEMPLE XML « R_EC_C03 »

    Erreur de création de 3 BVE dans la base Pablo de la douane avec transmission des codes erreurs associés.

    Erreur traitement : identifiant BVE déjà existant. 13013311208362885318 Erreur traitement : identifiant BVE déjà existant. 13013311208362885325 Erreur traitement : identifiant BVE déjà existant. 13013311208362885339

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 19/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    6 PROCESSUS « SUPPRESSION LISTE DE BVE »6.1 CONTEXTE

    La suppression d’une liste de BVE est limitée aux cas où l’opérateur, suite à desproblèmes techniques, a envoyé au système Pablo des données erronées ou incomplètes. Ilprocède alors à la suppression des BVE concernés puis à l’envoi des données corrigées.

    L’opérateur s’assure que les données transmises à la douane correspondent toujours strictementaux données imprimées sur le BVE du voyageur. Il ne peut donc y avoir, par ce biais, de correctionou d’annulation d’une opération, dès lors que celle-ci a été transmise à la douane.

    6.2 SCHÉMA

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 20/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    6.3 DESCRIPTION DU PROCESSUS

    1. Transmettre liste BVE : L’opérateur de détaxe transmet la liste des BVE à supprimer.Cette transmission de BVE s’effectue au travers d’un message A_E_S01.

    2. Recevoir messages : La messagerie applicative MAREVA réceptionne le(s) message(s)de l’opérateur.

    3. Notifier traitement OK : Les BVE valides sont supprimés dans le système. Le messageR_AR_S02 est transmis à l’opérateur. Il liste les BVE correctement traités.

    4. Notifier traitement KO : Les BVE non valides sont rejetés et le message R_EC_S03 esttransmis à l’opérateur. Il liste les BVE rejetés, en mentionnant la raison de leur invalidité.

    5. Réceptionner notifications : Mareva reçoit les notifications de Pablo (R_EC_S03 en casd’erreur et R_AR_S02 en cas de bonne suppression). Ces messages sont envoyés àl’opérateur.

    6. Traiter notifications : L’opérateur reçoit les messages de Mareva. Pour les BVE contenusdans le message R_AR_S02 , le processus est terminé. En revanche, pour ceux figurantdans R_EC_S03, l’opérateur relance le processus à moins que l’erreur soit dû à lasuppression déjà effective du BVE.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 21/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    6.4 MODÈLE DU MESSAGE « A_E_S01 »

    6.5 EXEMPLE XML « A_E_S01 »

    Demande de suppression de 2 BVE dans la base Pablo de la douane. Message envoyé par un opérateur.

    25020193793188477019 Motif de suppression : Problème technique du système. 25010010005034515525 Motif de suppression : Problème technique du système.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 22/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    6.6 MODÈLE DU MESSAGE « R_AR_S02 »

    6.7 EXEMPLE XML « R_AR_S02 »

    Confirmation suppression de 2 BVE dans la base Pablo de la douane.

    15090619150157462751

    15090619150158462782

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 23/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    6.8 MODÈLE DU MESSAGE « R_EC_S03 »

    6.9 EXEMPLE XML « R_EC_S03 »

    1509061910049642784 Erreur syntaxe : champs IDENTIFIANT_BVE incorrect.

    15090619140050764956Erreur traitement : identifiant BVE non reconnu.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 24/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    7 PROCESSUS «APUREMENT LISTE BVE »7.1 CONTEXTE

    Toutes les nuits, la douane transmet aux opérateurs la liste des BVE à apurer.

    7.2 SCHÉMA

    7.3 DESCRIPTION DU PROCESSUS

    1. Transmettre liste BVE : La douane transmet la liste des BVE à apurer. Cette transmission de BVE s’effectue au travers d’un message R_E_A01.

    2. Notifier traitement OK : Le message A_AR_A02 est transmis à la douane.

    3. Notifier traitement KO : Le message A_EC_A03 est transmis à la douane.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 25/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    7.4 MODÈLE DU MESSAGE « R_E_A01 »

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 26/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    7.5 EXEMPLE XML « R_E_A01 »

    Message de la douane à destination des opérateurs qui liste les BVE à apurer.

    15090619150236513489APUREROISSY VOYAGEURS

    25072011

    15090619150237154267APUREString

    25072011

    15090619150238541368ANNULEROISSY VOYAGEURS

    25072011

    Irrégularités constatées.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 27/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    7.6 MODÈLE DU MESSAGE « A_AR_A02 »

    7.7 EXEMPLE XML « A_AR_A02 »

    Message des opérateurs qui liste les BVE qui ont été traités (apurés) dans le système de l’opérateur.

    15183327483373348657

    15183327483373349271

    15183327468373690357

    15003327468356405356

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 28/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    7.8 MODÈLE DU MESSAGE « A_EC_A03 »

    7.9 EXEMPLE XML « A_EC_A03 »

    15090619150184846251 Erreur traitement : identifiant BVE non reconnu.

    15090619150185815452Erreur traitement : date d’apurement BVE antérieure à quatre

    mois.

    15090619150186846513 Erreur syntaxe !

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 29/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    8 PROCESSUS « INFORMATION STATUTS BVE »8.1 CONTEXTE

    L’envoi EDI des statuts des bordereaux confirmés ou annulés est effectué par un batchnocturne à J+1. Ce système ayant des limites fonctionnelles, il a été décidé de le compléter par unenvoi « au fil de l’eau » des statuts.

    Le nouveau système collecte régulièrement les bordereaux ayant acquit un statut « ANNULE » ou« CONFIRME » afin de les transmettre par EDI aux opérateurs concernés.

    Chaque opérateur est alors en mesure de fournir aux sociétés de remboursement le statut desbordereaux, leurs permettant ainsi d’accéder à l’information au travers d’un outil informatiqueunique.

    Attention, ce message est un message d’information et le statut peut toujours faire l’objet d’unemodification suite à contrôle par exemple.

    8.2 SCHÉMA

    8.3 DESCRIPTION DU PROCESSUS

    1. Constitution_Message_R_E_IS : Le système PABLO collecte les bordereaux qui ont étéconfirmés ou annulés depuis le dernier envoi et génère un message XML R_E_IS constituédes informations relatives à ces bordereaux.

    2. Envoi_Message_R_E_IS : Le système PABLO procède à l’envoi du message R_E_IS viala messagerie applicative MAREVA et n’attend pas de confirmation de la part de l’opérateurde détaxe.

    3. Intégration_Message_R_E_IS : Les bordereaux du message R_E_IS sont intégrés dansle système opérateur de détaxe.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 30/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    8.4 MODÈLE DU MESSAGE « R_E_IS »

    8.5 EXEMPLE XML « R_E_IS »

    Message R_E_IS1.0XXXXXXXXXX00000054280

    15090619150236513285

    CONFIRMEDRoissy 1 bse T12012-01-11T16:10:00.000+01:00

    15090619150237462752CONFIRMEDRoissy bse T2E2012-01-11T16:10:00.000+01:00

    15090619150238346527CANCELLEDRoissy bse T2C2012-01-11T16:10:00.000+01:00Irrégularités constatées.

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 31/41

  • PabloSpécifications fonctionnelles EDI

    Pablo_Specifications_EDI_Operateur_V2.0.1.odt

    9 ANNEXES DU DOCUMENT9.1 SCHÉMA DÉFINITION XML - XSD

    Differents XSD seront fournis à partir desquel les flux allers seront créées :

    • DataType.xsd définit les type primitifs et simples particuliers.

    • SchemaMessagePablo.xsd définit la structure racine, elle est composée de :

    ◦ EnveloppeConnexion.xsd définit la structure commune à l’enveloppe de connexion.

    ◦ EnveloppeMessage.xsd définit la structure commune à l’enveloppe des messages A_E_C01, A_E_S01, A_AR_A02 ou A_E_A03

    ◦ SchemaMessageA_E_C01.xsd

    }Definit le schéma selon le message.◦ SchemaMessageA_E_S01.xsd◦ SchemaMessageA_EC_A03.xsd◦ SchemaMessageA_AR_A02.xsd

    Ce document est la propriété de la DGDDI et ne peut être ni divulgué ni copié sans son autorisation. Les citations doivent mentionner la source. Page 32/41

  • 9.2 MESSAGE XML : EXEMPLES D’IMPLÉMENTATION

    9.2.1 ERREUR GLOBALE (MESSAGE MAREVA)

    Schéma Message Erreur Globale Mareva

    9.2.2 EXEMPLE MESSAGE ERREUR GLOBALE PABLO

    Attention : Ce message d’erreur inclut sa propre en veloppe de connexion MAREVA et sa structure est indépendante de la structure génériqu e des autres messages.

    DGDDI000000542762856

    11/12/1215:50:51

    Pablo-test

    G0004Une erreur applicative est apparue, veuillez signaler

    ce problème à l’administrateur de l’application. Veuillez nous excuser pour la gêne occasionnée.

  • 9.3 LES DIFFÉRENTS MESSAGES D’ERREUR ET D’AVERTISSEMENT

    (hors message technique de communication Cf. Documentation Mareva)

    Le tableau suivant recense les erreurs, qui peuvent être signalées à l’opérateur ou à ladouane, justifiant ainsi l’échec d’une opération. En outre, il contient les avertissements et lesmotifs courants qui peuvent être indiqués en informations complémentaires.

    9.3.1 LES ERREURS ET AVERTISSEMENTS LIÉS À L’APUREMENT

    Code Description

    AA101 Avertissement : syntaxe incorrecte pour le champ MOTIF.

    AA201 Avertissement : Balise MOTIF non trouvée.

    AA202 Avertissement : attribut Code Motif non trouvé.

    AA301 Avertissement : Code Motif non existant.

    AC201 Avertissement : Balise MONTANT_REMBOURSEMENT non trouvée.

    AC202 Avertissement : Balise VOYAGEUR_ADRESSE non trouvée.

    AC301 Avertissement : IDENTIFIANT_VENDEUR non reconnu.

    AS101 Avertissement : syntaxe incorrecte pour le champ CAUSE.

    AS201 Avertissement : Balise CAUSE non trouvée.

    EA101 Erreur syntaxe :champ IDENTIFIANT_BVE incorrect.

    EA102 Erreur syntaxe : champ STATUT incorrect.

    EA103 Erreur syntaxe : champ LIEU incorrect.

    EA104 Erreur syntaxe : champ JOUR incorrect.

    EA105 Erreur syntaxe : champ MOIS incorrect.

    EA106 Erreur syntaxe : champ ANNEE incorrect.

    EA107 Erreur syntaxe : erreur inconnue.

    EA200 Erreur récupération : XML non valide.Parsing Error : Unable to parse XML.

    EA201 Erreur récupération :champ IDENTIFIANT_BVE nul.

    EA203 Erreur récupération : champsSTAUT nul.

    EA204 Erreur récupération : champ LIEU nul.

    EA205 Erreur récupération : champsJOUR nul.

    EA206 Erreur récupération : champ MOIS nul.

    EA207 Erreur récupération : champ ANNEE nul.

    EA208 Erreur récupération : Balise IDENTIFIANT_BVE non trouvée.

    EA209 Erreur récupération : Balise STATUT non trouvée.

    EA210 Erreur récupération :Balise LIEU non trouvée.

    EA211 Erreur récupération : Balise JOUR non trouvée.

  • Code Description

    EA212 Erreur récupération : Balise MOIS non trouvée.

    EA213 Erreur récupération :Balise ANNEE non trouvée.

    EA214 Erreur récupération :Balise DATE_STATUT non trouvée.

    EA215 Erreur récupération :Balise APURE_BVE non trouvée.

    EA216 Erreur récupération erreur inconnue.

    EA300 Erreur traitement : traitement impossible.

    EA301 Erreur traitement : identifiant BVE non reconnu.

    EA302 Erreur traitement : statut BVE déjà APURE.

    EA303 Erreur traitement : statut BVE déjà ANNULE.

    EA304 Erreur traitement : date d’apurement BVE supérieure à la date actuelle.

    EA306 Erreur traitement : date d’apurement/annulation antérieure à date d’émission.

    EA307 Erreur traitement : non traité. (quota erreurs fichiers dépassé).

    EA308 Erreur traitement : erreur interne au serveur.

  • 9.3.2 LES ÉCHECS DE CRÉATION / INTEGRATION ERRORS

    Code Description Translation/Pattern

    EC301 Erreur traitement :erreur interne au serveur. Processing Error : Server internal error.

  • Code Description Translation/Pattern

    EC302 Erreur traitement : identifiant BVE déjà existant. Processing Error : ExistingIDENTIFIANT_BVE.

    EC303 Erreur traitement : date d’émission BVE supérieure à la date actuelle.

    Processing Error : The date of issue ishigher than the current date.

    EC304 Erreur traitement :date d’émission BVE antérieure à quatre mois.

    Processing Error : The date of issue isearlier than four months.

    EC305 Erreur traitement : date d’émission incohérente. Processing Error : The date of issue isinconsistent.

    EC306 Erreur traitement : Code ISO pays non existant. Processing Error : Country code isunknown.

    EC307 Erreur traitement : erreur inconnue. Processing Error : Unknown error.

    EC308 Erreur traitement : non traité. (quota erreurs fichiers dépassé).

    Processing Error : Error number is overquota.

    EC309 Erreur traitement : montant du BVE est inférieur au seuil légal.

    Processing Error : Amount of BVE is belowthe legal limit.

    EC310 Erreur traitement : pays non éligible à la détaxe. Processing Error : Country not eligible fortax refund.

    EC312 Erreur traitement : vendeur non existant. Processing Error : The seller is unknown.EC313 Erreur traitement : Identifiant TVA du vendeur

    non existant.Processing Error : The seller’s VAT ID is

    unknown.EC314 "Erreur traitement : Identifiant vendeur non

    existant.Processing Error : The seller’s ID is

    unknown.EC315 Erreur traitement : Séquence BVE incohérente. Processing Error : The sequence number of

    the BVE is incoherent

    EC316 Erreur traitement : Date de naissance incorrect (-16 ou +120).

    Processing Error :The date of birth is invalid

    EC317 Erreur traitement : Montant total TTC incorrect. Processing Error : Total Amount includingtaxes is invalid.

    EC318 Erreur traitement : Montant TTC incorrect. Processing Error : Amount including taxesis invalid.

  • Code Description Translation/Pattern

    EC319 Erreur traitement : Montant TVA incorrect. Processing Error : VAT amount is invalid.EC320 Erreur traitement : Date d’expiration du

    passeport incorrect.Processing Error : Passport expiration date

    is invalid .EC321 Erreur traitement : Code du produit incorrect. Processing Error : Product code is invalid.EC322 Erreur traitement : Taux de TVA inexistant. Processing Error :VAT rate is unknown.EC323 Erreur traitement : Montant du remboursement

    incorrect.Processing Error : Refunf amount is invalid.

    EC324 Erreur traitement : Mode de paiemenent inexistant.

    Processing Error : Payment mode does notinexist.

    EC325 Erreur traitement : Mode de remboursement inexistant.

    Processing Error :Refund mode does notinexist.

    EC326 Erreur traitement : Code produit inexistant. Processing Error : Product code is unkown.EC327 Erreur traitement : Montant total TVA incorrect. Processing Error :Totam VAT amount is

    invalid.

  • 9.3.3 LES ÉCHECS DE SUPPRESSION / DELETION ERRORS

    Code Description Translation/Pattern

    ES300 Erreur traitement : erreur interne au serveur. Processing Error : Server internal error.

    ES301 Erreur traitement : identifiant BVE non reconnu. Processing Error : IDENTIFIANT_BVE unknown.

    ES302 Erreur traitement : statut BVE différent de ENREGISTRE

    Processing Error : Form status is different from « registred ».

    ES303 Erreur traitement : erreur inconnue. Processing Error : Unknown error.

    9.3.4 LES CODES MOTIFS

    Code Description

    MA400 Motif de non apurement : autre.

    MA401 Motif de non apurement : hors délai.

    MA402 Motif de non apurement : irrégularité constatées.

    MA403 Motif de non apurement : BVE irrecevable.

    MS400 Motif de suppression : Problème technique du système.

    9.3.5 LES ERREURS GLOBALES

    Code Description Translation/Pattern

    G0001 Erreur lors de la vérification du schéma xsd Error during message structure validation.

  • Code Description Translation/Pattern

    G0002Une erreur applicative est apparue, veuillez signaler ce problème à l’administrateur de l’application. Veuillez nous excuser pour la gêne occasionnée.

    An application error occured.

    G0004 SchemaId non valide. SchemaId unknown.