REFERENCE VERSION 2.1.4 DATE 12/09/2014 Fichier de dépose de contrats Rédacteur RTE Technologies Référence Statut GC+_FD06018 Historique Version Date Modifications 1.0.0 20/11/2006 Version d origine pour le site GC PLUS 1.1.0 24/07/2007 Ajout d explication dans le cadre de la dépose via FTP Ajout de la section Login Ajout du champ RefFiles à la section Header Ajout du champ Action à la section Contr 1.1.1 20/12/2007 Version validée 2.1.0 28/03/2008 - Version 2.1 pour le site GC Plus 2.1.1 05/10/2009 - Compléments d informations sur l acquittement 2.1.2 01/07/2011 - Ajout du code EAN 2.1.3 10/11/2012 - Multi produit Whirlpool - Modification des codes constructeurs. 2.1.4 12/09/2014 Ajout EBERHARDT La règle de numérotation des versions est de la forme "X.Y.Z", où : X : Version majeure Numéro de version incrémenté en cas d évolution importante de GC PLUS. Y : Version mineure Numéro de version incrémenté en cas de changement du format de fichier (par exemple l ajout d un nouveau champ ou ajout d une nouvelle section) Z : Révision Numéro de révision incrémenté en cas de modification des spécifications sans changement du format du fichier (par exemple des règles de contrôles ou des valeurs admises)
Sommaire 1. INTRODUCTION... 4 1.1. OBJET DU PRESENT DOCUMENT... 4 1.2. PRINCIPE DE FONCTIONNEMENT... 4 1.2.1. Dépose via le site www.gcplus.fr... 4 1.2.2. Dépose par FTP à l adresse ftp.gcplus.fr... 5 1.3. MISE A JOUR DE CE DOCUMENT... 5 2. COMMENT UTILISER CE DOCUMENT... 6 2.1. DESCRIPTION GENERALE... 6 2.2. FORMAT DES ECHANGES DE DONNEES... 6 2.2.1. Types de données... 6 2.2.2. Liste des codes constructeurs... 7 2.2.3. Liste des codes Pays (ISO 3166-1)... 7 2.2.4. Liste des codes Langues (ISO 639-1)... 8 3. FICHIER DE DEPOSE DE CONTRATS... 9 3.1. STRUCTURE DU FICHIER DE DEPOSE... 9 3.1.1. Section LOGIN... 9 3.1.1.1. Structure...9 3.1.1.2. Règles fonctionnelles...9 3.1.2. Section HEADER... 10 3.1.2.1. Structure... 10 3.1.2.2. Règles fonctionnelles... 10 3.1.3. Section CONTR... 10 3.1.3.1. Structure... 10 3.1.3.2. Règles fonctionnelles... 10 3.1.4. Section CONSUMER... 11 3.1.4.1. Structure... 11 3.1.4.2. Règle fonctionnelle... 11 3.1.5. Section ADDRESS... 11 3.1.5.1. Structure... 11 3.1.5.2. Règle Fonctionnelle... 11 3.1.6. Section PRODUCT... 12 3.1.6.1. Structure... 12 3.1.6.2. Règles fonctionnelles... 12 3.1.7. Section ENDCONTR... 13 3.1.7.1. Structure... 13 3.1.8. Section ENDHEADER... 13 3.1.8.1. Structure... 13 3.2. REGLES SPECIFIQUES AUX CONSTRUCTEURS... 13 3.2.1. Contrats mono-marque... 13 4. EXEMPLE DE DEPOSE FORMAT CLASSIQUE... 14 4.1. DEPOSE PAR SITE WEB D UN CONTRAT SANS GARANTIE RENSEIGNEE... 14 4.1.1. Condition... 14 4.1.2. Fichier... 14 4.1.3. Traitement... 14 4.2. DEPOSE PAR SITE WEB D UN CONTRAT COMPOSE DE PLUSIEURS PRODUITS IDENTIQUES... 14 4.2.1. Condition... 14 4.2.2. Fichier... 15 4.2.3. Traitement... 15 4.3. DEPOSE PAR SITE FTP D UN CONTRAT AVEC UNE GARANTIE ET UNE EXTENSION RENSEIGNEES... 15 4.3.1. Condition... 15 4.3.2. Fichier... 16 DOSSIER DE SPECIFICATIONS DETAILLEES page 2 / 23
4.3.3. Traitement... 16 4.4. DEPOSE PAR SITE FTP D UN CONTRAT AVEC UNE DUREE DEFINIE... 16 4.4.1. Condition... 16 4.4.2. Fichier... 16 4.4.3. Traitement... 17 5. FICHIER DE DEPOSE DE CONTRATS SIMPLIFIE... 18 5.1. COMMENT CREER LE FICHIER MANUELLEMENT?... 20 5.2. DEPOSE DE CONTRATS... 20 6. RETOUR DES CONTRATS DEPOSES... 20 6.1. PAR FICHIER DE COMPTE RENDU... 20 6.1.1. Liste des codes erreurs... 22 6.2. PAR MAILING... 23 DOSSIER DE SPECIFICATIONS DETAILLEES page 3 / 23
1. Introduction 1.1. Objet du présent document Le principe de fonctionnement proposé permet la création de contrats en masse dans le système GC PLUS lorsque ceux-ci ont été préalablement saisis dans un autre système informatique. Ce document à pour but de fournir toutes les spécifications techniques nécessaires pour permettre le développement des programmes de création des fichiers utilisés dans ces échanges. Il contient une description : des deux modes de fonctionnement proposés (FTP et HTTP), du format de fichier à mettre en œuvre. 1.2. Principe de fonctionnement 1.2.1. Dépose via le site www.gcplus.fr Dans ce mode, le fonctionnement est le suivant : 1. Création du fichier o Le système informatique du distributeur doit générer un fichier conforme aux spécifications détaillées ci-après. 2. Envoi du fichier à GC PLUS o Depuis la page dépose de contrats du site www.gcplus.fr, l utilisateur peut interactivement sélectionner le fichier à envoyer sur le site GC PLUS. o Le fichier est alors envoyé (upload) depuis le poste du distributeur vers GC PLUS. 3. Traitement des fichiers o Tous les fichiers déposés sont placés dans une fille d attente de GC PLUS, pour être traités automatiquement sous un délai maximum de 2 heures o GC PLUS procède alors au traitement des fichiers reçus afin de s assurer que la syntaxe et les informations sont correctes. o Les contrats déposés sont associés automatiquement au client connecté sur le site, sauf si le champ «Distributeur» de la section «CONTR» est renseigné. 4. Validation des fichiers déposés o Le résultat de ces traitements est disponible sur une page de suivi du site www.gcplus.fr o En cas d erreurs détectées par GC PLUS, l utilisateur peut effectuer les corrections nécessaires en ligne sur le site GC PLUS (référence de produit, type de garantie, ), ou préférer annuler totalement le fichier et redéposer un nouveau fichier corrigé. o L utilisateur doit au final enregistrer de façon explicite les contrats valides (ou corrigés) afin qu ils soient définitivement pris en compte et que les contrats soient validés DOSSIER DE SPECIFICATIONS DETAILLEES page 4 / 23
1.2.2. Dépose par FTP à l adresse ftp.gcplus.fr Dans ce mode, le fonctionnement est le suivant : 1. Création du fichier o Le système informatique du distributeur doit générer un fichier conforme aux spécifications détaillées ci-après. 2. Envoi du fichier à GC PLUS o Les fichiers doivent être déposés via FTP à la racine du site ftp.gcplus.fr o Le compte et mot de passe à utiliser sera communiqué par GC PLUS ultérieurement. 3. Traitement des fichiers o Comme pour les fichiers déposés via HTTP sur le site Web, ces fichiers sont placés dans une fille d attente, pour être traités automatiquement sous un délai maximum de 2 heures o GC PLUS procède alors au traitement des fichiers reçus afin de s assurer que la syntaxe et les informations sont correctes. o L accès FTP n étant pas nominatif, GC PLUS utilise l identification contenu dans les fichiers déposés pour lier les contrats au bon distributeur, ou le champ «Distributeur» de la section «CONTR» dans le cas de contrats déposés par un grossiste pour le compte de ces adhérents. 4. Validation des fichiers déposés o Si le fichier est conforme et sans aucune erreur, tous les contrats qu il contient sont automatiquement validés o Dans le cas contraire, si au moins une erreur est détectée : Le résultat du traitement de ces fichiers est disponible en ligne sur le site www.gcplus.fr au même titre que les fichiers déposés de manière interactive. L utilisateur peut effectuer les corrections nécessaires en ligne sur le site GC PLUS (référence de produit, type de garantie, ), ou préférer annuler totalement le fichier et redéposer un nouveau fichier corrigé. L utilisateur doit alors enregistrer de façon explicite les contrats valides et ceux corrigés afin qu ils soient définitivement pris en compte et que les contrats soient validés o Un fichier d acquittement contenant le résultat du traitement des fichiers déposés en FTP est fourni sur les répertoires FTP. 1.3. Mise à jour de ce document Nous conseillons à ceux qui auraient mis en œuvre une telle dépose de contrats, de vérifier la version du format de dépose afin de pouvoir bénéficier d éventuelles modifications apportées à ces échanges et ce présent document. DOSSIER DE SPECIFICATIONS DETAILLEES page 5 / 23
2. Comment utiliser ce document 2.1. Description générale Le fichier doit respecter une syntaxe déterminée afin de pouvoir être interprété par GC PLUS. Les remarques générales concernant la structure de ce fichier sont les suivantes : Le fichier est au format texte ANSI à longueur fixe. Chaque ligne doit être séparée par un saut de ligne et/ou retour chariot (format Windows, Mac ou Unix). Les lignes commençant par un point virgule sont considérées comme des commentaires et sont ignorées. Chaque ligne contient un type d information particulier (aussi appelée «section» dans la suite du document) et donc une liste de champs déterminée, par exemple : Une ligne pour l entête du contrat. Une ligne pour le consommateur. Une ligne pour chaque produit du contrat. Le nom de la ligne (10 premiers caractères de chaque ligne) permet de déterminer le type et contenu de celle-ci. Chaque fichier doit contenir : Une et une seule ligne de type «HEADER» au début du fichier. Une et une seule ligne de type «ENDHEADER» en fin de fichier. Chaque fichier peut contenir un ou plusieurs contrats auprès de n importe quel constructeur, chaque contrat devant : Commencer par une ligne de type «CONTR» Et finir par une ligne de type «ENDCONTR» L organisation des différentes sections ainsi qu une description générale du contenu de chacune d entre elle est communiquée. 2.2. Format des échanges de données 2.2.1. Types de données Le tableau ci-dessous résume la liste des différents types de champs rencontrés dans la spécification du format de fichier. Type Description Format BIT Numérique 0 DF1 Date dd/mm/yyyy X02 Numérique 00 X03 Numérique 000 X06 Numérique 000000 Chaine Chaine DOSSIER DE SPECIFICATIONS DETAILLEES page 6 / 23
2.2.2. Liste des codes constructeurs N Nom du constructeur 01 FAGORBRANDT 02 WHIRLPOOL 03 ELECTROLUX 04 B/S/H/ 05 MIELE 06 INDESIT COMPANY 09 GROUPE.CANDY.HOOVER 21 GORENJE 22 EBERHARDT 2.2.3. Liste des codes Pays (ISO 3166-1) Dans la suite de ce document, les codes à utiliser pour l identification d un pays sont les codes ISO 3166-1 sous forme de "3-Numeric". Un extrait des codes est indiqué dans la liste ci-dessous. Code Pays 008 ALBANIA 020 ANDORRA 040 AUSTRIA 112 BELARUS 056 BELGIUM 070 BOSNIA AND HERZEGOWINA 100 BULGARIA 191 CROATIA 208 DENMARK 233 ESTONIA 246 FINLAND 250 FRANCE 249 FRANCE, METROPOLITAN 254 FRENCH GUIANA 258 FRENCH POLYNESIA 260 FRENCH SOUTHERN TERRITORIES 276 GERMANY 300 GREECE 348 HUNGARY 352 ICELAND 372 IRELAND 380 ITALY 438 LIECHTENSTEIN Code Pays 440 LITHUANIA 442 LUXEMBOURG 470 MALTA 498 MOLDOVA, REPUBLIC OF 492 MONACO 528 NETHERLANDS 578 NORWAY 616 POLAND 620 PORTUGAL 642 ROMANIA 643 RUSSIAN FEDERATION 674 SAN MARINO 703 SLOVAKIA (Slovak Republic) 705 SLOVENIA 724 SPAIN 752 SWEDEN 756 SWITZERLAND 792 TURKEY 804 UKRAINE 826 UNITED KINGDOM Actuellement, seul le code Pays 250 (France) est accepté au sein de la dépose de contrats GCPlus. Le code 249 devient obsolète à compter cette version 2.1 de GCPlus. DOSSIER DE SPECIFICATIONS DETAILLEES page 7 / 23
2.2.4. Liste des codes Langues (ISO 639-1) Dans la suite de ce document, les codes à utiliser pour l identification d une langue sont les codes ISO 639-1 sous forme de "alpha-2". La liste utilisée par le site est indiquée ci-dessous. Code DE EN ES FR IT HU NL PT Langue Allemand Anglais Espagnol Français Italien Hongrois Néerlandais Portugais DOSSIER DE SPECIFICATIONS DETAILLEES page 8 / 23
3. Fichier de dépose de contrats 3.1. Structure du fichier de dépose Import des fichiers déposé par le site Web ou par le FTP. Section Parent Description LOGIN Login (FTP) HEADER Entête de fichier CONTR Contrat CONSUMER CONTR Consommateur ADDRESS CONSUMER Adresse PRODUCT CONTR Produit ENDCONTR CONTR Fin de contrat ENDHEADER Fin de fichier 3.1.1. Section LOGIN 3.1.1.1. Structure Code Type Longueur Description Obligatoire Pos LOGIN Chaine 10 Section Oui 1 USER Chaine 30 Identifiant GCPlus Oui 11 PASSWORD Chaine 30 Mot de passe GCPlus Oui 41 3.1.1.2. Règles fonctionnelles Section obligatoire pour la dépose FTP. o Création d un numéro de fichier o Vérification que le compte GCPlus et le mot de passe existent o Si le compte GCPlus n existe pas dans la base, le fichier ne sera pas traité DOSSIER DE SPECIFICATIONS DETAILLEES page 9 / 23
3.1.2. Section HEADER 3.1.2.1. Structure Code Type Longueur Description Obligation Pos HEADER Chaine 10 Section Oui 1 FILEVERSION Chaine 7 Version du fichier Oui 11 REFID Chaine 20 Référence du fichier Non 18 3.1.2.2. Règles fonctionnelles Mise à jour de la référence pour ce fichier Vérification que la référence du fichier, si elle existe, n a pas déjà été utilisée par un autre fichier pour ce compte Si la référence existe déjà, le fichier sera indiqué comme incorrect. 3.1.3. Section CONTR 3.1.3.1. Structure Code Type Longueur Description Obligation Pos CONTR Chaine 10 Section Oui 1 IDDISTRI Chaine 30 Identifiant Distributeur Non 11 MANUF_ID Chaine 2 Identifiant Constructeur Oui 41 IDCONTDIS Chaine 20 Code Contrat distributeur Non 43 DATECREA DF1 10 Date Création Non 63 DATEVENT DF1 10 Date Vente Oui 73 OPTOUT BIT Indicateur de relance pour proposer une extension à échéance de la garantie : 0 = pas de relance 1 (défaut si non 1 renseigné) = relance Non 83 ACTION Chaine Action sur contrat 3 (désactivé) Non 84 3.1.3.2. Règles fonctionnelles Vérification de l existence du code constructeur o Si le code n existe pas, le fichier sera indiqué comme incorrect. Vérification sur le distributeur si il est renseigné o Si l identifiant distributeur est renseigné, comparaison avec un code adhérent Si un adhérent est trouvé, récupération du distributeur associé à l adhérent et au constructeur Si aucun adhérent n est trouvé, l identifiant distributeur est considéré comme un distributeur ou un grossiste du constructeur o Si l identifiant distributeur n est pas renseigné, récupération du distributeur principal lié au constructeur et au compte GCplus définie par le site Web durant la dépose ou par la section LOGIN (sous condition qu un seul distributeur est trouvé). Statut du contrat défini comme actif Si la date de création n est pas renseignée, la date de l import est insérée DOSSIER DE SPECIFICATIONS DETAILLEES page 10 / 23
3.1.4. Section CONSUMER 3.1.4.1. Structure Code Type Longueur Description Obligation Pos CONSUMER Chaine 10 section Oui 1 CIV X03 Civilité. Les codes autorisés sont : - '001 M., - '002 Mme, - '003 Mlle, 3 - '004 Sté Oui 11 NOM Chaine 50 Nom Oui 14 PRENOM Chaine 50 Prénom Oui 64 Indicateur d autorisation de mailings commerciaux au consommateur : 0 (défaut si non renseigné) = pas de mailing OPOUT BIT 1 1 = mailing autorisé Non 114 TEL Chaine 20 Téléphone Oui 115 GSM Chaine 20 Mobile Non 135 EMAIL Chaine 100 Email Non 155 3.1.4.2. Règle fonctionnelle Une seule section Consumer est autorisé par contrat Pour les champs TEL et GSM, seuls les numéros de 10 chiffres sont autorisés. TEL : En cas de refus par le consommateur de communiquer son numéro de téléphone, ce champ pourra être rempli avec la valeur «0000000000». 3.1.5. Section ADDRESS 3.1.5.1. Structure Code Type Longueur Description Obligation Pos ADDRESS Chaine 10 section Oui 1 Adresse1 Chaine 50 Adresse part1 Oui 11 Adresse2 Chaine 50 Adresse part2 Non 61 Adresse3 Chaine 50 Adresse part3 Non 111 CodePost Chaine 25 Code Postal Oui 161 Ville Chaine 50 Ville Oui 186 Pays X03 3 Pays Oui 236 TypeAddress Chaine 50 Type d adresses Non 239 3.1.5.2. Règle Fonctionnelle Type d adresse possible : PRINCIPALE, BUREAUX, LIVRAISON, SECONDAIRE, ADRESSE (par défaut) DOSSIER DE SPECIFICATIONS DETAILLEES page 11 / 23
3.1.6. Section PRODUCT 3.1.6.1. Structure Code Type Long Description Obligation Pos PRODUCT Chaine 10 section Oui 1 DATEMES DF1 10 Date Mise en service Non 11 SERIE Chaine 20 Numéro de Série Oui si un autre produit identique existe dans le contrat 21 REFCOM Chaine 50 Référence commercial Non 41 REFTEC Chaine Référence Technique 50 ou Code EAN Oui si Ref commercial non renseigné 91 TYPEGAR Chaine 30 Type garantie Non 141 DUREE X02 2 durée Oui pour FagorBrandt 171 3.1.6.2. Règles fonctionnelles Récupération du code interne du produit en se basant sur la référence commercial ou la référence technique. IMPORTANT : Si vous disposez du code EAN du produit, vous pouvez le transmettre dans le champ REFTEC. Le contrôle se fera alors prioritairement sur ce champ et diminuera sensiblement les risques de rejet sur la référence du produit. Si elle n est pas renseignée, la date de mise en service sera identique à la date de vente La facturation mis à 2 (facturation distributeur) Gestion sur le type de garantie et la durée : Type de garantie Durée Gestion Vérification du type de garantie. Renseigné Non Renseignée La durée prendra pour valeur celui de la garantie. Non Renseigné Non Renseignée Récupération de la garantie de base. La durée prendra pour valeur celui de la garantie. Vérification du type de garantie. Vérification de la durée soit cohérente avec la garantie. Si la durée renseignée est plus grande que la Renseigné Renseignée durée associée à la garantie : o création d une extension permettant d atteindre la durée renseignée (sous réserve que la garantie ne soit pas renseignée comme une extension) Récupération de la garantie de base. Vérification de la durée soit cohérente avec la garantie. Non Renseigné Renseignée Si la durée renseignée est plus grande que la durée associée à la garantie : o création d une extension permettant d atteindre la durée renseignée. DOSSIER DE SPECIFICATIONS DETAILLEES page 12 / 23
3.1.7. Section ENDCONTR 3.1.7.1. Structure Code Type Longueur Description Obligation Pos ENDCONTR Chaine 10 Section Oui 1 NB_PRODUCT X02 2 Nb de produit Oui 11 3.1.8. Section ENDHEADER 3.1.8.1. Structure Code Type Longueur Description Obligation Pos ENDHEADER Chaine 10 Section Oui 1 NB_CONT X06 6 Nombre de contrat Oui 11 3.2. Règles spécifiques aux constructeurs 3.2.1. Contrats mono-marque Les constructeurs suivants n autorisent qu une marque de produits par contrat : GROUPE BRANDT BSH MIELE WHIRLPOOL DOSSIER DE SPECIFICATIONS DETAILLEES page 13 / 23
4. Exemple de Dépose format classique Légende : suite de la ligne 4.1. Dépose par Site Web d un contrat sans garantie renseignée 4.1.1. Condition 1 produit Type de garantie non renseigné Durée non renseignée Date de création non renseignée Date de mise en service non renseignée 4.1.2. Fichier HEADER 1.0.0 FichierRef0001 CONTR 01k00001 020000000001 26/12/20070C CONSUMER 001CONSOTEST PRENOM 0600005078 ADDRESS 16 allée nicole vedres 26500 BOURG LES VALENCE 250Principale PRODUCT KHMF9010/I ENDCONTR 01 ENDHEADER 01 4.1.3. Traitement La garantie de base sera déduite ainsi que sa durée. La date de création et la date mise en service auront pour valeur la date du traitement de fichier. 4.2. Dépose par Site Web d un contrat composé de plusieurs produits identiques 4.2.1. Condition 3 produits identiques DOSSIER DE SPECIFICATIONS DETAILLEES page 14 / 23
Type de garantie non renseigné Durée non renseignée Date de création non renseignée Date de mise en service non renseignée 4.2.2. Fichier HEADER 1.0.0 FichierRef0001 CONTR 01k00001 020000000001 26/12/20070C CONSUMER 001CONSOTEST PRENOM 0600005078 ADDRESS 16 allée nicole vedres 26500 BOURG LES VALENCE 250Principale PRODUCT SN123456 KHMF9010/I PRODUCT SN178945 KHMF9010/I PRODUCT SN798167 KHMF9010/I ENDCONTR 03 ENDHEADER 01 4.2.3. Traitement La garantie de base sera déduite ainsi que sa durée. La date de création et la date mise en service auront pour valeur la date du traitement de fichier. Les numéros de série permettront de différencier les différents produits Remarque : Même aucun numéro n existe pour ces produits, une numérotation doit apparaître afin de différencier les produits sinon le contrat sera refusé 4.3. Dépose par Site FTP d un contrat avec une garantie et une extension renseignées 4.3.1. Condition 1 produit Type de garantie renseigné Extension de garantie renseignée Durée de garantie renseignée Date de création renseignée Date de mise en service renseignée DOSSIER DE SPECIFICATIONS DETAILLEES page 15 / 23
4.3.2. Fichier LOGIN CompteGCPlus Password HEADER 1.0.0 FichierRef0001 CONTR 01k00001 020000000001 20/03/200820/03/20080C CONSUMER 001CONSOTEST PRENOM 0600005078 ADDRESS 16 allée nicole vedres 26500 BOURG LES VALENCE 250Principale PRODUCT 20/03/2008 KHMF9010/I GAR_2_ANS 24 PRODUCT 20/03/2008 KHMF9010/I EXT_1_ANS 12 ENDCONTR 02 ENDHEADER 01 4.3.3. Traitement L extension sera rattachée à la garantie dans le contrat La date de fin de garantie du contrat sera déduite La date de mise en service de l extension sera déduite 4.4. Dépose par Site FTP d un contrat avec une durée définie 4.4.1. Condition 1 produit Type de garantie non renseigné Durée de garantie renseignée Date de création renseignée Date de mise en service renseignée 4.4.2. Fichier LOGIN CompteGCPlus Password HEADER 1.0.0 FichierRef0001 CONTR 01k00001 020000000001 20/03/200820/03/20080C CONSUMER 001CONSOTEST PRENOM 0600005078 ADDRESS 16 allée nicole vedres 26500 BOURG LES VALENCE 250Principale PRODUCT 20/03/2008 KHMF9010/I 36 ENDCONTR 01 ENDHEADER 01 DOSSIER DE SPECIFICATIONS DETAILLEES page 16 / 23
4.4.3. Traitement La garantie de base sera réduite L extension associé à la garantie de base sera déduite afin répondre de la condition sur la durée La date de fin de garantie du contrat sera déduite La date de mise en service de l extension sera déduite DOSSIER DE SPECIFICATIONS DETAILLEES page 17 / 23
5. Fichier de dépose de contrats simplifié Attention: le format de dépose simplifié n est possible qu après activation de la fonction par AGORA SAS. Le format de dépose simplifié est un fichier texte dans lequel chaque colonne est séparée par un point-virgule. L ordre des colonnes doit respecter le tableau ci-dessous : Nom du champ Long. MAX Ordre Oblig. Description / commentaires USER 30 0 Identifiant GC PLUS PASSWORD 25 1 Mot de passe GC PLUS MANU 2 2 Code constructeur pour lequel est créé le contrat ACCID 30 3 Identifiant du distributeur auprès du constructeur NB : doit être en concordance avec les identifiants saisis et/ou intégrés dans GC PLUS CODEDIST 30 4 N de contrat propre au distributeur ou n de livret DATECREA 20 5 Date de création du contrat DATEVENTE 20 6 Date de vente des produits du contrat CIVILITY 20 7 Les codes par défaut sont : '001 M., '002 Mme, '003 M lle, '004 S té NAME 255 8 Nom du consommateur FIRSTNAME 255 9 Prénom du consommateur TEL 255 10 Téléphone du consommateur GSM 255 11 Mobile du consommateur EMAIL 255 12 Email du consommateur HOMEADRESS 255 13 Adresse HOMEZIP 20 14 Code postal HOMECITY 100 15 Ville HOMECOUNTRY 20 16 Code du pays (voir recommandation de code ISO) LIVADRESS 255 17 Adresse de livraison LIVZIP 20 18 Code postal de livraison LIVCITY 100 19 Ville de livraison LIVCOUNTRY 20 20 Code pays de livraison REFCOM 50 21 Référence commerciale du produit REFTEC 50 22 Référence technique du produit SERIAL 128 23 N de série du produit DATESERVICE 20 24 () Date de mise en service du produit TYPEWAR 30 25 Code du type de garantie associé au produit (hors garantie de base) DURATION 3 26 () Durée de la garantie (en mois) Si la date de création du contrat n est pas saisie, c est la date de dépose qui sera prise en compte. () Si la date de Mise en Service n est pas renseignée, c est la date de vente de la Error! Reference source not found. qui sera prise en compte. Le code de type de garantie ne doit être renseigné que pour les extensions ajoutées à la garantie contractuelle. Il faut 1 Error! Reference source not found. par extension successive. ( ) Ce champ n est obligatoire que pour les garanties sur des produits du constructeur FAGORBRANDT. DOSSIER DE SPECIFICATIONS DETAILLEES page 18 / 23
Nom du champ Long. MAX CONTOPTOUT 1 27 CONSOPTOUT 1 28 Ordre Oblig. Description / commentaires Indicateur de relance pour proposer une extension à échéance de la garantie : 0 = pas de relance 1 (défaut si non renseigné) = relance Indicateur d autorisation de mailings commerciaux au consommateur : 0 (défaut si non renseigné) = pas de mailing 1 = mailing autorisé DOSSIER DE SPECIFICATIONS DETAILLEES page 19 / 23
5.1. Comment créer le fichier manuellement? Le format CSV peut être généré à partir de l application Microsoft Excel. La démarche est la suivante : Ouvrir l application Microsoft Excel et créer une nouvelle feuille de calcul Saisir une ligne par contrat, par produit et par type de garantie. Attention, toutes les lignes d un même contrat, autres que celles du produit et du type de garantie, doivent être strictement identiques. Le numéro de contrat «CODEDIST» est obligatoire pour que GCPlus puisse reconstituer le contrat. Lorsque la saisie est terminée, il est impératif de supprimer la ligne d entêtes de colonnes si toutefois elle avait été ajoutée. Pour finir, sauvegarder le fichier Excel pour en conserver une copie. Puis enregistrer le fichier au format CSV (Fichier -> Enregistrer sous -> dans le type choisir CSV). Puis déposer le fichier dans GCPlus. Attention, en cas de modification, nous déconseillons fortement d ouvrir le fichier CSV avec l application Microsoft Excel. La raison est qu Excel formate automatiquement les colonnes et peut tronquer les valeurs. Si des modifications doivent être effectuées, nous vous conseillons de les faire dans le fichier Excel original ou d ouvrir le fichier CSV avec un éditeur de texte standard (notepad, notepad++, UltraEdit ) 5.2. Dépose de contrats Le fichier peut être déposé à partir du site web ou par FTP si le client dépose d un accès. Les processus de traitement et de retour d erreur sont identiques à celui de la dépose classique. 6. Retour des contrats déposés Un retour est effectué après le traitement du fichier FTP. 6.1. Par fichier de compte rendu Format du nom : <nom fichier>_<date aaaammdd>.ack Création d un fichier ACK dans un dossier RETOUR : Si une erreur de format de fichier c est produit : le fichier contiendra uniquement un texte du style : «le fichier ne peut être interprété, ou son format est incorrect» Si la référence existe déjà : «Le fichier ne peut être intégré car un fichier de référence identique à déjà été déposé» Sinon liste des contrats et leur état, format : DOSSIER DE SPECIFICATIONS DETAILLEES page 20 / 23
Nom du champ Type Long. Oblig. Expl. Description longue et commentaires Pos Numero de Numéro de ligne de l entête de X10 10 0000000001 ligne contrat 1 Code constructeur X02 2 01 Code constructeur pour le suivi 11 Code Contrat Chaine 20 N de contrat généré par GCPLUS 13 Code N de contrat ou carte garantie Chaine 20 Distributeur généré par le distributeur 33 Etat X01 1 1 Etat du contrat (0 = non valide, 1 = valide) 53 Code erreur X06 6 Code erreur 54 Description erreur Chaine 512 Description de l erreur 60 DOSSIER DE SPECIFICATIONS DETAILLEES page 21 / 23
6.1.1. Liste des codes erreurs Code Description 9001 Le Distributeur ou l'adhérent n'existe pas ou son statut n'est pas actif 9002 La civilité n'existe pas 9003 La date de création de l'entête de contrat est supérieure à la date du jour La date de vente de l'entête de contrat est supérieure à la date du jour ou a dépassée la date 9004 limite de vente définie par le site 9005 La numéro de tel fixe n'est pas un numérique ou sa longueur dépasse les 10 caractères 9006 La numéro de tel mobile n'est pas un numérique ou sa longueur dépasse les 10 caractères 9007 Aucune adresse n'est renseignée 9008 Le pays n'existe pas 9009 Le type d'adresse n'existe pas 9010 Le code postal n'existe pas 9011 Le produit n'existe pas La date de vente du produit est supérieur à la date du début de la garantie ou a dépassée la 9012 date limite de vente définie par le constructeur 9013 Aucune garantie trouvé correspondant au code ou à la durée 9014 Impossible de définir les garanties associées au distributeur et à la durée totale de la garantie 9015 La garantie n'est pas active 9016 La garantie de base ne correspond pas avec la garantie indiquée 9017 L'extension est invalide 9018 Le numéro de série n'existe ou ne correspond pas aux règles constructeurs 9019 Le contrat n'accepte pas plusieurs marques 9020 La facturation ne peut pas être définie 9021 La durée de la garantie est obligatoire 9022 Le contrat n'accepte pas plusieurs produits 9023 Aucun prix trouvé pour cette garantie 9024 Le nom du consommateur n existe pas DOSSIER DE SPECIFICATIONS DETAILLEES page 22 / 23
6.2. Par Mailing Création d un mail en s appuyant sur l adresse indiqué dans la facturation du compte GCPlus. Origine : NoReply@Rte.fr Envoie : Adresse du compte GCPlus Objet : Rapport automatique du fichier <nomfichier> Sujet : Rapport de dépose du fichier <nomfichier> traité le <Datetraitement> à <heure de traitement> En cas de succès : Intégré sans anomalie : [Nb de contrats enregistrés : <N1>] [Nb de contrats d extensions créés : <N2>] [Nb de contrats en demande d annulation <N3>] En cas d erreur : Anomalie dans le fichier : [[Nb de contrats valide en attente d intégration : <N1>] [Nb de contrats incorrectes : <N2>]] [Le fichier ne peut être interprété, ou son format est incorrect] [Le fichier ne peut être intégré car un fichier de référence identique à déjà été déposé] DOSSIER DE SPECIFICATIONS DETAILLEES page 23 / 23