Introduction
Si vous utilisez King ERP de Björn Lundén, vous envoyez vos factures de Catermonkey directement vers King. Vous choisissez comment : si King se charge de la facturation, chaque facture arrive comme commande client que King facture sous son propre numéro. Si vous envoyez déjà vos factures depuis Catermonkey, la connexion les comptabilise sous leur numéro Catermonkey dans votre journal des ventes. Dans les deux cas, Catermonkey ajoute le client dans King comme débiteur, et la TVA et le chiffre d'affaires arrivent sur les codes et les comptes que vous avez choisis.
Ce qu'il vous faut. La connexion King est un module distinct à 19,50 € par mois, à activer sous Paramètres > Intégrations. Elle fonctionne avec King ERP (King 5) sur lequel King Webservices est installé ; votre administrateur King ou votre partenaire King s'en charge sur votre propre serveur King. Catermonkey doit pouvoir joindre cette adresse par internet, de préférence en https.
Étape 1 : demandez à votre administrateur King d'activer les webservices
Dans King, votre administrateur ouvre Diversen > Vaste gegevens webservices et définit un code d'accès pour chacun de ces webservices : Webservice_Test, Debiteur_ToevoegenWijzigen, Order_Toevoegen, Order_OrderRegel_Toevoegen, Order_LockVrijgeven, Order_Wijzigen, Order_Verwijderen, Boekingsgang_Toevoegen, Boekingsgang_Journaalpost_Toevoegen, Boekingsgang_Journaalpost_Journaalregel_Toevoegen, Boekingsgang_Journaalpost_Verwijderen et Boekingsgang_Afsluiten. Un webservice sans code d'accès est désactivé dans King.
Votre administrateur vous communique trois informations : l'adresse de King Webservices (avec protocole et port, par exemple https://king.votreentreprise.com:8082), le code de l'administration et le code d'accès.
Étape 2 : saisissez la connexion et testez-la
Allez dans Paramètres > Intégrations, ouvrez King et remplissez Adresse de King Webservices, Administration et Code d'accès. Cliquez sur Enregistrer et tester la connexion. Catermonkey enregistre vos données et demande une réponse de test à King ; si tout fonctionne, vous voyez « Connecté : King Webservices accepte le code d'accès. »
Si l'adresse commence par http:// au lieu de https://, Catermonkey vous avertit : le code d'accès circule alors sans chiffrement. Utilisez https si votre serveur King le permet.
Étape 3 : choisissez qui facture
La case Facturer depuis Catermonkey et n'envoyer que les écritures de vente vers King détermine ce que King reçoit :
Décochée (par défaut) : King facture. Chaque facture devient une commande client dans King, avec une ligne de commande par produit et le nom du produit comme texte sur la facture. King facture la commande sous son propre numéro de facture : n'envoyez donc pas aussi la facture depuis Catermonkey.
Cochée : vous facturez depuis Catermonkey. La facture devient une écriture dans votre journal des ventes, sous son numéro de facture Catermonkey, avec une ligne de débiteur et, par groupe de chiffre d'affaires et par taux de TVA, une ligne de produits avec sa TVA. L'écriture est provisoire : votre comptable la vérifie dans King avant qu'elle ne devienne définitive.
Avec Utiliser le code client comme numéro de débiteur, le code client Catermonkey est envoyé comme numéro de débiteur. Un débiteur qui existe déjà dans King sous ce numéro est mis à jour au lieu d'être créé en double. Sans cette option, King attribue lui-même un numéro de débiteur ; Catermonkey le conserve avec le client pour l'exportation suivante.
Étape 4 : associez vos taux de TVA
Sous Codes TVA, saisissez le Code TVA dans King de chaque taux de TVA avec lequel vous facturez, tel qu'il apparaît dans King. Une facture avec un taux sans code n'est pas exportée : Catermonkey vous indique quel taux, sur quelle ligne, attend encore un code.
Étape 5 : complétez les données selon votre façon de travailler
Si King facture (case décochée) :
Entrepôt : le numéro de l'entrepôt King dans lequel les commandes sont créées.
Lignes de commande comme : Tarifs (TAR) ou Articles (ART). Les tarifs ne nécessitent pas de stock ; choisissez les articles si vos articles dans King gèrent un stock.
Numéro d'article ou de tarif : l'article ou le tarif King sur lequel va une ligne de commande. Vous pouvez au besoin utiliser un autre article ou tarif par groupe de chiffre d'affaires.
Libérer les commandes pour la facturation : approuve la commande dans King et la libère immédiatement pour la facturation.
Si vous facturez depuis Catermonkey (case cochée) :
Journal : le code du journal des ventes de King.
Exercice : le code de l'exercice ; laissez vide pour utiliser l'année de la date de facture.
Compte de produits : le compte général du chiffre d'affaires, et au besoin un compte propre par groupe de chiffre d'affaires.
Comptabiliser en définitif : laissez décoché pour comptabiliser en provisoire.
Cliquez sur Enregistrer les modifications.
Étape 6 : exportez une facture
Ouvrez une facture. Dans la carte King, cliquez sur Exporter vers King. Catermonkey enregistre la facture, ajoute le client dans King comme débiteur et crée la commande client ou l'écriture. Vous voyez aussitôt ce que King contient désormais : le numéro de commande, ou le numéro du lot d'écritures. Ensuite, le bouton est désactivé : une facture part une seule fois vers King.
Quand vous comptabilisez depuis Catermonkey, la facture doit d'abord avoir un numéro : une facture en brouillon ne peut pas être comptabilisée.
Questions fréquentes
King refuse la facture. Que faire ? Catermonkey affiche le motif donné par King, par exemple un article manquant ou une période clôturée. Une commande ou une écriture créée à moitié est supprimée par Catermonkey ; le message vous indique si cela a réussi. Corrigez les paramètres ou la facture, puis exportez à nouveau.
Puis-je exporter une facture deux fois ? Non. Après une exportation réussie, le bouton est désactivé, pour qu'une facture n'arrive pas deux fois dans King, comme commande ou comme écriture. Pour l'envoyer à nouveau, supprimez-la d'abord dans King et demandez-nous de débloquer l'exportation.
Que devient une note de crédit ? Une note de crédit part de la même façon. Comme commande client, ses lignes portent une quantité négative ; comme écriture, débit et crédit s'inversent, de sorte que le chiffre d'affaires et la TVA sont annulés.
Quel numéro de facture le client reçoit-il ? Si King facture, King attribue son propre numéro de facture et vous envoyez la facture depuis King. Si vous comptabilisez depuis Catermonkey, le numéro Catermonkey reste celui qui compte : l'écriture dans King porte ce numéro.
Mon serveur King n'est pas ouvert sur internet. Dans ce cas, Catermonkey ne peut pas l'atteindre. Demandez à votre partenaire King de rendre King Webservices accessible en https, ou de mettre en place un tunnel vers nos serveurs. Une adresse de votre réseau interne (comme 192.168.x.x) n'est pas acceptée.
Et si un groupe de chiffre d'affaires n'a pas d'article ni de compte propre ? Catermonkey utilise alors l'article par défaut ou le compte de produits par défaut saisi dans les paramètres. S'il manque aussi, la facture n'est pas exportée et Catermonkey vous indique quel groupe de chiffre d'affaires en attend encore un.

