Connexion COTEC >> SYDONIA OTR

FORMAT FICHIER XML ENVOYE PAR COTEC VERS BRIDGE SYDONIA

Pierre Liroulet | Société COTEC | 11 juillet 2020

Table des matières

Introduction ............................................................................................................................................................................................. 2
Demandes de l’OTR prise en compte par COTEC ............................................................................................................................... 2
Remarque sur l’envoi des fichiers XML ................................................................................................................................................. 5
Annexe → format XML préliminaire fourni par OTR .......................................................................................................................... 6

PAGE 1
Introduction

Ce document décrit les réponses COTEC et les questions qui restent à résoudre à la suite de la communication par l’OTR du
fichier XML d’envoi des données d’évaluations.

Remarques : ce qui est statué par l’OTR et validé par COTEC lors de notre dernière réunion →
• L’envoi des données d’évaluation se fera par SFTP via un fichier XML

• Globalement, le format XML proposé par l’OTR convient parfaitement à COTEC

• Il reste à définir précisément quelques points sur le contenu des données XML afin que les 2 systèmes se
comprennent sans ambiguïté

• Enfin, COTEC devra demander aux contribuables des données supplémentaires exigé par l’OTR (données déclarant)

Demandes de l’OTR prise en compte par COTEC

Les questions restant à statuer par l’OTR sont surlignées en orange ci-dessous :

• <Ctc_ref/> → N°ADV

o Ce numéro est unique et peut servir de clé primaire

• <parc/> → Question ?

o COTEC peut envoyer :

▪ Soit le nom complet du parc (Ex : SAMIMAR)
▪ Soit notre clé primaire interne

o Ci-joint notre « table des parcs » pour examen par OTR

o Attention, nous gérons aussi le « parc sans manifeste » pour les véhicules TOGO

• <Type_of_declaration> → C/T/TD

o C pour “consommation”
o T pour “transit”
o TD pour “transit direct”

• <Country_of_origin> → Pays de fabrication de la voiture

o COTEC doit ajouter cette donnée dans son système

o Nous enverrons le nom complet du pays

PAGE 2
• <Export_country> → Pays de provenance de la voiture

o COTEC doit ajouter cette donnée dans son système

o Nous enverrons le nom complet du pays

• <Destination_country> → Pays d’exportation de la voiture

o Cas TRANSIT, vide en CONSO

o Donnée codifiée de type « table des pays » (principalement pays Africain)
o Ci-joint notre table pour examen par OTR

• <Destination_border> → Frontière d’exportation de la voiture – à ajouter ?

o Cas TRANSIT, vide en CONSO

o Codification des postes frontière du TOGO – exemple :
▪ CK, CINKASSE
▪ …
o Même codification que celle utilisée à STCA et aux transports routiers
o Ci-joint notre table pour examen par OTR

• Remarque sur les données de « type Pays » ?

o COTEC gère ces données avec une table ISO (norme internationale) pour laquelle la clé primaire est codée
sur 3 caractères
o COTEC peut envoyer :
▪ Soit le nom complet du Pays (Ex : ALLEMAGNE)
▪ Soit notre clé primaire ISO interne (Ex : GER)
o Ci-joint notre « table des pays » (principalement pays Africain) pour examen par OTR

• <Vehicle_Date_Circ> → Date de mise en circulation du véhicule (sur carte grise)

o Possible uniquement sur les véhicules arrivés avec carte grise (60% de perte de C.G. environ)
o COTEC doit ajouter cette donnée dans son système

• <Vehicle_chassis> → VIN ou N° série du véhicule (de 3 à 17 caractères max.)

o Ce numéro est unique et peut servir de clé primaire

• <Vehicle_categorie> → Types de véhicules correspondant aux différents frets

o VOITURE
o 4x4
o CAMION PORTEUR
o CAMION TRACTEUR
o BTP (engin de chantier)
o AGRICOLE (tracteur, …)
o REMORQUE

PAGE 3
• <Vehicle_boite_vitesse> → Transmission – valeurs possibles :

o MANUELLE
o AUTOMATIQUE
o Si inconnu → vide

• <Vehicle_energy> → Carburant – valeurs possibles :

o ESSENCE
o DIESEL
o HYBRIDE
o ELECTRIQUE
o Si inconnu → vide

• <Vehicle_cylindre> → Cylindrée moteur – valeurs possibles :

o Soit en cm3 (ex : 1995)

o Soit en L (ex : 1.9)
o Si inconnu → vide

• <Vehicle_motricite> et <Vehicle_equipement> → ne sont renseignés que pour les camions (vide sinon)

• <Valeur_neuve> → ne peut être fourni que pour les véhicules EUROPEEN > 1995 (vide sinon)

