EOinvoice
Web-service - Mode d’emploi

Première utilisation par un magasin:

° Se rendre dans le menu Web-service
° Entrer l’URL du fichier XML de définition du magasin


IL DOIT IMPERATIVEMENT SE NOMMER "store.xml" !

Le fichier XML se présente comme suit:
<?xml version="1.0"?> <store> <info> <name>BTP Direct</name> <taxnumber>FR46842523</taxnumber> <email>btpdirect@mail.com</email> <type>SARL</type> <capital>10000</capital> <acceptcheck>1</acceptcheck> </info> <address> <street>5 bis, rue du pont de Lattes</street> <suburb/> <city>Montpellier</city> <postcode>34000</postcode> <state/> <country>France</country> <phone>0425659856</phone> <telecopy>0456873215</telecopy> </address> <bank> <frbank>45678</frbank> <frreg>98765</frreg> <fraccount>65487</fraccount> <frkey>23</frkey> <iban>123456789</iban> <bic>321564897</bic> </bank> </store>

Au terme de cette procédure le magasin est enregistré en base de données et deux informations sont fournies à l'utilisateur:

° Un identifiant unique (uniqid)
° Une clé de cryptage


Ces informations sont à noter et à conserver !
Dès lors, le magasin peut transférer ses commandes sous forme d'un fichier XML construit de cette manière:
<?xml version="1.0"?> <purchase> <customer id="2"/> <cart> <item class="product"> <name>Ballon orange</name> <desc>Un ballon haute qualité avec revêtement PVC - Couleur orange</desc> <ref>BA256DF23</ref> <qty>4</qty> <weight>0.5</weight> <tax>19.6</tax> <discount>0</discount> <pricenotax>20</pricenotax> </item> <item class="product"> <name>Souris Labtec</name> <desc>Souris filaire à pointeur IR, 3 boutons + molette de défilement - Couleur grise</desc> <ref>SRM4587LAB</ref> <qty>1</qty> <weight>2</weight> <tax>19.6</tax> <discount>0</discount> <pricenotax>15</pricenotax> </item> </cart> </purchase>

Ce fichier doit être impérativement nommé de la manière suivante:
[uniqid].xml
où [uniqid] doit être remplacé par l'identifiant unique du magasin, fourni à l'étape précédente.

----------------------------------------------------------------
Une fois le fichier correctement nommé, il est nécessaire de le crypter;
La fonction suivante permet d'effectuer ce traitement:
----------------------------------------------------------------
function crypt_purchase($file, $file_output, $key) { // Lecture du fichier $huge_string = file_get_contents($file,'r'); // Choix d'un algo, mode (couple) $algo = 'blowfish'; // ou la constante php MCRYPT_BLOWFISH $mode = 'nofb'; // ou la constante php MCRYPT_MODE_NOFB // Calcul des longueurs max de la clé et de l'IV $key_size = mcrypt_module_get_algo_key_size($algo); // 56 $iv_size = mcrypt_get_iv_size($algo, $mode); // 8 // Création d'un IV aléatoire de la bonne longueur // N'importe quoi du moment qu'il est de la bonne longueur $iv = mcrypt_create_iv($iv_size, MCRYPT_RAND); // Choix d'une clé secrète de cryptage/décryptage et mise à longueur si trop longue $key = substr($key, 0, $key_size); // On encrypte $huge_string_crypt = mcrypt_encrypt($algo, $key, $huge_string, $mode, $iv); // On crée un fichier de sortie $file_crypt = fopen($file_output, 'w+'); // On met le IV au début du fichier ($iv_size caractères) puis le reste du fichier, cripté fputs($file_crypt, $iv.$huge_string_crypt); // On ferme le fichier fclose($file_crypt); }
L'argument $key doit être remplacé par la clé fournie lors de l'inscription du magasin.
----------------------------------------------------------------

Dernière étape:

° Se rendre dans le menu Web-service
° Entrer l’URL du fichier XML de définition de la commande

Une facture a été générée !