Вы находитесь на странице: 1из 165

Description des flux de donnes entre Constructeur et RTE

Version : 2.37
Date : 03/12/2015

RTE Services Alle Charles Victor Naudin, 06410 BIOT, FRANCE - Tel : +33 (0) 4 89 87 10 60 Fax : +33 (0) 4 89 87 10 61
SARL au capital de 50.000 SIRET : 531 854 446 00014 TVA FR68531854446
www.rte-services.com

2
Reference

AGORA Manufacturer Data exchange

Rdig par

RTE Services

Version

2.37

Historique

Page | 2

Version
1.0.1

Date
03/06/2005

1.0.2
1.1.0

09/06/2005
18/11/2005

1.1.1

08/08/2007

1.2
1.3
1.4
1.5
2.0

26/06/2009
15/04/2011
22/04/2011
17/02/2010
18/02/2010

2.1

18/03/2010

2.2

29/03/2010

2.3
2.4

29/03/2010
19/04/2010

2.5

23/04/2010

2.6

11/05/2010

2.7

11/05/2010

2.8

28/05/2010

2.9

11/06/2010

2.10

12/08/2010

2.11
2.12

12/08/2010
01/09/2010

Rdig par

Modification description
Cration du document
Ce document annule et remplace les prcdents documents :
- Echanges standard AGORA Version 1.16
Echanges graphiques AGORA Version 1.5
Suppression du chapitre sur les formats dchanges spcifiques
Mise jour du document
- Ajout du chapitre Formation
- Ajout de la section ImagesAccessories
- Ajout de la section OrderResponseLineDetail
Correction dune erreur sur le format du champ Country de la
table Client : Valeur numrique uniquement
Modification du format du flux Promotion
Ajout de la section Mandatement ISG
Ajout du fichier ProductsSerialNumber
Ajout des flux ClientsStock et PartsStock
Ajout du format XML :
Flux de documentation
Flux WarrantyClaim
Flux WarrantyResponse
Mandatement :
Modification de la longueur de date de rendez-vous souhait
Modification du type pour AppointmentStartTime et
AppointmentEndTime
Mandatement :
Modification du type pour AppointmentStartTime et
AppointmentEndTime
Ajout de la section Demande de Solution SAV
Mandatement
- Ajout des codes civilit (1,2,3)
Mandatement
- Modification du champ GCPlusContract de la section
MAND
Mandatement section MAND
- PurchaseDate devient facultatif
- ActivationDate devient facultatif
Demande de solution SAV
- SolutionClaim n de rapport passe de 12 50
caractres
- SolutionResponse commentaire passe de 100 250
caractres
Demande de solution SAV
- ClaimNbManufacturer passe de 12 50 caractres
- Ajout du status Annul
Modification du flux SolutionClaim
- ENDCLAIM passe de 10 13 caractres
- ENDTYPE passe de 10 13 caractres
Ajout du flux Formation participants
Ajout de lidentifiant interne de session sur le flux Formation.
Mise jour du format du fichier Formation export
Mise jour du format du fichier Formation-Participants export

Page | 3

2.13

15/09/2010

2.14
2.15
2.16
2.17
2.18

13/10/2010
04/11/2010
08/12/2010
22/04/2011
05/12/2011

2.19
2.20
2.21
2.22
2.23
2.24

05/12/2011
05/12/2011
05/12/2011
05/12/2011
09/12/2011
01/02/2012

S.MARIE

2.25
2.26
2.27

01/04/2013
14/06/2013
01/08/2013

S.MARIE
S.MARIE
S.MARIE

2.28

06/03/2014

S.MARIE

2.29

01/10/2014

S.MARIE

2.30

17/10/2014

S.MARIE

2.31

08/12/2014

S.MARIE

2.32

02/02/2015

S.MARIE

2.33
2.34
2.35
2.36
2.37

09/02/2015
30/09/2015
22/10/2015
17/11/2015
03/12/2015

S.MARIE
S.MARIE
S.MARIE
S.MARIE
S.MARIE

Mise jour du format SolutionResponse : ajout du


manufacturerId
Ajout du champ code EAN sur le flux des Products
Ajout du code 4 dans les civilits du mandatement.
Mandatement : Symptme de la panne 400 caractres
Mandatement : Evolution flux Accepts/refuss vers flux statuts
Mandatement : V1Bis, enrichissement de la liste des reason
code dans le flux Infos RDV.
Mandatement : V1Bis, correction sur les listes de reason codes
Mandatement : la date de RV devient optionnelle.
Mandatement : V1Bis, correction sur les listes de reason codes
Mandatement : V1Bis, correction sur les listes de reason codes
Mandatement : V1Bis, correction sur les listes de reason codes
WarrantyClaim : ajout du mapping avec le type dintervention du
mandat
Ajout des tats amricains dans le flux warranty XML
Ajouts du flux SOLSAV2 et Traabilit V2
Mise jour des formats dexport SOLSAV2 et Mandatement
Traabilit V2
Ajout des champs : DeliveryPhone, DeliveryEmail,
WhishedDeliveryDate,DeliveryInfo pour lexport des commandes
Cration du document
Ce document annule et remplace les prcdents documents :
- Echanges standard AGORA Version 1.16
Echanges graphiques AGORA Version 1.5
Ajout des pices interdites (RestrictedParts)
Modification du template
Correction des Schmas XSD et Ajout des fichiers pour la
traabilit V2
Correction des rpertoires de dpose.
Modification des proprits du mandatement V2. Suppression
du champs (Null Autoris)
Ajout des codes tat de refus
Ajout adresse email dans le Pickup SOLSAV
Ajout du flux OrderTrancking
Ajout du flux Solution Admin
OPTIONNEL - Ajout de lordre de mission dans le flux des
commandes

Table des matires


1

Introduction ..................................................................................................................................................... 7
1.1

Contexte................................................................................................................................................. 7

1.2

Principe .................................................................................................................................................. 7

1.3

Compression et dcompression............................................................................................................. 7

1.4

Aspects rseau ...................................................................................................................................... 8

1.4.1

Type dchange ................................................................................................................................. 8

1.4.2

Contrle des accs et scurit .......................................................................................................... 8

1.5

Les flux................................................................................................................................................... 9

1.6

Le mode de mise jour.......................................................................................................................... 9

1.7

Format des flux dchange ................................................................................................................... 10

Description des flux et des tables de paramtrage AGORA ......................................................................... 11


2.1

TABLES DE PARAMETRAGE ............................................................................................................. 11

2.1.1

Table Brands ............................................................................................................................. 11

2.1.2

Table PartsStatus ...................................................................................................................... 11

2.1.3

Table Family .............................................................................................................................. 12

2.1.4

Table FamilyDes ........................................................................................................................ 13

2.1.5

DeliveryMode referential ............................................................................................................ 13

2.1.6

Table Currencies ....................................................................................................................... 14

2.1.7

Table Languages ....................................................................................................................... 14

2.1.8

Table DiscountPrice ................................................................................................................... 15

2.2

FLUX ET TABLES DE REFERENCES ................................................................................................ 16

2.2.1

Gestion des filiales - AGORA STUDIO ............................................................................................ 16

2.2.2

Flux Clients ................................................................................................................................ 17

2.2.3

Flux Products ............................................................................................................................. 19

2.2.4

Flux ProductsDes ...................................................................................................................... 20

2.2.5

Flux ProductsPrice ..................................................................................................................... 21

2.2.6

Flux Parts ................................................................................................................................... 22

2.2.7

Flux PartsDes ............................................................................................................................ 24

2.2.8

Flux MultiReplace ...................................................................................................................... 24

2.2.9

Flux PartsPrice .......................................................................................................................... 25

2.2.10

Flux PriceCode ...................................................................................................................... 25

2.2.11

Flux Promotions .................................................................................................................... 27

2.2.12

Flux RestrictedParts (Fichier au format CSV) ....................................................................... 28

Page | 4

5
2.2.13

Flux PartsRef ......................................................................................................................... 29

2.2.14

Flux ProductsSerialNumber ................................................................................................... 29

2.2.15

Flux ClientsStock ................................................................................................................... 30

2.2.16

Flux PartsStock ..................................................................................................................... 30

2.3

MODULE DE MESSAGERIE ............................................................................................................... 31

2.3.1
2.4

Flux MessagesV2 ...................................................................................................................... 31


MODULE DOCUMENTATION ............................................................................................................. 32

2.4.1

CHOIX 1 : Flux de type Texte (ASCII ou UNICODE) ....................................................................... 32

2.4.2

CHOIX2 : Flux de type XML ............................................................................................................ 42

2.5

MODULE ACCESSOIRES ................................................................................................................... 52

2.5.1

Flux Accessories ........................................................................................................................ 52

2.5.2

Flux AccessoriesDes ................................................................................................................. 53

2.5.3

Flux AccessoriesCountries ........................................................................................................ 53

2.5.4

Flux AccessoriesFamilies .......................................................................................................... 54

2.5.5

Flux AccessoriesFamiliesDes .................................................................................................... 56

2.5.6

Flux AccessoriesInfos ................................................................................................................ 56

2.5.7

Flux AccessoriesInfosLabels ..................................................................................................... 57

2.5.8

Flux AccessoriesProducts ......................................................................................................... 57

2.5.9

Flux AccessoriesPictures ........................................................................................................... 58

2.6

MODULE COMMANDE ....................................................................................................................... 59

2.6.1

Introduction ...................................................................................................................................... 59

2.6.2

Gestion des filiales AGORA STUDIO ........................................................................................... 59

2.6.3

Flux ClientsLiv ........................................................................................................................... 60

2.6.4

CHOIX 1 : Flux de commandes en mode entte et lignes spares ........................................ 61

2.6.5

CHOIX 2 : Flux de commandes en mode fichier unique ........................................................... 63

2.6.6

CHOIX 3 : Flux de commandes au format XML............................................................................... 65

2.6.7

Flux OrderResponse .................................................................................................................. 67

2.6.8

Flux OrderResponseDetail ........................................................................................................ 68

2.6.9

Flux OrderResponseLineDetail ................................................................................................... 69

2.6.10
2.7

Flux OrderTacking ................................................................................................................. 70

MODULE GARANTIE .......................................................................................................................... 71

2.7.1

Gestion des filiales - AGORA STUDIO ............................................................................................ 71

2.7.2

Flux WarrantyClients ................................................................................................................. 72

2.7.3

Flux WarrantyProducts .............................................................................................................. 73

2.7.4

Flux WarrantyType .................................................................................................................... 74

2.7.5

Flux WarrantyFixedList .............................................................................................................. 75

Page | 5

6
2.7.6

Flux WarrantyFixedDes ............................................................................................................. 76

2.7.7

Flux WarrantyFixedPrices .......................................................................................................... 76

2.7.8

CHOIX 1: Flux WarrantyClaim format texte (ASCII ou UNICODE) ............................................ 77

2.7.9

CHOIX 2 : Flux WarrantyClaim format XML .............................................................................. 79

2.7.10

CHOIX 1 : Flux WarrantyResponse au format texte (ASCII ou UNICODE) ................................ 86

2.7.11

CHOIX 2 : Flux WarrantyResponse au format XML .................................................................... 88

2.8

MODULE SERVICES BULLETINS ...................................................................................................... 91

2.8.1

Flux BulDoc ............................................................................................................................... 91

2.8.2

Flux BulDocProperties ............................................................................................................... 92

2.8.3

Flux BulDocRelation .................................................................................................................. 94

2.9

MODULE FORMATION ....................................................................................................................... 96

2.9.2
2.10

Flux FormationsParticipants ...................................................................................................... 98


MODULE MANDATEMENT ................................................................................................................. 99

2.10.1

Flux Mandate ......................................................................................................................... 99

2.10.2

Flux Cancel ......................................................................................................................... 105

2.10.3

Flux Infos Statut ................................................................................................................... 106

2.10.4

Flux RDV Info ....................................................................................................................... 107

2.11

MODULE SOLSAV ............................................................................................................................ 108

2.11.1

CHOIX 1 : format texte (ASCII ou UNICODE) ........................................................................... 108

2.11.2

CHOIX 2 : Flux XML .................................................................................................................. 118

2.12

MODULE SOLSAV ADMIN ................................................................................................................ 136

2.12.1
2.13

Fichier SolutionClaimAdmin.XML ......................................................................................... 136

MODULE TRACABILITE V2 .............................................................................................................. 146

2.13.1

Fichier de traabilit .................................................................................................................. 146

2.13.2

Fichier de rponse du Traabilit V2 ................................................................................... 155

2.13.3

Import/Export des fichiers physiques......................................................................................... 157

Annexes .......................................................................................................................................................... 1
3.1

Types de donnes ................................................................................................................................. 1

3.2

Liste des codes devises (ISO 4217) ...................................................................................................... 1

3.3

Code Pays (ISO 3166-1) ........................................................................................................................ 2

3.4

Liste des codes constructeurs................................................................................................................ 7

Page | 6

1 Introduction
1.1 Contexte
La rgle de numrotation des versions volue de manire suivante :
Les documents sont dsormais numrots sous la forme de X.Y.Z
X:
Version majeure
Numro de version modifi en cas dvolution importante dAGORA et une restructuration des tables existantes
Y:
Version mineure
Numro de version modifi en cas de changement dune table (par exemple lajout dun Nouveau champ) ou ajout de
nouvelles tables
Z:
Rvision
Numro de rvision modifi en cas de modification sans changement du format des tables changes (par exemple la
mise en place de valeur par dfaut par RTE lors de limport)

1.2 Principe
Le but premier du serveur AGORA est de mettre la disposition des rparateurs dlectromnager un certain Nombre
dinformations. Celles-ci devront tre maintenues jour rgulirement.
Afin dassurer ce service, un moyen de communication doit tre mis en place entre
RTE (qui assure la mise uvre, le fonctionnement et la maintenance du serveur AGORA),
et les constructeurs dlectromnager (qui fournissent les donnes et informations, et assurent le traitement des
commandes).
Les changes dinformations seffectuent depuis chacun des constructeurs vers RTE, et inversement.
-

Le principe dchange des informations retenu par RTE sappuie sur le Sens du transfert de fichiers intervalles rguliers.
Afin dassurer un bon niveau de disponibilit et de fiabilit :
-

Le systme retenu en standard sappuie sur lutilisation dun serveur FTP passerelle localis chez chacun des
constructeurs (serveur utilis comme boite aux lettres )
Ce serveur reoit les fichiers provenant des constructeurs destination de RTE, ainsi que les fichiers envoys
par RTE pour les constructeurs.

1.3 Compression et dcompression


Pour rduire les temps de Sens du transfert des fichiers, RTE met en place un service de traitement et de compression
des fichiers dposs sur le serveur FTP passerelle. Celui-ci fonctionne en tant que service et doit tre install sur ce
serveur.
Sa fonction est :
-

Page | 7

de compresser les fichiers dposs par le constructeur,


de dcompresser les fichiers dposs par RTE,
de renumrot automatiquement les fichiers changes pour sassurer de tout conflit ou fichier crass du fait
que lenvoi par le constructeur et limport par RTE sont des processus asynchrones

1.4 Aspects rseau


1.4.1 Type dchange
RTE fourni chaque constructeur un accs FTP ddi.
2 rpertoires par dfaut:

IN: Contient tous les fichiers gnrs par le constructeur qui doivent tre intgr dans AGORA
OUT: Contient tous les fichiers gnrs par AGORA destination du systme du constructeur

Laccs FTP est scuris, de type Explicit TLS.

1.4.2 Contrle des accs et scurit


Seules les connexions NON anonymes sont autorises. Ainsi, un nom d'utilisateur et un mot de passe doivent tre dfinis
entre RTE et chaque Constructeur.

Page | 8

1.5 Les flux


Les diffrents types dinformations changes utilisent un fichier distinct. Ceci peut tre considr comme lextraction
dune table de la base de donnes dj gre par chaque constructeur. Le format des bases et les types dinformations
utilises par le serveur AGORA ont t slectionns afin que le constructeur gre le moins dinformations spcifiques
lapplication AGORA. Cependant, la gestion de certaines fonctions (accus de commande par exemple) imposera aux
constructeurs de mmoriser de nouveaux champs dans leur systme informatique.
Sauf mention contraire dans le reste du document, les fichiers changs entre RTE et les constructeurs seront au format
texte longueur fixe. Chaque champ est alors caractris par :
Un Nom
Un type par exemple Alphanumrique, numrique ou boolen (voir liste en annexe la fin de ce document).
Une taille prcisant sa longueur exprime en Nombre de caractres
Une indication prcisant si le champ est considr comme la cl primaire (doublons interdits). Dans ce cas une
mention est indique dans les colonnes PK correspondantes (Primary Key).
- Une indication prcisant si le champ peut tre vide ou si une valeur doit tre toujours renseigne.
- Une description
Les fichiers changs doivent tre au format ASCII (retour la ligne : 0x0D 0x0A)
-

1.6 Le mode de mise jour


RTE propose trois modes dchanges de fichiers :
1. Par envoi dun fichier complet qui annule et remplace la prcdente version
- Le constructeur effectue chaque mise jour un export complet des donnes de son systme
dinformation
- Un fichier unique est donc communiqu RTE
2. Par mise jour diffrentiel via un type de transaction
- Ce mode utilise un champ Type de transaction pour prciser si les donnes transmises
correspondent un ajout denregistrement ( A pour Add ), une modification ( C pour Change )
ou une suppression (D pour Delete ).
- Dans le cas dun ajout, le contenu des enregistrements est ajout la base de donnes gre par
AGORA.
- Dans le cas dune modification, AGORA recherche lancien enregistrement en se basant sur la cl
primaire. Lancien contenu est alors mise jour. Si celui-ci nest pas trouv, AGORA considre que cest
un ajout.
- Dans le cas dune suppression, AGORA recherche lancien enregistrement en se basant sur la cl
primaire. Lenregistrement est supprim de la base de donnes.
3. Par mise jour diffrentiel date
- Ce mode utilise un champ Date de suppression pour indiquer que lenregistrement nest plus actif.
- De manire identique au premier mode, AGORA recherche dans les cls primaires de sa base
lenregistrement comportant les mmes donnes.
- Si celui-ci nest pas trouv, les informations reues sont ajoutes.
- Si celui-ci est trouv et que la date de suppression nest pas prcise, AGORA considre que cest une
modification et met jour les informations.
- Si celui-ci est trouv, mais que la date est antrieure ou gale la date du jour, alors lenregistrement
est supprim.
En regard des performances actuelles des serveurs, et du fait de lexistence dun service de compression des donnes,
RTE prconise lenvoi de donnes en mode complet (annule et remplace).
Dans tout le reste du document, le mode de Sens du transfert nest pas prcis. Si un constructeur dsire effectuer un
Sens du transfert diffrentiel des informations, il devra lindiquer et fournir en plus des champs mentionns :

un champ type de transaction alphanumrique contenant A , D , C suivant le type de transaction


ou un champ date sur 10 positions, contenant la date de suppression de cet enregistrement (format jj/mm/aaaa
).

Page | 9

1.7 Format des flux dchange


Sont prsents sur AGORA 3 formats dchange :

Format Texte
o ASCII (lorsque seul la langue Franaise est utilis)
o UNICODE (pour supporter les langues trangres)

Format CSV (Colonnes spares par u point-virgule)


o ASCII (lorsque seul la langue Franaise est utilis)
o UNICODE (pour supporter les langues trangres)

Format XML
o UTF16

Page | 10

2 Description des flux et des tables de paramtrage AGORA


2.1 TABLES DE PARAMETRAGE
2.1.1

Table Brands

2.1.1.1 Description gnrale


Contenu de la table :
Marques commercialises par le constructeur
Sens du Sens du transfert : Du constructeur vers RTE
Priodicit conseille :
Cette table nest pas mise jour automatiquement par change de fichier mais sur intervention manuelle du constructeur
2.1.1.2

Description des champs

Nom du champ

Type

Long.

PK

Brand

Char

PK

Des

Char

28

Null
autoris

Description longue et commentaires


Code marque constructeur
La liste des marques est utilise lors de la recherche de produit par Marques/Gamme/Famille
Il est possible un constructeur de ne pas communiquer la liste exhaustive de ces marques mais
uniquement celle devant tre prsente. Les produits de ces autres marques restent alors accessibles par
rfrences
Un logo de ces marques devra tre communiqu RTE dans une rsolution suffisante et de prfrence dans un
format vectoriel (EPS par exemple)
Libell de la marque

2.1.2 Table PartsStatus


2.1.2.1 Description
Contenu de la table :
Sens du Sens du transfert :
Priodicit conseille :

Page | 11

Liste des statuts de pices


Du constructeur vers RTE
Cette table nest pas mise jour automatiquement par change de fichier mais sur intervention manuelle du constructeur

2.1.2.2

Description des champs

Nom du champ

Type

Long.

PK

Status
Language
StatusDes
OrderAllowed

Int
Char
Char
Bool

2
2
18
1

PK
PK

Null
autoris

Description longue et commentaires


Code statut constructeur des pices
Code langue
Dsignation du statut
Statut correspondant des pices commandables ou Non
0 pour statut Non commandables
1 pour statut commandables

2.1.3 Table Family


2.1.3.1 Description
Contenu de la table :

Sens du transfert :
Priodicit conseille :
2.1.3.2

Liste des codes familles dappareils


Cette base permet de lister et hirarchiser les familles dappareils en gamme, famille, sous-famille
Par exemple Gamme cuisson puis Plaques de cuisson puis Plaques 4 gaz *
Cette base permet de prciser des familles diffrentes en fonction de la marque
Du constructeur vers RTE
Cette table nest pas mise jour automatiquement par change de fichier mais sur intervention manuelle du constructeur

Description des champs

Nom du champ

Type

Long.

PK

FamilyID

Int

10

PK

Family

Char

Brand

Char

Picture

Char

12

Page | 12

Null
autoris

Oui

Description longue et commentaires


Numro dordre pour lidentification et la classification
Ce numro didentification est attribu par RTE et permet de classifier hirarchiquement les familles
Ce code est utilis en interne par AGORA et ne fait donc pas partie des changes avec les constructeurs
Code famille constructeur
Ce champ est vide si lenregistrement correspondant a t cr par RTE et ne correspond pas une
famille prcise chez le constructeur. Cest par exemple le cas pour une gamme dcompose en familles
Code marque constructeur
Ce champ permet de prciser la marque dans laquelle la famille est disponible.
Pour un mme code famille il est ncessaire de mettre dans cette table un enregistrement par marque
Nom de limage utilise pour la reprsentation de la famille
Le format recommand est GIF ou JPEG en 256 couleurs et une rsolution voisine de 120x120 pixels
Une image par gamme/famille/sous-famille devra tre fournie par le constructeur

2.1.4 Table FamilyDes


2.1.4.1 Description
Contenu de la table:
Sens du transfert :
Priodicit conseille :
2.1.4.2

Dsignation des familles


Du constructeur vers RTE
Cette table nest pas mise jour automatiquement par change de fichier mais sur intervention manuelle du constructeur

Description des champs

Nom du champ

Type

Long.

FamilyID
Language
Des

N
A
A

10
2
32

PK

Null
autoris

Description longue et commentaires

PK
PK

Numro dordre pour lidentification et la classification


Code langue constructeur
Dsignation de la famille

2.1.5 DeliveryMode referential


2.1.5.1 Table Description
Contenu de la table :

Liste des diffrents modes de livraison

Sens du transfert :
Priodicit conseille :

Les modes de livraison peuvent tre spcifiques par pays du rparateur


Du constructeur vers RTE
Cette table nest pas mise jour automatiquement par change de fichier mais sur intervention manuelle du constructeur

2.1.5.2

Description des champs

Nom du champ

Type

Long.

PK

DeliveryMode
Country
Language
Des

Int
Int
Char
Char

1
4
2
18

PK
PK
PK

Page | 13

Null
autoris

Description longue et commentaires

Code didentification du mode de livraison


Code pays (voir recommandation ISO 3 numeric)
Code langue constructeur
Dsignation du mode de livraison

2.1.6 Table Currencies


2.1.6.1 File Description
Contenu de la table :
Sens du transfert :
Priodicit conseille :
2.1.6.2

Liste des devises gres par AGORA


Cette liste est commune lensemble des constructeurs
Voir annexes pour la liste des valeurs possibles
Du constructeur vers RTE
Cette table nest pas mise jour automatiquement par change de fichier mais sur intervention manuelle du constructeur

Description des champs


PK

Null
autoris

Nom du champ

Type

Long.

Description longue et commentaires

Currency

Char

Code devise

18
4

Ce code est utilis entre autre dans la table des prix de pices PartsPrice ou celle fournissant la
conversion du code prix dune pice vers la valeur en Euro
Dsignation de la devise en toute lettre
Symbole de lunit montaire

CurrencyDes
CurrencyUnit

Char
Char

Symbole affich aprs la valeur numrique prsente lors de laffichage des tarifs

2.1.7 Table Languages


2.1.7.1

Table description

Contenu de la table :

Liste des langues gres par chaque constructeur

Sens du transfert :
Priodicit conseille :

Laffichage de toutes les dsignations de la base de donnes (produits, pices, familles, etc) ce base sur ce code
Une dsignation doit donc tre prsente dans les diffrentes tables pour lensemble des codes renseigns ici
Du constructeur vers RTE
Cette table nest pas mise jour automatiquement par change de fichier mais sur intervention manuelle du constructeur

Page | 14

2.1.7.2

Field description

Nom du champ

Type

Long.

PK

