API et webhooks · Enterprise
Connectez vos devis au reste de vos outils
L'API REST de QuotWay permet à votre ERP, votre CRM ou votre boutique sur mesure de lire les devis et d'envoyer de nouvelles demandes de devis, et des webhooks signés préviennent vos systèmes dès qu'un acheteur accepte, fait une contre-offre ou qu'un devis est converti. Clés à scopes, payloads sans données personnelles et limites documentées. Disponible sur le forfait Enterprise - y compris pendant l'essai gratuit de 14 jours.
Enterprise · API incluse dans l'essai de 14 jours · spécification OpenAPI 3.1
Deux points d'entrée
QuotWay se connecte aux autres systèmes de deux façons : une API REST que vos systèmes appellent pour lire et créer des devis, et des webhooks que QuotWay envoie à vos systèmes dès qu'un devis change. La plupart des intégrations utilisent les deux - le webhook signale qu'il s'est passé quelque chose, l'API en donne le détail.
- API REST - https://api.quotway.com/v1 : lister et consulter les devis, créer des demandes de devis, publier des messages, envoyer une proposition chiffrée par votre équipe, télécharger les PDF et récupérer les statistiques
- Webhooks - une requête HTTPS signée pour 25 événements de devis, de la nouvelle demande à la commande validée, convertie et payée
Ce que vous pouvez construire
Quelques exemples de ce que vous pouvez connecter avec l'API et les webhooks ensemble.
Intégration ERP et synchronisation des commandes
Recevez quote.converted dès qu'une commande provisoire est créée et quote.order_completed quand elle est payée, puis importez les lignes et les totaux du devis dans votre ERP.
Pipeline CRM
Reflétez chaque devis sous forme d'affaire : les webhooks font avancer l'étape, l'API renseigne le montant - à partir du chiffre headline du devis, pour qu'un devis partiellement accepté affiche ce qui a réellement été convenu, et non l'offre initiale.
Boutiques headless et sur mesure
Envoyez des demandes de devis depuis n'importe quel front-end avec POST /v1/quotes. Elles passent par les mêmes règles de ciblage, la même validation de formulaire et la même automatisation que votre boutique en ligne.
Finance et reporting
Synchronisez les devis de façon incrémentale dans un entrepôt de données, ou récupérez des indicateurs précalculés de pipeline, de conversion et de délai de réponse par jour, semaine ou mois.
Alertes d'équipe
Acheminez quote.merchant_approval.requested ou un quote.created de montant élevé vers l'outil que votre équipe surveille déjà.
Enterprise
Conçue pour la production
L'API est conçue pour les systèmes que les marchands B2B font réellement tourner : prévisible, documentée et sans risque à relancer.
Clés à scopes
Cinq scopes (lire les devis, lire les données personnelles des acheteurs, lire les statistiques, écrire des devis, gérer les webhooks). Expiration et listes d'adresses IP autorisées en option. Renouvelez une clé avec 24 heures de chevauchement, ou révoquez-la immédiatement. Réservé aux administrateurs.
Données acheteur sur demande
Un devis n'inclut le nom, l'e-mail, le téléphone et les adresses de l'acheteur que pour une clé disposant du scope données acheteur. Les payloads des webhooks n'incluent jamais de données personnelles d'acheteur - ils nomment le devis et renvoient vers lui.
Signatures Standard Webhooks
Vérifiez les livraisons avec les bibliothèques open source officielles pour Node, Python et d'autres langages. Faites tourner un secret avec 24 heures de chevauchement.
Des relances dont vous n'avez pas à vous soucier
Les livraisons échouées sont relancées pendant environ 3,7 jours selon un délai croissant ; un journal de livraison affiche chaque tentative, et vous pouvez renvoyer n'importe quelle livraison.
Rien ne se perd
Chaque événement est aussi disponible pendant 30 jours dans un flux d'événements, avec les mêmes identifiants que les webhooks - un récepteur qui était hors service peut donc rattraper son retard.
Relances sans doublon
Un Idempotency-Key sur chaque écriture garantit qu'un délai d'attente réseau ne peut pas créer un devis ou un message en double.
Des contrats clairs
Spécification OpenAPI 3.1, erreurs RFC 9457 avec un code stable pour chaque échec, pagination par curseur et limites de débit publiées (120 requêtes par minute par clé, 300 par boutique).
Votre équipe garde la main sur les prix
L'API QuotWay ne fixe jamais un prix. Elle peut enregistrer la demande d'un acheteur et envoyer une proposition que votre équipe a déjà chiffrée et enregistrée - et même dans ce cas, votre prix plancher et vos règles d'approbation s'appliquent exactement comme dans l'admin.
- Les demandes de devis envoyées par l'API utilisent les prix du catalogue Shopify ; votre équipe chiffre la proposition comme d'habitude
- Envoyer une proposition préparée sous votre prix plancher exige la même confirmation explicite que dans l'admin - et le plancher tient compte de toute remise sur le devis entier, exactement comme dans l'admin
- Une remise fixe sur tout le devis supérieure au sous-total de la proposition est refusée (422 invalid_proposal)
- Si une règle d'approbation s'applique, la proposition attend votre approbateur au lieu de partir chez l'acheteur
Connectez-vous en quatre étapes
- 1
Créer une clé
Dans QuotWay, ouvrez Paramètres → Intégrations → Clés API, choisissez les scopes et copiez la clé.
- 2
Faire un premier appel
Une requête curl vers https://api.quotway.com/v1/ping avec la clé confirme la boutique et les scopes.
- 3
Ajouter un endpoint de webhook
Dans Paramètres → Intégrations → Webhooks, ajoutez votre URL HTTPS, choisissez les événements et copiez le secret de signature.
- 4
Vérifier et traiter
Vérifiez la signature de chaque livraison, répondez 200 et récupérez le devis quand vous avez besoin de son détail.
Continuer la lecture
Vos questions, nos réponses
QuotWay a-t-il une API ?
Oui. QuotWay dispose d'une API REST à l'adresse https://api.quotway.com/v1 pour lire les devis, créer des demandes de devis, publier des messages, envoyer des propositions préparées, télécharger les PDF de devis et lire les statistiques. Elle est documentée par une spécification OpenAPI 3.1 et disponible sur le forfait Enterprise.
QuotWay prend-il en charge les webhooks ?
Oui. QuotWay envoie un webhook HTTPS signé pour 25 événements de devis - notamment devis créé, proposition envoyée, contre-offre, accepté, partiellement accepté, refusé, converti en commande provisoire, commande payée, et validation demandée ou décidée. Les webhooks suivent la spécification Standard Webhooks et sont disponibles sur le forfait Enterprise.
Quel forfait inclut l'API et les webhooks ?
Enterprise (199 $/mois). Une boutique en essai gratuit de 14 jours peut utiliser les deux : vous pouvez donc développer et tester avant de vous abonner. Si une boutique passe à un forfait inférieur, ses clés et ses endpoints sont conservés mais mis en pause.
Puis-je créer des devis depuis une boutique headless ?
Oui. POST /v1/quotes enregistre la demande de devis d'un acheteur depuis n'importe quel front-end. Les lignes font référence à des variantes de produit Shopify (ou sont des lignes personnalisées), et la demande passe par les règles de ciblage, la validation du formulaire de devis et les règles d'automatisation de la boutique, exactement comme une demande venue de la boutique en ligne.
L'API peut-elle modifier les prix ou accepter un devis ?
Non. L'API ne fixe ni ne modifie jamais les prix, et elle ne peut pas accepter, refuser ou convertir un devis à la place de qui que ce soit. Elle peut envoyer une proposition que votre équipe a déjà chiffrée et enregistrée dans QuotWay, et votre prix plancher et vos règles d'approbation s'appliquent toujours.
Les webhooks contiennent-ils des données client ?
Non. Les payloads des webhooks identifient le devis et portent un court résumé - statut, devise et totaux - mais jamais le nom, l'e-mail, le téléphone ou l'adresse de l'acheteur. Récupérez le devis via l'API avec une clé disposant du scope données acheteur quand vous avez besoin de ces informations.
Que se passe-t-il si mon endpoint est hors service ?
QuotWay relance une livraison échouée sept fois sur environ 3,7 jours, et chaque événement reste disponible 30 jours dans le flux d'événements pour que vous puissiez rattraper votre retard. Un endpoint qui échoue sans interruption pendant cinq jours est désactivé et la boutique est prévenue par e-mail.
Existe-t-il une application Zapier ou une intégration HubSpot ?
Pas aujourd'hui. Vous pouvez connecter QuotWay à d'autres outils avec l'API REST et les webhooks, et à l'automatisation de Shopify avec l'intégration Shopify Flow.
Placez vos devis là où tourne votre activité
Ajoutez QuotWay gratuitement, lancez un essai de 14 jours d'Enterprise et connectez votre premier système avec l'API et les webhooks - documentés, à scopes et signés.
Forfait Lite gratuit · essai de 14 jours sur les forfaits payants · compatible Shopify Plus