Aller au contenu principal

Comment créer un jeton d'accès ?

Un jeton d'accès permet à un outil externe, par exemple un logiciel de comptabilité, de lire certaines de vos données Malt. Vous le créez dans Mon compte, puis vous le copiez dans l'outil. Malt ne l'affiche qu'une seule fois.

En résumé :
  • Ouvrez Mon compte, puis Clés API.
  • Générez un jeton avec l'autorisation READ_INVOICE pour un outil qui importe vos factures.
  • Copiez-le tout de suite. S'il n'est plus affiché, générez-en un nouveau : la page ne le montre qu'une fois.

Où le créer

  1. Ouvrez Mon compte.
  2. Choisissez Clés API. La page s'intitule Jetons d'accès.
  3. Cliquez sur Générer le jeton.
  4. Dans Type de jeton, laissez Account.
  5. Dans Autorisations, sélectionnez READ_INVOICE. C'est l'accès en lecture à vos factures. Pour un outil qui importe vos factures, cette autorisation suffit.
  6. Renseignez le Nom du jeton. Le nom de l'outil convient.
  7. La Remarque est facultative.
  8. Cliquez sur Générer.
  9. Copiez le jeton immédiatement. La page affiche : « Assurez-vous de copier votre nouveau jeton d'accès maintenant. Vous ne pourrez plus le voir ! »

L'écran affiche le code READ_INVOICE, pas une phrase du type « Factures en lecture seule ».

Le coller dans l'outil

Collez le jeton dans l'outil, à l'endroit prévu pour la connexion à Malt. Collez-le en entier, sans espace avant ou après.

Si vous avez fermé la fenêtre avant de le copier, générez-en un nouveau, puis supprimez celui que vous n'avez pas pu copier. Un nouveau jeton suffit dans ce cas.

Si l'outil refuse le jeton

Le motif du refus s'affiche dans l'outil, pas sur Malt.

  1. Vérifiez que le jeton collé est complet, sans espace avant ou après.
  2. Vérifiez que l'autorisation READ_INVOICE est sélectionnée.
  3. Si besoin, générez un nouveau jeton avec cette autorisation, et collez celui-là.

Si l'outil refuse encore ce nouveau jeton, écrivez au support Malt. Indiquez le nom du jeton, sa date de création et le message affiché par l'outil. N'envoyez pas le jeton.

Quand écrire au support

Écrivez au support dans deux cas.

  • La page affiche : « Une erreur imprévue est survenue, le jeton d'accès n'a pas pu être créé. »
  • Un outil refuse un jeton que vous venez de générer, alors que READ_INVOICE est sélectionné et que le jeton a été collé en entier.

Indiquez le nom du jeton, la date et le message affiché par l'outil. N'envoyez pas le jeton : il donne accès à vos factures.

Si le jeton n'est plus affiché, vous pouvez en générer un nouveau vous-même. La page ne le montre qu'une fois.

Articles associés