LanguageAgora
LanguageConstr
LanguageDes

Char
Char
Char

2
2
18

PK

Null
autoris

Description longue et commentaires


Code langue Agora
Code langue constructeur
Description de la langue

2.1.8 Table DiscountPrice


2.1.8.1

Table Description

Contenu de la table :
Sens du transfert :
Priodicit conseille :
2.1.8.2

Taux de remise par catgorie de client et de pice permettant de calculer le prix net remis partir du prix de base
Du constructeur vers RTE
Cette table nest pas mise jour automatiquement par change de fichier mais sur intervention manuelle du constructeur

Description des champs


PK

Null
autoris

Nom du champ

Type

Long.

Description longue et commentaires

ClientType

Type client

PartsType

Cette valeur doit correspondre aux valeurs possibles dans le champ ClientType de la table Client
Type de pice

Cette valeur doit correspondre aux valeurs possibles dans le champ correspondant PartsType de la
table Parts
Coefficient de rduction

Discount

Correspond au coefficient permettant de passer du prix de base au prix net


A titre dexemple une valeur de 0.75 correspond une remise de 25%

2.1.8.3 Remarque
Pour les constructeurs ne grant pas de remise, cette table doit au moins comprendre un enregistrement avec les valeurs suivantes :
ClientType = 1 (ou tout autre valeur initialise par dfaut dans le champ ClientType de la table Clients )
PartsType = 0 (ou tout autre valeur initialise par dfaut dans le champ PartsType de la table Parts )
Discount = 1.0000 (pas de remise)
Page | 15

2.2 FLUX ET TABLES DE REFERENCES


2.2.1 Gestion des filiales - AGORA STUDIO
La matrice ci-dessous dfinit les flux qui peuvent tre utiliss par une filiale:
Clients
Products
Parts
PartsDes
MultiReplace
PartsPrice
PriceCode
Promotions
PartsRef

ClientStock
PartStock

Page | 16

Description
Manufacturer client accounts
Product list
Reference list of spare parts
or accessories
Parts and accessories
designations
Multiple spare parts replaces
Spare part prices
Price code

Peut tre tendu aux filiales


OUI
NON
OUI

Contains information about


promotions valid price on
certain items
List of possible references for
the same item (supplier
reference, old reference,
recoding ...)
Connecting customers to
warehouses
Connecting parts to
warehouse

NON

NON
NON
NON
NON

NON

OUI
OUI

2.2.2 Flux Clients


2.2.2.1 Description gnrale
Contenu de la table :
Liste les comptes clients de chaque constructeur.
Sens du transfert :
Priodicit conseille :
Format de fichier :
2.2.2.2

Utilise par AGORA pour identifier la personne connecte sur AGORA et connatre ces droits.
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Description des champs

Nom du champ

Type

Long.

PK

ClientNumber
Password

Char
Char

10
8

PK

Null autoris

Autoris pour les


filiales

Description longue et commentaires

Oui
Oui

Numro de compte client auprs chez le constructeur


Mot de passe du client auprs de ce constructeur

Oui

Ce mot de passe permet de vrifier lidentit de la personne connecte et est


utilis conjointement au champ ClientNumber
Raison sociale de la socit

Oui

Champ de ladresse de facturation non utilis actuellement et rserv un usage


futur
Nom de la personne

Oui

Champ de ladresse de facturation non utilis actuellement et rserv un usage


futur
Premier champ de ladresse

Oui

Champ de ladresse de facturation non utilis actuellement et rserv un usage


futur
Deuxime champ de ladresse

Oui

Champ de ladresse de facturation non utilis actuellement et rserv un usage


futur
Troisime champ de ladresse

Company

Char

32

Oui

Name

Char

32

Oui

Address1

Char

32

Oui

Address2

Char

32

Oui

Address3

Char

32

Oui

Page | 17

Champ de ladresse de facturation non utilis actuellement et rserv un usage


futur

Zip

Char

10

Oui

Oui

Code postal ou Zip

Oui

Champ de ladresse de facturation non utilis actuellement et rserv un usage


futur
Nom de la ville

Oui

Champ de ladresse de facturation non utilis actuellement et rserv un usage


futur
Code du pays (voir recommandation de code ISO en annexe)

Oui

Champ de ladresse de facturation non utilis actuellement et rserv un usage


futur
Numro de tlphone

Oui

Champ de ladresse de facturation non utilis actuellement et rserv un usage


futur
Numro de fax

Town

Char

32

Oui

Country

int

Oui

Tel

Char

14

Oui

Fax

Char

14

Oui

Champ de ladresse de facturation non utilis actuellement et rserv un usage


futur
1ire ligne de ladresse de livraison
2ime ligne de ladresse de livraison
3ime ligne de ladresse de livraison
Code postal de ladresse
Ville de ladresse de livraison
Code du pays (voir recommandation de code ISO en annexe)
Client autoris modifier ladresse de livraison lors dune commande de pices
Client autoris commander sous garantie
Client autoris passer un rapport dintervention sous garantie
Indique AGORA dafficher les zones permettant la saisie des coordonnes du revendeur
lors dune saisie dun rapport dintervention sous garantie.
Indique AGORA que les coordonnes du revendeur doivent tre saisies obligatoirement
lors dun rapport dintervention sous garantie.
Client autoris commander des pices
Client pouvant accder AGORA via Internet sans avoir souscrire et payer un pack.

DeliveryAddress1
DeliveryAddress2
DeliveryAddress3
DeliveryZip
DeliveryTown
DeliveryCountry
DeliveryAllowed
WarrantyAllowed
RefundAllowed
ResellerView

Char
Char
Char
Char
Char
Char
Bool
Bool
Bool
Bool

32
32
32
10
32
4
1
1
1
1

Oui
Oui
Oui
Oui
Oui
Oui
Non
Oui
Oui
Non

ResellerInput

Bool

Non

OrderAllowed
InternetAllowed

Bool
Bool

1
1

Oui
Non

Cette option est strictement rserve des comptes internes aux constructeurs et ne

Page | 18

ClientType

Char

Non

doivent pas tre utiliss pour des rparateurs. Le cot dutilisation dAGORA gnr par
ces clients est pris en charge par le constructeur.
Type de client

Currency

Char

Oui

Valeur fixer par dfaut 1 si le constructeur ne dispose pas de codification


Ce type permet de codifier les catgories de client et via la table
DiscountPrice le taux de remise dont ils disposent auprs du constructeur
Code devise de facturation chez le constructeur

ConsumerInput
IrisView
IrisInput

Bool
Bool
Bool

1
1
1

Non
Non
Non

A fixer par dfaut EUR pour la zone Euro


Saisie obligatoire coordonnes consommateur (rapport dintervention sous garantie)
Affichage code IRIS (rapport dintervention sous garantie)
Saisie obligatoire code IRIS (rapport dintervention sous garantie)

2.2.3 Flux Products


2.2.3.1 Description gnrale
Contenu de la table :
Liste des appareils (produits finis)
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.2.3.2

Description des champs

Nom du champ

Type

Long.

PK

ProductID

Char

18

PK

Null
autoris

Description longue et commentaires

Numro didentification unique de lappareil


Suivi la norme de codification en place chez le constructeur, ce code est appel rfrence produit ,
rfrence technique , plaque signaltique ,
Ce champ peut tre initialis avec une valeur identique lun des champs TechnicalRef ou
CommercialRef
Ce champ est utilis comme cl pour les liens avec les bases nomenclatures et documentation et nest
jamais affich sur AGORA
Rfrence technique

TechnicalRef

Page | 19

Char

18

Oui

CommercialRef

Brand
Family

Char

Char
Char

18

4
6

Oui

Champ utilis comme champ de recherche et daffichage


Un des deux champs TechnicalRef et CommercialRef peut tre laiss vide
Rfrence commerciale

Oui
Oui

Champ utilis comme champ de recherche et daffichage


Un des deux champs TechnicalRef et CommercialRef peut tre laiss vide
Code marque de lappareil
Code famille constructeur

Warranty

Int

Oui

Ce code prcise la famille du produit ( Lave vaisselle , Lave linge , four ,)


Les produits pour lesquels ce champ ne serait pas prcis ne seront pas accessibles lors de la recherche
guide par marque, gamme, famille,
Dure de la garantie

StartSales

Date

10

Oui

Champ non utilis et remplace par les informations prsente dans la table WarrantyType
Dbut de commercialisation

EndSales

Date

10

Oui

Champ non utilis par dfaut par AGORA


Fin de commercialisation

AllPartsList

Bool

ReplaceID

Char

18

2.2.4 Flux ProductsDes


2.2.4.1 Description gnrale
Contenu de la table :
Dsignation des appareils
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
Page | 20

Oui

Champ non utilis par dfaut par AGORA


Indique si la nomenclature de lappareil est unique pour lensemble des pages de vues clates ou par page.
Ce champ permet dindiquer deux modes de fonctionnement supports par AGORA pour la gestion de laffichage
des nomenclatures par page :
Indiquer 0 si la numrotation des repres recommence sur chaque vue clate
Indiquer 1 si la numrotation continue dune vue clates lautre
Produit propos en remplacement dans le cas dune demande dchange
Doit correspondre une valeur existante dans la table Products

2.2.4.2

Description des champs

Nom du champ

Type

Long.

PK

ProductID
Language
Des

Char
Char
Char

18
2
40

PK
PK

Null
autoris

Description longue et commentaires

Numro didentification unique de lappareil


Code langue constructeur
Dsignation de lappareil

2.2.5 Flux ProductsPrice


2.2.5.1 Description gnrale
Contenu de la table :
Prix des produits affichs pour information en cas de demande dchange
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.2.5.2

Description des champs

Nom du champ

Type

Long.

PK

ProductID
Currency
Price
PublicPrice

Char
Char
Cur
Cur

18
3
10
10

PK
PK

2.2.5.3

Null
autoris

Description longue et commentaires

Rfrence unique du produit


Devise
Prix standard en unit montaire
Prix public en unit montaire

Remarques
La table PRODUCTSPRICE est utilise dans le cas de proposition de produit de remplacement dans le cadre d'un change en Garantie.
Le produit de remplacement propos est indiqu dans le champ ReplaceID de la table PRODUCTS. De ce fait, il ne peut y avoir q'un seul produit de remplacement pour un
produit donn.

Page | 21

2.2.6 Flux Parts


2.2.6.1 Description gnrale
Contenu de la table :
Liste des rfrences de pices dtaches ou accessoires
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.2.6.2

Description des champs

Nom du champ

Type

Long.

PK

PartsRef

Char

18

PK

PriceCode

Char

Null autoris

Oui

Autoris pour les


filiales

Description longue et commentaires

Oui

Rfrence de la pice

Non

Cette rfrence doit permettre didentifier de manire unique la pice


Code prix

Non

Ce code tre traduit en EURO (ou autre devise) laide de la table PriceCode dcrite dans la
suite de ce document, pour obtenir le prix de base professionnel
Ce champ peut tre laiss vide pour les constructeurs ne grant pas les prix de pices via un
code prix mais directement en EURO (ou autre devise). Dans ce cas, la table PartsPrice
devra tre utilise.
Code prix public

Non

Ce code tre traduit en EURO (ou autre devise) laide de la table PriceCode dcrite dans la
suite de ce document, pour obtenir le prix public
Ce champs peut tre laiss vide pour les constructeurs ne grant pas les prix de pices via un
code prix mais directement en EURO (ou autre devise). Dans ce cas, la table PartsPrice
devra tre utilise.
Indique si la pice est disponible ou non

Non

Les pices non disponibles restent commandables et passent uniquement en reliquats


Pour indiquant des rfrences abandonnes et plus commandable, voir lutilisation du champ
Status et de la table PartsStatus associe.
Indique la date de disponibilit prvue pour les pices non disponibles

PublicPricCode

Char

Oui

Available

Bool

AvailableDate

Char

15

Oui

Page | 22

Pour les pices non disponibles, les constructeurs disposent du champ AvailableDate pour
indiquer une date de disponibilit.
Le format de ce champ est laiss libre au constructeur afin quil puisse faire apparatre une date

Replace

Char

18

Oui

Oui

en fonction de son mode de gestion (Date, numro de semaine, ).


Aucun traitement nest effectu sur le contenu de ce champ, qui sera affich tel quel.
Rfrence de la pice de remplacement

Oui

Si la pice a t remplace, ce champ indique la rfrence de la pice de remplacement.


Lors de la recherche de pices (nomenclature dun produit, commande de pices, demande
davoir ou de garantie), cette rfrence sera affiche en plus de la rfrence saisie.
Dans le cas de remplacements multiples (pice est remplace par plusieurs autres pices), il
convient dutiliser le champ MultiReplace associ la table MultiReplace
Statut de la pice

Non

Valeur initialiser 0 pour les constructeurs nexploitant pas cette information


La traduction et le paramtrage de ce code seffectue via la table PartsStatus dcrite
prcdemment
Type de pice

Non

Type de pices utilis pour dterminer le taux de remise


Valeur initialiser 0 pour les constructeurs nexploitant pas cette information
Quantit minimale de commande

Non

AGORA utilise ce paramtre pour sassurer que la quantit commande est suprieure ou gale
cette valeur
Valeur initialiser 1 pour les constructeurs nexploitant pas cette information
Quantit maximale de commande

Non

AGORA utilise ce paramtre pour sassurer que la quantit commande est infrieure ou gale
cette valeur
Valeur initialiser 9999 pour les constructeurs nexploitant pas cette information
Unit de conditionnement

Non

AGORA utilise ce paramtre pour sassurer que la quantit commande est un multiples de
lunit de conditionnement
Valeur initialiser 1 pour les constructeurs nexploitant pas cette information
Prsence dun remplacement multiple

Status

Int

PartsType

MinQuantity

Char

Int

MaxQuantity

Int

UnitQuantity

Int

MultiReplace

Bool

Page | 23

La valeur doit tre fixe 1 si la pice est remplace par plusieurs rfrences et non un Kit.
Le dtail du remplacement doit tre indiqu dans la table MultiReplace
La valeur doit tre laiss 0 dans le cas contraire lors dun remplacement par une seule
rfrence (rfrence de remplacement indiqu dans le champ Replace de la prsente table)

2.2.7 Flux PartsDes


2.2.7.1 Description gnrale
Contenu de la table :
Dsignations des pices et accessoires
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.2.7.2

Description des champs


Null
autoris

Nom du champ

Type

Long.

PK

Description longue et commentaires

PartsRef

Char

18

PK

Rfrence de la pice

Language

Char

PK

Cette rfrence doit permettre didentifier de manire unique la pice


Code langue constructeur
Si la dsignation nexiste par pour un article dans une des langues configures sur AGORA, celle-ci
apparatra vide
Dsignation de la pice

Des

Char

32

2.2.8 Flux MultiReplace


2.2.8.1 Description gnrale
Contenu de la table :
Dsignations des pices et accessoires
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.2.8.2

Description des champs

Nom du champ

Type

Long.

PK

PartsRef

Char

18

PK

Null
autoris

Description longue et commentaires

Rfrence de la pice remplace

Page | 24

Ce champ correspond aux rfrences prsentes dans la table Parts

Replace

Char

18

Quantity

Int

PK

Rfrence de la pice remplaante


Ces rfrences doivent galement tre prsentes dans la table Parts
Nombre de pices remplaante

2.2.9 Flux PartsPrice


2.2.9.1 Description gnrale
Contenu de la table :
Prix des pices
Sens du transfert :
Priodicit conseille :
Format de fichier :
2.2.9.2

Cette table doit tre utilise par les constructeurs ne grant pas de notion de code prix
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Description des champs

Nom du champ

Type

Long.

PK

PartsRef

Char

18

PK

Currency
Price
PublicPrice

Char
Cur
Cur

3
10
10

Null
autoris

Description longue et commentaires


Rfrence de la pice remplace
Ce champ correspond aux rfrences prsentes dans la table Parts
Code de la devise
Prix standard dans cette devise
Prix public dans cette devise

2.2.10 Flux PriceCode


2.2.10.1 Description gnrale
Contenu de la table :
Table de conversion des codes prix des pices
Sens du transfert :
Priodicit conseille :
Format de fichier :

Page | 25

Cette table doit tre utilise par les constructeurs utilisant une notion de code prix
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

2.2.10.2 Description des champs


Nom du champ

Type

Long.

PK

Null
autoris

Description longue et commentaires

PriceCode
Currency
Price

A
A
M

5
3
10

Code prix
Code de la devise
Prix de base dans cette devise

PublicPrice

10

Egalement appel Prix professionnel ou Prix standard


Prix public dans cette devise

2.2.10.3 Remarques
AGORA propose deux fonctionnements pour convertir le code prix en prix de base et prix public.
1. En utilisant le mme code prix
Le mme code est renseign par le constructeur dans les champs PriceCode et PublicPriceCode de la table Parts
Ce code prix est alors traduit en un prix de base (champ Price de cette table) et un prix public (champ PublicPrice de cette table)
2. En utilisant deux codes prix
Le constructeur utilise deux valeurs de codes diffrents dans la table Parts (1 pour le champ PriceCode et 1 pour le champ PublicPriceCode )
La prsente table est alors utilise pour traduire le PriceCode en prix de base via le champ Price
La prsente table est galement utilise pour traduire le PublicPriceCode en prix public via le champ PublicPrice

Page | 26

2.2.11 Flux Promotions


2.2.11.1 Description gnrale
Contenu de la table :
Contient les informations sur des promotions de prix valable sur certains articles
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.2.11.2 Description des champs
Nom du champ

Type

Long.

PK

PartsRef

Char

18

PK

ClientNumber

Char

10

PK

Oui

Cette rfrence doit tre prsente dans la table PARTS


Numro de compte client

ClientType

Char

PK

Oui

A ne remplir que pour des promotions accessibles un compte client


Type de client

Currency
BeginDate
EndDate
Price
Quantity min
Quantity max

Char
Date
Date
Curr
Char
Char

3
10
10
10
5
5

PK

Page | 27

PK
PK

Null
autoris

Description longue et commentaires


Rfrence de la pice en promotion

A ne remplir que pour des promotions accessibles un type de client


Devise
Date de dbut de la promotion (inclusive)
Date de fin de la promotion (inclusive)
Prix net de la pice
Borne infrieure de la quantit pour bnficier de la promotion
Borne suprieure de la quantit pour bnficier de la promotion

2.2.12 Flux RestrictedParts (Fichier au format CSV)


2.2.12.1 Description gnrale
Contenu de la table :
Liste des interdictions pour une pice et un ClientWarrantyType donn.
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
CSV (ASCII ou UNICODE)
2.2.12.2 Description des champs
Nom

Type

Longueur Description

PartsRef

Varchar

ClientWarrantyType

Varchar

4 Type de Client en Garantie (La valeur XX Applique linterdiction sur tous les clientWarrantyType)

RestrictedPartMotiveId

Integer

4 Identifiant du motif dinterdiction (voir table des motifs ci-dessous)

18 Rfrence de pice

2.2.12.3 Table des motifs (Pas de flux automatique)


Nom

Type

RestrictedPartMotiveId

Integer

Description

Varchar

IsConditional

Page | 28

Bool

Longueur Description
4 Identifiant du motif dinterdiction
1024 Type de Client en Garantie (La valeur XX Applique linterdiction sur tous les clientWarrantyType)
Indique si le motif est conditionnel.
1 Si-0, le motif nest pas bloquant en garantie et saffiche sous forme dalerte.
Si 1, le motif est bloquant en garantie (Le blocage la commande est effectu sur demande. Par dfaut le systme autorise la commande)

2.2.13 Flux PartsRef


2.2.13.1 Description gnrale
Contenu de la table :
Liste des autres rfrences possibles pour un mme article (rfrence fournisseur, ancienne rfrence, recodification, )
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.2.13.2 Description des champs
Nom du champ

Type

Long.

PK

Null
autoris

Description longue et commentaires

PartsRef

18

PK

Rfrence de la pice

OldPartsRef

18

PK

Cette rfrence est utilise comme lien vers lensemble des autres tables Parts , PartsPrice ,
Autre rfrence possible pour ce mme article

Champ utilise pour la recherche et laffichage

2.2.14 Flux ProductsSerialNumber


2.2.14.1 Description gnrale
Contenu de la table :
Liste des numros de srie des produits
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.2.14.2 Description des champs
Nom du champ

Type

Long.

PK

TechnicalRef
SerialNumber
Date

A
A
DateTime

18
20
19

PK
PK

Page | 29

Null
autoris

Description longue et commentaires


Rfrence technique du produit.
N de srie du produit
Date associe au N de srie du produit.

2.2.15 Flux ClientsStock


2.2.15.1 Description gnrale
Contenu de la table :
Rattachement des clients aux entrepts
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.2.15.2 Description des champs
Nom du champ

Type

Long.

PK

ClientNumber
Stock

Char
Char

18
50

PK
PK

Null
autoris

Autoris pour les


filiales
Oui
Oui

Description longue et commentaires

Autoris pour les


filiales
Oui
Oui
Oui

Description longue et commentaires

Rfrence client du constructeur


Dsignation de lentrept

2.2.16 Flux PartsStock


2.2.16.1 Description gnrale
Contenu de la table :
Rattachement des pices aux entrepts
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.2.16.2 Description des champs
Nom du champ

Type

Long.

PK

PartsRef
Stock
IsAvailable

Char
Char
Int

18
50
1

PK
PK

Null
autoris

Rfrence client du constructeur


Dsignation de lentrept
Dfinit la disponibilit de la pice pour lentrept :
0 : Pice indisponible
1 : Pice disponible

Page | 30

2.3 MODULE DE MESSAGERIE


2.3.1 Flux MessagesV2
2.3.1.1 Description gnrale
Contenu de la table :
Adresses email des correspondants chez chaque constructeur en regard du compte client et du type de question.
Cette table remplace la table Messages et permet un paramtrage plus fin
Si aucun enregistrement nest trouve dans cette table pour le client connect et le type de question, linformation est galement recherche
dans la table Messages
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.3.1.2

Description des champs

Nom du champ

Type

Long.

PK

QuestionType

Char

PK

Null
autoris

Description longue et commentaires


Type de question
Ce champ doit contenir un des 4 codes suivants
o TE pour une question technique
o PP pour une question relative une pice dtache ou un produit
o GA pour une question relative une demande de garantie
o AC pour une question administrative ou commerciale
Numro de compte client auprs du constructeur
Adresse email du correspondant

ClientNumber
Email

Page | 31

A
A

10
128

PK

2.4 MODULE DOCUMENTATION


2.4.1 CHOIX 1 : Flux de type Texte (ASCII ou UNICODE)
2.4.1.1

Flux DocLink

2.4.1.1.1 Description gnrale


Contenu de la table :
Arborescence des documents disponibles pour un appareil
AGORA a adopt un systme de classement de la documentation bas sur une structure darbre hirarchique. Cette table permet de dcrire
et de stocker cet arbre.
Cette table permet par exemple dindiquer que plusieurs documents sont disponibles pour un produit, que ceux-ci sont composs de plusieurs
chapitres, eux-mmes dcomposes en pages.
Le niveau de dcomposition peut tre variable pour les diffrents constructeurs, mais galement pour chaque produit ou documentation, ou
mme lintrieur mme dune documentation.
Structure de larbre :
o Le principe de cette table est dindiquer pour un nud pre , la liste des nuds Fils qui le compose. Cette relation pre / fils
permet de construire un arbre pour chaque appareil.
o Le premier type de nud situ la base de chaque arbre est constitu par un produit fini (ID de lappareil).
o Les derniers lments situs au bout de chaque branche reprsentent les pages des documents.
o A partir dun produit fini, il est donc possible de trouver lensemble des documents disponibles, ainsi que de les prsenter classs.
Lors du parcours de larbre, la langue de chaque fils est contrle par rapport la langue de la personne connecte pour ne
prsenter que les fils dans la langue parle par le rparateur
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)

Page | 32

2.4.1.1.2

Description des champs

Nom du champ

Type

Long.

PK

Null
autoris

Description longue et commentaires

DocID

Char

18

PK

Numro du document pre

PK

Pour le premier nud de larbre ce champ doit contenir lidentifiant du produit, c'est--dire le contenu du
champ ProductID
Dans tous les autres cas, la valeur indique doit provenir des documents lists dans la table Doc
Type de document pre

DocType

Char

Pour le premier nud de larbre ce champ doit contenir le type rserv 00 (2 chiffres zros) pour
indiquer que le lien est fait sur un appareil
Dans tous les autres cas, la valeur indique doit provenir des documents lists dans la table Doc
Numro du sous document fils
Type du sous document fils
Numro de classement
Ce dernier champ permet de classer les fils afin de dterminer lordre daffichage des diffrents lments.
Son utilisation est primordiale pour le bon classement des diffrentes pages dune documentation.
Celui-ci devrait tre si possible utilis pour que les diffrents types de documentation soit toujours
prsents dans le mme ordre indpendamment du produit (par exemple Information technique , puis
Vues clates , puis Schmas lectriques ).

NextDocID
NextDocType
SortNb

Page | 33

Char
Char
Int

18
2
3

PK
PK

2.4.1.2

Flux Doc

2.4.1.2.1 Description gnrale


Contenu de la table :
Liste lensemble des lments de la documentation mis disposition par un constructeur
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.4.1.2.2

Description des champs

Nom du champ

Type

Long.

PK

DocID

Char

18

PK

DocType

Char

PK

FileName

Char

255

WebFormat

Char

Null
autoris

Oui

Description longue et commentaires


