Dictionnaire de données
Le dictionnaire de données reprend tous les éléments contenus dans le fichier XML à fournir à Alp-Facturation.
Tous les noms de nœuds doivent être produits en minuscule.
Structure de base :
Le fichier XML doit avoir une déclaration avec un encodage au format UTF-8.
Le nœud "root" doit contenir l'attribut "email". Cet email correspond à l'email associé avec l'option e-commerce. En général c'est l'email de votre société.
Le nœud "root" encapsule le nœud "factures" qui va contenir chaque facture à générer.
Le nœud "facture" contient l'attribut "commande" (facultatif) qui permet d'identifier de manière unique chaque facture à générer.
En-tête d'une facture :
Le nœud "entete" (rattaché à un nœud "facture") comporte les données suivantes :
- numero : Numéro de la facture, si ce nœud n'est pas renseigné, alors le logiciel va générer le numéro de facture automatiquement ;
- date : Date d'émission de la facture au format JJ/MM/AAAA. Si aucune valeur n'est renseignée, alors la facture aura celle du jour de la génération ;
- type : Nombre entier : 0 pour une facture ou 1 pour un avoir. Si aucune valeur n'est renseignée, alors le type sera 0 ;
- type_libelle : Libellé du document. Si aucune valeur n'est renseignée, alors le libellé sera celui définit dans le logiciel ;
- reglement_web_code : Le web code du mode de règlement de la facture. Si aucune valeur n'est renseigneé, alors le mode de règlement utilisé sera celui par défaut du logiciel ;
- remarque : Remarque sur la facture ;
- commentaire_client (Section Data) : Commentaire adressé au client ;
- commentaire_perso (Section Data) : Commentaire interne ;
- info_legale (Section Data) : Informations légales.
Remarque : Aucun de ces champs n'est obligatoire.
En-tête d'une facture, nœud client :
Dans le nœud "entete" vous devez avoir un nœud "client" qui comporte les informations sur le client.
- numero : Numéro du client dans Alp-Facturation, si ce nœud n'est pas renseigné, alors le logiciel va générer le numéro de client automatiquement ;
- civilite : Civilité du client ;
- nom (Obligatoire) : Nom du client ;
- adresse (Section Data) : Adresse du client ;
- cp : Code postal du client ;
- ville : Ville du client ;
- tel : Téléphone du client ;
- fax : Télécopieur du client ;
- email : Adresse email du client ;
- site_internet : Site internet du client ;
- reglement_web_code : Le web code du mode de règlement par défaut du client. Si aucune valeur n'est renseignée, alors le mode de règlement utilisé sera celui par défaut du logiciel ;
- type_web_code : Le web code du type de client. Si aucune valeur n'est renseignée, alors le type de client utilisé sera celui par défaut du logiciel ;
- tva_intracommunautaire : Code de TVA intracommunautaire du client ;
- commentaire (Section Data) : Commentaire sur le client.
Remarque : si le nœud "numero" est renseigné avec un numéro de client existant, alors sa fiche sera mise à jour avec les données fournies.
En-tête d'une facture, nœud reference :
Dans le nœud "entete" vous devez produire un nœud "references" qui contient des nœuds "reference".
- libelle : Nom de la référence ;
- type : Le type de référence ;
- valeur : Valeur de la référence, utile uniquement si le type est 4 ;
- ordre : Ordre d'affichage des références (nombre entier de 1 à n).
Liste des types :
1 : Numéro de document,
2 : Date du document,
3 : Numéro du client,
4 : Texte personnel,
5 : TVA Intra-communautaire du client,
6 : Mois du Document,
7 : Trimestre du document,
8 : Année du document.
Corps de la facture :
Le nœud "corp" (rattaché à un nœud "facture") comporte des nœuds "ligne" qui correspondent à chaque ligne d'une facture. Tous les champs de types nombres doivent être complétés.
- numero_ligne : Ordre d'affichage des désignations (nombre entier de 1 à n) ;
- reference : Référence de l'article ;
- designation (Section Data) : Désignation de l'article ;
- qte (Nombre au format 1234.78) : Nombre de désignation vendues ;
- unite : Chaine contenant l'unité de l'article ;
- pu_ht (Nombre au format 1234.78) : Prix unitaire HT de l'article ;
- pu_ttc (Nombre au format 1234.78) : Prix unitaire TTC de l'article ;
- remise_taux (Nombre au format 1234.78) : Taux de remise sur l'article ;
- remise_ht (Nombre au format 1234.78) : Montant de la remise HT ;
- remise_ttc (Nombre au format 1234.78) : Montant de la remise TTC ;
- taux_tva (Nombre au format 1234.78) : Taux de TVA ;
- montant_tva (Nombre au format 1234.78) : Montant de TVA ;
- montant_ht (Nombre au format 1234.78) : Montant HT ;
- montant_ttc (Nombre au format 1234.78) : Montant TTC ;
- colonne_personalisee (Section Data).
Remarque : Si le champ référence correspond à une référence du logiciel, alors la ligne sera rattachée à l'article dans le logiciel et permettra de gérer le stock, statistiques sur l'article.
Actions à effectuer sur la facture :
Le nœud "actions" (rattaché à un nœud "facture") comporte des nœuds "imprimer", "pdf", "mail" correspondent aux actions à effectuer après l'enregistrement de la facture.
Le nœud "imprimer" :
- actif (0 ou 1) : 0 demande de ne pas imprimer la facture, 1 demande de l'imprimer ;
- copies (Nombre entier) : Nombre de copies à imprimer.
Le nœud "pdf" :
- actif (0 ou 1) : 0 demande de ne pas exporter la facture en PDF la facture, 1 demande de l'exporter ;
- destination (Obligatoire si actif) : Dossier existant sur le poste qui va faire la synchronisation.
Le nœud "mail" :
- actif (0 ou 1) : 0 demande de ne pas envoyer la facture par email , 1 demande de l'envoyer ;
- destinataire : Adresse email de la personne qui va recevoir la facture (si vide, l'email du client sera utilisé) ;
- objet : Objet du message email ;
- message (Section Data) : Message contenu dans l'email.
Informations complémentaires
|
Fiches de la même rubrique
|