o COTEC doit ajouter cette donnée dans son système

• <DECLARANT> → Ne fait pas parti du processus actuel d’évaluation

o COTEC doit demander aux déclarants de fournir la carte d’identité du déclarant

o COTEC doit ajouter cette donnée dans son système

o L’OTR doit envoyer à COTEC une circulaire nous permettant de justifier l’exigence de cette pièce

o L’OTR peut-il fournir sa table « déclarant » à COTEC pour que nous puissions l’introduire dans notre
système ?

• <Nationalite_proprietaire> → appelé chez nous « pays de résidence »

o Donnée codifiée de type « table des pays » (principalement pays Africain)

o Ci-joint notre table pour examen par OTR

• <Nationalite_importateur> → nous proposons d’ajouter cette même donnée pour l’importateur

o Donnée codifiée de type « table des pays » (principalement pays Africain)

o Ci-joint notre table pour examen par OTR

PAGE 4
Remarque sur l’envoi des fichiers XML

Trois opérations envoyées par le serveur COTEC doivent être prises en compte par l’application de l’OTR :

• INSERT → création de l’enregistrement d’évaluation (1ère fois car inexistant)

• UPDATE → mise à jour d’un enregistrement d’évaluation déjà existant (pour prendre en compte les changements
possibles : acheteur, destination, régime, dépréciation, …)

• DELETE → cas d’une évaluation erronée à supprimer physiquement de la BD de l’OTR

Nous proposons donc d’ajouter un « type action » ou « code action » ou autre en début de fichier XML qui peut contenir les
trois valeurs suivantes : INSERT, UPDATE, DELETE

PAGE 5
Annexe → format XML préliminaire fourni par OTR

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

<COTEC_SYDONIA>
<CTC>
<Ctc_ref/>
<Ctc_dat>5/26/20</Ctc_dat>
<parc/>
<Type_of_declaration>IM</Type_of_declaration>
<Country_of_origin>JP</Country_of_origin>
<Export_country>VN</Export_country>
<Destination_country>TG</Destination_country>
<Poids>FR</Poids>
</CTC>
<Vehicle>
<Vehicle_chassis>MM12121</Vehicle_chassis>
<Vehicle_mark>HYUNDAI</Vehicle_mark>
<Vehicle_model>dDz</Vehicle_model>
<Vehicle_Date_Circ>5/26/20</Vehicle_Date_Circ>
<Vehicle_Annee>2010</Vehicle_Annee>
<Vehicle_puissance_moteur>4</Vehicle_puissance_moteur>
<Vehicle_puissance_fiscal>4</Vehicle_puissance_fiscal>
<Vehicle_categorie>VOITURE</Vehicle_categorie>
<Vehicle_boite_vitesse>MANUELLE</Vehicle_boite_vitesse>
<Vehicle_motor>SQDSQC</Vehicle_motor>
<Vehicle_energy>ESSENCE</Vehicle_energy>
<Vehicle_cylindre>2010</Vehicle_cylindre>
<Vehicle_nbre_siege>4</Vehicle_nbre_siege>
<Vehicle_nbre_porte>4</Vehicle_nbre_porte>
<Vehicle_gamme>VOITURE</Vehicle_gamme>
<Vehicle_finition>MANUELLE</Vehicle_finition>
<Vehicle_segment>SQDSQC</Vehicle_segment>
<Vehicle_motricite>MANUELLE</Vehicle_motricite>
<Vehicle_equipement>SQDSQC</Vehicle_equipement>
</Vehicle>
<VALEUR>
<Valeur_imposable>400.0</Valeur_imposable>
<Valeur_neuve>400</Valeur_neuve>
<Valeur_reference>400</Valeur_reference>
<Depreciation>400.0</Depreciation>
<Abbatement>400</Abbatement>
<Fret>400</Fret>
</VALEUR>
<IMPORTATEUR>
<Code_importateur>TG1000271462</Code_importateur>

PAGE 6
 <Nom_importateur>LE LEVANT
AZAR CHARBEL ADEL
RUE DES PARCS AUTO - PORT LOME
1801
92501916</Nom_importateur>
</IMPORTATEUR>
<DECLARANT>
<Code_declarant>TG1984194322</Code_declarant>
<Nom_declarant>STE
ROUTE D'ANEHO PK 105
ZONE PORTUAIRE</Nom_declarant>
</DECLARANT>
<PROPRIETAIRE>
<Code_proprietaire>TG1984194322</Code_proprietaire>
<Nom_proprietaire>STE
ROUTE D'ANEHO PK 105
ZONE PORTUAIRE</Nom_proprietaire>
<Nationalite_proprietaire>CN</Nationalite_proprietaire>
</PROPRIETAIRE>
</COTEC_SYDONIA>

PAGE 7