Numro didentification du document
Ce numro doit imprativement tre unique dans le type mentionn dans le champ DocType .
Deux documents, peuvent avoir des valeurs identiques, uniquement si le type de document est diffrent.
Type de document
Les valeurs utilisables doivent correspondre aux valeurs configures dans la table DocType
Nom du fichier image associ cet lment de document
Ce champ contient le nom du fichier du document.
Celui-ci peut tre vide, si llment de documentation na aucune reprsentation possible. Cest par
exemple le cas des titres de chapitre Vues clates .
Type du fichier graphique affich sur internet

Les formats grs pour le moment par Agora sont :


o TIF
o PDF
o HTM
o PNG
o Sur Minitel, seul le format TIF est support.

2.4.1.2.3 Remarques
- Lensemble des valeurs spcifies dans la table DocLink pour un nud pre ou fils doivent tre prsent dans cette table, sauf les valeurs de type 00 utilises pour faire le
lien sur les appareils

Page | 34

2.4.1.3

Flux DocType

2.4.1.3.1 Description gnrale


Contenu de la table :
Liste lensemble des types de documentations, ainsi quune description pour ceux-ci dans les diffrentes langues gres par le constructeur.
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
Cette table nest pas mise jour automatiquement par change de fichier mais sur intervention manuelle du constructeur
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.4.1.3.2

Description des champs

Nom du champ

Type

Long.

PK

Null
autoris

Description longue et commentaires

DocType

Char

PK

Type de document

PK

Ce champ contient un code identifiant les types de documentation gre par le constructeur.
Ces types peuvent par exemple correspondre SE pour Schma lectrique, ou VE pour Vues
clates ,
Code langue constructeur
Description du type de doc
Type Page

Language
Des
IsPage

Char
Char
Bool

2
32
1

OUI

Ce champ boolen si positionn 1 indique que les documents de ce type (DocType) doivent tre
considrs comme des pages de documentation, c'est--dire le niveau final dune arborescence de
document
Sur Minitel
o En cas de slection dun document de ce type, le service Minitel AGORA en proposera lenvoi
par fax.
o Les autres types de documents pour lesquels cette valeur est 0 (chapitre par exemple), ne
sont utiliss que pour la navigation et le classement, mais ne seront jamais envoys par fax.
Sur Internet
o Ce champ dtermine galement le comportement des outils de visualisation
Prsence dune liste de pices associes ce type de doc

Ce champ doit obligatoirement tre utilis conjointement au champ IsPage .


PartsList doit tre positionn la valeur 1 , si le document comporte une liste de pice
"lectronique" cest dire issue de la base de donnes (voir table Partslist ).
La liste de pice associe doit tre imprime partir de la nomenclature en base de donnes

PartsList

Bool

PrintPartsList

Bool

Page | 35

Ce champ doit obligatoirement tre utilis conjointement au champ PartsList .


Ce champ sil est fix 1 indique que la liste de pices lectronique (contenue dans la base de

donnes) doit tre imprime ou faxe en mme temps que la documentation.


Ce champ peut cependant est renseign 0 , si la liste des pices apparat dj dans le document
graphique.
Ce type de document est un chapitre devant tre affich dans le TreeView sur internet

TreeView

Bool

2.4.1.3.3

Page | 36

En mettant ce champ 1 , le document (que ce soit un chapitre, une section ou une page) sera visible
dans la TreeView sur internet (voir ci-dessous).
Les recommandations sont les suivantes :
o Pour les types de documents utilisant des formats autres que TIFF, la valeur doit obligatoirement
tre positionne 1 ainsi que pour tous les types de chapitres rencontrs dans les niveaux
suprieurs de larborescence
o Pour les documents utilisant des formats TIFF, la valeur doit peut-tre positionn
A 0 pour que la navigation dans les diffrents chapitres et sous-chapitre seffectue
avec loutil de consultation de RTE. Seul le dernier lment avec la valeur 1 sera
visible dans le treeview.
A 1 pour que llment apparaissent dans le treeview. En cas de slection dans ce
mme treeview du niveau le plus bas, le document associ sera affich dans la partie
droite

Remarques
Tous les types de documents pour lesquels le champ TreeView est positionn 1 sont affichs dans larborescence tel que cela est illustr ci-dessous.

2.4.1.4

Flux DocTitle

2.4.1.4.1 Description gnrale


Contenu de la table :
Indique la langue et un titre de document
Lutilisation de cette table nest pas obligatoire.
Si elle nest pas utilise, toutes les documentations sont prsentes au rparateur indpendamment de la langue parle et un titre gnrique
sera issu de la table DocType (en fonction du type du document)
Si un constructeur dcide de prciser la langue des documentations, ceci devra tre fait pour lensemble des documentations en respectant le
principe dutilisation des champs suivant (particulirement le champ Language ). Labsence denregistrement pour une documentation, rend
celle-ci indisponible pour toutes les langues.
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.4.1.4.2

Description des champs

DocID

Char

18

PK

Identification du document

DocType
Language

Char
Char

2
2

PK
PK

Type de document
Code langue constructeur

PK

Le document (couple DocID / DocType ) ne saffiche que pour les langues spcifies dans ce
champ
Si un document est valable pour plusieurs langues (par exemple une vues clates sans notion de texte), cette table
doit contenir autant denregistrement que de langues
Titre du document
Identification du document

Des
DocID

Page | 37

Char
Char

32
18

Oui

2.4.1.5

Flux PartsList

2.4.1.5.1 Description gnrale


Contenu de la table :
Cette table permet de connatre la liste des pices associes un produit (nomenclature)
Sens du transfert :
Priodicit conseille :
Format de fichier :
2.4.1.5.2

Plusieurs modes de gestion sont possible suivant si les champs DocID , DocType sont renseigns ou non.
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Description des champs


Null
autoris

Nom du champ

Type

Long.

PK

Description longue et commentaires

ProductID

Char

18

PK

DocID

Char

18

PK

Oui

Numro du document

DocType

Char

PK

Oui

Type du document

PartsRef

Char

18

PK

LocateNb

Char

PK

Quantity

Int

Numro didentification de lappareil

Rfrence de la pice
Oui

Numro de repre sur les vues clates

Oui

Ce champ est optionnel si le constructeur gre directement la rfrence de pice sur les vues clates
Quantit

Ce champ permet de contrler les quantits de pices indiqus lors dun rapports dintervention sous
garantie

2.4.1.5.3 Remarques
Les champs DocID et DocType ne doivent tre utilis que dans le cas suivant :
-

le constructeur peut identifier pour lappareil les pices prsentes sur chacune des pages de vues clates
la valeur AllPartsList de la table Products pour lappareil en question est alors positionn 0
Les champs ProductID , DocID , DocType et PartsRef sont alors systmatiquement renseigns pour permettre AGORA de dterminer la liste de pices
associes chaque page.

Page | 38

2.4.1.6

Flux DocZone

2.4.1.6.1 Description gnrale


Contenu de la table :
Position des numros de repres ou rfrences de pices dans les images TIFF
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.4.1.6.2

Description des champs


Null
autoris

Nom du champ

Type

Long.

PK

Description longue et commentaires

DocID

Char

18

PK

Numro de doc

DocType

Char

PK

Type de doc

PartsRef

Char

18

PK

Oui

Rfrence de la pice

LocateNb

Char

PK

Oui

Numro de repre sur les vues clates

LeftPos

Int

Position du bord gauche

TopPos

Int

Position du bord suprieur

RightPos

Int

Position du bord droit

BottomPos

Int

Position du bord infrieur

2.4.1.6.3 Remarques
- En regard de la composition et des informations prsentes sur les vues clates, un seul des champs PartsRef et LocateNb peut tre utilis par un constructeur. Lautre
champ doit alors tre laiss vide.
- Ces quatre coordonnes dterminent la position et la taille de la zone dans laquelle le numro de repre (ou la rfrence pice) apparat.
- Les valeurs doivent imprativement tre exprimes en pixels, et limage correspondante doit imprativement utiliser une taille proche de la rsolution fax (soit 1728 par 2340
pixels).

Page | 39

2.4.1.7

Images

2.4.1.7.1 Description gnrale


Contenu de la table :
Ce flux correspond lenvoi vers AGORA des fichiers images pour la documentation.
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
2.4.1.7.2 Formats accepts
Les formats supports par RTE sont :
-

PDF
PNG
TIFF
JPEG
GIF

Pour le format TIFF :


-

RTE prend en charge la majorit des normes de compressions existantes :


- Sans compression
- Compression Packbit
- Compression LZW
- Compression LZW avec diffrentiation
- Compression CCITT Group 3 1D NO EOL
- Compression CCITT Group 3 1D EOL
- Compression CCITT Group 3 2D
- Compression CCITT Group 4
- ordre des bytes Intel ou Macintosh

Les recommandations vis--vis de la rsolution des images TIFF sont les suivantes :
- Format A4
- Rsolution 200dpi
- Noir et Blanc
- Compression CCITT Group 4

Page | 40

2.4.1.7.3 Remarque sur le format PDF


Les documents PDF peuvent contenir une ou plusieurs pages. Pour viter une taille trop importante et donc un temps de tlchargement long pour lutilisateur, RTE recommande :
-

de limiter la rsolution des photos une rsolution cran (72dpi)


dutiliser loption Optimisation pour le web disponible dans la majorit des logiciels de cration de fichiers PDF (par exemple Acrobat Distiller)

Page | 41

2.4.2 CHOIX2 : Flux de type XML


2.4.2.1

Flux XML Itemdocs

2.4.2.1.1 Description gnrale


Contenu de la table :
Liste lensemble des lments de la documentation mis disposition par un constructeur
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
XML (UTF16)
2.4.2.1.2

Page | 42

Vue densemble du schma

2.4.2.1.3

Description du schma

Nom de llment

Nom de
lattribut

Type

mode

String

type

String

reference

String

code
name
action

String
String
String

Null autoris

itemdocs

Oui

Elment racine du document xml


Permet de spcifier si le mode de mise jour est :
Annule et remplace (valeur =replace)
Diffrentiel (valeur=update)
Cet lment reprsente un document.
Type de document
Les valeurs utilisables doivent correspondre aux valeurs configures dans la table DocType
Numro didentification du document
Ce numro doit imprativement tre unique dans le type mentionn dans le champ type
Deux documents peuvent avoir des valeurs identiques, uniquement si le type de document est diffrent.
Code du document
Nom du document
Si le mode de mise jour est diffrentiel, alors cet attribut doit contenir une des valeurs suivantes :
delete (pour suppression)
insert (pour ajout)
Cet lment reprsente la traduction dun titre de document

Oui

Code langue constructeur


Le document ne saffiche que pour les langues spcifies dans ce champ
Si un document est valable pour plusieurs langues (par exemple une vues clates sans notion de texte),
cette table doit contenir autant denregistrement que de langues
Titre du document
Reprsente le fichier du document
Nom du fichier image associ cet lment de document
Ce champ contient le nom du fichier du document.
Celui-ci peut tre vide, si llment de documentation na aucune reprsentation possible. Cest par exemple le cas des
titres de chapitre Vues clates .
Cet lment reprsente le lien vers un fichier dont le contenu est traduit dans une autre langue.

itemdocs > Itemdoc

itemdocs > Itemdoc > localizations >


localization
language

String

value

String

Oui

itemdocs > Itemdoc > file


name

itemdocs > Itemdoc > file > localizations >


localization

Page | 43

Description longue et commentaires

2.4.2.1.4 Remarques
- Ce fichier XML contient les donnes des anciens fichiers plats DOC et DOC_TITLE
- Ci-dessous le mapping avec les flux TXT :
FMT

XML

File name

Field name

File name

DOC.FMT

DOCID

itemdocs.xsd

/itemdocs/itemdoc[@reference]

DOC.FMT

DOCTYPE

itemdocs.xsd

/itemdocs/itemdoc[@type]

DOC.FMT

FILENAME

itemdocs.xsd

/itemdocs/itemdoc/file[@name]

DOC.FMT

UPDATE

N/A

FMT

N/A

XML

File name

2.4.2.2

Field name

Field name

File name

Field name

DOCTITLE.FMT

DOCID

itemdocs.xsd

/itemdocs/itemdoc[@reference]

DOCTITLE.FMT

DOCTYPE

itemdocs.xsd

/itemdocs/itemdoc[@type]

DOCTITLE.FMT

LANGUAGE

itemdocs.xsd

/itemdocs/itemdoc/localizations/localization[@language]

DOCTITLE.FMT

DES

itemdocs.xsd

/itemdocs/itemdoc/localizations/localization[@value]

DOCTITLE.FMT

UDPATE

N/A

N/A

Flux XML Itemtrees

2.4.2.2.1 Description gnrale


Contenu de la table :
Arborescence des documents disponibles pour un appareil
AGORA a adopt un systme de classement de la documentation bas sur une structure darbre hirarchique. Cette table permet de dcrire
et de stocker cet arbre.
Cette table permet par exemple dindiquer que plusieurs documents sont disponibles pour un produit, que ceux-ci sont composs de plusieurs
chapitres, eux-mmes dcomposes en pages.
Le niveau de dcomposition peut tre variable pour les diffrents constructeurs, mais galement pour chaque produit ou documentation, ou
mme lintrieur mme dune documentation.
Page | 44

Structure de larbre :
o Le principe de cette table est dindiquer pour un nud pre , la liste des nuds Fils qui le compose. Cette relation pre / fils
permet de construire un arbre pour chaque appareil.
o Le premier type de nud situ la base de chaque arbre est constitu par un produit fini (ID de lappareil).
o Les derniers lments situs au bout de chaque branche reprsentent les pages des documents.
o A partir dun produit fini, il est donc possible de trouver lensemble des documents disponibles, ainsi que de les prsenter classs.
Lors du parcours de larbre, la langue de chaque fils est contrle par rapport la langue de la personne connecte pour ne
prsenter que les fils dans la langue parl par le rparateur
Du constructeur vers RTE
1 fois par jour
XML (UTF16)

Sens du transfert :
Priodicit conseille :
Format de fichier :

Page | 45

2.4.2.2.2

Page | 46

Vue densemble du schma

2.4.2.2.3

Description du schma

Nom de llment

Nom de
lattribut

Type

mode

String

type
reference
displayorder

String
String
Int

action

String

type
reference
displayorder

String
String
Int

type
reference
displayorder

String
String
Int

Null autoris

Itemtrees

Itemtrees > Itemtree

Itemtrees > Itemtree > Item

Itemtrees > Itemtree > Node

Oui

Description longue et commentaires


Elment racine du document xml
Permet de spcifier si le mode de mise jour est :
Annule et remplace (valeur =replace)
Diffrentiel (valeur=update)
Elment parent de larbre de documentation
Prcise le type darborescence, pour un arbre, la valeur Root est spcifier.
Contient la rfrence du noeud
Numro de classement. Ce champ permet de classer les fils afin de dterminer lordre daffichage des diffrents
lments.
Si le mode de mise jour est diffrentiel, alors cet attribut doit contenir une des valeurs suivantes :
delete (pour suppression)
insert (pour ajout)
Elment fils de type feuille (i.e. qui ne contient aucun sous-lment)
Type de document
Numro du document
Numro de classement. Ce champ permet de classer les fils afin de dterminer lordre daffichage des diffrents
lments.
Elment fils de type noeud (i.e. qui contient au moins 1 sous-lment)
Type de document
Numro du document
Numro de classement. Ce champ permet de classer les fils afin de dterminer lordre daffichage des diffrents
lments.

2.4.2.2.4 Remarques
- Ce fichier XML contient les donnes de lancien fichier plat DOCLINK
- La technologie XML permet de reprsenter sous forme arborescente larbre de documentation : les lments Node peuvent contenir dautres lments Node rcursivement
et sur autant de sous-niveaux que souhait.

Page | 47

2.4.2.3

Flux XML Itemlinklist

2.4.2.3.1 Description gnrale


Contenu de la table :
Cette table permet de connatre la liste des pices associes un produit (nomenclature)
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
XML (UTF16)
2.4.2.3.2

Page | 48

Vue densemble du schma

2.4.2.3.3

Description du schma

Nom de llment

Nom de
lattribut

Type

mode

String

action

String

type
reference

String
String

type
reference

String
String

type
reference

String
String
Int

Null autoris

Itemlinklist

Itemlinklist > linklist

Itemlinklist > linklist > item

Oui

Description longue et commentaires


Elment racine du document xml
Permet de spcifier si le mode de mise jour est :
Annule et remplace (valeur =replace)
Diffrentiel (valeur=update)
Elment de la nomenclature
Si le mode de mise jour est diffrentiel, alors cet attribut doit contenir une des valeurs suivantes :
delete (pour suppression)
insert (pour ajout)
Elment reprsentant un produit
La valeur doit tre fixe : model
Numro didentification de lappareil

Itemlinklist > linklist > itemdoc

Itemlinklist > linklist > list


Itemlinklist > linklist > list > linkeditem

Itemlinklist > linklist > list > linkeditem >


quantity
Itemlinklist > linklist > list > linkeditem >
locatenb
Itemlinklist > linklist > list > linkeditem >
displayorder

Page | 49

String
Int

Type du document
Numro du document
Elment de regroupement des pices lies la nomenclature
Elment de lien avec la pice
La valeur doit tre fixe : part
Rfrence de la pice
Quantit. Ce champ permet de contrler les quantits de pices indiqus lors dun rapports dintervention sous garantie
Numro de repre sur les vues clates. Ce champ est optionnel si le constructeur gre directement la rfrence de
pice sur les vues clates
Numro de classement. Ce champ permet de classer les pices afin de dterminer lordre daffichage des diffrents
lments.

2.4.2.3.4 Remarques
- Ce fichier XML contient les donnes de lancien fichier plat PARTSLIST
- Ci-dessous le mapping avec les flux TXT :
FMT
File name

2.4.2.4

XML
Field name

File name

Field name

PARTSLIST.FMT

PRODUCTID

itemlinklist.xsd

/itemlinklist/linklist/item[@reference]

PARTSLIST.FMT

DOCID

itemlinklist.xsd

/itemlinklist/linklist/itemdoc[@reference]

PARTSLIST.FMT

DOCTYPE

itemlinklist.xsd

/itemlinklist/linklist/itemdoc[@type]

PARTSLIST.FMT

PARTSREF

itemlinklist.xsd

/itemlinklist/linklist/list/linkeditem[@reference]

PARTSLIST.FMT

LOCATENB

itemlinklist.xsd

/itemlinklist/linklist/list/linkeditem/locatenb

PARTSLIST.FMT

QUANTITY

itemlinklist.xsd

/itemlinklist/linklist/list/linkeditem/quantity

PARTSLIST.FMT

UPDATE

N/A

Description XSD

<?xml version="1.0" encoding="utf-8"?>


<xs:schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified">
<!-- definition of complex elements -->
<xs:complexType name="localizationsType">
<xs:sequence>
<xs:element name="localization" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="language" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="taglistType">
<xs:sequence>
<xs:element name="tag" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="listaction" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="delete"/>
<xs:enumeration value="merge"/>
<xs:enumeration value="override"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
<xs:complexType name="countrylistType">
<xs:sequence>
<xs:element name="country" type="xs:integer" minOccurs="0"
</xs:sequence>
<xs:attribute name="listaction" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration
<xs:enumeration
<xs:enumeration
</xs:restriction>
</xs:simpleType>
</xs:attribute>

maxOccurs="unbounded"/>

value="delete"/>
value="merge"/>
value="override"/>

</xs:complexType>
<xs:complexType name="custompropertiesType">
<xs:sequence>
<xs:element name="customproperty" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="localizations" type="localizationsType" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="linklistType">
<xs:sequence>
<xs:element name="linkeditem" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:all>
<xs:element name="item" type="itemType" />
<xs:element name="quantity" type="xs:decimal" minOccurs="0"/>
<xs:element name="displayorder" type="xs:integer" minOccurs="0"/>
</xs:all>
<xs:attribute name="locatenb" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="listaction" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="delete"/>

Page | 50

N/A

<xs:enumeration value="override"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
<xs:complexType name="substitutelistType">
<xs:sequence>
<xs:element name="substitute" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:all>
<xs:element name="item" type="itemType"/>
<xs:element name="displayorder" type="xs:integer" minOccurs="0"/>
</xs:all>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="listaction" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="delete"/>
<xs:enumeration value="override"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
<xs:complexType name="itemType">
<xs:all>
<xs:element name="code" type="xs:string" minOccurs="0"/>
<xs:element name="icon" type="xs:string" minOccurs="0"/>
<xs:element name="label" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="localizations" type="localizationsType" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="default" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="thumbnail" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="localizations" type="localizationsType" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="default" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="picture" type="xs:string" minOccurs="0"/>
<xs:element name="comment" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="localizations" type="localizationsType" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="default" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="countrylist" type="countrylistType" minOccurs="0"/>
<xs:element name="authorizationgroup" type="xs:string" minOccurs="0"/>
<xs:element name="customproperties" type="custompropertiesType" minOccurs="0"/>
<xs:element name="file" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="localizations" type="localizationsType" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="default" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="linklist" type="linklistType" minOccurs="0"/>
<xs:element name="substitutelist" type="substitutelistType" minOccurs="0"/>
<xs:element name="taglist" type="taglistType" minOccurs="0"/>
</xs:all>
<xs:attribute name="type" type="xs:string" use="required"/>
<xs:attribute name="reference" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="nodeType">
<xs:all>
<xs:element name="item" type="itemType"/>
<xs:element name="displayorder" type="xs:integer" minOccurs="0"/>
<xs:element name="nodes" type="nodesType" minOccurs="0"/>
</xs:all>
</xs:complexType>
<xs:complexType name="nodesType">
<xs:sequence>
<xs:element name="node" type="nodeType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="itemtreeType">
<xs:sequence>
<xs:element name="item" type="itemType"/>
<xs:element name="nodes" type="nodesType" minOccurs="0"/>
</xs:sequence>
<xs:attribute name="listaction" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="delete"/>
<xs:enumeration value="merge"/>
<xs:enumeration value="override"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
<xs:element name="rtedoc-stream">
<xs:complexType>
<xs:sequence>
<xs:element name="itemlist" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="item" type="itemType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="listaction" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="delete"/>
<xs:enumeration value="merge"/>
<xs:enumeration value="override"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="itemtree" type="itemtreeType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="version" type="xs:string" use="required"/>
<xs:attribute name="sequencenumber" type="xs:integer" use="optional"/>
</xs:complexType>
</xs:element>
</xs:schema>

Page | 51

2.5 MODULE ACCESSOIRES


2.5.1 Flux Accessories
2.5.1.1 Description gnrale
Contenu de la table :
Liste des articles disponibles comme accessoires
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.5.1.2

Description des champs


Null
autoris

Nom du champ

Type

Long.

PK

AccRef

Char

18

PK

AccType

Char

Oui

CountryFilter

Char

Oui

BrandFilter

Char

Oui

Code filtre par pays


Champ facultatif utilis pour limiter laccs certains pays
Cette information est utilise en relation avec la table AccessoriesCountries
Non Utilis Champ laisser vide

AccFamilyCode

Char

Status
MinQuantity
MaxQuantity
UnitQuantity
PriceCode
PublicPriceCode

Int
Int
Int
Int
Char
Char

2
3
4
3
5
5

Oui
Oui
Oui
Oui
Oui
Oui

Code famille accessoire


Code utilis lors de la recherche daccessoires par famille
Ce code est li la table AccessoriesFamilies.
Non Utilis Champ laisser vide
Non Utilis Champ laisser vide
Non Utilis Champ laisser vide
Non Utilis Champ laisser vide
Non Utilis Champ laisser vide
Non Utilis Champ laisser vide

Page | 52

Description longue et commentaires

Rfrence accessoire
Cette rfrence doit tre prsent dans la table Parts comme un article (champs PartsRef ) et dans
lensemble des autres tables associes ( PartsPrice par exemple)
Non Utilis Champ laisser vide

2.5.2 Flux AccessoriesDes


2.5.2.1 Description gnrale
Contenu de la table :
Dsignation des accessoires
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
2.5.2.2

Description des champs

Nom du champ

Type

Long.

PK

AccRef
Language
AccDes

Char
Char
Char

18
2
32

PK
PK

Null
autoris

Description longue et commentaires


Rfrence accessoire
Code langue constructeur
Dsignation

2.5.3 Flux AccessoriesCountries


2.5.3.1 Description gnrale
Contenu de la table :
Fichier de filtre daccs aux accessoires en fonction du pays du rparateur
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.5.3.2

Description des champs

Nom du champ

Type

Long.

PK

CountryFilter
CountryCode

Char
Int

4
4

PK
PK

Null
autoris

Description longue et commentaires


Code filtre de pays
Code du pays

suivant la codification utilise dans la table Clients


recommandation de la norme ISO-3 numrique dtaille en annexe

2.5.3.3 Exemple de filtre


- Pour configurer un filtre CF01 valable pour la Belgique, la France et la Grante Bretagne
- Les enregistrements suivants devront tre crs dans cette table

Page | 53

CountryFilter

CountryCode

cf01
cf01
cf01

056
250
826

2.5.4 Flux AccessoriesFamilies


2.5.4.1 Description gnrale
Contenu de la table :
Arborescence de classification des accessoires
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.5.4.2

Description des champs

Nom du champ

Type

Long.

AccFamilyCode

Char

AccSubFamilyCode

Char

CountryFilter

Char

PK

Null
autoris

Oui

Description longue et commentaires


