Skip to main content
Cet exemple montre comment ajouter un PDF à une commande de vente dans Bonx depuis un script Node.js. Le fichier apparaîtra dans l’onglet Fichiers de la commande, comme s’il avait été ajouté depuis l’interface. Vous avez besoin de :
  • l’identifiant de la commande de vente dans Bonx ;
  • un fichier PDF ;
  • l’URL GraphQL et une clé API Bonx.
L’ajout du fichier se fait en trois appels :
1

Demander une URL d'upload

Bonx renvoie une URL temporaire sur laquelle envoyer le PDF.
2

Envoyer le PDF

Envoyez le contenu du fichier à cette URL avec une requête PUT.
3

Lier le PDF à la commande

Créez le fichier dans Bonx avec le type salesOrders et l’identifiant de la commande.

Exemple complet

Cet exemple utilise fetch, disponible nativement à partir de Node.js 18. Enregistrez le script dans un fichier .mjs pour pouvoir l’exécuter directement.

Points à vérifier

  • salesOrderId est l’identifiant interne de la commande dans Bonx.
  • L’URL d’upload expire après 10 minutes. Demandez-la juste avant d’envoyer le fichier.
  • Utilisez application/pdf lors de la création de l’URL et lors du PUT.
  • Pour fileId, utilisez le fileName renvoyé par generatePresignedUrlUpload.
  • Relancer le script ajoute une nouvelle copie du fichier. Évitez donc de traiter deux fois la même opération.
Pour rattacher le PDF à un autre type de fiche, remplacez salesOrders par le recordType correspondant. Consultez Rattacher un document pour voir les valeurs disponibles.