📍 Où trouver ce module ?
Menu principal > Points de vente > Boutiques en ligne
Vous vendez en ligne ? Kafinea se connecte à votre boutique e-commerce pour synchroniser automatiquement votre catalogue et vos commandes, dans les deux sens, sans double saisie.
La connexion repose sur un connecteur adapté à votre solution e-commerce, à sélectionner parmi les types de boutique disponibles dans Kafinea. Cette page présente les réglages et les usages communs. La manière d’obtenir les accès de connexion dépend de votre solution.
1. Ce qui est synchronisé #
La synchronisation fonctionne dans les deux sens.
De Kafinea vers votre boutique (catalogue) :
| Élément | Détail |
|---|---|
| Catégories de la boutique | Publiées dans la boutique, avec leur arborescence |
| Articles | Uniquement ceux marqués « en vente en ligne » (référence, prix hors taxe, nom et description, images) |
| Stock | Quantité disponible d’un emplacement de stockage dédié au e-commerce |
| TVA | Le taux de TVA de chaque article est associé à la règle de taxe correspondante de la boutique |
De votre boutique vers Kafinea (commandes) :
| Élément | Détail |
|---|---|
| Commandes | Chaque commande en ligne devient un bon de commande dans Kafinea |
| Mode de paiement | Le moyen indiqué par la boutique est associé au mode Kafinea choisi sur la fiche boutique |
| Catégories de la boutique | Reprises à l’identique lors d’un import de catalogue, avec leur arborescence |
| Clients | Le client et son contact sont créés ou rattachés automatiquement, et leurs coordonnées actualisées |
| Lignes | Chaque ligne conserve son prix d’origine, sa remise et son taux de TVA |
| Bons de réduction | Repris sur une ligne de remise dédiée, par taux de TVA |
| Frais de port | Selon les fonctions du connecteur, répartis entre les articles de port configurés selon la nature des articles commandés |
| Région fiscale | Proposée selon l’adresse de livraison et les règles configurées, sans remplacer les taxes historiques de la boutique |
2. Les catégories de la boutique #
Le classement marchand de votre boutique est géré dans une liste dédiée, Catégories boutique en ligne : chaque catégorie appartient à une boutique et conserve sa catégorie parente, comme sur votre site.
Ce classement est distinct des familles d’articles, et c’est volontaire : la famille d’articles sert à la gestion (stratégies comptables, comptes de TVA, seuils de taux de marque, tableaux de bord). Vos rubriques de vente en ligne peuvent donc évoluer librement, sans jamais toucher à votre paramétrage comptable.
Concrètement :
- un même article peut figurer dans plusieurs catégories, et être classé différemment sur chaque boutique ;
- ses catégories s’ajoutent et se retirent depuis la fiche article, dans la liste liée Catégories boutique en ligne ;
- lors d’un import de catalogue, la boutique fait référence : Kafinea aligne les catégories de cette boutique sur les vôtres, sans jamais toucher à celles d’une autre boutique ;
- la fiche boutique permet de choisir ce que Kafinea publie comme catégories : les catégories de la boutique ou les familles d’articles, si vous préférez conserver ce fonctionnement.
Bon à savoir : les articles importés depuis une boutique arrivent sans famille d’articles : aucune valeur n’est appliquée par défaut, car la famille détermine la comptabilisation. Le cockpit de la fiche boutique affiche le nombre d’articles en ligne encore sans famille, pour que vous les qualifiiez en une passe.
3. Qui crée les articles ? #
Deux organisations sont possibles, et vous choisissez la vôtre sur la fiche de chaque boutique.
Cas 1 : la boutique peut créer les articles (réglage Créer les articles depuis la boutique activé, comportement par défaut). Si une commande fait référence à un article inconnu de Kafinea, sa fiche est créée automatiquement depuis la boutique. Pratique pour démarrer vite ; la famille d’articles reste à renseigner ensuite.
Cas 2 : le catalogue est géré dans Kafinea (réglage désactivé). Vous créez vos articles dans Kafinea, avec leur famille d’articles et leur paramétrage comptable, puis vous les créez dans la boutique. La boutique se contente alors de lire votre catalogue :
- c’est le code article ou le code-barres qui identifie l’article, jamais son libellé ;
- si le libellé ou la description diffèrent entre la boutique et Kafinea, c’est la fiche de Kafinea qui est conservée sur le bon de commande ;
- le prix reste celui de la boutique, repris tel quel sur la ligne de commande ;
- vos articles arrivent toujours avec la bonne famille d’articles, puisque c’est vous qui les créez ;
- le bouton d’import de catalogue disparaît de l’écran de synchronisation, la boutique n’étant plus autorisée à alimenter votre base articles.
Rapprochement par libellé. Un second réglage, Rapprocher les articles par libellé, détermine si Kafinea peut, en dernier recours, reconnaître un article par son libellé exact lorsque ni le code article ni le code-barres n’ont permis de l’identifier. Sur une base articles importante, deux articles différents peuvent porter le même libellé : désactivez ce réglage si vos codes sont fiables, pour que seuls le code article et le code-barres fassent foi.
L’écran de synchronisation de la boutique rappelle en permanence l’organisation retenue et les clés utilisées pour rapprocher les lignes de commande.
4. Article introuvable : comment le repérer #
Lorsqu’une commande fait référence à un article que Kafinea ne trouve pas dans votre gestion commerciale, la ligne est rattachée à l’article de repli indiqué sur la fiche boutique, afin que rien ne soit perdu de la commande. Trois repères vous permettent de traiter ces cas :
- sur le bon de commande, la ligne concernée porte un commentaire explicite indiquant que l’article n’a pas été trouvé, avec le libellé, le code et le code-barres transmis par la boutique ;
- sur l’écran de synchronisation, la carte Documents à revoir liste les documents importés contenant au moins une ligne de ce type ;
- dans la liste des lignes de documents, un lien depuis cette carte affiche l’ensemble des lignes rattachées à l’article de repli, pour un traitement en une passe.
La marche à suivre est toujours la même : créez l’article manquant dans Kafinea (ou corrigez son code dans la boutique), puis corrigez la ligne du document.
Bon à savoir : cette liste est calculée à partir des documents eux-mêmes. Elle reste donc consultable bien après la synchronisation qui a créé les documents, contrairement aux messages du dernier passage.
5. Qui crée les clients ? #
Comme pour le catalogue, vous décidez sur la fiche de chaque boutique si votre base client est alimentée par la boutique ou tenue dans Kafinea.
Reconnaître le client d’une commande. Le réglage Reconnaissance du client détermine la clé utilisée :
- Réf. client boutique : Kafinea mémorise l’identifiant que la boutique donne à son client dès la première commande. C’est une identité, donc le client est retrouvé même s’il change de nom ou d’adresse e-mail ;
- E-mail : le client est retrouvé par prénom, nom et e-mail. Pratique quand la base client n’a pas été reprise, mais un changement d’e-mail crée alors un doublon ;
- Réf. client boutique, puis e-mail : l’identifiant d’abord, l’e-mail en second recours.
Créer le client s’il est inconnu. Avec le réglage Créer les clients depuis la boutique activé (comportement par défaut), un client inconnu donne lieu à la création automatique d’une fiche client, avec son e-mail, son téléphone et ses adresses de facturation et de livraison, et d’un contact rattaché portant le nom de la personne. Désactivé, la commande est rattachée au client de repli de la boutique avec une alerte : votre base client reste maîtrisée dans Kafinea, sans doublon importé.
Bon à savoir : un contact venu de la boutique n’est jamais rattaché à une société déjà existante qui porterait le même nom. C’est une mesure de sécurité : sans cela, une commande passée sur votre site pourrait donner accès aux données d’un de vos clients.
Raison sociale et SIRET d’un client professionnel. La société saisie sur l’adresse de facturation, à défaut sur le compte client de la boutique, devient la raison sociale de la fiche, qui donne alors son nom au compte. Le SIRET est repris du compte client de la boutique, à défaut du numéro d’identification de l’adresse de facturation lorsqu’elle est en France. Seul un SIREN ou un SIRET valide est enregistré : une valeur erronée est signalée dans le journal des synchronisations et la fiche reste sans SIRET, à compléter à la main. Ces deux champs doivent être affichés sur la fiche client (éditeur de mise en page) : s’ils sont masqués, la fiche ne peut pas les recevoir et le journal le signale.
Actualiser un client déjà connu. À chaque commande, la boutique complète les informations manquantes de la fiche client et de son contact (e-mail, téléphone, adresses de facturation et de livraison, SIRET, et raison sociale d’un client professionnel) et signale les informations qui diffèrent, sans y toucher : la fiche client est tenue dans Kafinea, et le document porte de toute façon les adresses de la commande. Une raison sociale écrite autrement sur la boutique n’est pas signalée : c’est le cas courant.
Si vous préférez que votre site fasse référence sur les coordonnées de vos clients, cochez Mettre à jour les fiches clients depuis la boutique : la boutique remplace alors aussi les valeurs déjà renseignées. Les champs concernés sont toujours les mêmes, sur la fiche client comme sur son contact : e-mail, téléphone, adresse de facturation et adresse de livraison (rue, ville, code postal, région, pays). La raison sociale, le SIRET, le numéro de TVA, le commercial et les autres informations de la fiche ne sont jamais remplacés par la boutique. Dans les deux cas, chaque écart est tracé dans le journal des synchronisations, avec le nom des champs concernés.
6. Connecter une boutique #
Étape 1 – Récupérer la clé de connexion depuis votre boutique
Dans l’administration de votre boutique, ouvrez les réglages d’accès à l’API ou aux services web. Activez cet accès si nécessaire, puis créez les identifiants demandés par le connecteur : une clé d’API, parfois accompagnée d’un secret. Consultez la documentation de votre solution pour connaître le chemin exact et les droits disponibles.
Étape 2 – Créer la boutique dans Kafinea
- Rendez-vous dans Menu principal > Points de vente > Boutiques en ligne.
- Créez une nouvelle boutique, choisissez le type correspondant à votre solution et renseignez l’adresse de la boutique ainsi que les identifiants de connexion obtenus à l’étape précédente.
- Enregistrez.
Et voilà ! Kafinea peut désormais pousser votre catalogue vers la boutique et récupérer vos commandes.
Une fois enregistrés, la clé d’API et le secret ne sont plus jamais affichés : la fiche indique seulement « Valeur enregistrée » ou « Aucune valeur », l’historique des modifications les remplace par des astérisques, et les exports comme les lectures par l’API ne les contiennent pas. Pour changer de clé, saisissez la nouvelle valeur dans le formulaire de la boutique ; laissez le champ vide pour conserver la clé enregistrée.
Astuce : Renseignez un client par défaut, un article par défaut et un emplacement de stock e-commerce sur la fiche boutique : ils servent de valeurs de repli lorsqu’une commande référence un client inconnu ou un article absent du catalogue.
Choisir le sujet des commandes importées #
Sur la fiche boutique, le champ Modèle du sujet définit le sujet des nouveaux documents importés. Une nouvelle boutique utilise par défaut WEB - {order_reference} : pour une référence ABC123, le sujet sera WEB – ABC123. Vous pouvez remplacer ce modèle par un texte associant les variables suivantes :
| Variable | Valeur insérée dans le sujet |
|---|---|
{store_name} |
Nom de la boutique dans Kafinea |
{order_id} |
Identifiant numérique de la commande dans la boutique |
{order_reference} |
Référence ou numéro de commande lisible affiché par la boutique |
Par exemple, {store_name} - {order_reference} ({order_id}) combine le nom de la boutique, la référence lisible et l’identifiant. Le modèle doit contenir {order_id} ou {order_reference}. Le sujet final peut compter jusqu’à 100 caractères. Si vous videz ce champ sur une boutique déjà créée, Kafinea reprend le sujet habituel fourni par son connecteur. Une modification du modèle s’applique aux prochaines commandes et aux documents existants que vous rafraîchissez depuis la boutique.
Le sujet est indépendant des deux références présentes sur le bon de commande :
| Champ du bon de commande | Valeur provenant de la boutique |
|---|---|
| Ref externe | Identifiant de rapprochement utilisé par le connecteur pour retrouver la commande source |
| Réf. commande externe | Référence ou numéro de commande lisible, soit la valeur de {order_reference} |
Ces références permettent de retrouver la commande lors des synchronisations ; le modèle du sujet ne les modifie pas.
7. Quand la synchronisation a-t-elle lieu ? #
- Automatiquement, à intervalle régulier : Kafinea récupère les nouvelles commandes et met à jour le catalogue de chaque boutique active.
- À la demande, grâce au bouton Synchroniser les boutiques en ligne, placé juste à côté du bouton d’ajout dans la liste des bons de commande (il n’apparaît que si au moins une boutique est active).
Pendant une synchronisation lancée à la demande, un indicateur de chargement s’affiche sur la page. À la fin, Kafinea vous indique le résultat :
- si de nouvelles commandes ont été importées, la liste des bons de commande se recharge automatiquement pour les faire apparaître ;
- s’il n’y a aucune nouvelle commande, un message vous le confirme et la page n’est pas rechargée inutilement.
Note : Une commande déjà importée n’est jamais dupliquée : si la synchronisation est relancée, Kafinea reconnaît la commande et la met simplement à jour.
Retrouver les erreurs des jours précédents #
Comme la synchronisation tourne aussi le week-end et la nuit, l’écran de synchronisation ne se limite pas au dernier passage :
- la carte Points à vérifier affiche les messages du dernier passage, puis, juste en dessous, la liste des synchronisations en erreur des sept derniers jours, avec leur date et un accès à chacune ;
- cette carte ne devient verte que si le dernier passage et cette semaine d’historique sont sans erreur : un incident du samedi reste donc visible le lundi matin, même si les passages du dimanche se sont bien déroulés ;
- le bouton Journal des synchronisations ouvre l’historique complet de la boutique : chaque passage y est conservé avec sa date, son résultat, le nombre de commandes importées et ses messages d’erreur, sans limite de durée ;
- les commandes qui n’ont pas pu être importées restent dans la file d’attente de l’écran de synchronisation jusqu’à ce qu’elles soient effectivement importées, avec leur bouton Rejouer.
Vous disposez ainsi de deux niveaux de lecture : un coup d’œil hebdomadaire sur l’écran de synchronisation, et l’historique complet dès que vous voulez remonter plus loin.
8. Prix, remises et frais de port #
La boutique fait foi sur le montant encaissé. Kafinea ne recalcule pas votre commande : il la reconstitue de façon à retomber exactement sur ce que votre client a payé.
- Le prix d’origine de l’article est repris sur la ligne, et la remise de la boutique est affichée comme telle, en pourcentage ou en montant. Votre client retrouve donc sur le document le prix barré et sa remise, exactement comme sur votre site.
- Si les deux informations ne se recomposent pas au centime, Kafinea inscrit le prix net réellement payé et ajoute sur la ligne une mention lisible par votre client, du type « Remise de 5 % déjà appliquée sur ce prix. » Le montant reste juste dans tous les cas.
- Les frais de port, lorsque le connecteur prend en charge leur traitement partagé, sont répartis entre les articles de port configurés selon la nature des articles commandés. Le champ Source de la TVA des frais de port permet soit d’Appliquer les règles fiscales Kafinea, soit de Conserver le taux facturé par la boutique. Le montant TTC du port reste celui de la boutique. Le premier choix utilise les catégories et taux régionaux des articles de port ; le second reprend le taux historique transmis, y compris zéro. Voir La TVA sur les frais de port.
- Les différents taux de TVA d’une même commande sont conservés, ligne par ligne, y compris les taux à 0 %. Kafinea utilise les données fiscales de la commande source : une modification ultérieure du catalogue ne change pas la taxe de la vente passée. Un taux nul transmis ne constitue pas, à lui seul, une preuve de conformité de l’exonération.
Lorsque les règles d’arrondi de la boutique et de Kafinea laissent un faible écart, Kafinea ajoute une ligne de régularisation au bon de commande avec le service dédié Arrondi. Ce service est choisi automatiquement : aucun article d’arrondi n’est à sélectionner dans la configuration de la boutique. La ligne reprend une catégorie de TVA déjà présente sur la commande et ajuste le total au centime payé. Elle suit ensuite le document lors de sa transformation en facture : le total TTC de la facture correspond au paiement du client.
Les bons de réduction #
Un bon de réduction porte sur la commande entière, pas sur une ligne. Kafinea le reprend donc sur une ligne de remise dédiée, en négatif, et le répartit entre les taux de TVA des articles commandés : une commande mêlant du 20 % et du 5,5 % reçoit une ligne de remise par taux, au prorata. Comme sur votre boutique, le bon ne réduit pas les frais de port, sauf pour la part qui dépasse le montant des articles, par exemple sur une commande entièrement payée par un bon. La TVA reste ainsi exacte taux par taux, ce qui est la condition d’une déclaration juste.
La ligne porte le nom du bon utilisé quand votre boutique accepte de le communiquer, et l’intitulé générique « Remise commande » sinon.
Pour que ces lignes puissent être créées, renseignez une seule fois le champ Article de remise (bons de réduction) sur la fiche de la boutique : c’est l’article qui portera ces lignes, et c’est lui qui détermine leur comptabilisation. Créez-lui un article dédié, hors suivi de stock, exactement comme pour les frais de port. Tant qu’il n’est pas renseigné, une commande porteuse d’un bon n’est pas importée et l’écran de synchronisation vous invite à le configurer, puis à relancer la commande.
Important : chaque taux de TVA doit correspondre à une règle de taxe connue de Kafinea. Si un taux ne peut pas être rattaché, ou si le taux du port ne peut pas être déterminé, la commande n’est pas importée et le message vous indique le réglage à compléter : aucune valeur par défaut n’est appliquée silencieusement sur une donnée comptable.
9. Les modes de paiement #
Ouvrez la fiche de votre boutique, puis l’onglet Correspondances de paiement. Les moyens rencontrés lors de la récupération des commandes y apparaissent automatiquement. Pour chacun, cliquez sur Modifier et choisissez le Mode de paiement Kafinea de la société de la boutique. Le code fourni par la boutique est déjà renseigné ; le libellé vous aide à reconnaître le moyen.
Plusieurs moyens de la boutique peuvent utiliser le même mode Kafinea. La correspondance utilise le code du moyen, indépendamment de la langue du libellé affiché au client. Vous pouvez aussi ajouter une correspondance depuis cette liste. La carte Modes de paiement du résumé de la boutique présente les associations et celles qui restent à compléter.
Une correspondance à compléter n’empêche pas l’import de la commande. Une nouvelle commande est créée avec le mode de paiement vide. Une fois la correspondance renseignée, elle s’applique aux prochaines commandes et au rafraîchissement des commandes existantes encore admissibles. Pour une reprise par lots, votre intégrateur peut utiliser le rafraîchissement via l’API. Ce rafraîchissement reprend aussi les autres informations de la commande depuis la boutique. Si aucune correspondance exploitable n’est disponible, le mode déjà présent sur un document est conservé.
Ces correspondances renseignent uniquement le mode de paiement. Elles ne modifient pas les conditions de paiement et ne créent pas de modalités selon le nombre de mensualités d’un prestataire.
10. La région fiscale et la TVA à vérifier #
La proposition de région repose sur les règles communes aux documents de gestion commerciale :
adresse de livraison, éventuelle exception territoriale, nature du client et contexte activé par
l’administrateur. Les mêmes règles servent aux devis, commandes, factures et avoirs. Elles ne sont
pas limitées aux boutiques. Voir La configuration des taxes.
La région indique un contexte fiscal ; les taxes historiques transmises par la boutique restent
prioritaires sur les lignes importées, y compris lorsqu’elles sont nulles. Kafinea peut signaler
qu’une exonération ou un taux paraît incohérent avec la configuration, sans remplacer la taxe source.
La politique du port se règle séparément, comme indiqué ci-dessus.
Si l’attribution d’une région professionnelle exige une Exonération intracommunautaire autorisée,
cette autorisation se renseigne sur la fiche client après examen de son dossier. L’import ne l’accorde
pas automatiquement sur la seule présence d’une entreprise ou d’un numéro de TVA.
Si elle exige un numéro de TVA d’un autre pays, le numéro saisi sur la commande compte, ainsi que
la case Exonération intracommunautaire autorisée de la fiche client. Lorsque
l’attribution automatique est active, l’import le recopie sur la fiche client avant de proposer la
région :
- le numéro de l’adresse de livraison est pris en priorité, sinon celui de l’adresse de facturation ;
- il n’est recopié que sur une fiche client qui n’a pas encore de numéro de TVA ;
- un numéro déjà présent n’est jamais remplacé, même si la boutique met à jour les fiches clients ;
une différence est signalée dans le journal de synchronisation ; - le client de repli de la boutique n’est jamais complété ;
- le numéro n’est pas recopié si la prévention des doublons des clients porte sur le numéro de TVA.
Dans ce cas, renseignez-le sur la fiche client.
Toutes les solutions de boutique ne transmettent pas ce numéro. Sans numéro, renseignez-le sur la fiche
client puis rafraîchissez la commande.
Une commande passée au nom d’une société pour un client enregistré comme particulier reçoit l’avis
TVA à vérifier : la nature du client décide de sa région et reste une décision de votre équipe.
Le réglage Si la région fiscale est inconnue permet soit d’importer avec les taux exploitables
transmis par la boutique et un avis TVA à vérifier, soit de suspendre l’import pour compléter le
paramétrage. Si les données fiscales nécessaires sont insuffisantes, l’import indique ce qui manque.
TVA à vérifier invite à lire le motif, puis à examiner l’adresse, le profil du client, les taxes
source et les règles de l’entreprise. Cet avis n’empêche pas la facturation. Corriger un réglage prépare
les prochains imports ; cela ne recalcule pas les documents existants et ne valide pas leur conformité.
Avant de relancer une commande existante, vérifiez son historique et ses documents liés.
Le rafraîchissement reprend les données de la boutique et peut remplacer les corrections effectuées
dans Kafinea. Excluez de votre sélection les commandes déjà corrigées ou facturées. Les contrôles
habituels des documents verrouillés et des pièces liées restent applicables.
Voir La région fiscale des documents.
11. Un document qui ne retombe pas sur le montant encaissé #
À chaque import, Kafinea compare le total du document qu’il vient de créer au montant réellement encaissé par la boutique, hors taxe et taxe comprise. La commande est conservée dans tous les cas : elle a été payée, elle doit rester visible dans votre gestion.
Si les deux montants diffèrent, même d’un centime, le document est signalé en écart :
- un bandeau s’affiche en tête du document : « Ce document ne correspond pas au montant encaissé sur la boutique », avec le montant de la boutique et l’écart constaté ;
- le document porte le champ Écart de montant boutique, sur lequel vous pouvez filtrer et créer une vue de liste ;
- l’écran de synchronisation affiche l’indicateur Réconciliation des montants : nombre de commandes en écart et écart cumulé sur les 7 et 30 derniers jours, avec un accès direct à la liste ;
- le bouton Rejouer les documents en écart tente un rafraîchissement par lots après correction de la cause, avec les contrôles habituels des documents verrouillés et des pièces liées.
Lisez le motif de l’écart, puis examinez le prix, le port, les remises et les taux. Vous choisissez la correction du document. Si elle passe par un nouvel import, corrigez d’abord sa cause et vérifiez les documents concernés. Si un lot contient des commandes déjà corrigées ou facturées, préférez une reprise ciblée qui les exclut. L’alerte d’écart n’empêche pas la facturation.
Bon à savoir : une ligne de régularisation n’est ajoutée que si son calcul est vérifié avec la TVA de la commande. Dans les autres cas, l’écart reste signalé pour correction. L’exigence est le centime exact.
12. Questions fréquentes #
Tous mes articles sont-ils publiés en ligne ?
Non. Seuls les articles explicitement marqués « en vente en ligne » sont poussés vers la boutique.
Comment le stock est-il géré ?
Kafinea pousse la quantité disponible d’un emplacement de stockage dédié au e-commerce. La sortie de stock lors d’une vente s’appuie sur le bon de livraison habituel, et la quantité est réactualisée à chaque synchronisation.
Puis-je connecter plusieurs boutiques ?
Oui. Chaque boutique dispose de sa propre fiche et de sa propre clé de connexion, et est synchronisée indépendamment.
Que se passe-t-il si une commande référence un article inconnu de Kafinea ?
Si la boutique est autorisée à créer les articles, sa fiche est créée automatiquement. Sinon, la ligne utilise l’article de repli de la boutique et conserve en commentaire le libellé, le code et le code-barres d’origine, afin de ne rien perdre de la commande : voir Article introuvable : comment le repérer.
Un client qui déménage voit-il son adresse mise à jour dans Kafinea ?
Seulement si vous le demandez. Par défaut, la boutique complète les informations manquantes et signale celles qui diffèrent, sans modifier ce que vous avez saisi. Cochez Mettre à jour les fiches clients depuis la boutique sur la fiche boutique pour que le site fasse référence sur l’e-mail, le téléphone et les adresses de facturation et de livraison : voir Qui crée les clients ?
Les erreurs de synchronisation sont-elles conservées ?
Oui. Chaque passage est enregistré dans le journal des synchronisations de la boutique, avec son résultat et ses messages : rien n’est effacé par les passages suivants. L’écran de synchronisation met en avant les erreurs des sept derniers jours, et le journal vous permet de remonter aussi loin que nécessaire.
Quels droits accorder à la clé de connexion ?
Appliquez le principe du moindre privilège : accordez à la clé la lecture et l’écriture sur les catégories, les articles, le stock et les images (pour publier votre catalogue), et la lecture seule sur les commandes, les clients et les adresses (pour récupérer vos ventes). Les autres droits sont inutiles. Pensez en particulier à autoriser la lecture des images : sans ce droit, la boutique répond que la lecture des images est interdite et Kafinea ne peut pas récupérer les visuels de vos articles.
Note : La finesse des droits disponibles dépend de votre solution e-commerce. Limitez les accès aux besoins de synchronisation et conservez les identifiants dans les champs de connexion prévus sur la fiche boutique.
Ma boutique est protégée par un mot de passe supplémentaire et la connexion échoue.
Certains sites (souvent en préproduction) sont masqués derrière un mot de passe d’accès posé au niveau du serveur web, qui s’ajoute à la clé d’API. Les deux protections reposent sur le même mécanisme et entrent en conflit : la synchronisation renvoie alors une erreur d’authentification, même si la clé est correcte. Demandez à l’administrateur du serveur de rendre l’adresse de l’API accessible (en excluant le chemin de l’API de la protection par mot de passe, ou en ajoutant la clé d’API comme identifiant autorisé). Une fois l’API joignable avec la seule clé, la synchronisation fonctionne normalement.
Le total d’une commande importée diffère de quelques centimes du total affiché sur ma boutique. Est-ce normal ?
Non, et Kafinea vous le signale. L’exigence est le centime exact : le document est importé, puis marqué en écart avec le montant encaissé et l’écart constaté, pour permettre à l’utilisateur de choisir la correction appropriée. Un nouvel import est possible seulement si la commande respecte les protections de rafraîchissement (voir Un document qui ne retombe pas sur le montant encaissé). Pour comprendre d’où viennent ces différences de calcul entre deux logiciels, voir Les écarts d’arrondi de TVA entre logiciels.
Comment un bon de réduction apparaît-il sur le bon de commande ?
Sur une ligne de remise dédiée, en négatif, avec le nom du bon lorsque la boutique le transmet. Si la commande comporte plusieurs taux de TVA, la remise est répartie entre eux au prorata, ce qui donne une ligne de remise par taux et une TVA juste taux par taux.