Code famille daccessoires
Pour le premier niveau de classification des accessoires, le champ isTopFamily doit galement tre
positionn 1
Code sous-famille daccessoires
Le champ AccSubFamilyCode laiss vide, indique quil ny a plus de sous-famille et quon se trouve en
prsence dun code famille daccessoire li la table Accessories .
Code filtre par pays
Champ facultatif utilis pour limiter laccs certains pays
En cas de filtre configur, la famille daccessoires ne sera visible que pour les rparateurs dans les pays
concerns
Est utilis relation avec la table AccessoriesCountries
Rserv Non Utilis
Famille de premier niveau

BrandFilter
IsTopFamily

Char
Bool

4
1

FamilyPicture

Char

18

Page | 54

Oui

Une valeur 1 indique quil sagit dune famille de base


Nom de limage associe
Ce fichier image illustre sur AGORA la famille ou sous-famille daccessoire.
Les formats dimages accepts sont : GIF, JPG et PNG.
La taille maximale conseille est de 150px en largeur sur 150px en hauteur avec une palette de 256
couleurs.

2.5.4.3 Exemple
Lexemple de contenu de table suivant :

AccFamilyCode
acfam1
acfam1
acfam2
acsub1
acsub1
acsub2
acsec1
acsec2

AccSubFamilyCode
acsub1
acsub2
acsec1
acsec2

IsTopFamily
1
1
1
0
0
0
0
0

Permet de crer sur AGORA une classification de famille telle que :


acfam1
acsub1
acsec1
acsec2
acsub2
acfam2

Page | 55

2.5.5 Flux AccessoriesFamiliesDes


2.5.5.1 Description gnrale
Contenu de la table :
Dsignation de la famille daccessoires
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.5.5.2

Description des champs

Nom du champ

Type

Long.

PK

AccFamilyCode
Language
AccFamilyDes

Char
Char
Char

6
2
32

PK
PK

Null
autoris

Description longue et commentaires


Code famille daccessoires (ou sous-famille)
Code langue constructeur
Dsignation de la famille daccessoires

2.5.6 Flux AccessoriesInfos


2.5.6.1 Description gnrale
Contenu de la table :
Fichier utilise pour la gestion de la partie informations supplmentaires de la prsentation dun accessoire.
Sens du transfert :
Priodicit conseille :
Format de fichier :
2.5.6.2

Permet au constructeur dassocier un accessoire un ensemble dinformation, chacune compose dun libell et dune valeur
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Description des champs

Nom du champ

Type

Long.

PK

AccRef
AccLabelID

Char
Char

18
5

PK
PK

Rfrence accessoire
Code identifiant du libell

Language
AccInfo

Char
Char

2
40

PK

Cette valeur correspond un identifi dcrit dans la table AccessoriesInfosLabel


Code langue constructeur
Valeur afficher

Page | 56

Null
autoris

Description longue et commentaires

2.5.7 Flux AccessoriesInfosLabels


2.5.7.1 Description gnrale
Contenu de la table :
Liste des libells configurs
Sens du transfert :
Priodicit conseille :
Format de fichier :
2.5.7.2

Cette table permet pour chaque ID de libell dindiquer un le texte correspond et lordre de prsentation
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Description des champs

Nom du champ

Type

Long.

PK

AccLabelID
Language
AccLabel
AccOrder

Char
Char
Char
Int

5
2
18
2

PK
PK

Null
autoris

Oui
Oui

Description longue et commentaires


Code identifiant du libell
Code langue constructeur
Texte du libell
Ordre de classement

2.5.8 Flux AccessoriesProducts


2.5.8.1 Description gnrale
Contenu de la table :
Liste des accessoires disponibles pour un appareil
Sens du transfert :
Priodicit conseille :
Format de fichier :
2.5.8.2

Fichier utilise pour la recherche de cas demploi daccessoires ainsi que laffichage de la liste des accessoires compatible avec un appareil
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Description des champs

Nom du champ

Type

Long.

PK

AccRef
ProductID

Char
Char

18
18

PK
PK

Null
autoris

Description longue et commentaires


Rfrence de laccessoire
Identifiant appareil

Page | 57

Valeur existante dans la table Products

2.5.9 Flux AccessoriesPictures


2.5.9.1 Description gnrale
Contenu de la table :
Fichier dfinissant le nom des fichiers images reprsentant laccessoire (photo par exemple)
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.5.9.2

Description des champs

Nom du champ

Type

Long.

PK

AccRef
Language
AccPicture

Char
Char
Char

18
2
18

PK
PK

Null
autoris

Description longue et commentaires


Rfrence de laccessoire
Code langue constructeur
Nom du fichier

Page | 58

Le nom de limage peut tre le mme pour les diffrentes langues (par exemple sil ny a pas de texte dans
limage) ou au contraire spcifique une langue.
Les formats dimages accepts sont : GIF, JPG et PNG.
La taille maximale conseille est de 400pixels en largeur sur 300pixels en hauteur avec une palette de 256
couleurs.

2.6 MODULE COMMANDE


2.6.1 Introduction
Lenvoi des fichiers de commande de RTE vers le constructeur peut se faire selon 2 formats :
1. Fichier entte et dtail spar :
Deux fichiers distincts seront transmis
Un fichier Orders pour les en-ttes de commande
Un fichier OrderDetail pour les lignes de commandes
2. Fichier entte et dtail unique :
un seul fichier contenant les en-ttes et les dtails des commandes est transmis

2.6.2 Gestion des filiales AGORA STUDIO


The below matrix defines flows that can be used by a subsidiary:
Description
ClientsLiv
OrderResponse

OrderResponseDetail

OrderResponseLineDetail

Page | 59

Delivery adresses
Contains information
returned by the
manufacturer to RTE to
update the order status
Contains information
returned by the
manufacturer to RTE to
update each order line
status
Contains information
returned by the
manufacturer to RTE to
update the delivery slips on
a command line.

May be extended to
subsidiaries?
OUI
OUI

OUI

NON

2.6.3 Flux ClientsLiv


2.6.3.1 Description gnrale
Contenu de la table :
Fichier des Adresses/ Comptes de livraison
Sens du transfert :
Priodicit conseille :
Format de fichier :
2.6.3.2

Lors de la transmission dune commande, il est possible de choisir entre plusieurs adresses de livraison.
Constructeur vers RTE
1 fois par heure ou suivant la planification souhaite par le constructeur
TEXTE (ASCII ou UNICODE)

Description des champs

Nom du champ

Type

Long.

PK

ClientNumber

Char

10

PK

ClientNbLiv

Char

10

PK

Company
Name
Address1
Address2
Address3
Zip
Town
Country
Tel
Fax

Char
Char
Char
Char
Char
Char
Char
Int
Char
Char

32
32
32
32
32
10
32
4
14
4

Page | 60

Nom du
champ

Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui

Autoris pour les


filiales
Oui

Description longue et commentaires


Numro du client

Oui

Ce champ contient le numro du client auprs du constructeur


Identification de ladresse de livraison

Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui

Ce champ contient le numro de client correspondant ladresse de livraison


Nom de la socit pour ladresse de livraison
Nom de la personne pour la livraison
Premire ligne de ladresse de livraison
Deuxime ligne de ladresse de livraison
Troisime ligne de ladresse de livraison
Code postal de ladresse de livraison
Ville de ladresse de livraison
Code pays de ladresse de livraison
Numro de tlphone
Numro de fax

2.6.4 CHOIX 1 : Flux de commandes en mode entte et lignes spares


2.6.4.1

Flux Orders

2.6.4.1.1 Description gnrale


Contenu de la table :
Entte de commande

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.6.4.1.2

Contient les enttes des commandes de pices


Correspond au format de fichier lorsque deux fichiers sont transmis aux constructeurs (1 pour les enttes, 1 pour les lignes)
Du RTE vers les constructeurs
1 fois par heure ou suivant la planification souhaite par le constructeur
TEXTE (ASCII ou UNICODE)

Description des champs

Nom du champ

Type

Long.

PK

OrderNbAGORA

Char

12

PK

OrderNbCLIENT

Char

12

ClientNumber
ClientNumberLiv
OrderDate
DeliveryMode
DeliveryCompany
DeliveryName
DeliveryAddress1
DeliveryAddress2
DeliveryAddress3
DeliveryZip
DeliveryTown
DeliveryCountry

Char
Char
DateTime
Int
Char
Char
Char
Char
Char
Char
Char
Char

10
10
19
1
32
32
32
32
32
10
32
4

Page | 61

Null
autoris

Oui

Oui

Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui

Description longue et commentaires


Numro de commande attribu par AGORA
Numro de commande unique calcul par le serveur AGORA.
Ce numro est transmis aux constructeurs pour permettre un suivi des informations retournes.
Ce champ ne sera pas affich
Numro de commande saisie par le rparateur
Le serveur AGORA autorise le rparateur saisir un numro de commande.
Celui-ci est gnralement mmoris tel quel sans contrle, et envoy au constructeur.
Pour certain constructeur utilisant ce numro comme numro didentification de la commande, le
serveur AGORA imposera une unicit de linformation saisie.
Numro de compte client chez ce constructeur
Numro client pour ladresse de livraison (champ ClientNbLiv de la table ClientsLiv).
Date et heure de saisie de la commande
Mode de livraison souhait
Nom de la socit pour ladresse de livraison
Nom de la personne pour la livraison
Premire ligne de ladresse de livraison
Deuxime ligne de ladresse de livraison
Troisime ligne de ladresse de livraison
Code postal de ladresse de livraison
Ville de ladresse de livraison
Code pays de ladresse de livraison

DeliveryPhone
DeliveryEmail
WhishedDeliveryDate
DeliveryInfo
ServiceOrder

Char
Char
DateTime
Char
Char

14
128
19
512
20

Oui
Oui
Oui
Oui

Numro de tlphone li ladresse de livraison


Adresse mail li ladresse de livraison
Date de livraison souhaite
Informations complmentaires
Numro dordre de mission du mandat

2.6.4.1.3 Remarques
Si le rparateur na pas le droit de modifier son adresse de livraison (Voir champ DeliveryAllowed de la table Clients ), le contenu des champs de ladresse de livraison est
gal ladresse par dfaut fournie par le constructeur dans sa table Clients .
2.6.4.2

Flux OrderDetail

2.6.4.2.1 Description gnrale


Contenu de la table :
Lignes de commande
Contient les lignes de commande de pices
Correspond au format de fichier lorsque deux fichiers sont transmis aux constructeurs (1 pour les enttes, 1 pour les lignes)
Sens du transfert :
Du RTE vers les constructeurs
Priodicit conseille :
1 fois par heure ou suivant la planification souhaite par le constructeur
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.6.4.2.2

Description des champs

Nom du champ

Type

Long.

PK

OrderNbAGORA
Line

Char
Int

12
4

PK
PK

PartsRef
NewPartsRef

Char
Char

18
18

Oui

Quantity
Notes

Int
Char

4
40

Oui

Page | 62

Null
autoris

Description longue et commentaires


Numro de commande attribu par AGORA
Numro de la ligne de commande
Ce champ permet didentifier une ligne de commande (pour diffrencier plusieurs demandes dune mme
pice dans une mme commande)
Il doit tre mmoris par le constructeur sil dsire retourner au serveur AGORA des informations sur
lvolution de la ligne de commande.
Rfrence de la pice commande
Rfrence de la pice de remplacement
Cette rfrence est communique pour information uniquement
Quantit commande
Commentaires saisis par le rparateur pour identifier sa commande
Ce champ ne subit aucun contrle ni traitement.
Il est transmis pour information si le constructeur dsire faire apparatre cette information sur le bon de

livraison ou la facture lors du traitement de la commande.

2.6.5 CHOIX 2 : Flux de commandes en mode fichier unique


2.6.5.1

Flux Orders unique

2.6.5.1.1 Description gnrale


Contenu de la table :
Fichier de commande de pices
Sens du transfert :
Priodicit conseille :
Format de fichier :

Format avec enttes et lignes dans un mme fichier


Du RTE vers les constructeurs
1 fois par heure ou suivant la planification souhaite par le constructeur
TEXTE (ASCII ou UNICODE)

2.6.5.1.2 Format du fichier


Lentte ainsi que les lignes des commandes de pices sont transmises aux constructeurs dans un mme fichier.

Contenu du fichier de commande


1re commande

ORDERHEADER

Champs relatifs lentte de 1re commande

1ire ligne

ORDERLINE

Champs dcrivant la 1re ligne de la 1re commande

2ime ligne

ORDERLINE

Champs dcrivant la 2ime ligne de la 1re commande

Ligne suivante

ORDERLINE

2ime commande

ORDERHEADER

Champs relatifs lentte de la 2me commande

1ire ligne

ORDERLINE

Champs dcrivant la 1re ligne de la 2me commande

Le premier champ de chaque ligne contient :


- soit ORDERHEADER pour indiquer quil sagit de lentte
- soit ORDERLINE pour indiquer quil sagit dune ligne
Page | 63

La longueur de ce premier champ doit obligatoirement faire 11 caractres

Les autres champs pour les lignes denttes et de dtails sont identiques ceux documents dans les chapitres prcdents correspond des changes via fichiers spars (entte et
lignes).
2.6.5.1.3

Exemple de dbut de fichier


ORDERHEADER12591131000
ORDERLINE 12591131000
ORDERLINE 12591131000
ORDERLINE 12591131000
ORDERLINE 12591131000
ORDERLINE 12591131000

Page | 64

61302614
570551B
1
64561202
2
77X7233
3
75X2712
4
75x1764
5
31x5038

13/06/2002 11:311CENTRE
71X8709
1
girard
1
GUILLAUM
2
stock
1
camelin
1
stock

2.6.6 CHOIX 3 : Flux de commandes au format XML

Page | 65

2.6.6.1

Description XSD

<?xml version="1.0" encoding="utf-8" ?>


