Connecteur Sage

Connecteur permettant la création d’un fichier CSV pour Sage comportant des informations relatives à une facture.

Format du fichier CSV

Le fichier CSV produit par ce connecteur contient les champs dans l’ordre de la table ci-dessous. Le caractère séparateur de champ est “;“, sans échappement des chaînes de caractères. Les nombres sont au format français, sans séparateur des milliers (“1234,56” par ex).

Champ CSV	Description
Nom du journal	Nom du journal à utiliser (“ACH“, par ex.)
Date de la facture	Date de la facture au format YYYYMMDD
Date d’échéance	Date d’échéance de la facture au format YYYYMMDD
Numéro chronologique	Identifiant unique (Id du document Workey, par ex)
Numéro de la facture	Numéro indiqué sur la facture
Compte à imputer	Numéro d’imputation comptable
Code fournisseur	Identifiant du fournisseur (présent seulement sur la première ligne)
Libellé de l’écriture	Libellé de l’écriture
Montant TTC	Montant TTC de l’entrée
Débit/Crédit	Indique si l’entrée est une opération de débit ou crédit (“D” ou “C“)
Moyen de paiement	Code du moyen de paiement (entier)
Devise	Code de la devise (“EUR“, par ex)
Cours de la devise	Cours de la devise (“1” si aucune conversion n’est nécessaire)
Total devise	Résultat de l’opération Montant TTC * Cours devise
Bon à payer	Indique si la facture est validée pour paiement (“OUI” ou “NON“)

Champs CSV exportés par le connecteur

Appel du connecteur

Classe : com.clog.workey.connectors.sage.ExportSage

Paramètres d’entrée

1. Champ ayant comme valeur un objet JSON comportant la configuration des différents champs à utiliser.

Valeurs de sortie

1. (Aucune)

Configuration

Propriétés systèmes

Plusieurs propriétés systèmes peuvent être configurées dans le fichier $TOMCAT/conf/catalina.properties pour définir des valeurs par défaut à utiliser :

• com.clog.workey.connectors.ExportSage.exportDir : Répertoire où seront créés les fichiers CVS pour Sage (par défaut $TOMCAT/workey/sage/)
• com.clog.workey.connectors.ExportSage.journal : Nom par défaut du journal si aucun champ journal n’est présent dans le formulaire (“ACH“, par ex).
• com.clog.workey.connectors.ExportSage.compteTiers : Compte tiers par défaut si aucun champ n’est présent dans le formulaire.

Configuration JSON

La configuration permet d’effectuer un “mapping” entre les champs présents dans le formulaire Workey et les champs attendus dans le CVS Sage. Pour chaque propriété, il est possible d’indiquer le nom du champ qui lui correspond. Sinon, le nom de champ par défaut et/ou la valeur par défaut sera utilisé.

{
  "codeFournisseur": "Fournisseur",
  "compteGeneral": "Compte_debit",
  "devise": "Monnaie"
}

Liste des propriétés

Propriété	Nom du champ par défaut	Observations
journal	Journal	propriété com.clog.workey.connectors.ExportSage.journal
compteTiers	Compte_tiers	propriété com.clog.workey.connectors.ExportSage.compteTiers
compteGeneral	Compte_general
dateFacture	Date_facture
dateEcheance	Date_echeance
numeroFacture	Numero_facture
codeFournisseur	Code_fournisseur
libelleEcriture	Libelle_ecriture
montant	Montant_TTC	valeur par défaut : 0
detailMontant	Montant_net	champ multivalué
detailCompte	Compte_general	champ multivalué
detailLibelle	Libelle	champ multivalué
modePaiement	Moyen_paiement
devise	Devise	valeur par défaut : EUR
coursDevise	Cours_devise	valeur par défaut : 1
bonAPayer	Bon_a_payer	valeur par défaut : false
tvaIntracommunautaire	TVA_Intracommunautaire	valeur par défaut : false
compteTvaIntraCredit	Compte_TVA_intra_credit
compteTvaIntraDebit	Compte_TVA_intra_debit
typeFacture	Type_facture	valeurs possibles : INVOICE (facture) ou CREDIT NOTE (avoir)

Propriétés pour la correspondance Workey/CSV

En plus de ces propriétés utilisées pour la correspondance entre les champs Workey et les champs CSV, il est possible de redéfinir le nom du fichier de sortie avec la propriété “fileTemplate“. Sa valeur par défaut est “ExportSage-%s.csv“, où le “%s” représente la date (au format YYYYMMDD). Par conséquent, un seul fichier d’export par jour est créé, qui va contenir toutes les factures traitées dans la journée.

Attention

Si la propriété “fileTemplate” est redéfinie, la marque “%s” doit toujours être présentes.

TVA Intracommunautaire

Si la propriété “tvaIntracommunautaire” est à “true“, deux lignes supplémentaires seront créés dans le fichiers CSV : l’une pour l’opération de crédit avec le compte d’imputation indiqué par la propriété “compteTvaIntraCredit” et l

Limitations

Actuellement, la ventilation de la facture sur plusieurs compte n’est pas supportée.GitbucketICescrum

• Étiquettes

• Connecteur

---