Description du fichier des pièces au format XML
Section Entête (une section par pièce)
La balise générale pour chaque pièce à importer est <PIECE>, les sous balises à utiliser pour les données de l'en-tête sont de même code que les champs du format CSV décrit ici pièces de ventes si format CSV
Les balises obligatoires pour un en-tête sont les mêmes que pour un fichier CSV : TYPE et CLIENT_CODE, sauf que l'on n'a pas besoin de la zone IDENT car le lien entre les en-têtes et les lignes de chaque pièce est fait par le contenu du XML : une balise PIECE va contenir les zones de l'en-tête puis on aura une sous balise LIGNE pour chaque ligne de la pièce, puis la balise de fin de la pièce </PIECE>, puis la balise de début de la pièce suivante <PIECE>.
Une autre différence avec les fichiers CSV est que l'on peut aussi intégrer des balises pour les adresses de facturation et de livraison de chaque pièce importée. Pour cela on a une sous balise <adresse> avec dedans une balise du type d'adresse <STYPE>, de contenu "Facturation" ou "Livraison" pour adresse de facturation ou de livraison.
Cf en bas de cette page le fichier exemple pour voir comment est organisé ce fichier XML.
Section pour les lignes (une section par ligne de pièce)
La balise de cette section est <LIGNE>, les sous balises à utiliser ont pour code les codes de champ comme définis dans le cas du fichier CSV. Seule différence avec le cas du fichier CSV : pas besoin du champ ENTETE_IDENT, les sous balises des lignes étant intégrées à l'intérieur des balises PIECE.
Section pour les adresses (une section pour l'adresse de facturation, et une pour l'adresse de livraison si différente)
La balise de cette section est <adresse>, ci-dessous les sous balises à utiliser. Avec le format XML lors de l'import des pièces vous pouvez intégrer des sous balises adresse si vous souhaitez créer de nouvelles adresses pour des clients, pour les pièces à importer. Dans ce cas le traitement crée les adresses pour le client puis il affecte ces adresses (facturation et / ou livraison) à la pièce créée lors de l'import.
Si vous ne voulez pas de nouvelles adresses dans les pièces importées ne mettez pas de sous balise adresse, dans ce cas les pièces auront comme adresse de facturation et de livraison les 2 adresses par défaut des fiches clients.
| BALISE | DESCRIPTION | TYPE | LG. MAX |
| STYPE | Type (= "Facturation" ou "Livraison") | Chaîne | 12 |
| NOM | Nom | Chaîne | 45 |
| ADRESSE | Adresse | Chaîne | 40 |
| ADRESSE2 | Adresse 2 | Chaîne | 40 |
| CP | Code postal | Chaîne | 15 |
| VILLE | Ville | Chaîne | 30 |
| REGION | Région | Chaîne | 40 |
| PAYS | Pays | Chaîne | 40 |
| TEL | Téléphone | Chaîne | 50 |
| MOBILE | Mobile | Chaîne | 50 |
| FAX | Fax | Chaîne | 50 |
| Chaîne | 255 |
Exemple de fichier XML : (exemple)
<?xml version="1.0" encoding="UTF-8"?>
<DataSet xmlns="http://tempuri.org/">
<NewDataSet xmlns="http://tempuri.org/data.xsd">
<PIECE>
<CLIENT_CODE>PIGN</CLIENT_CODE>
<TYPE>C</TYPE>
<WEB_ID>00660</WEB_ID>
<DESIG>Petit matériel</DESIG>
<DATE_CREATION>22/07/2024</DATE_CREATION>
<DATE_LIVRAISON>22/07/2024</DATE_LIVRAISON>
<TAUX_REMISE>20.00</TAUX_REMISE>
<TAUX_ESCOMPTE>0.00</TAUX_ESCOMPTE>
<GCPREG_CODE>CHQ</GCPREG_CODE>
<PORT_HT>8,00</PORT_HT>
<PORT_TVA_CODE>NORM</PORT_TVA_CODE>
<FRAIS_HT>11</FRAIS_HT>
<FRAIS_TVA_CODE>NORM</FRAIS_TVA_CODE>
<ECOTAXE>0</ECOTAXE>
<GCPEXP_CODE></GCPEXP_CODE>
<GCPTRA_CODE></GCPTRA_CODE>
<NBRE_JOURS>20</NBRE_JOURS>
<ARRETE>F</ARRETE>
<DECALAGE>5</DECALAGE>
<MONNAIE>EUR</MONNAIE>
<VALID>1</VALID>
<GCPREGM_CODE>ASSUJ</GCPREGM_CODE>
<adresse>
<STYPE>Facturation</STYPE>
<NOM>Société PIGNON</NOM>
<ADRESSE>969 route de Pégomas</ADRESSE>
<ADRESSE2>Bât A, P6</ADRESSE2>
<CP>06130</CP>
<VILLE>GRASSE</VILLE>
<REGION>PACA</REGION>
<PAYS>France</PAYS>
<TEL>+33 4 99 88 77 66</TEL>
<MOBILE>06 15 19 33 33</MOBILE>
<FAX>+33 4 99 88 77 60</FAX>
<EMAIL>info_tech@email.com</EMAIL>
</adresse>
<adresse>
<STYPE>Livraison</STYPE>
<ADRESSE>10 avenue de la plaine</ADRESSE>
<ADRESSE2>Bat C</ADRESSE2>
<CP>06250</CP>
<VILLE>MOUGINS</VILLE>
<PAYS>France</PAYS>
<TEL>04 97 21 90 90</TEL>
<EMAIL>infos@pignon.fr</EMAIL>
</adresse>
<LIGNE>
<NUMERO>1</NUMERO>
<ARTICLE_WEB_CODE>UNIPINC</ARTICLE_WEB_CODE>
<DESIG>Pince universelle</DESIG>
<QTE>1.00</QTE>
<PUHT>9,00</PUHT>
<TAUX_REMISE>0.00</TAUX_REMISE>
<GCPTVA_CODE>NORM</GCPTVA_CODE>
<GCPTPF_CODE></GCPTPF_CODE>
<GCPDEPOT_CODE></GCPDEPOT_CODE>
</LIGNE>
<LIGNE>
<NUMERO>2</NUMERO>
<ARTICLE_WEB_CODE>PLBPIT</ARTICLE_WEB_CODE>
<DESIG>Planche pin teintée</DESIG>
<QTE>20.00</QTE>
<PUHT>79,28</PUHT>
<TAUX_REMISE>0.00</TAUX_REMISE>
<GCPTVA_CODE>RED</GCPTVA_CODE>
</LIGNE>
<LIGNE>
<NUMERO>3</NUMERO>
<DESIG>Commentaire</DESIG>
<QTE>0.00</QTE>
<TAUX_REMISE>0.00</TAUX_REMISE>
</LIGNE>
</PIECE>
<PIECE>
<TYPE>D</TYPE>
<WEB_ID>#61</WEB_ID>
<DATE_CREATION>23/07/2024</DATE_CREATION>
<CLIENT_CODE>BONH</CLIENT_CODE>
<TAUX_REMISE>20.00</TAUX_REMISE>
<TAUX_ESCOMPTE>0.00</TAUX_ESCOMPTE>
<GCPREG_CODE>CB</GCPREG_CODE>
<PORT_HT>8,00</PORT_HT>
<ECOTAXE>0</ECOTAXE>
<DECALAGE>0</DECALAGE>
<NBRE_JOURS>0</NBRE_JOURS>
<MONNAIE>USD</MONNAIE>
<VALID>0</VALID>
<adresse>
<STYPE>Livraison</STYPE>
<ADRESSE>170 chemin des Roses</ADRESSE>
<ADRESSE2>Bat. B</ADRESSE2>
<CP>06250</CP>
<VILLE>MOUGINS</VILLE>
<PAYS>France</PAYS>
<TEL>04 97 21 60 90</TEL>
<EMAIL>demande@bonh.fr</EMAIL>
</adresse>
<adresse>
<STYPE>Facturation</STYPE>
<ADRESSE>969 route de Pégomas</ADRESSE>
<ADRESSE2>Bât A</ADRESSE2>
<CP>06130</CP>
<VILLE>GRASSE</VILLE>
<PAYS>France</PAYS>
<MOBILE>06 15 19 34 99</MOBILE>
</adresse>
<LIGNE>
<NUMERO>001</NUMERO>
<ARTICLE_WEB_CODE>ARDNAT</ARTICLE_WEB_CODE>
<DESIG>Ardoise naturelle</DESIG>
<QTE>15</QTE>
<PUHT>20.81</PUHT>
<TAUX_REMISE>0.00</TAUX_REMISE>
</LIGNE>
<LIGNE>
<NUMERO>002</NUMERO>
<DESIG>Commentaire suppl.</DESIG>
</LIGNE>
</PIECE>
</NewDataSet></DataSet>