<!--Created with Liquid XML Studio - FREE Community Edition 7.0.2.746 (http://www.liquid-technologies.com)-->
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Orders">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="Order">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="ClientNumber">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="ClientNumberLiv">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="OrderDate" type="xs:date" />
<xs:element minOccurs="0" name="DeliveryMode" type="xs:int" />
<xs:element minOccurs="0" name="DeliveryCompany">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="DeliveryName">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="DeliveryAddress1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="DeliveryAddress2">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="DeliveryAddress3">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="DeliveryZip">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="DeliveryTown">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="DeliveryCountry">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="4" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="DeliveryStateCode">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="2" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="DeliveryPhone">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="19" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="DeliveryEmail">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="255" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="WhishedDeliveryDate" type="xs:date" />
<xs:element minOccurs="0" name="OrderLines">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="OrderLine">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="PartsRef">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="18" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="NewPartsRef">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="18" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="Quantity" type="xs:int" />
<xs:element minOccurs="0" name="Notes">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="40" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
<xs:attribute name="Line" type="xs:int" use="optional" />

Page | 66

</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="OrderNbAGORA" use="optional">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="12" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="OrderNbCLient" use="optional">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="12" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

2.6.7 Flux OrderResponse


2.6.7.1 Description gnrale
Contenu de la table :
Ce fichier contient les informations renvoyes par le constructeur RTE pour mettre jour les informations sur lentte de commande
Les tables envoyes peuvent contenir un nombre indtermin daccuss
Lenvoi de ce message est facultatif. Cependant, si un constructeur envoie de tels messages, les trois champs doivent tre renseigns.
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par heure ou suivant la planification souhaite par le constructeur
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.6.7.2

Description des champs

Nom du champ

Type

Long.

PK

OrderNbAGORA

Char

12

PK

OrderNbManufacturer

Char

12

Oui

Status

Int

Oui

Page | 67

Null
autoris

Autoris pour les


filiales
Oui

Description longue et commentaires


Numro de commande AGORA
Ce champ doit contenir le numro de commande attribu par le serveur AGORA.
Il doit correspondre celui reu par le constructeur lors de la transmission du dtail dune
commande.
Numro de commande retourn par le constructeur
Ce champ permet au constructeur de remonter son propre numro de commande.
Ce nouveau numro sera affich lors de la prsentation des commandes en cours.
Statut de la commande
Les statuts recommands sont :
o En prparation : lorsque le constructeur confirme avoir reue la
commande valeur 13
o Livre : lorsque la commande t traite valeur 2
o Livre partiellement valeur 3
o En reliquat valeur 4
Si le constructeur dsire utiliser des statuts supplmentaires, contacter RTE.

2.6.8 Flux OrderResponseDetail


2.6.8.1 Description gnrale
Contenu de la table :
Ce fichier contient les informations renvoyes par le constructeur RTE pour mettre jour les informations sur les lignes de commande
Les tables envoyes peuvent contenir un nombre indtermin daccuss pour des articles provenant dune ou plusieurs commandes.
Lenvoi de ce message est facultatif.
Du constructeur vers RTE
1 fois par heure ou suivant la planification souhaite par le constructeur
TEXTE (ASCII ou UNICODE)

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.6.8.2

Description des champs

Nom du champ

Type

Long.

PK

OrderNbAGORA

12

PK

Null
autoris

Autoris pour
les filiales
Oui

Description longue et commentaires


Numro de commande AGORA

Line

Status

Oui

Delivered

Oui

Ce champ doit contenir le numro de commande attribu par le serveur AGORA.


Il doit correspondre celui reu par le constructeur lors de la transmission du dtail dune
commande.
Numro de la ligne dans la commande
Il doit correspondre au numro initialement envoy par AGORA
Statut de la ligne
Ce champ prcise le nouvel tat de traitement de la ligne de commande.
Le statut sera exprim sous la forme dun code qui sera transcrit en clair par le serveur
AGORA.
Les valeurs recommandes sont :
o En prparation : lorsque le constructeur confirme avoir reue la commande
valeur 13
o Livre : lorsque la commande t traite valeur 2
o En reliquat valeur 4
o Non disponible : lorsque le produit est indisponible valeur 5
Si le constructeur dsire utiliser des statuts supplmentaires, contacter RTE.
Quantit livre

NewPartsRef
DeliveryDate

A
A

18
10

Oui
Oui

Si aucune pice na t livre, remplir ce champ par un zro.


Rfrence de la pice livre par le constructeur en cas de remplacement
Date de livraison

Page | 68

PK

Oui

Oui
Oui

2.6.9 Flux OrderResponseLineDetail


2.6.9.1 Description gnrale
Contenu de la table :
Ce fichier contient les informations renvoyes par le constructeur RTE pour mettre jour les informations concernant les bordereaux de Livraison
relatifs une ligne de commande les lignes de commande.
Les tables envoyes peuvent contenir un nombre indtermin daccuss pour des articles provenant dune ou plusieurs commandes.
Lenvoi de ce message est facultatif.
Du constructeur vers RTE
1 fois par heure ou suivant la planification souhaite par le constructeur
TEXTE (ASCII ou UNICODE)

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.6.9.2

Description des champs

Nom du champ

Type

Long.

PK

Null
autoris

OrderNbAGORA

12

PK

Autoris pour
les filiales
Oui

Line

PK

Oui

BLNumber

12

PK

Oui

PartsRef

18

PK

Oui

Delivered

Oui

Oui

DeliveryDate

10

Oui

Oui

Description longue et commentaires


Numro de commande AGORA
Ce champ contient le numro de commande attribu par le serveur AGORA.
Il doit correspondre celui reu par le constructeur lors de la transmission du dtail dune
commande
Numro de la ligne dans la commande
Ce champ correspond au numro de la ligne de commande concerne
Numro du Bon de Livraison
Ce champ correspond au numro de Bordereau de Livraison relatif la ligne de
commande concerne.
A une mme ligne de commande pourra correspondre plusieurs BL si la livraison a t
partielle.
Rfrence de la pice livre
Ce champ indique la rfrence de la pice rellement livre.
A un mme bordereau de livraison pourra correspondre plusieurs rfrences de pice
livre dans le cas ou pour une mme pice commande, la livraison a t faite via
plusieurs pices
Exemple : 10 pices X commandes 8 pices Y livres + 2 pices Z livres
Quantit livre pour cette pice
Ce champ contient la quantit rellement livre pour la pice concerne.
Date de livraison (du BL)
Ce champ contient la date de livraison relative au bordereau de livraison concern.

Page | 69

2.6.10 Flux OrderTacking


2.6.10.1 Description gnrale
Contenu de la table :
Ce fichier contient les informations renvoyes par le constructeur RTE pour mettre jour les informations de tracking colis
Lenvoi de ce message est facultatif.
Sens du transfert :
Priodicit conseille :
Format de fichier :

Du constructeur vers RTE


1 fois par heure ou suivant la planification souhaite par le constructeur
TEXTE (ASCII ou UNICODE)

Nom du champ

Type

Long. PK Null
Description longue et commentaires
autoris

OrderNbAGORA

Char

12

BLNumber

Char

12

PK

Numro de commande AGORA

PK

Ce champ contient le numro de commande attribu par le serveur AGORA.


Il doit correspondre celui reu par le constructeur lors de la transmission du dtail dune commande
Numro du Bon de Livraison

Ce champ correspond au numro de Bordereau de Livraison relatif la ligne de commande concerne.


A une mme ligne de commande pourra correspondre plusieurs BL si la livraison a t partielle.

Line

PK

Numro de la ligne dans la commande


Ce champ correspond au numro de la ligne de commande concerne

PartsRef

Char

18

PK

Rfrence de la pice livre

50

Ce champ indique la rfrence de la pice rellement livre.


A un mme bordereau de livraison pourra correspondre plusieurs rfrences de pice livre dans le cas ou pour une
mme pice commande, la livraison a t faite via plusieurs pices
Exemple : 10 pices X commandes 8 pices Y livres + 2 pices Z livres
Quantit livre pour cette pice
Ce champ contient la quantit rellement livre pour la pice concerne.
Code de suivi de colis fourni par le transporteur

Delivered

Number

TrackingNumber

Char

50

CarrierCode

Char

10

Page | 70

PK

Code interne du constructeur

2.7 MODULE GARANTIE


2.7.1 Gestion des filiales - AGORA STUDIO
The below matrix defines flows that can be used by a subsidiary:
Description
WarrantyClients

WarrantyProducts

WarrantyType

WarrantyFixedList

WarrantyFixedDes
WarrantyFixedPrices
WarrantyResponse

Page | 71

For each client, precise a type


for
If Non record is found for a
client, its possible to enter a
warranty report but the fields
for fixed price labour and
various expenses wont be
displayed.
For each product, precise a
type for
If Non record is found for a
product, its possible to enter a
warranty report but the fields
for fixed price labor and
various expenses wont be
displayed.
This table describes the
conditions to display for
warranty depending of :
The client warranty
type
The product
warranty type
The list of warranty types for :
Client warranty type
Product warranty
type
Contains the label for each
labour
The amount for each fixed
labour code
Status of the warranty report

May be extended to
subsidiaries?
NON

NON

NON

NON

NON
NON
OUI

WarrantyResponseDetail

(provided by the
manufacturer)
Updates the warranty reports
with manufacturer status
Status of the warranty report
(provided by the
manufacturer)
Updates the warranty reports
with manufacturer status

OUI

2.7.2 Flux WarrantyClients


2.7.2.1 Description gnrale
Contenu de la table :
Indique pour chaque compte client, un code de typologie de prise en charge de la garantie par le constructeur
Si aucun enregistrement nest trouv pour le client connect, le rapport dintervention sous garantie est possible mais ne donne pas accs aux
champs permettant au rparateur dindiquer la main duvre ou autres frais rembourser
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.7.2.2

Description des champs

Nom du champ

Type

Long.

PK

ClientNumber

Char

10

PK

ClientWarrantyType

Char

Null
autoris

Description longue et commentaires


Numro de compte client auprs de ce constructeur
Voir table Clients
Type de typologie de garantie associ au client

Page | 72

Indique un code de typologie de remboursement appliquer au client (voir table WarrantyProducts et


WarrantyType pour des explications plus compltes)
La liste des codes est laiss entirement libre aux constructeurs

2.7.3 Flux WarrantyProducts


2.7.3.1 Description gnrale
Contenu de la table :
Indique pour chaque compte client, un code de typologie de prise en charge de la garantie par le constructeur
Si aucun enregistrement nest trouv pour le produit concern, le rapport dintervention sous garantie est possible mais ne donne pas accs
aux champs permettant au rparateur dindiquer la main duvre ou autres frais rembourser
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.7.3.2

Description des champs

Nom du champ

Type

Long.

PK

ProductID

Char

18

PK

ProductWarrantyType

Char

Null
autoris

Description longue et commentaires


Numro didentification de lappareil
Ce champ contient le numro didentification unique utilis dans la table Products
Type de typologie de garantie associ au produits

Page | 73

Indique un code de typologie de remboursement appliquer au produit (voir table WarrantyClients et


WarrantyType pour des explications plus compltes)
La liste des codes est laiss entirement libre aux constructeurs

2.7.4 Flux WarrantyType


2.7.4.1 Description gnrale
Contenu de la table :
Cette table permet dindiquer les conditions de garantie appliquer en fonction :

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.7.4.2

- du type de garantie associ au client connect


- du type de garantie associ au produit faisant lobjet de la demande
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Description des champs

Nom du champ

Type

Long.

PK

ClientWarrantyType
ProductWarrantyType
bForfaits

Char
Char
Bool

4
8
1

PK
PK

bMOeuvreTemps
bMOeuvreCout

Bool
Bool

1
1

La liste des forfaits accessibles est dtaille dans la suite du document


Accs autoris un remboursement de main duvre en heure
Accs autoris un remboursement de main duvre en devise

bDeplacementKm
bDeplacementCout

Bool
Bool

1
1

La saisie seffectue dans la devise de facture du client (voir champ Currency de la table Client )
Accs autoris un remboursement de frais de dplacement en Km
Accs autoris un remboursement de frais de dplacement en devise

bAutreCout

Bool

La saisie seffectue dans la devise de facture du client (voir champ Currency de la table Client )
Accs autoris un remboursement dautres cots

Laccs cette option permet lutilisateur sur AGORA de saisir aussi bien le montant dune description pour ces
autres cots.
Dure de la garantie en mois

La dure de garantie du produit indiqu dans ce champ est utilise pour contrler le dlai existant entre la
date dachat et la date dappel saisie par un rparateur dans un rapport dintervention sous garantie
Une dure gale zro indique AGORA de ne pas procder cette vrification
Accs autoris une prise en charge des frais de rexpdition

Duree

Int

Null
autoris

Description longue et commentaires


Type de garantie associ au client
Type de garantie associ au produit
Accs autoris une liste de forfait

bRexepedition

Page | 74

Bool

2.7.4.3 Remarque
Pour les champs bXXXXX :
-

une valeur 1 donne laccs au champ correspondant, mais toute saisie reste optionnelle pour lutilisateur
une valeur 0 ne donne pas laccs
.

2.7.5 Flux WarrantyFixedList


2.7.5.1 Description gnrale
Contenu de la table :
Cette table permet dindiquer la liste des codes forfaits disponibles pour :

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.7.5.2

un type de garantie client


un type de garantie produit
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Description des champs

Nom du champ

Type

Long.

PK

ClientWarrantyType
ProductWarrantyType
Forfait

Char
Char
Char

4
8
8

PK
PK
PK

Null
autoris

Description longue et commentaires


Type de garantie associ au client
Type de garantie associ au produit
Code forfait
Lorsque plusieurs forfaits sont possibles pour le client connect et lappareil concern, le rparateur ne
pourra choisir quun seul code forfait.
Indique un forfait froid

bFroid

Bool

Page | 75

Le boolen bFroid doit tre positionn 1 lorsque le code forfait indiqu correspond un forfait froid.
Ceci permet RTE dafficher le message Attention, vous indiquez avoir effectu une intervention avec
ouverture du circuit froid ds la slection de celui-ci.

2.7.6 Flux WarrantyFixedDes


2.7.6.1 Description gnrale
Contenu de la table :
Contient le libell pour chaque code forfait
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.7.6.2

Description des champs

Nom du champ

Type

Long.

PK

Forfait
Language
Designation

Char
Char
Char

8
2
64

PK
PK

Null
autoris

Description longue et commentaires


Code forfait
Code langue constructeur
Dsignation du forfait

2.7.7 Flux WarrantyFixedPrices


2.7.7.1 Description gnrale
Contenu de la table :
Contient le montant de remboursement pour chaque code forfait
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.7.7.2

Description des champs

Nom du champ

Type

Long.

PK

Forfait
Currency
Cost

Char
Char
Cur

8
3
10

PK
PK

Null
autoris

Description longue et commentaires


Code forfait
Code devises
Montant du forfait

2.7.7.3 Remarques
Le montant du forfait est prsent dans la mme devise que celle du client (table Clients)
Si aucune valeur nest trouve dans cette table, le montant du forfait nest pas prsent (uniquement le libell)

Page | 76

2.7.8 CHOIX 1: Flux WarrantyClaim format texte (ASCII ou UNICODE)


2.7.8.1 Description gnrale
Contenu de la table :
Contient rapports dinterventions sous garantie et demande davoir saisies sur AGORA
Sens du transfert :
Du RTE vers les constructeurs
Priodicit conseille :
1 fois par heure ou suivant la planification souhaite par le constructeur
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.7.8.2 Introduction
Le nouveau format de fichier standardis GEM/PEM est identique au format de fichier utilis par les diteurs de logiciel de SAV pour la dpose sur AGORA.
Seule une section complmentaire existe et contient les informations dtermines par RTE aprs saisie par le rparateur. Cette section est dtaille ci-dessous.
Les autres sections sont dcrites dans le document de spcification de format de dpose.
A titre dexemple un fichier dpos par un rparateur pourra contenir les sections :
AGORACLAIM
CLAIMTYPE
CLAIMDELIV
CLAIMRESAL
CLAIMCONSO
CLAIMINFOS
CLAIMLAB
CLAIMPARTS
CLAIMPARTS
ENDTYPE
CLAIMTYPE
CLAIMDELIV
CLAIMRESAL
CLAIMCONSO
CLAIMINFOS
CLAIMLAB
CLAIMPARTS
CLAIMPARTS
ENDTYPE
ENDCLAIM
Page | 77

Alors que le fichier envoy par RTE au constructeur contiendra en plus la section CLAIMAGORA comme dans lexemple ci-dessous
AGORACLAIM
CLAIMTYPE
CLAIMAGORA (with the Agora warranty report Identifier and the report date)
CLAIMDELIV
CLAIMRESAL
CLAIMCONSO
CLAIMINFOS
CLAIMLAB
CLAIMPARTS
CLAIMPARTS
ENDTYPE
CLAIMTYPE
CLAIMAGORA (with the Agora warranty report Identifier and the report date)
CLAIMDELIV
CLAIMRESAL
CLAIMCONSO
CLAIMINFOS
CLAIMLAB
CLAIMPARTS
CLAIMPARTS
ENDTYPE
ENDCLAIM

2.7.8.3

Section CLAIMAGORA

Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur
OrderNbAgora

Char
Int

10
12

CLAIMAGORA

ClientNumber
OrderDate

Char
DateTime

10
19

31260
01/06/2005

Code didentification de la section


Numro de rapport attribu par AGORA
Ce numro doit tre mmoris par les constructeurs qui souhaite renvoyer vers AGORA un accus et statut de la demande
sous garantie
Numro de compte client du rparateur ayant saisi ou dpos le rapport
Date et heure de saisie du rapport dintervention sur AGORA

Page | 78

12:53:23

2.7.8.4

Remarque sur les champs de la section CLAIMTYPE

Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Statut produit

Char

Dans le cas o lISG est issue dun mandat, voici le mapping avec les types dinterventions transmis dans le
mandat :
1
'S' (Sous Garantie)
2
'E' (Sous Extension de Garantie)
3
'S' (Sous Garantie)
9
'S' (Sous Garantie)
Le reste
'H' (Hors conditions de Garantie)

2.7.9 CHOIX 2 : Flux WarrantyClaim format XML


2.7.9.1 Description gnrale
Contenu de la table :
Contient rapports dinterventions sous garantie et demande davoir saisies sur AGORA
Sens du transfert :
De RTE vers le constructeur
Priodicit conseille :
1 fois par heure ou suivant la planification souhaite par le constructeur
Format de fichier :
XML (UTF16)
2.7.9.2

Page | 79

XMLSchema

Page | 80

2.7.9.3

Description du schma

Nom de llment

Nom de lattribut ou lment


feuille

Type

Null
autoris

Warrantyclaims
Warrantyclaims > WarrantyClaim
index
ordernbagora

Int
Char

creationdate
clientnumber
type

Date
Char
Char

username

Char

Ordernbclient

Char

AssignmentNumber
orderperson

Char
Char

Elment racine du fichier. Contient la liste des claims


Elment reprsentant une claim
Numro dordre de la claim dans le fichier (1,2,3)
Numro de rapport attribu par AGORA
Ce numro doit tre mmoris par les constructeurs qui souhaite renvoyer vers AGORA un accus et
statut de la demande sous garantie
Date et heure de saisie du rapport dintervention sur AGORA
Numro de compte client du rparateur ayant saisi ou dpos le rapport
Type de la demande, ne peut tre quune des 2 valeurs ci-dessous :
WAR : commande sous garantie
LAB : rapport dintervention sous garantie
Compte Agora ayant saisi le dossier
Contient des informations sur le rapport dintervention

Warrantyclaims > WarrantyClaim >


ClaimInfo

Warrantyclaims > WarrantyClaim >


product

Correspond au numro de rapport attribu par le rparateur ou son applicatif


informatique. Ce numro doit tre unique par clients dans la totalit de lhistorique et
dans les numros prsents dans le fichier dpos
Oui
Nom de la personne qui effectue le rapport dintervention
Informations du produit

technicalref
commercialref
manufacturingdate

Char
Char
Char

Rfrence technique de lappareil


Rfrence commerciale de lappareil
Date de fabrication de lappareil
Contient des informations dentte du rapport

status

Char

Valeurs possibles :
H : pour Hors Garantie
S : pour Sous Garantie
E : pour Sous Extension de garantie

Warrantyclaims > WarrantyClaim >


claimtype

Page | 81

Description longue et commentaires

number

Char
Oui

Warrantyclaims > WarrantyClaim >


consumer

Contient des informations sur le consommateur


title

Char

firstname
lastname
streetnumber
address1
address2
address3
zipcode
city
state
isocountrycode
phone
mobile
email

Char
Char
Char
Char
Char
Char
Char
Char
Char
Char
Char
Char
Char

Warrantyclaims > WarrantyClaim >


reseller

Oui
Oui
Oui
Oui
Oui

name
name unknown
zipcode
city
state
isocountrycode
distributorreference

Char
Bool
Char
Char
Char
Char
Char

purchasedate
startdate

Date
Date

Warrantyclaims > WarrantyClaim > claim

Page | 82

Numro daccord du constructeur pour la prise en charge dune intervention sur un appareil hors
garantie.
Ce champ est obligatoire si lintervention a t dclare tre ralise hors garantie.

Oui

Civilit du consommateur :
1:M
2 : Mlle
3 : Mme
Prnom
Nom
Numro de rue
Zone dadresse 1
Zone dadresse 2
Zone dadresse 3
Code postal
Ville
Etat (US)
Code pays ISO
N de tlphone
N de tlphone mobile
Email
Contient des informations sur le revendeur
Nom de lenseigne
Indique si lutilisateur a choisi lenseigne Autre et a fait une saisie libre
Code postal
Ville
Etat(US)
Code pays ISO
Rfrence du distributeur
Contient des informations sur lintervention
Date dachat
Date de dpt

enddate
source

additionalcosts
additionalcosts
description
additionalcosts
amount
additionalcosts
currency

Date
Char

Char

Date de fin dintervention


Origine, contient lune des 2 valeurs suivante :
P (consommateur)
R (revendeur)
Section qui contient les couts additionnels
Description des autres frais

Decimal

Montant des autres frais

Char

Contient la devise utilise, une des 2 valeurs suivantes :


EUR
USD
Contient les donnes de codification IRIS
Code IRIS
Rfrence de la pice l'origine de la panne
Numro daccord change
Descriptif de lintervention
Elment qui contient la liste des pices
Elment reprsentant une pice
Numro de squence des pices (1 ligne par pice)
rfrence de la pice
quantit
Numro de facture
Notes-contremarque
Section contenant les informations dadresse de livraison

Oui

Warrantyclaims > WarrantyClaim > iris


code
part
replaceagreementnumber
repairdescription

Char
Char
Char
Char

Warrantyclaims > WarrantyClaim > parts

Oui
Part
Part (attribut : line)
Part ref
Part quantity
Part invoicenumber
Part comment

Int
Char
Int
Char
Char

Warrantyclaims > WarrantyClaim >


delivery

Page | 83

mode
clientcode

Oui

company
name
address1
address2
address3
zipcode

Oui
Oui
Oui
Oui
Oui
Oui

Mode de livraison
Contient le code client livr. Si cette information est renseigne alors tous les lments de cette
section ne sont pas remplir.
Si le code est Autre, alors les autres champs doivent tre renseigns
Nom de la socit
Nom du destinataire
Champ dadresse 1
Champ dadresse 2
Champ dadresse 3
Code postal

city
state
isocountrycode

Char

Oui
Oui
Oui

Ville
Etat (US)
Code pays ISO

2.7.9.4 Remarques
Ce fichier XML est utilis par le constructeur SEB uniquement et contient de ce fait le spcifique associ.

Le champ state sera cod sur 2 caractres suivant la norme ISO 3166-2. Ci-dessous la liste des codes tats :
-

Code Description
AK Alaska
AL Alabama
AR Arkansas
AZ Arizona
CA California
CO Colorado
CT Connecticut
DC Columbia (District de)
DE Delaware
FL Florida
GA Georgia
HI Hawaii
IA Iowa
ID Idaho
IL Illinois
IN Indiana
KS Kansas
KY Kentucky
LA Louisiana
MA Massachusetts
MD Maryland
ME Maine
MI Michigan
MN Minnesota
MO Missouri

Page | 84

MS Mississippi
MT Montana
NC North Carolina
ND North Dakota
NE Nebraska
NH New Hampshire
NJ New Jersey
NM New Mexico
NV Nevada
NY New York
OH Ohio
OK Oklahoma
OR Oregon
PA Pennsylvania
RI Rhode Island
SC South Carolina
SD South Dakota
TN Tennessee
TX Texas
UT Utah
VA Virginia
VT Vermont
WA Washington (State of)
WI Wisconsin
WV West Virginia
WY Wyoming

Page | 85

2.7.10 CHOIX 1 : Flux WarrantyResponse au format texte (ASCII ou UNICODE)


2.7.10.1 Fichier WarrantyResponse
2.7.10.1.1 Description gnrale
Contenu de la table :
Contient les informations renvoyes par les constructeurs pour mettre jour le suivi dune demande sous garantie
Ce message est utilis pour la mise jour des informations sur lentte de la demande sous garantie
Du constructeur vers RTE
1 fois par heure ou suivant la planification souhaite par le constructeur
TEXTE (ASCII ou UNICODE)

Sens du transfert :
Priodicit conseille :
Format de fichier :

2.7.10.1.2 Description des champs


Nom du champ

Type

Long.

PK

OrderNbAGORA

12

PK

OrderNbManufacturer
Status

A
N

12
2

Null
autoris

Autoris pour les


filiales
Oui

Description longue et commentaires


Numro de rapport attribu par AGORA

Oui
Oui

Le numro doit correspondre au numro initialement transmis au constructeur


Numro de rapport calcul par le constructeur
Statut

Oui

Ce code statut est traduit en texte via une table gr par RTE
Les tats les plus frquemment utiliss sont :
o Accept : si la demande est conforme valeur 6
o Non conforme : si incohrence valeur 7
o Refus : si hors garantie valeur 8
Les dossiers en statut 7 ( Non-conforme ) deviennent de nouveau modifiables sur
AGORA pour permettre au rparateur de corriger linformation incorrecte
Informations supplmentaires concernant le statut de la commande

Comment

100

Oui

Page | 86

Est destin en premier lieu indiquer un commentaire sur la raison de rejet dune
demande non-conforme ou incomplte

2.7.10.2 Flux WarrantyResponseDetail


2.7.10.2.1 Description gnrale
Contenu de la table :
Contient les informations renvoyes par les constructeurs pour mettre jour le suivi dune demande sous garantie
Ce message est utilis pour la mise jour des informations sur les lignes de la demande sous garantie (liste des pices)
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par heure ou suivant la planification souhaite par le constructeur
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.7.10.2.2 Description des champs
Nom du champ

Type

Long.

PK

OrderNbAGORA

12

PK

PK

Null
autoris

Autoris pour les


filiales
Oui

Line

Oui

Status

Oui

Delivered

Oui

Description longue et commentaires


Numro de rapport attribu par AGORA
Le numro doit correspondre au numro initialement transmis au constructeur
Numro de la ligne dans la commande
Le numro doit correspondre celui initialement communiqu par RTE
Code statut de la ligne
Les codes grs habituellement sont:
o Accept
valeur 6
o En contrle valeur 9
o Refus
valeur 10
Quantit livr
Ce champ indique le nombre de pices livres dans le cadre des commandes sous
garantie
Il nest pas destin tre utilis dans le cadre des rapports dintervention sous
garantie pour demande davoir
Rfrence de la pice livre
Ce champ indique le nombre de pices livres dans le cadre des commandes sous
garantie
Il nest pas destin tre utilis dans le cadre des rapports dintervention sous
garantie pour demande davoir
Date de livraison
Ce champ indique le nombre de pices livres dans le cadre des commandes sous
garantie
Il nest pas destin tre utilis dans le cadre des rapports dintervention sous
garantie pour demande davoir

NewPartsRef

18

Oui

DeliveryDate

10

Oui

Page | 87

2.7.11 CHOIX 2 : Flux WarrantyResponse au format XML


2.7.11.1 Description gnrale
Contenu de la table :
Contient les informations renvoyes par les constructeurs pour mettre jour le suivi dune demande sous garantie. Ce message est utilis pour la mise
jour des informations sur lentte de la demande sous garantie.
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
1 fois par heure ou suivant la planification souhaite par le constructeur
Format de fichier :
XML (UTF16)
2.7.11.2 XML Schema

Page | 88

2.7.11.3 Description du schma

Nom de llment

Nom de lattribut ou
lment feuille

Type

Null
autoris

Warrantyresponse
Warrantyresponse > WarrantyClaim
index
ordernbagora

Int
Char

ordernbmanufacturer
clientnumber
status

Char
Char
Int

comment

Char

file

Char

Oui

Warrantyresponse > WarrantyClaim > parts

Page | 89

part
line

Oui
Int

ref
status

Char
Int

delivered

Bool

newpartref

Char

Description longue et commentaires


Elment racine du fichier. Contient la liste des suivis de dossier
Elment reprsentant un dossier
Numro dordre de la claim dans le fichier (1,2,3)
Numro de rapport attribu par AGORA. Le numro doit correspondre au numro initialement
transmis au constructeur.
Numro de rapport calcul par le constructeur
Numro de compte client du rparateur ayant saisi ou dpos le rapport
Statut
Ce code statut est traduit en texte via une table gr par RTE
Les tats les plus frquemment utiliss sont :
o Accept : si la demande est conforme valeur 6
o Non conforme : si incohrence valeur 7
o Refus : si hors garantie valeur 8
Les dossiers en statut 7 ( Non-conforme ) deviennent de nouveau modifiable sur
AGORA pour permettre au rparateur de corriger linformation incorrecte
Informations supplmentaires concernant le statut de la commande
Est destin en premier lieu indiquer un commentaire sur la raison de rejet dune
demande non-conforme ou incomplte
En prvision de la gestion de fichier attach non gr sur Agora.
Section contenant le dtail du suivi de lintervention
Elment contenant les informations de suivi dune rfrence de pice
Numro de ligne de pice, au sein de lintervention. Le numro doit correspondre celui
initialement communiqu par RTE.
Rfrence de la pice
Code statut de la ligne. Les codes grs habituellement sont:
o Accept
valeur 6
o En contrle valeur 9
o Refus
valeur 10
Indique si la rfrence a t livre :
0 : non
1 : oui
Rfrence de la pice livre

deliverydate

Page | 90

Date

Date de livraison
Ce champ indique le nombre de pices livres dans le cadre des commandes sous
garantie
Il nest pas destin tre utilis dans le cadre des rapports dintervention sous garantie
pour demande davoir

2.8

MODULE SERVICES BULLETINS

2.8.1 Flux BulDoc


2.8.1.1 Description gnrale
Contenu de la table :
Liste des documents diffuser sur AGORA
Cette table contient la liste exhaustive de toutes les informations diffuser sur AGORA en prcisant les dates correspondantes et le niveau de
criticit.
Elle doit contenir un enregistrement par document.
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.8.1.2

Description des champs

Nom du champ

Type

buldocId

Int

Long.

PK

10

PK

Null
autoris

Description longue et commentaires


Numro didentification du document
Il est impratif pour un bon fonctionnement de AGORA, que ce numro reste identique entre deux mises
jour envoye vers AGORA
Dans le cas contraire, AGORA ne serait plus mme dterminer aprs une mise jour si le document a
dj t lu par le rparateur connect
Date de cration du document
Date de dbut de diffusion du document
Date de fin de diffusion du document
Niveau de criticit

creationDate
parutionDate
peremptionDate
criticalLevelId

Date
Date
Date
Int

10
10
10
4

Oui

Page | 91

Les valeurs acceptes sont (0, 1, 2, 3).


Voir explications dtailles dans le document standard AGORA Services Bulletin V1.5 sur la
signification des diffrentes valeurs.

2.8.2 Flux BulDocProperties


2.8.2.1 Description gnrale
Contenu de la table :
Lien entre le numro de document et le fichier image pour chaque langue
Cette table contient autant denregistrements que de langues disponibles.
Elle permet de faire un lien entre le numro de service bulletin et :
o soit un nouveau document tlcharg dans un flux spcifique (champs title , filename , bultypeid )
o soit un des documents dj existants sur AGORA (champs docid , doctype )
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.8.2.2

Description des champs

Nom du champ

Type

Long.

PK

Null
autoris

Description longue et commentaires

buldocId
langueId

Int
Char

10
2

Numro didentification du document


Code langue du document, parmi la liste gre par le constructeur

255
255
4

Le champ langueID doit systmatiquement tre renseign.


Si un mme document est diffusable pour toutes les langues gres par le constructeur, ce champ doit
tre initialis DF (Default)
Si un mme document est diffusable pour plusieurs langues mais pas toutes (par exemple fichier PDF
contenant le texte en franais et anglais), le constructeur devra envoyer dans ce fichier
BULDocProperties deux enregistrements faisant le lien vers le mme fichier PDF
Titre du document
Nom du fichier pour ce document
Type de document et de format de fichier (liste de valeurs communique ultrieurement)

Title
filename
bultypeId

Char
Char
Int

Oui
Oui
Oui

Page | 92

La liste des valeurs supportes par AGORA est en cours de dtermination par AGORA SAS et sera
communique ultrieurement
Celles-ci permettent AGORA aussi bien didentifier le type dinformation que le format du fichier indiqu
dans le champ filename
Par exemple :
o 1 pour Service bulletin en PDF
o 2 pour Campagne de rappel en PDF
o
AGORA ne prvoit pour linstant que de supporter les formats :
o TIFF

docId
doctype

Char
Char

18
2

Oui
Oui

o PDF
o JPEG
o PNG
Numro DocID du document
Numro DocType du document

2.8.2.3 Remarque:
- Champs title , filename , bultypeid
o Ces champs doivent tre utiliss si le constructeur souhaite transfrer des documents complmentaires ceux dj en ligne sur AGORA dans les changes
standards graphiques
o Ils ne doivent pas tre utiliss conjointement aux champs DocID et DocType
o En cas dutilisation de ces champs, les documents seront rendus automatiquement visibles dans le treeview des appareils concerns (voir dossier AGORA
Services bulletin V1.5.doc pour plus de prcision)
- Champs DocID , DocType
o Lutilisation de ces champs permet dindiquer que le document existe dj dans la base documentaire de AGORA
o Dans ce cas, le titre, le nom du fichier et son format sont dtermins par la base actuelle dj reue par RTE (voir tables DocTitle, Doc, DocType des changes
standards)

Page | 93

2.8.3 Flux BulDocRelation


2.8.3.1 Description gnrale
Contenu de la table :
Lien entre le numro du document et les pices et appareils concerns
Sens du transfert :
Priodicit conseille :
Format de fichier :
2.8.3.2

Cette table peut contenir autant de lien que ncessaire entre un document et les pices ou appareils correspondants
Du constructeur vers RTE
1 fois par jour
TEXTE (ASCII ou UNICODE)

Description des champs

Nom du champ

Type

Long.

buldocId
mainrefId
mainreftypeId

int
char
int

10
100
4

secondrefId
secondreftypeId

char
int

100
4

PK

Null
autoris

Oui
Oui

Description longue et commentaires


Numro didentification du document
Rfrence(s) concernes
Type de rfrence concerne
Les valeurs acceptes sont
1. Rfrence technique dappareil
2. Rfrence commerciale dappareil
3. Rfrence de pices dtaches
4. Code de famille
Rfrence(s) concernes
Type de rfrence concern
Les valeurs acceptes sont
1. Rfrence technique dappareil
2. Rfrence commerciale dappareil
3. Rfrence de pices dtaches
4. Code de famille

2.8.3.3 Remarque
- Whildcards
o AGORA acceptera des jokers (aussi appels Wildcard ) utilisables dans les champs mainRefID et secondRefID
o Par exemple ARG9% pour toutes les rfrences dappareils commenant par ARG9
o La syntaxe des Wildcard grs par AGORA sera confirme ultrieurement
- Utilisation des rfrences main et second
o A lheure actuelle, seuls les couples de critres suivants sont grs comme dtaill dans le tableau ci-dessous
Page | 94

mainRef

secondRef

1. Rfrence technique dappareil


2. Rfrence commerciale dappareil
3. Rfrence de pices dtaches
4. Code de famille

o
o

Page | 95

1. Rfrence technique dappareil

3. Rfrence de pices dtaches

2. Rfrence commerciale dappareil

3. Rfrence de pices dtaches

Les champs secondRefID et secondRefTypeID ne doivent tre donc utiliss que si deux critres avec une clause ET doivent sappliquer
Par exemple si un Service Bulletin ne concerne que la pice de rfrences 50-0000 montes dans les appareils de rfrence technique 80000100/1 , alors il
convient de renseigner les champs tel que :
mainRefID = 80000100/1
mainRefTypeID = 1
secondRefID = 50-0000
secondRefTypeID = 3
Lorsquun seul critre sapplique, seul les champs mainRefID et mainRefTypeID doivent tre renseigns, les champs secondRefID et
secondRefTypeID devant tre laisss vides.

2.9 MODULE FORMATION


2.9.1.1 Description gnrale
Contenu de la table :
Ce flux correspond lenvoi vers les constructeurs dun fichier contenant la liste exhaustive des inscriptions aux formations.

Sens du transfert :
Priodicit conseille :
Format de fichier :
2.9.1.2

Description des champs utiliss dans Formations_sessions_subscriptions

Nom du champ
fse_id
fse_city
fse_date
fss_state
fss_subscription_date
fss_cancelled_date
fss_ClientNumber
fss_firm
fss_type
fss_name
fss_address1
fss_address2
fss_address3
fss_zipcode
fss_city
fss_country
fss_phone
fss_contact_type
fss_email

Page | 96

Ce fichier est gnrer par un lot DTS.


Ce fichier est gnrer par constructeur.
Ce fichier est de format texte avec un sparateur ;
De RTE vers constructeur
1 fois par jour
TEXTE (ASCII ou UNICODE)

Type

Long.
8
32
10
1
10
10
10
32
1
32
32
32
32
10
32
32
32
1
100

PK

Null
autoris

Description longue et commentaires


Identifiant de la session
Ville de la session
Date de la session
Etat de la souscription
Date de la souscription
Date dannulation de la souscription
N client du souscripteur
Socit inscrite
Contact dans la socit inscrite

fss_fax
fss_payment_type

32
1

1 = "By cheque"
2 = "Through a training organization"
3 = "By manufacturer account"

fss_nbr_participants
fss_nbr_participants *
fse_price_ht
fss_nbr_participants *
fse_price_ttc
fss_formation_organization_nu
mber
fss_formation_organization_na
me

Page | 97

10
15 / 10

4 = "Free (partner repairer)"


Nombre de participants
Si le mode de paiement est diffrent de 4, sinon vide sur 10 caractres

15 / 10

Si le mode de paiement est diffrent de 4, sinon vide sur 10 caractres

32
32

2.9.2 Flux FormationsParticipants


2.9.2.1 Description gnrale
Contenu de la table :
Ce flux correspond lenvoi vers les constructeurs dun fichier contenant la liste exhaustive des participants aux formations.
Sens du transfert :
De RTE vers constructeur
Priodicit conseille :
1 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.9.2.2

Description des champs utiliss

Nom du champ

Type

Long.

SessionID
Company
ClientNumber
LastName
FirstName

int
Char
Char
Char
Char

8
32
10
32
32

Page | 98

PK

Null
autoris

Description longue et commentaires


Identifiant de la session
Nom de la socit inscrite
Numro client du constructeur
Nom du participant
Prnom du participant

2.10 MODULE MANDATEMENT


2.10.1 Flux Mandate
2.10.1.1 Overview
Contenu de la table :
Sens du transfert :
Priodicit conseille :
Format de fichier :

Gnre un mandatement dISG destination dun rparateur.


Du constructeur vers RTE
3 fois par jour
TEXTE (ASCII ou UNICODE)

2.10.1.2 Description des sections


La structure du fichier est la suivante :
AGORAMAND
MAND
INTER
CONS
PARTS
PARTS
PARTS
ENDMAND
ENDAGORAMAND

(file header)
(contains data from the Repair Request's header)
(contains operations data)
(contains consumer information)
(contains spare parts references and quantities)
(contains spare parts references and quantities)
(contains spare parts references and quantities)

2.10.1.3 Section "AGORAMAND"


Contenu de la section :
Entte du fichier
Remarque :
Cette ligne doit imprativement tre la premire ligne du fichier
Nom du champ

Type

Long.

Identificateur

Char

N de version

Char

Description longue et commentaires


9 Code didentification de la section
Exemple : AGORAMAND
7 Permet dindiquer AGORA le niveau de spcification suivi pour la prparation du fichier
afin dassurer une compatibilit ascendante.
Exemple : 1.0.0

Page | 99

2.10.1.4 Section MAND


Contenu de la section :
Remarque :
Nom du champ

Mandatement
Cette ligne est obligatoire pour un mandatement et il ne doit y en avoir quune seule.
Type

Long.

PK

Null
autoris

Identificateur

Char

OrdreMission
ManufacturerId
ClientNumber
CommercialRef
TechnicalRef
SerialNumber
PurchaseDate
CallDate
ActivationDate
ConsumerContract

Char
Int
Char
Char
Char
Char
Date
Date
Date
Char

20
2
10
18
18
20
10
10
10
20

GCPlusContract

Char

Oui

NbAccordHorsGar
ResalerName
ResalerZip
ResalerTown
ResalerCountry
Family
BrandDes

Char
Char
Char
Char
Int
Char
Char

20
32
10
32
3
34
27

Oui
Oui
Oui
Oui
Oui
Oui
Oui

Int

Action

X
X
X
Oui
Oui
Oui
Oui
Oui
Oui

Description longue et commentaires


Code didentification de la section
Exemple : MAND
Ordre de mission
N Constructeur (voir en annexe)
N du rparateur
Rfrence Commerciale
Rfrence Technique
Numro de srie
Date d'achat
Date appel CONSO
Date de mise en service
N de contrat (si le type dintervention = 1 ou 2)
Indique si le n dextension de garantie (champ ConsumerContract) est un contrat GC+ ou non.
0 : non
1 : oui
N accord hors garantie (si Type intervention = H)
Revendeur Enseigne
Revendeur Code Postal
Revendeur Ville
Revendeur Pays (code pays ISO sur 3 chiffres)
Famille de produit
Marque
1 : Cration dun nouveau mandatement
2 : Mise jour dun mandatement

Page | 100

2.10.1.5 Section INTER


Contenu de la section :
Remarque :

Donnes lies lintervention


Cette ligne est obligatoire pour un mandatement et il ne doit y en avoir quune seule.

Field name

Type

Length

PK

Allow nulls

Login name:

Char

OperationType
Failure
ManufacturerRemark
IRIS code condition
Expanded IRIS code condition
IRIS code characteristic
IRIS code section
IRIS default code
FirstDateDesired
FirstStartTimeDesired
FirstEndTimeDesired
Operations48h

Int
Char
Char
Char
Char
Char
Char
Char
Date
Time
Time
Int

2
400
128
5
5
5
5
5
10
5
5
1

Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui
Oui

ReplaceRef

Char

18

Oui

Full description and comments


Section Id code
Example: INTER
OperationType*
Breakdown characteristics
Manufacturer remarks
IRIS code condition
Expanded IRIS code condition
IRIS code characteristic
IRIS code section
IRIS default code
st
1 appointment date requested
st
1 appointment date requested Start time indicated as (hh:mm)
st
1 appointment date requested End time indicated as (hh:mm)
Flag request for repair within 48h at the latest
0 : Non / 1: Oui
Replacement product reference

* Types dintervention : Liste exhaustive des types dinterventions recenss :


1.
2.
3.
4.
5.
6.
7.
8.
9.

Intervention sous-garantie constructeur


Intervention sous garantie suite accord dextension de garantie
Intervention pour change sous-garantie du produit (PEM)
Intervention pour change hors garantie du produit (PEM) (Pas de remonte ISG dans AGORA)
Intervention hors garantie avec prise en charge de la main duvre par le constructeur
Intervention hors garantie avec prise en charge des pices par le constructeur
Intervention hors garantie sans prise en charge par le constructeur
Intervention hors garantie avec prise en charge totale constructeur
Intervention de mise en service appareil

Page | 101

2.10.1.6 Section CONS


Contenu de la section :
Remarque :
Nom du champ
Identificateur
ConsumerInvoice

Donnes du consommateur
Cette ligne est obligatoire pour un mandatement et il ne doit y en avoir quune seule.
Type

Long.

PK

Char

Int

ConsumerTitle

Char

ConsumerName
ConsumerFirstName
ConsumerAddress1
ConsumerAddress2
ConsumerAddress3
ConsumerZip
ConsumerTown
ConsumerCountry
ConsumerTel
ConsumerTypeTel
ConsumerSMSCode
ConsumerProTel
ConsumerEmail
ConsumerRemarks

Char
Char
Char
Char
Char
Char
Char
Int
Char
Char
Char
Char
Char
Char

32
32
32
32
32
10
32
3
20
32
20
20
128
128

Page | 102

Null
autoris

Oui

Oui
Oui

Oui
Oui
Oui
Oui
Oui

Description longue et commentaires


Code didentification de la section
Exemple : CONS
Flag facturation consommateur
0 : Non / 1 : Oui
Code civilit du consommateur :
1 (Mme)
2 (Mlle)
3 (M)
4 (St)
Consommateur Nom
Consommateur Prnom
Consommateur Adresse1
Consommateur Adresse2
Consommateur Adresse3
Consommateur CP
Consommateur Ville
Consommateur Pays (code pays ISO sur 3 chiffres)
Consommateur Tl
Consommateur type Tl
Consommateur Code acceptation SMS
Consommateur Tl professionnel
Consommateur email
Remarques du consommateur

2.10.1.7 Section PARTS


Contenu de la section :
Liste des pices dtaches prconises
Remarque :
Cette ligne est facultative pour un mandatement.
Cette ligne peut tre utilise plusieurs fois pour le mme mandatement, dans le cas o plusieurs pices dtaches sont prconises (1 rfrence de
pice par ligne)
Nom du champ

Type

Long.

PK

Identificateur

Char

PartsRef
Quantity
Notes

Char
Int
Char

18
2
40

Null
autoris

X
Oui

Description longue et commentaires


Code didentification de la section
Exemple : PARTS
Rfrence de la pice dtache
Quantit prconise
Commentaire du constructeur

2.10.1.8 Section ENDMAND


Contenu de la section :
Indique la fin du mandatement et le nombre de lignes de pices dtaches (PARTS).
Remarque :
Le fichier doit contenir une ligne ENDMAND par ligne MAND
Nom du champ
Identificateur

Type

Long.
Char

Description longue et commentaires


7 Code didentification de la section
Exemple : ENDMAND

Nb de ligne PARTS

Page | 103

Int

2 Le nombre de lignes doit correspondre au nombre de lignes PARTS du mandatement

2.10.1.9 Section ENDAGORAMAND


Contenu de la section :
Indique la fin du fichier et le rappel du nombre de demandes MAND pour un contrle de cohrence
Remarque :
Cette ligne doit imprativement tre la dernire ligne du fichier.
Le nombre de mandatement doit correspondre au nombre de ligne MAND que le fichier contient.
Nom du champ
Identificateur
Nb de mandatements

Page | 104

Type

Long.
Char
Int

Description longue et commentaires


12 Code didentification de la section
Exemple : ENDAGORAMAND
3 Le nombre de lignes doit correspondre au nombre de lignes MAND du fichier
Exemple : 003

2.10.2 Flux Cancel


2.10.2.1 Description gnrale
Contenu de la table :
Permet dannuler un mandatement
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
3 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.10.2.2 Description des champs
Nom du champ

OrdreMission

Type

Long.

PK

Null
autoris

Description longue et commentaires

Char

20

Ordre de mission

ManufacturerId

Int

N Constructeur (voir en annexe)

ClientNumber

Char

10

N du rparateur

ReasonCode

Char

Code motif dannulation :


- CONDEC (Changement davis du consommateur)
- STADEL (Dlai propos par la STA trop long)
- PARDEL (Pice en rupture constructeur, dlai trop long)
- MANEXC (Dcision constructeur change produit)
- OTHERS (Autre motif)

Comment

Page | 105

Char

128

Oui

Description dautre motif dannulation du constructeur.

2.10.3 Flux Infos Statut


2.10.3.1 Description gnrale
Contenu de la table :
Indique pour chaque mandatement sil a t accept ou refus par le rparateur
Sens du transfert :
De RTE vers le constructeur
Priodicit conseille :
3 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.10.3.2 Description des champs
Nom du champ

Type

Long.

PK

OrdreMission
ManufacturerId
ClientNumber
StatusCode
ReasonCode

Char
Int
Char
Int
Char

20
2
10
1
6

Comment

Char

128

Page | 106

Null
autoris

X
X
X

Oui

Description longue et commentaires


Ordre de mission
N Constructeur (voir en annexe)
N du rparateur
0 : Refus / 1 : Accept / 2 : Planifi / 3 : Annul par le constructeur / 4 : Clos sans isg / 5 : Clos avec isg
Code motif du refus :
- STANAV
(Pas de disponibilit dans les dlais demands)
- CONFAR
(Consommateur trop loign par rapport la STA)
- STACLO
(STA indisponible pour cause de fermeture)
- OTHERS
(autre, voir commentaires du rparateur du champ Comment)
- PDTOK
(Appareil fonctionne nouveau)
- PDTECH
(Appareil dj chang)
- CLIREF
(Client refuse l'intervention)
- HORGAR
(Inter hors garantie, facturation client)
- MSGOK
(Message laiss, pas de rappel client)
Remarques et commentaires du rparateur, Obligatoire si le champ ReasonCode est OTHER

2.10.4 Flux RDV Info


2.10.4.1 Description gnrale
Contenu de la table :
Indique pour chaque mandatement les nouvelles informations de rendez-vous pris par la STA
Sens du transfert :
De RTE vers le constructeur
Priodicit conseille :
3 fois par jour
Format de fichier :
TEXTE (ASCII ou UNICODE)
2.10.4.2 Description des champs
Nom du champ
OrdreMission
ManufacturerId
ClientNumber
AppointmentDate
AppointmentStartTime
AppointmentEndTime
ReasonCode

Type

Long.
Char
Int
Char
Date
Time
Time
Char

PK
20
2
10
10
5
5
6

Null
autoris

X
X
X
Oui
Oui
Oui

Oui

Comment

Page | 107

Char

128

Oui

Description longue et commentaires


Ordre de mission
N Constructeur (voir en annexe)
N du rparateur
Date du rendez-vous pris avec le consommateur
Tranche horaire Heure dbut
Tranche horaire Heure fin
Si la date du premier RV confirm saisie est suprieure la date de 1ere
intervention souhaite, un code motif est sera fourni :
- PLACON
(Convenance consommateur)
- PLASTA
(Contrainte Planning STA)
- PNASTA
(Pice indisponible STA)
- PNAMAN
(Pice indisponible constructeur)
- PDEFCT
(Pice reue dfectueuse ou casse)
- RVIMP
(Rdv impossible: Trop de contraintes conso)
- CLIREF
(Client refuse l'intervention)
- RESSEC
(Produit en rsidence secondaire)
- INJOIG
(Client injoignable, n de tel et/ou e-mail errone)
- INJMSG
(Client injoignable, dpt de message impossible)
- MSGOK
(Message laiss, pas de rappel client)
- ATTRAP
(Attente du rappel conso.)
- PIECDE
(Pice en commande)
- OTHER
(Autre)
Remarques et commentaires du rparateur

2.11 MODULE SOLSAV


2.11.1 CHOIX 1 : format texte (ASCII ou UNICODE)
2.11.1.1 Flux SolutionClaim
2.11.1.1.1 Overview
Contenu de la table :
Sens du transfert :
Priodicit conseille :
Format de fichier :

Contient les demandes de solutions SAV saisies sur AGORA


De RTE vers les constructeurs
1 fois par heure ou suivant la planification souhaite par le constructeur
TEXTE (ASCII ou UNICODE)

2.11.1.1.2 Introduction
Le format utilis est le mme sur celui des demandes dinterventions sous garantie, lexhaustivit du format est prsente ci-dessous.
2.11.1.1.3 Organisation des sections

1ere
demande

Dlimiteurs
du fichier
2ime
demande

Page | 108

Nom de la section
SOLUTIONCLAIM
CLAIMAGORA
CLAIMTYPE
CLAIMREASON
CLAIMRESAL
CLAIMCONSO
CLAIMINFOS
CLAIMPICKUP
CLAIMATTACH
CLAIMATTACH
ENDTYPE
CLAIMAGORA
CLAIMTYPE
CLAIMREASON
CLAIMRESAL
CLAIMCONSO
CLAIMINFOS
CLAIMPICKUP
ENDTYPE
ENDCLAIM

Contenu
Entte du fichier
Identification du premier rapport
Dbut du premier rapport
Motif de la demande
Coordonnes du revendeur
Coordonnes du consommateur
Informations sur la demande
Info de reprise de lappareil
Pice jointe n1
Pice jointe n2
Fin du premier rapport
Identification du second rapport
Dbut du second rapport
Motif de la demande
Coordonnes du revendeur
Coordonnes du consommateur
Informations sur la demande
Info de reprise de lappareil
Fin du second rapport
Fin du fichier

Commentaire
Contient principalement le numro de version du format de fichier
Contient le type de demande et les informations denttes (ex SOL )
Demand par les constructeurs uniquement certains rparateurs

Contient le nombre de demandes pour contrle de cohrence

2.11.1.1.4 Section AGORACLAIM


2.11.1.1.4.1 Description gnrales
Contenu de la section :
Entte du fichier
Remarque :
Cette ligne doit imprativement tre la premire ligne du fichier
2.11.1.1.4.2 Description des champs
Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur
N de version

Char
Char

13
7

SOLUTIONCLAIM
1.0.0

Code didentification de la section


Le numro de version indiquer dans le fichier texte gnr doit tre identique celui utilis pour le prsent document. Ceci permet
dindiquer AGORA le niveau de spcification suivi pour la prparation du fichier afin dassurer une compatibilit ascendante.

2.11.1.1.5 Section CLAIMAGORA


Nom du champ

Long.

Exemple

Description longue et commentaires


Code didentification de la section
Numro de demande attribu par AGORA
Ce numro doit tre mmoris par les constructeurs qui souhaitent renvoyer vers AGORA un accus et statut de la demande
Numro de compte client du rparateur ayant saisi la demande
Date et heure de saisie de la demande sur AGORA

Identificateur
ClaimNbAgora

Char
Int

13
12

CLAIMAGORA

ClientNumber
DateTime

Char
DateTime

10
19

31260
01/06/2013
12:53:23

Page | 109

2.11.1.1.6 Section CLAIMTYPE


2.11.1.1.6.1 Description gnrales
Contenu de la section :
Entte de la demande de solution contenant les informations sur :
- lappareil
- le dossier
Remarque :
Cette ligne doit imprativement tre la premire ligne dun rapport
2.11.1.1.6.2 Description des champs
Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur
N denregistrement

Char
Int

13
3

CLAIMTYPE
001

Type

Char

LAB

Constructeur
Rf. Technique
Rf. Commerc.
N de srie
Date d'achat
Nom
N de rapport

Char
Char
Char
Char
Date
Char
Char

2
18
18
20
10
32
50

01
A12B34C56
A12VR
SN1234
24/12/1999
DUPONT
12345678

Code didentification de la section


Le champ n denregistrement correspond la numrotation des demandes de solution prsentes dans le fichier. Cette
numrotation doit commencer 1 par incrment de 1 et est utilise pour la vrification de la structure du fichier.
Les valeurs possibles sont :
- SOL pour les demandes de solution
Numro du constructeur

N dordre de mission

Char

20

Page | 110

La rfrence technique et/ou la rfrence commerciale de lappareil faisant lobjet de la demande.


Numro de srie de lappareil
Date dachat de lappareil
Nom de la personne qui effectue le rapport dintervention
Correspond au numro de rapport attribu par le rparateur. Ce numro doit tre unique par clients dans la totalit de lhistorique et
dans les numros prsents dans le fichier dpos.
Numro communiqu la station technique en cas de demande dintervention provenant du call-center dun constructeur.

2.11.1.1.7 Section CLAIMREASON


2.11.1.1.7.1 Description gnrales
Contenu de la section :
Motif de la demande
Remarque :
Une seule ligne CLAIMREASON par demande est autorise
2.11.1.1.7.2 Description des champs
Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur
Type de la demande

Char
Char

13
8

CLAIMREASON
SOLUTION

Motif de la demande
de solution

Char

PMS

Rfrence de la pice
indisponible
Date de la commande

Char

18

X1234567

Date

10

21/03/2010

Rfrence de la
commande pice
Rfrence du client/de
la commande
constructeur
Demande de solution
Autre
Type de demande
Autre

Char

20

12FR4567

Char

20

UH789E45

Code didentification de la section


Contient le type de la demande, doit imprativement tre une valeur de la liste suivante :
- SOLUTION : demande de solution SAV
- OTHER : demande autre
Si le type de la demande est OTHER, alors ce champ est ignor ;
Sinon, si le type de la demande est SOLUTION, alors la valeur doit tre parmi la liste suivante :
- PMS : Panne la Mise en Service
- IND : Pice indisponible
- IRR : Appareil Irrparable
- MUL : Multiples Interventions
- AUT : Autre
Si le motif de la demande de solution est IND alors ce champ contient la rfrence de la pice indisponible.
Sinon, ce champ est ignor.
Si le motif de la demande de solution est IND alors ce champ contient la date de la commande.
Sinon, ce champ est ignor.
Si le motif de la demande de solution est IND alors ce champ contient la rfrence de la commande pice.
Sinon, ce champ est ignor.
Si le motif de la demande de solution est IND alors ce champ contient la rfrence du client/de la commande constructeur.
Sinon, ce champ est ignor.

Char

100

Char

100

Page | 111

Si le motif de la demande de solution est AUT alors ce champ contient le descriptif de la demande.
Sinon, ce champ est ignor.
Si le type de la demande de solution est OTHER alors ce champ contient le descriptif du motif.
Sinon, ce champ est ignor.

2.11.1.1.8 Section CLAIMRESAL


2.11.1.1.8.1 Description gnrales
Contenu de la section :
Coordonnes du revendeur lorigine du produit fini
Remarque :
Une seule ligne CLAIMRESAL par demande est autorise
2.11.1.1.8.2 Description des champs
Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur
Demandeur

Char
Char

13
3

CLAIMRESAL
ADH

Distributeur N de compte constructeur


Distributeur - Nom
Distributeur Adresse 1
Distributeur Adresse 2
Distributeur Adresse 3
Distributeur CP
Distributeur Ville
Distributeur Pays
Adhrent Nom
Adhrent Adresse 1
Adhrent Adresse 2
Adhrent Adresse 3
Adhrent CP
Adhrent Ville
Adhrent Pays
SAV N de compte constructeur
SAV Nom
SAV Adresse 1
SAV Adresse 2

Char
Char
Char
Char
Char
Char
Char
Int
Char
Char
Char
Char
Char
Char
Int
Char
Char
Char
Char

10
32
32
32
32
10
32
3
32
32
32
32
10
32
3
10
32
32
32

Code didentification de la section


Indique qui est lorigine de la demande. Doit contenir une des valeurs
suivantes :
- DIS : Distributeur
- ADH : Adhrent
- SAV : SAV
Si le revendeur dispose dun compte constructeur sur GCPLUS

Page | 112

06410
BIOT
250

06410
BIOT
250
Si le SAV dispose dun compte constructeur sur Agora

SAV Adresse 3
SAV CP
SAV Ville
SAV Pays

Char
Char
Char
Int

32
10
32
3

06410
BIOT
250

2.11.1.1.9 Section CLAIMCONSO


2.11.1.1.9.1 Description gnrales
Contenu de la section : Adresse et coordonnes du consommateur
2.11.1.1.9.2 Description des champs
Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur
Nom
Adresse1
Adresse2
Adresse3
Code Postal
Ville
Pays

Char
Char
Char
Char
Char
Char
Char
Int

13
32
32
32
32
10
32
3

CLAIMCONSO
DUPOND
Avenue de la Rpublique

Code didentification de la section

06410
BIOT
250

Code ISO du pays du consommateur.


Si linformation nest pas prcise :
- le code pays du rparateur connect est automatiquement utilis
- si celui-ci ne peut tre dtermin, le code pour le France est utilis par dfaut

Tlphone

Page | 113

Char

20

033038978123

2.11.1.1.10 Section CLAIMINFOS


2.11.1.1.10.1 Description gnrales
Contenu de la section : Informations sur la demande de solution SAV
2.11.1.1.10.2 Description des champs
Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur
Date dappel/dordre de
mission
IRIS Condition
IRIS Cond. Etendue
IRIS Symptme
IRIS Section
IRIS Dfaut
Symptme de la panne

Char
Date

13
10

CLAIMINFOS
27/03/2010

Code didentification de la section

Char
Char
Char
Char
Char
Char

2
4
4
4
3
100

6
X1E
16N
G11
51
La pice
tait...

Page | 114

2.11.1.1.11 Section CLAIMPICKUP


2.11.1.1.11.1 Description gnrales
Contenu de la section : Informations sur la reprise de lappareil
2.11.1.1.11.2 Description des champs
Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur
Nom
Adresse 1
Adresse 2
Adresse 3
CP
Ville
Nom du responsable
Tl 1 du responsable
Tl 2 du responsable
Date de dispo.

Char
Char
Char
Char
Char
Char
Char
Char
Char
Char
Date

13
32
32
32
32
10
32
32
14
14
10

CLAIMPICKUP

Code didentification de la section


Nom o le produit remplacer est reprendre
Adresse o le produit remplacer est reprendre
Adresse o le produit remplacer est reprendre
Adresse o le produit remplacer est reprendre
CP o le produit remplacer est reprendre
Ville o le produit remplacer est reprendre
Nom du responsable contacter pour la reprise ventuelle
Tlphone du responsable contacter pour la reprise ventuelle
Autre tlphone du responsable contacter pour la reprise ventuelle
Date potentielle de disponibilit pour la reprise (appareil emball)

02/04/2010

2.11.1.1.12 Section CLAIMATTACH


2.11.1.1.12.1 Description gnrales
Contenu de la section : Informations sur une pice jointe la demande de solution SAV
2.11.1.1.12.2 Description des champs
Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur

Char

13

CLAIMATTACH

Code didentification de la section

Nom du fichier

Char

50

8BF816E0-B0DD-4353-B5DF97C94DA0DBC9.jpg

Identifiant unique de la pice jointe transmise avec le flux.


Lidentifiant gnr est un Guid, suivi de lextension du fichier.

Page | 115

2.11.1.1.13 Section ENDTYPE


2.11.1.1.13.1 Description gnrales
Contenu de la section : Indique la fin de la demande.
Remarque : Le fichier doit contenir une ligne ENDTYPE par ligne CLAIMTYPE
2.11.1.1.13.2 Description des champs
Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur

Char

13

ENDTYPE

Code didentification de la section

2.11.1.1.14 Section ENDCLAIM


2.11.1.1.14.1 Description gnrales
Contenu de la section :
Indique la fin du fichier et le rappel du nombre de demandes CLAIMTYPE pour un contrle de cohrence
Remarque :
Cette ligne doit imprativement tre la dernire ligne du fichier.
Le nombre de demandes doit correspondre au nombre de ligne CLAIMTYPE que le fichier dpos contenait
2.11.1.1.14.2 Description des champs
Nom du champ

Type

Long.

Exemple

Description longue et commentaires

Identificateur

Char

13

ENDCLAIM

Code didentification de la section

Nombre de rapports

Int

003

Page | 116

2.11.1.2

Flux "SolutionResponse"

2.11.1.2.1 Overview
Contenu de la table :
Sens du transfert :
Priodicit conseille :
Format de fichier :

Indique pour chaque demande de solution SAV son tat davancement constructeur.
Du constructeur vers RTE
3 fois par jour
TEXTE (ASCII ou UNICODE)

2.11.1.2.2 Description des champs


Nom du champ

Type

Long

PK

ClaimNbAGORA

Int

12

PK

ManufacturerID
ClaimNbManufacturer
Status

Int
Char
Char

2
50
4

PK

Comment

Char

250

Page | 117

Null autoris

Oui

Oui

Description longue et commentaires


Numro de demande attribu par AGORA
Le numro doit correspondre au numro initialement transmis au constructeur
Identifiant du constructeur
Numro de demande calcul par le constructeur
Doit contenir une des valeurs suivantes :
ACC : Accepte
STBY : En attente (visite Inspecteur Technique / rception justificatifs)
REF : Refuse
INV : Non conforme (besoin dinformations complmentaires)
ANN : Annule
Informations supplmentaires concernant le statut de la demande
Est destin en premier lieu indiquer un commentaire sur la raison de rejet dune demande non-conforme ou
incomplte

2.11.2 CHOIX 2 : Flux XML


2.11.2.1 Fichier SolutionClaim.XML
2.11.2.1.1 Description gnrale
Contenu de la table :
Contient les demandes de solutions SAV saisies sur AGORA
Sens du transfert :
De RTE vers les constructeurs
Priodicit conseille :
1 fois par heure ou suivant la planification souhaite par le constructeur
Format de fichier :
XML (UTF16)

Page | 118

Nom de
llment
claims
claims > claim

Nom de lattribut ou lment


feuille

Null
autoris

Type

Description longue et commentaires

claimnumber

String

clientnumber
createdate
modificationdate

String
DateTime
DateTime

Elment racine du fichier. Contient la liste des suivis de dossier


Elment reprsentant une demande de solution SAV
Numro de rapport attribu par AGORA. Le numro doit correspondre au numro initialement transmis au
constructeur.
Numro de compte client du rparateur ayant saisi ou dpos le rapport
Date de cration de la demande
Date de modification de la demande de solution

contactemail

String

Email de la personne qui suit le dossier

updatenumber
manufacturer

Int
Int

Numro incrment chaque change


Identifiant du constructeur

2.11.2.1.2 PRODUCT - Description du produit

Nom de llment

Nom de lattribut ou lment feuille Type Null autoris Description longue et commentaires

claims
claims > claim > product

Page | 119

Elment racine du fichier. Contient la liste des suivis de dossier


Elment reprsentant le produit concern par la demande
technicalref

String

La rfrence technique de lappareil faisant lobjet de la demande.

commercialref
serialnumber
purchasedate

String
String
Date

La rfrence commerciale de lappareil faisant lobjet de la demande.


Numro de srie de lappareil
Date dachat de lappareil

2.11.2.1.3 CLAIMINFO - Information complmentaire de la demande

Nom de llment

Nom de lattribut ou lment


feuille

Type

claims
claims > claim >
claiminfo

Page | 120

Null
autoris

Description longue et commentaires


Elment racine du fichier. Contient la liste des suivis de dossier
Elment reprsentant les informations complmentaires de la demande

username

String

Nom de la personne qui effectue le rapport dintervention

atsnumber

String

agorawarrantynumber
ordermission

String
String

Correspond au numro de rapport attribu par le rparateur. Ce numro doit tre unique par clients dans la totalit de
lhistorique et dans les numros prsents dans le fichier dpos.
Numro du rapport dintervention partir de laquelle la demande a t cre
Numro dordre de mission communiqu par le constructeur

calldate

Date

Date dappel

comment

String

Commentaire gnral du rparateur

2.11.2.1.4 CLAIMREASON Motif de la demande

Nom de llment

Nom de lattribut ou lment


feuille

Type

claims
claims > claim >
claimreason

Page | 121

Null
autoris

Description longue et commentaires


Elment racine du fichier. Contient la liste des suivis de dossier
Elment reprsentant le motif de la demande

requesttype

String

requestobject

String

unvailablepart

String

orderdate

Date

Contient le type de la demande, doit imprativement tre une valeur de la liste suivante :
- SOLUTION : demande de solution SAV
- OTHER : demande autre
Si le type de la demande est OTHER, alors ce champ est ignor ;
Sinon, si le type de la demande est SOLUTION, alors la valeur doit tre parmi la liste suivante :
- PMS : Panne la Mise en Service
- IND : Pice indisponible
- IRR : Appareil Irrparable
- MUL : Multiples Interventions
- AUT : Autre
Si le motif de la demande de solution est IND alors ce champ contient la rfrence de la pice indisponible.
Sinon, ce champ est ignor.
Si le motif de la demande de solution est IND alors ce champ contient la date de la commande.

Sinon, ce champ est ignor.

Page | 122

ordernumber

String

atsordernumber

String

requestdesc

String

requestother

String

Si le motif de la demande de solution est IND alors ce champ contient la rfrence de la commande pice.
Sinon, ce champ est ignor.
Si le motif de la demande de solution est IND alors ce champ contient la rfrence du client/de la commande
constructeur.
Sinon, ce champ est ignor.
Si le motif de la demande de solution est AUT alors ce champ contient le descriptif de la demande.
Sinon, ce champ est ignor.
Si le type de la demande de solution est OTHER alors ce champ contient le descriptif du motif.
Sinon, ce champ est ignor.

2.11.2.1.5 CLAIMRESAL Information sur le revendeur

Page | 123

Nom de llment

Nom de lattribut ou lment feuille Type Null autoris Description longue et commentaires

claims
claims > claim > claimresal
claimant

String

manufactureraccount

String

name

String

address1

String

address2

String

address3

String

zip

String

city

String

country

Int

claims > claim > claimresal > distributor

claims > claim > claimresal > adherent

Page | 124

Elment racine du fichier. Contient la liste des suivis de dossier


Elment reprsentant le demandeur
Indique qui est lorigine de la demande. Doit contenir une des valeurs suivantes :
- DIS : Distributeur
- ADH : Adhrent
- SAV : SAV
Elment reprsentant le distributeur
Si le revendeur dispose dun compte constructeur sur GCPLUS

Code ISO du pays


Elment reprsentant ladhrent

name

String

address1

String

address2

String

address3

String

zip

String

city

String

country

Int

claims > claim > claimresal > aftersales


manufactureraccount

String

name

String

address1

String

address2

String

address3

String

zip

String

city

String

country

int

2.11.2.1.6 CONSUMER Le consommateur

Page | 125

Elment reprsentant le SAV


Si le SAV dispose dun compte constructeur sur Agora

Code ISO du pays

Nom de llment

Nom de lattribut ou lment feuille Type Null autoris Description longue et commentaires

claims
claims > claim > Consumer

Elment racine du fichier. Contient la liste des suivis de dossier


Elment reprsentant le distributeur
name

String

address1

String

address2

String

address3

String

zip

String

city

String

country

Int

phone

String

2.11.2.1.7 IRIS Description de la panne

Page | 126

Code ISO du pays

Nom de llment

Nom de lattribut ou lment


Type
feuille

claims
claims > claim > iris

Description longue et commentaires

code

String

Elment racine du fichier. Contient la liste des suivis de dossier


Elment reprsentant lhistorique de la panne
Code IRIS

repairDesc

String

Commentaire sur la panne

2.11.2.1.8 CLAIMPICKUP Reprise de lappareil

Page | 127

Null
autoris

Nom de llment

Nom de lattribut ou lment feuille Type Null autoris Description longue et commentaires

claims
claims > claim > claimpickup
name

String

Elment racine du fichier. Contient la liste des suivis de dossier


Elment reprsentant les informations de reprise de lappareil
Nom o le produit remplacer est reprendre

contactname

string

Nom du responsable contacter pour la reprise ventuelle

address1

String

Adresse o le produit remplacer est reprendre

address2

String

Adresse o le produit remplacer est reprendre

address3

String

Adresse o le produit remplacer est reprendre

zip

String

CP o le produit remplacer est reprendre

city

String

Ville o le produit remplacer est reprendre

country

Int

Code ISO du pays

phone1
phone2
Email
availabledate

String
String
String
Date

Tlphone du responsable contacter pour la reprise ventuelle


Autre tlphone du responsable contacter pour la reprise ventuelle
Adresse email du contact pour la reprise dappareil
Date potentielle de disponibilit pour la reprise (appareil emball)

2.11.2.1.9 ATTACHEDFILES Pices jointes

Nom de llment
claims
claims > claim > attachedfiles

Page | 128

Nom de lattribut ou lment feuille Type Null autoris Description longue et commentaires
Elment racine du fichier. Contient la liste des suivis de dossier
Elment contenant les pices jointes

attachedfile

String

2.11.2.1.10 Description XSD

<?xml version="1.0" encoding="utf-16" ?>


<!--Created with Liquid XML Studio - FREE Community Edition 7.0.2.746 (http://www.liquid-technologies.com)-->
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="claims">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" name="claim">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="1" name="product">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="1" name="technicalref">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="18" />
<xs:maxLength value="18" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="1" maxOccurs="1" name="commercialref">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="18" />
<xs:maxLength value="18" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="1" maxOccurs="1" name="serialnumber" nillable="true">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="20" />
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="purchasedate" type="xs:date" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="1" maxOccurs="1" name="claiminfo">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="1" name="username">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="1" maxOccurs="1" name="atsnumber">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="50" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="agorawarrantynumber">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="ordermission">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="20" />
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="1" maxOccurs="1" name="calldate" type="xs:date" />
<xs:element minOccurs="0" maxOccurs="1" name="comment" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="claimreason">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="1" name="requesttype" type="xs:string" />
<xs:element minOccurs="0" maxOccurs="1" name="requestobjet">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="3" />
<xs:maxLength value="3" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="unvailablepart">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="18" />
<xs:maxLength value="18" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="orderdate" type="xs:date" />
<xs:element minOccurs="0" maxOccurs="1" name="ordernumber">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="20" />
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="atsordernumber">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="20" />
<xs:length value="20" />
</xs:restriction>
</xs:simpleType>

Page | 129

Identifiant unique de la pice jointe transmise avec le flux.


Lidentifiant gnr est un Guid, suivi de lextension du fichier.

</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="requestdesc">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="100" />
<xs:maxLength value="100" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="requestother">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="100" />
<xs:maxLength value="100" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="claimresal">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="1" name="distributor">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="1" name="manufactureraccount">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="name">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address2">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address3">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
<xs:maxLength value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="zip">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="city">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="country">
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:totalDigits value="3" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="adherent">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="1" name="name">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address2">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address3">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="zip">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="city">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="country">
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:totalDigits value="3" />
</xs:restriction>
</xs:simpleType>
</xs:element>

Page | 130

</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="aftersales">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="1" name="manufactureraccount">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="name">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address2">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address3">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="zip">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="city">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
<xs:maxLength value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="country">
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:totalDigits value="3" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="claimant" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="3" />
<xs:maxLength value="3" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:element minOccurs="1" maxOccurs="1" name="consumer">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="1" name="name">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address2">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address3">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="zip">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="city">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="country">
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:totalDigits value="3" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="phone">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="14" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>

Page | 131

</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="iris">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="code">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="17" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="repairdesc">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="100" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="claimpickup">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="1" name="name">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="contactname">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address2">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="address3">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="zip">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="city">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="32" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="country">
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:totalDigits value="3" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="phone1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="14" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="phone2">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="14" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="email">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="255" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="availabledate" type="xs:date" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="attachedfiles">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="attachedfile">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="50" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="claimnumber" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="12" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="clientnumber" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="10" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="createdate" type="xs:dateTime" use="required" />
<xs:attribute name="contactemail" type="xs:string" use="optional" />
<xs:attribute name="modificationdate" type="xs:dateTime" use="optional" />
<xs:attribute name="updatenumber" type="xs:int" use="optional" />
<xs:attribute name="Manufacturer" type="xs:int" use="required" />

Page | 132

</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

2.11.2.2 Fichier SolutionResponse.XML


2.11.2.2.1 Description gnrale
Contenu de la table :
Indique pour chaque demande de solution SAV son tat davancement constructeur.
Sens du transfert :
Du constructeur vers RTE
Priodicit conseille :
3 fois par jour
Format de fichier :
XML (UTF16)

2.11.2.2.2 Description des champs

Nom de llment
claims
claims > claim

Page | 133

Nom de lattribut ou lment feuille

Type

Null
autoris

Description longue et commentaires


Elment racine du fichier. Contient la liste des suivis de dossier
Elment reprsentant les informations de reprise de lappareil

claimnumber

String

manufacturer

int

Numro de demande attribu par AGORA


Le numro doit correspondre au numro initialement transmis au constructeur
Constructeur

claimnbmanufacturer

string

Elment reprsentant les informations de la rponse


Numro de demande calcul par le constructeur

status

string

comment

string

oui

attachedfile

String

oui

claims > claim > claiminfo


oui

claims > claim > attachedfiles

2.11.2.2.3 Description XSD


<?xml version="1.0" encoding="utf-16" ?>
<!--Created with Liquid XML Studio - FREE Community Edition 7.0.2.746 (http://www.liquid-technologies.com)-->
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="claims">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" name="claim">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="1" name="claiminfo">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="1" name="claimnbmanufacturer">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="50" />
<xs:minLength value="1" />
<xs:maxLength value="50" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="1" maxOccurs="1" name="status">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="4" />
<xs:maxLength value="4" />
<xs:minLength value="1" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="comment">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="250" />
<xs:maxLength value="250" />
<xs:minLength value="0" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="1" name="attachedfiles">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="attachedfile">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="50" />
<xs:minLength value="1" />
<xs:maxLength value="50" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>

Page | 134

Doit contenir une des valeurs suivantes :


ACC : Accepte
STBY : En attente (visite Inspecteur Technique / rception justificatifs)
REF : Refuse
INV : Non conforme (besoin dinformations complmentaires)
ANN : Annule
Informations supplmentaires concernant le statut de la demande
Est destin en premier lieu indiquer un commentaire sur la raison de rejet dune
demande non-conforme ou incomplte
Elment contenant les pices jointes
Identifiant unique de la pice jointe transmise avec le flux.
Lidentifiant gnr est un Guid, suivi de lextension du fichier.

</xs:element>
</xs:sequence>
<xs:attribute name="claimnumber" use="optional">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="12" />
<xs:maxLength value="12" />
<xs:minLength value="1" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="manufacturer" use="optional">
<xs:simpleType>
<xs:restriction base="xs:int">
<xs:totalDigits value="2" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

2.11.2.3 Import/Export des fichiers physiques


2.11.2.3.1 Solution
Les SOLSAV gnres par AGORA destination du constructeur seront dposes sous larborescence suivante :

OUT/
Solution/
Le transfert FTP devra suivre la rgle suivante :
Durant le transfert le fichier doit sappeler : <Date>_IN_SOLUTION.tmp
A la fin du transfert, il faut lappeler <Date>_IN_SOLUTION.zip
2.11.2.3.2 Solution Response
Les messages SOLSAV gnrs par le constructeur destination des STA seront dposs sous larborescence suivante :

IN/
SolutionResponse/
Le transfert FTP devra suivre la rgle suivante :
Durant le transfert le fichier doit sappeler : <Date>_IN_SOLUTIONRESPONSE.tmp
A la fin du transfert, il faut lappeler <Date>_IN_SOLUTIONRESPONSE.zip
A noter que le fichier XML et les pices jointes sont compresss dans la mme archive.
Page | 135

2.12 MODULE SOLSAV ADMIN


2.12.1 Fichier SolutionClaimAdmin.XML
2.12.1.1 Description gnrale
Contenu de la table :
Contient les donnes de suivi SOLSAV renseignes par les ITC
Sens du transfert :
De RTE vers les constructeurs
Priodicit conseille :
1 fois par heure ou suivant la planification souhaite par le constructeur
Format de fichier :
XML (UTF16)

2.12.1.2 Description des champs

Nom de llment

Nom de lattribut ou lment feuille

Type

claims
claims > claim

Page | 136

Null autoris Description longue et commentaires

claimnumber

String

Elment racine du fichier. Contient la liste des suivis de dossier


Elment reprsentant les informations de reprise de lappareil
Numro de demande attribu par AGORA

updatedate

Date

Date de mise jour

clientnumber

String

Compte client

manufacturer

int

Constructeur

mti

String

Compte AGOSE de lITC en charge du dossier

mtistatus

int

Statut ITC de la demande de solution SAV

claimstatus

int

Status de la demande de solution de SAV


Doit contenir une des valeurs suivantes :
ACC : Accepte
ACP : Accord de principe
STBY : En attente (visite Inspecteur Technique / rception justificatifs)
REF : Refuse

comment

String

iriscondition

String

irisconditionex

String

irissection

String

irissymptom

String

irisdefault

String

irisrepair

String

agreementtype

int

sparepartagreement

bool

labouragreement

bool

exceptionallabourcostagreement

bool

nameplatereceived

bool

deviceexpertised

bool

claims > claim > agreementcondition

Page | 137

INV : Non conforme (besoin dinformations complmentaires)


ANN : Annule
Commentaire ITC
ACC : Accepte
ACP : Accord de principe
STBY : En attente (visite Inspecteur Technique / rception justificatifs)
REF : Refuse
ATP : Attente pices justificative
ATPS : Attente retour plaque signaltique

Elment reprsentant les conditions de laccord


Type daccord
1 = prise en charge pices
2 = prise en charge intervention
3 = avoir avec reprise
4 = avoir avec destruction
5 = Echange
Balise prsente si le type daccord=2
Prise en charge pices
Balise prsente si le type daccord=2
Prise en charge de la main doeuvre
Balise prsente si le type daccord=2
Prise en chargeforfait exceptionnel
Balise prsente si le type daccord=4 ou 5
Plaque signaltique reue
Balise prsente si le type daccord=4 ou 5

Appareil expertis
creditvalue

decimal

Valeur de lavoir (en pourcentage, ex 0,5 pour 50%)

creditcontribution

decimal

newdeviceref

String

sparepartorigin

String

Balise prsente si le type daccord=5


Montant de la participation
Balise prsente si le type daccord=5
Rfrence du nouvel appareil
Pice lorigine de la panne

creditaccount

String

Compte de facturation

aggreementvalidatedby

String

Accord donn par (compte AGORA)

agreementdate

Date

Date de laccord

agreementnumber

String

Numro daccord

creditnumber

String

Numro de lavoir

creditdate

Date

Date de lavoir

SAPTransac

String

Numro de transaction SAP

claims > claim >


agreementcondition>spareparts
claims > claim >
agreementcondition>spareparts>sparepart

Elment contenant les pices de la prise en charge de type pices


Elment contenant les pices de la prise en charge de type pices
ref

String

Rfrence de la pice

quantity

int

Quantit rembours

price

decimal

Prix net

claims > claim > retrieval

Page | 138

Elment contenant les informations relatives la reprise de lappareil


name

String

address1

String

Nom / Raison sociale

address2

String

address3

String

zip

String

city

String

country

String

phone1

String

phone2

String

email

String

retrievalwishdate

Date

Date de reprise souhaite

retrievaleffectivedate

Date

Date de reprise effective de lappareil (retour transporteur)

comment

Date

Commentaire du transporteur

claims > claim > delivery

Page | 139

Elment contenant les informations relatives la livraison de lappareil


name

String

address1

String

address2

String

address3

String

zip

String

city

String

country

String

phone1

String

phone2

String

Nom / Raison sociale

email

String

deliverywishdate

Date

Date de livraison souhaite

deliveryeffectivedate

Date

Date de livraison effective de lappareil (retour transporteur)

comment

String

Commentaire du transporteur

2.12.1.3 XSD

<?xml version="1.0" encoding="utf-16"?>


<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="claims">
<xs:complexType>
<xs:sequence>
<xs:element name="claim">
<xs:complexType>
<xs:sequence>
<xs:element name="mti" type="xs:string"
/>
<xs:element name="mtistatus" type="xs:string"
/>
<xs:element name="claimstatus" type="xs:string" />
<xs:element name="comment" type="xs:string" />
<xs:element name="iriscondition" type="xs:string" />
<xs:element name="irisconditionex" type="xs:string" />
<xs:element name="irissection" type="xs:string" />
<xs:element name="irissymptom" type="xs:string" />
<xs:element name="irisdefault" type="xs:string" />
<xs:element name="irisrepair" type="xs:string" />
<xs:element name="agreementcondition" >
<xs:complexType>
<xs:sequence>
<xs:element name="agreementtype" type="xs:unsignedByte" />
<xs:element name="sparepartagreement" type="xs:unsignedByte"
/>
<xs:element name="labouragreement" type="xs:unsignedByte"
/>
<xs:element name="exceptionallabourcostagreement" type="xs:unsignedByte" />
<xs:element name="nameplatereceived" type="xs:unsignedByte" />
<xs:element name="devicedexpertised" type="xs:unsignedByte" />
<xs:element name="creditvalue" type="xs:decimal" />
<xs:element name="creditcontribution" type="xs:decimal" />

Page | 140

<xs:element name="newdeviceref" type="xs:string" />


<xs:element name="sparepartorigin" type="xs:string" />
<xs:element name="creditaccount" type="xs:decimal" />
<xs:element name="agreementvalidatedby" type="xs:string" />
<xs:element name="agreementdate" type="xs:date" />
<xs:element name="agreementnumber" type="xs:string" />
<xs:element name="creditnumber" type="xs:string" />
<xs:element name="creditdate" type="xs:date" />
<xs:element name="SAPTransac" type="xs:string" />
<xs:element name="spareparts">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="sparepart">
<xs:complexType>
<xs:sequence>
<xs:element name="ref" type="xs:string" />
<xs:element name="Quantity" type="xs:unsignedByte" />
<xs:element name="Price" type="xs:decimal" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="retrieval">
<xs:complexType>
<xs:sequence>
<xs:element name="name" type="xs:string" />
<xs:element name="address1" type="xs:string" />
<xs:element name="address2" type="xs:string" />
<xs:element name="address3" type="xs:string" />
<xs:element name="zip" type="xs:string" />
<xs:element name="city" type="xs:string" />
<xs:element name="country" type="xs:string" />
<xs:element name="phone1" type="xs:string" />
<xs:element name="phone2" type="xs:string" />
<xs:element name="email" type="xs:string" />
<xs:element name="retrievalwishdate" type="xs:date" />
<xs:element name="retrievaleffectivedate" type="xs:date" />
<xs:element name="comment" type="xs:string" />

Page | 141

</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="delivery">
<xs:complexType>
<xs:sequence>
<xs:element name="name" type="xs:string" />
<xs:element name="address1" type="xs:string" />
<xs:element name="address2" type="xs:string" />
<xs:element name="address3" type="xs:string" />
<xs:element name="zip" type="xs:string" />
<xs:element name="city" type="xs:string" />
<xs:element name="country" type="xs:string" />
<xs:element name="phone1" type="xs:string" />
<xs:element name="phone2" type="xs:string" />
<xs:element name="email" type="xs:string" />
<xs:element name="deliverywishdate" type="xs:date" />
<xs:element name="deliveryeffectivedate" type="xs:date" />
<xs:element name="comment" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="claimnumber" type="xs:string" use="required" />
<xs:attribute name="clientnumber" type="xs:string" use="required" />
<xs:attribute name="updatedate" type="xs:date" use="required" />
<xs:attribute name="manufacturerid" type="xs:unsignedShort" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

Page | 142

2.12.1.4 XML (Exemple de fichier)


<?xml version="1.0" encoding="utf-16"?>
<claims>
<claim claimnumber="XXX" clientnumber="0096663" updatedate="2015-09-11" manufacturerid="3">
<mti>E6459877</mti>
<mtistatus>APS</mtistatus>
<claimstatus>INV</claimstatus>
<comment>texte</comment>
<iriscondition>X</iriscondition>
<irisconditionex>X1X</irisconditionex>
<irissection>12P</irissection>
<irissymptom>12A</irissymptom>
<irisdefault>12E</irisdefault>
<irisrepair>12F</irisrepair>
<agreementcondition>
<agreementtype>1</agreementtype>
<sparepartagreement>1</sparepartagreement>
<labouragreement>1</labouragreement>
<exceptionallabourcostagreement>0</exceptionallabourcostagreement>
<nameplatereceived>1</nameplatereceived>
<devicedexpertised>0</devicedexpertised>
<creditvalue>0.5</creditvalue>
<creditcontribution>300</creditcontribution>
<newdeviceref>wa32132</newdeviceref>
<sparepartorigin>xx123456</sparepartorigin>
<creditaccount>545465466</creditaccount>
<agreementvalidatedby>E6459877</agreementvalidatedby>
<agreementdate>2015-09-12</agreementdate>
<agreementnumber>897987987</agreementnumber>
<creditnumber>654564</creditnumber>
<creditdate>2015-09-13</creditdate>
<SAPTransac>654654656465</SAPTransac>
<spareparts>
<sparepart>
<ref>X789555</ref>
<Quantity>1</Quantity>
<Price>88.63</Price>
</sparepart>
<sparepart>
<ref>X789556</ref>
<Quantity>1</Quantity>
<Price>65.03</Price>
</sparepart>

Page | 143

</spareparts>
</agreementcondition>
<retrieval>
<name>NOM</name>
<address1>AD1</address1>
<address2>AD2</address2>
<address3>AD3</address3>
<zip>06600</zip>
<city>ANTIBES</city>
<country>FRANCE</country>
<phone1>+33660606060</phone1>
<phone2>+33660606060</phone2>
<email>sebastien.marie@rte.fr</email>
<retrievalwishdate>2015-09-11</retrievalwishdate>
<retrievaleffectivedate>2015-09-11</retrievaleffectivedate>
<comment>TEXTE</comment>
</retrieval>
<delivery>
<name>NOM</name>
<address1>AD1</address1>
<address2>AD2</address2>
<address3>AD3</address3>
<zip>06600</zip>
<city>ANTIBES</city>
<country>FRANCE</country>
<phone1>+33660606060</phone1>
<phone2>+33660606060</phone2>
<email>sebastien.marie@rte.fr</email>
<deliverywishdate>2015-09-11</deliverywishdate>
<deliveryeffectivedate>2015-09-11</deliveryeffectivedate>
<comment>TEXTE</comment>
</delivery>
</claim>
</claims>

Page | 144

2.12.1.5 Export des fichiers physiques


2.12.1.5.1 Solution Admin
Les informations SOLSAV Admin gnres par AGORA destination du constructeur seront dposes sous larborescence suivante :

OUT/
SolutionAdmin/
Le transfert FTP devra suivre la rgle suivante :
Durant le transfert le fichier doit sappeler : <Date>_OUT_SOLUTIONADMIN.tmp
A la fin du transfert, il faut lappeler <Date>_OUT_SOLUTIONADMIN.zip

Page | 145

2.13 MODULE TRACABILITE V2


2.13.1 Fichier de traabilit
2.13.1.1 Description gnrale
Contenu de la table :
Sens du transfert :
Priodicit conseille :
Format de fichier :

Nom de llment

Retour de lavancement du dossier de SAV du CTA vers le constructeur.


RTE vers le Constructeur
3 fois par jour
XML (UTF16)

Nom de lattribut ou lment feuille Type

Obligatoire Description longue et commentaires

mandatestates
mandatestates > mandatestate

Page | 146

manufacturerid

int

ordermission
statuscode

String
Date

Elment racine du fichier. Contient la liste des suivis de dossier


Elment reprsentant ltat du mandat
Identifiant du constructeur
Numro dordre de mission
Etat du mandat :

1 = Accept
2 = Planifi
3 = Annul
4 = Cltur
5 = Cltur avec ISG

2.13.1.2 CONSUMER Information du consommateur

Page | 147

Nom de llment

Nom de lattribut ou lment feuille Type

mandatestates
mandatestates > mandatestate > consumer

Obligatoire Description longue et commentaires


Elment racine du fichier. Contient la liste des suivis de dossier
Elment reprsentant un consommateur

civility

String

firstname
lastname
phoneType
businessphonenumber
phonenumber
smscode
email

String
String
String
String
String
String
String

mandatestates > mandatestate > consumer > postaladdress

Elment reprsentant une adresse postal


address1
address2
address3
zip
city
country

String
String
String
String
String
int

2.13.1.3 PRODUCT Modification des rfrence produit

Nom de llment

Nom de lattribut ou lment feuille Type

mandatestates
mandatestates > mandatestate >product

Page | 148

Obligatoire Description longue et commentaires

commercialreference

String

Elment racine du fichier. Contient la liste des suivis de dossier


Elment reprsentant un consommateur
Nouvelle rfrence commerciale

technicalreference

String

Nouvelle rfrence technique

2.13.1.4 PARTS Pices

Nom de llment

Nom de lattribut ou lment feuille Type

Obligatoire Description longue et commentaires

mandatestates
mandatestates > mandatestate >parts
mandatestates > mandatestate >parts > part
ordernumber

string

Elment racine du fichier. Contient la liste des suivis de dossier


Elment contenant le prvis pice ou les pices en litige
Elment reprsentant la pice
Numro de commande

quantit

int

Quantit commande

reference

String

La liste des pices peut tre renseigne dans 2 cas de figure :


titre indicatif pour informer le constructeur du prvis pice.
Dans le cas des codes tat de pices dtaches 200, 201 et 202
2.13.1.5 STATENATURE - Dtail des codes tats

Page | 149

Rfrence de la pice

Nom de llment

Nom de lattribut ou lment feuille Type Obligatoire Description longue et commentaires

mandatestates

Elment racine du fichier. Contient la liste des suivis de dossier

mandatestates > mandatestate >statenatures

Elment contenant la liste des codes tats

mandatestates > mandatestate >statenatures > statenature

Elment reprsentant le code tat

Page | 150

code

string

Code tat

comment

string

Commentaire

appointmentNumber

int

Numro de rendez-vous consommateur

2.13.1.5.1 Listes des codes tats


NATURE

INFORMATIONS RENSEIGNEES SUR LE MANDAT

INFORMATIONS RENSEIGNEES SUR LE MANDAT

100

CONSOMMATEUR NON ENCORE CONTACTE

RAS

101

CONSOMMATEUR IMPOSSIBLE A JOINDRE

INFOS LIBRES

102N

RV PRIS CONFIRME CONSOMMATEUR (N)

DATE ET TRANCHE HORAIRE DU 1ER RV

103

CONSOMMATEUR ABSENT LORS DU RV

INFOS LIBRES

104

CONSOMMATEUR REFUSE L'INTERVENTION

INFOS LIBRES

105

RV REFUSE CONVENANCE CONSOMMATEUR

INFOS LIBRES

106

RV NON PRIS CONTRAINTE PLANNING STA

INFOS LIBRES

107

RV NON PRIS PRODUIT EN RESIDENCE SECONDAIRE

INFOS LIBRES

108

INFOS LIBRES

109

RV NON PRIS TROP DE CONTRAINTE CONSOMMATEUR


RV NON PRIS MESSAGE LAISSE AU CONSO SANS
REPONSE

110

RV PRIS A DATE CONVENANCE CONSOMMATEUR

INFOS LIBRES

200

PIECES DETACHEES COMMANDEES NON RECUES

REF PIECES N DE CDE AGORA ET DATE DE LA CDE

201

PIECES DETACHEES COMMANDEES RECUES

REF PIECES N DE CDE AGORA ET DATE DE LA CDE

202

PIECES DETACHEES INDISPONIBLES CONSTRUCTEUR

REF PIECES N DE CDE AGORA ET DATE DE LA CDE

203

PIECES DETACHEES INDISPONIBLES STA

INFOS LIBRES

204

PIECE RECUE DEFECTUEUSE OU CASSEE

REF PIECES N DE CDE AGORA ET DATE DE LA CDE

205

PIECES DETACHEES COMMANDEES

INFOS LIBRES

300

PROBLEME TECHNIQUE NON RESOLU

INFOS LIBRES RENSEIGNE SUR LE PROBLEME TECH

301

INTERVENTION NON FINALISEE

INFOS LIBRES RENSEIGNE SUR MOTIF NON RESOLUTION

302

DEMANDE DE SOLUTION COMMERCIALE

INFOS LIBRESRENSEIGNE SUR LA DEMANDE

303

APPAREIL FONCTIONNE A NOUVEAU

INFOS LIBRES

304

APPAREIL ECHANGE PAR LE REVENDEUR

INFOS LIBRES

400

RETOUR PRODUIT ATELIER

INFOS LIBRES RENSEIGNE SUR RAISON DU RETOUR ET DATE

401

REPARATION EN COURS ATELIER

INFOS LIBRES

402

RV PRIS POUR RELIVRAISON DU PRODUIT

INFOS LIBRES DATE ET TRANCHE HORAIRE

403

PRT D'APPAREIL

INFOS LIBRES DATE DE PRT

404

REPRISE DU PRET D'APPAREIL

INFOS LIBRES DATE DE REPRISE DU PRT

500

ATTENTE D'INFORMATION DU CLIENT

INFOS LIBRES RENSEIGNE SUR INFO EN ATTENTE

501

ATTENTE ACCORD DEVIS

INFOS LIBRES RENSEIGNE DU DEVIS

502

MISE EN STAND BY PAR LE CONSOMMATEUR

TABLE DES MOTIFS DE MISE EN STAND BY A CREER

503

SOUS GARANTIE PASSE EN HORS GARANTIE

INFOS LIBRES

600

INTERVENTION SOUS TRAITEE

INFOS LIBRES RENSEIGNE DU SOUS TRAITANT ET DATE

901

INFOS LIBRES RENSEIGNE DU SOUS TRAITANT ET DATE

902

CLIENT REFUSE L'INTERVENTION


CONSOMMATEUR TROP ELOIGNE PAR RAPPORT A LA
STA

903

INTERVENTION HORS GARANTIE FACTURATION CLIENT

INFOS LIBRES RENSEIGNE DU SOUS TRAITANT ET DATE

904

MESSAGE LAISSE PAS DE RAPPEL CLIENT

INFOS LIBRES RENSEIGNE DU SOUS TRAITANT ET DATE

905

AUTRE VOIR COMMENTAIRES DU REPARATEUR

INFOS LIBRES RENSEIGNE DU SOUS TRAITANT ET DATE

906

APPAREIL DJ ECHANGE

INFOS LIBRES RENSEIGNE DU SOUS TRAITANT ET DATE

907

APPAREIL FONCTIONNE A NOUVEAU

INFOS LIBRES RENSEIGNE DU SOUS TRAITANT ET DATE

908

STA INDISPONIBLE POUR CAUSE DE FERMETURE

INFOS LIBRES RENSEIGNE DU SOUS TRAITANT ET DATE

909

PAS DE DSIPONIBILITE DANS LES DELAIS DEMANDES

INFOS LIBRES RENSEIGNE DU SOUS TRAITANT ET DATE

1
1
1
1
1
1
1
1
1

CODE ETAT

1
1
2
2
2
2
2
2

Page | 151

PRESENCE
DATE

OUI

OUI

INFOS LIBRES

INFOS LIBRES RENSEIGNE DU SOUS TRAITANT ET DATE

OUI

Page | 152

2.13.1.6 ATTACHEDFILES Pices jointes

Nom de llment

Nom de lattribut ou lment feuille Type Obligatoire Description longue et commentaires

mandatestates
mandatestates > mandatestate > attachedfiles
attachedfile

String

Elment racine du fichier. Contient la liste des suivis de dossier


Elment contenant les pices jointes
Identifiant unique de la pice jointe transmise avec le flux.
.

2.13.1.6.1 Description XSD

<?xml version="1.0" encoding="utf-16" ?>


<xs:schema xmlns:tns="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:tnsa="http://schemas.datacontract.org/2004/07/Agora.Mandate.Contracts.Dto" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://schemas.datacontract.org/2004/07/Agora.Mandate.Contracts.Dto" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="mandatestates">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" name="mandatestate">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="1" name="manufacturerid" type="xs:int" />
<xs:element minOccurs="1" maxOccurs="1" name="ordermission">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="consumer">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="civility">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="5" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="firstname">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="50" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="lastname">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="50" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="phonetype">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="businessphonenumber">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="phonenumber">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="smscode">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="email">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="150" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="postaladdress">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="address1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="150" />
</xs:restriction>
</xs:simpleType>
</xs:element>

Page | 153

<xs:element minOccurs="0" name="address2">


<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="150" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="address3" type="xs:string" />
<xs:element minOccurs="0" name="zip">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="10" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="city">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="50" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="country" type="xs:int" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="product">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="commercialreference">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="100" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="technicalreference">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="100" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="parts">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" name="part">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="ordernumber">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="50" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="quantity" type="xs:int" />
<xs:element minOccurs="1" name="reference">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="100" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="statenatures">
<xs:complexType>
<xs:sequence minOccurs="0">
<xs:element minOccurs="1" maxOccurs="1" name="stateNature">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" name="code">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="comment">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="1024" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="appointmentNumber" type="xs:int" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" name="statuscode">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="attachedfiles">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" name="attachedfile">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="1024" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

Page | 154

2.13.2 Fichier de rponse du Traabilit V2


2.13.2.1 Description gnrale
Contenu de la table :
Retour constructeur.
Sens du transfert :
Constructeur vers RTE
Priodicit conseille :
3 fois par jour
Format de fichier :
XML (UTF16)

Nom de llment

Nom de lattribut ou lment feuille Type Obligatoire Description longue et commentaires

mandatemessages
mandatemessages > message
manufacturer

int

Elment racine du fichier. Contient la liste des suivis de dossier


Elment contenant la liste des codes tats
Identifiant du constructeur

ordermission

string

Numro dordre de mission

Date
content

date
String

X
X

attachedfile

string

mandatemessages > message > attachedfiles

Page | 155

Commentaire retour constructeur


Elment contenant la liste des pices jointes
Identifiant unique de la pice jointe transmise avec le flux.
Lidentifiant gnr est un Guid, suivi de lextension du fichier.

2.13.2.1.1 Description XSD


<?xml version="1.0" encoding="utf-16" ?>
<!--Created with Liquid XML Studio - FREE Community Edition 7.0.2.746 (http://www.liquid-technologies.com)-->
<xs:schema elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="mandatemessages">
<xs:complexType>
<xs:sequence>
<xs:element name="message">
<xs:complexType>
<xs:sequence minOccurs="1" maxOccurs="1">
<xs:element name="date" type="xs:date" />
<xs:element name="content">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="1024" />
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element minOccurs="0" name="attachedfiles">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" name="attachedfile">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="1024" />
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="manufacturer" type="xs:int" use="required" />
<xs:attribute name="ordermission" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:maxLength value="20" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

Page | 156

2.13.3 Import/Export des fichiers physiques


2.13.3.1 Mandat
Les mandats gnrs par le constructeur destination des CTA seront dposs sous larborescence AGORA suivante :
IN/
Mandat/
Le transfert FTP devra suivre la rgle suivante :
Durant le transfert le fichier doit sappeler : <Date>_IN_MANDAT.tmp
A la fin du transfert, il faut lappeler <Date>_IN_MANDAT.zip

2.13.3.2 MandatResponse (Traabilit V2 - Response)


Les fichiers de rponse du constructeur seront dposs sous larborescence suivante :
IN/
MandatResponse/
Le transfert FTP devra suivre la rgle suivante :
Durant le transfert le fichier doit sappeler : <Date>_IN_MANDATRESPONSE.tmp
A la fin du transfert, il faut lappeler <Date>_IN_MANDATRESPONSE.zip, contenant les fichiers suivants :
Les pices jointes
Le fichier XML <Date>_IN_MANDATRESPONSE.XML

2.13.3.3 MandatTrace (Traabilit V2 )


Les informations remontes par les CTA seront (Code tat, prvisionnel picesetc) seront dposs sous larborescence AGORA suivante :

OUT/
MandatTrace/

Page | 157

Durant le transfert le fichier doit sappeler : <Date>_OUT_MANDATTRACE.tmp


A la fin du transfert, il faut lappeler <Date>_OUT_MANDATTRACE.zip, contenant les fichiers suivants :
Les pices jointes
Le fichier XML <Date>_OUT_MANDATTRACE.XML

3 Annexes
3.1 Types de donnes
Le tableau ci-dessous rsume la liste des diffrents types de champs rencontrs dans la spcification du format
de fichier.

Type
Char
Int
Real

Contenu
Caractres alphanumriques au format ISO
8859-1
Chiffre entier
Chiffre rel

Bool

Boolen sur 1 position

Cur

Chiffres montaires sur 10 caractres

Date
DateTime

Au format jj/mm/aaaa sur 10 caractres


Au format jj/mm/aaaa hh:mm:ss sur 19
positions
Au format hh:mm sur 5 positions

Time

Remarque
Complt par des blancs, justifi gauche
Align droite ou complt par des 0 (ex : 00001)
Aligne droite ou complt par des 0
Le point est utilis comme sparateur dcimal
0 = faux
1 = vrai
Complts par des 0 justifis droite avec 2 dcimales
spares par un point (ex 0000002.02)
exemple : 01/01/2000

exemple 14:30

3.2 Liste des codes devises (ISO 4217)


ATS
BEF
CHF
DEM
ESP
EUR
FIM
FRF
GBP
GRD
IEP
ITL
JPY
LUF
NLG
NOK
PTE
SEK
USD

Austria, Schilling
Belgium, Franc
Switzerland, Franc
Germany, Deutsche Mark
Spain, Peseta
uro
Finland, Markka
France, Franc
Great Britain, Pound Sterling
Greece, Drachma
Eire (Ireland), Punt
Italy, Lira
Japan, Yen
Luxembourg, Franc
Holland (The Netherlands), Guilder
Norway, Krone
Portugal, Escudo
Sweden, Krona
United States of America, US Dollar

RTE Services 2014

3.3 Code Pays (ISO 3166-1)


Dans la suite de ce document, les codes utiliser pour lidentification dun pays sont les codes ISO-3166-1 sous
forme de 3-Numeric . La liste est indique ci-dessous.

004
008
012
016
020
024
660
010
028
032
051
533
036
040
031
044
048
050
052
112
056
084
204
060
064
068
070
072
074
076
086
096
100
854
108
116
120
124
132
136
140
148
152
156

AFGHANISTAN
ALBANIA
ALGERIA
AMERICAN SAMOA
ANDORRA
ANGOLA
ANGUILLA
ANTARCTICA
ANTIGUA AND BARBUDA
ARGENTINA
ARMENIA
ARUBA
AUSTRALIA
AUSTRIA
AZERBAIJAN
BAHAMAS
BAHRAIN
BANGLADESH
BARBADOS
BELARUS
BELGIUM
BELIZE
BENIN
BERMUDA
BHUTAN
BOLIVIA
BOSNIA AND HERZEGOWINA
BOTSWANA
BOUVET ISLAND
BRAZIL
BRITISH INDIAN OCEAN TERRITORY
BRUNEI DARUSSALAM
BULGARIA
BURKINA FASO
BURUNDI
CAMBODIA
CAMEROON
CANADA
CAPE VERDE
CAYMAN ISLANDS
CENTRAL AFRICAN REPUBLIC
CHAD
CHILE
CHINA

RTE Services 2014

162
166
170
174
178
180
184
188
384
191
192
196
203
208
262
212
214
626
218
818
222
226
232
233
231
238
234
242
246
250
249
254
258
260
266
270
268
276
288
292
300
304
308
312
316
320
324
624
328
332
334

CHRISTMAS ISLAND
COCOS (KEELING) ISLANDS
COLOMBIA
COMOROS
CONGO
CONGO, THE DEMOCRATIC REPUBLIC OF THE
COOK ISLANDS
COSTA RICA
COTE D'IVOIRE
CROATIA
CUBA
CYPRUS
CZECH REPUBLIC
DENMARK
DJIBOUTI
DOMINICA
DOMINICAN REPUBLIC
EAST TIMOR
ECUADOR
EGYPT
EL SALVADOR
EQUATORIAL GUINEA
ERITREA
ESTONIA
ETHIOPIA
FALKLAND ISLANDS (MALVINAS)
FAROE ISLANDS
FIJI
FINLAND
FRANCE
FRANCE, METROPOLITAN
FRENCH GUIANA
FRENCH POLYNESIA
FRENCH SOUTHERN TERRITORIES
GABON
GAMBIA
GEORGIA
GERMANY
GHANA
GIBRALTAR
GREECE
GREENLAND
GRENADA
GUADELOUPE
GUAM
GUATEMALA
GUINEA
GUINEA-BISSAU
GUYANA
HAITI
HEARD AND MC DONALD ISLANDS

RTE Services 2014

336
340
344
348
352
356
360
364
368
372
376
380
388
392
400
398
404
296
408
410
414
417
418
428
422
426
430
434
438
440
442
446
807
450
454
458
462
466
470
584
474
478
480
175
484
583
498
492
496
500
504

HOLY SEE (VATICAN CITY STATE)


HONDURAS
HONG KONG
HUNGARY
ICELAND
INDIA
INDONESIA
IRAN (ISLAMIC REPUBLIC OF)
IRAQ
IRELAND
ISRAEL
ITALY
JAMAICA
JAPAN
JORDAN
KAZAKHSTAN
KENYA
KIRIBATI
KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF
KOREA, REPUBLIC OF
KUWAIT
KYRGYZSTAN
LAO PEOPLE'S DEMOCRATIC REPUBLIC
LATVIA
LEBANON
LESOTHO
LIBERIA
LIBYAN ARAB JAMAHIRIYA
LIECHTENSTEIN
LITHUANIA
LUXEMBOURG
MACAU
MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
MADAGASCAR
MALAWI
MALAYSIA
MALDIVES
MALI
MALTA
MARSHALL ISLANDS
MARTINIQUE
MAURITANIA
MAURITIUS
MAYOTTE
MEXICO
MICRONESIA, FEDERATED STATES OF
MOLDOVA, REPUBLIC OF
MONACO
MONGOLIA
MONTSERRAT
MOROCCO

RTE Services 2014

508
104
516
520
524
528
530
540
554
558
562
566
570
574
580
578
512
586
585
275
591
598
600
604
608
612
616
620
630
634
638
642
643
646
659
662
670
882
674
678
682
686
690
694
702
703
705
090
706
710
239

MOZAMBIQUE
MYANMAR
NAMIBIA
NAURU
NEPAL
NETHERLANDS
NETHERLANDS ANTILLES
NEW CALEDONIA
NEW ZEALAND
NICARAGUA
NIGER
NIGERIA
NIUE
NORFOLK ISLAND
NORTHERN MARIANA ISLANDS
NORWAY
OMAN
PAKISTAN
PALAU
PALESTINIAN TERRITORY, OCCUPIED
PANAMA
PAPUA NEW GUINEA
PARAGUAY
PERU
PHILIPPINES
PITCAIRN
POLAND
PORTUGAL
PUERTO RICO
QATAR
REUNION
ROMANIA
RUSSIAN FEDERATION
RWANDA
SAINT KITTS AND NEVIS
SAINT LUCIA
SAINT VINCENT AND THE GRENADINES
SAMOA
SAN MARINO
SAO TOME AND PRINCIPE
SAUDI ARABIA
SENEGAL
SEYCHELLES
SIERRA LEONE
SINGAPORE
SLOVAKIA (Slovak Republic)
SLOVENIA
SOLOMON ISLANDS
SOMALIA
SOUTH AFRICA
SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS

RTE Services 2014

724
144
654
666
736
740
744
748
752
756
760
158
762
834
764
768
772
776
780
788
792
795
796
798
800
804
784
826
840
581
858
860
548
862
704
092
850
876
732
887
891
894
716

SPAIN
SRI LANKA
ST. HELENA
ST. PIERRE AND MIQUELON
SUDAN
SURINAME
SVALBARD AND JAN MAYEN ISLANDS
SWAZILAND
SWEDEN
SWITZERLAND
SYRIAN ARAB REPUBLIC
TAIWAN, PROVINCE OF CHINA
TAJIKISTAN
TANZANIA, UNITED REPUBLIC OF
THAILAND
TOGO
TOKELAU
TONGA
TRINIDAD AND TOBAGO
TUNISIA
TURKEY
TURKMENISTAN
TURKS AND CAICOS ISLANDS
TUVALU
UGANDA
UKRAINE
UNITED ARAB EMIRATES
UNITED KINGDOM
UNITED STATES
UNITED STATES MINOR OUTLYING ISLANDS
URUGUAY
UZBEKISTAN
VANUATU
VENEZUELA
VIET NAM
VIRGIN ISLANDS (BRITISH)
VIRGIN ISLANDS (U.S.)
WALLIS AND FUTUNA ISLANDS
WESTERN SAHARA
YEMEN
YUGOSLAVIA
ZAMBIA
ZIMBABWE

RTE Services 2014

3.4 Liste des codes constructeurs


Identifiant
1
2
3
4
5
6
8
9
10
11
14
15
16
17
18
19
20
21

Constructeur
Groupe BRANDT
Whirlpool
Electrolux
B/S/H/
Miele
Indesit Company
Gias Consommables
Gias Pices Dtaches
Sogedis
Electrolux Consommables
Philips
Groupe Seb
Dometic
Beko
Saeco
DeLonghi
Gorenje
Eberhardt

RTE Services 2014

Rfrence
Version
Date

RTE Services 2014

Rfrence
V.{_UIVersionString}
03/12/2015 12:34:00

Вам также может понравиться