Ponteo

Développeurs

Une API REST pour Acomba et Avantage, sans rien exposer chez le client.

Votre application parle HTTPS et JSON. Ponteo Connect se charge du reste, jusqu’au SDK officiel du logiciel comptable.

Ouvrir le playground Documentation
Premier appel, réponse quasi instantanée. Clé de démo : données générées, aucune écriture.
curl "https://api.ponteo.ca/v1/customers?limit=5" \
  -H "Authorization: Bearer PTEO1-DEMOPONTEOPLAYGROUND234567-QEX5"
Connexion
sortante, port 443
Interface
REST, JSON
Signature
HMAC-SHA256
Agent
Windows 10, Server 2016+

Le modèle : une requête, quatre étapes

Aucune donnée n’est conservée chez Ponteo : le relais efface le contenu dès que la réponse est livrée.

  1. Votre système appelle l’API

    Une requête HTTPS vers api.ponteo.ca/v1, avec la clé de licence de la compagnie visée dans l’en-tête Authorization.

  2. Ponteo Connect valide et protège

    Licence vérifiée à chaque appel, limitation du débit et quotas, avant tout relais. Aucune donnée n’est conservée : le contenu est effacé dès la réponse livrée.

  3. L’agent reçoit la requête

    L’agent garde une connexion sortante permanente vers Ponteo Connect. La requête lui parvient par ce canal, sans ouverture de port chez le client.

  4. Acomba exécute l’opération

    L’agent passe par le SDK officiel, puis renvoie le résultat dans une enveloppe JSON uniforme.

L’agent Windows, en détail

Suivez une requête d’un bout à l’autre du pont

Choisissez un scénario : chaque étape s’affiche au fil du trajet, de votre application jusqu’au logiciel comptable, et retour.

Une facture approuvée, écrite une seule fois

Votre plateforme d’approbation écrit la facture dans Acomba avec sa répartition et ses taxes. Même si l’appel est rejoué, aucun doublon.

  1. 01 La facture numérisée est approuvée dans votre outil de comptes fournisseurs.
  2. 02 L’outil l’envoie avec une Idempotency-Key. POST/v1/invoices/ap
  3. 03 Ponteo Connect vérifie la licence et réserve la clé : un second envoi identique ne sera pas réécrit.
  4. 04 L’agent contrôle fournisseur, comptes et répartition, puis écrit la facture avec ses taxes.
  5. 05 Réponse 201 avec la facture relue dans Acomba. Un rejeu obtiendrait la même réponse.

Le solde du client, avant l’appel

Votre équipe des ventes voit la fiche client, le solde à recevoir et la date du dernier achat directement dans le CRM.

  1. 01 Une représentante ouvre la fiche d’un client dans le CRM.
  2. 02 Le CRM interroge Ponteo Connect avec le numéro du client. GET/v1/customers/{number}
  3. 03 L’agent lit la fiche du client dans Acomba.
  4. 04 Le solde à recevoir, le total des achats et la date du dernier achat s’affichent.

Le stock réel, affiché sur la boutique

La boutique lit les quantités disponibles et les prix dans l’inventaire, et ne vend plus ce qui est en rupture.

  1. 01 La boutique demande les produits modifiés depuis sa dernière synchronisation. GET/v1/products?modifiedSince=…
  2. 02 Ponteo Connect valide la licence et relaie la lecture vers l’agent, sans rien conserver.
  3. 03 L’agent parcourt l’inventaire et retient les fiches modifiées.
  4. 04 Quantité disponible, prix et emplacement reviennent, page par page.
  5. 05 La boutique met ses fiches à jour : les produits épuisés ne sont plus proposés.

Connecteur WooCommerce · Shopify

Une commande web créée dans Acomba

Avec le connecteur e-commerce, le panier validé sur votre boutique devient une facture dans Acomba ou Avantage, sans ressaisie.

  1. 01 Le client valide son panier sur la boutique.
  2. 02 Le connecteur transmet la commande à Ponteo Connect, en HTTPS, avec la clé de licence.
  3. 03 api.ponteo.ca valide la licence et le débit, et écarte tout doublon.
  4. 04 La commande est relayée à l’agent par sa connexion sortante, sans port ouvert chez vous.
  5. 05 L’agent crée la facture dans Acomba par le SDK officiel.
  6. 06 La confirmation revient au connecteur, qui met la commande à jour dans la boutique.

La création de commandes dans Acomba ou Avantage est assurée par les connecteurs e-commerce.

Les garde-fous qu’exige une donnée comptable

Un connecteur fermé relie une boutique à la comptabilité, et s’arrête là. Ponteo Connect relie tout ce qui doit l’être, avec les garde-fous qu’exige une donnée comptable.

Jamais de doublon

Écritures idempotentes, répartition qui doit s’annuler, simulation avant d’écrire, et facture relue dans Acomba après l’écriture.

?dryRun=true Idempotency-Key

Écritures sous contrôle

Une écriture doit être permise par la licence et autorisée dans l’agent, compagnie par compagnie. Côté agent, la case est décochée par défaut.

Aucun port entrant

Connexion sortante chiffrée sur le port 443 : elle traverse le NAT et les pare-feu sans règle particulière.

Signature HMAC

En option, signez chaque requête avec un horodatage (±300 s) pour empêcher la réutilisation d’un appel intercepté.

X-Ponteo-Signature X-Ponteo-Timestamp

Restriction d’adresse IP

En option, limitez l’usage d’une licence aux adresses IP de vos systèmes autorisés.

Journal d’audit

Chaque requête porte un identifiant unique et est journalisée côté API comme côté agent.

X-Request-Id

Révocation immédiate

Une licence révoquée coupe aussitôt l’accès à l’API et la connexion de l’agent pour cette compagnie.

Sécurité, dans la documentation

Ce que l’API expose

  • Routes métier à champs normalisés : clients, produits, fournisseurs, charte de comptes, factures clients et fournisseurs.
  • 90 ressources du SDK en lecture, et en écriture là où le SDK le permet, avec leur schéma consultable.
  • Pagination par curseur, filtre modifiedSince, enveloppe et codes d’erreur uniformes.
  • Une licence par compagnie, deux forfaits, prix publiés.
Référence des ressources Ce que l’API permet, tâche par tâche
Réponse
{
  "ok": true,
  "data": {
    "items": [
      { "number": "C0001", "name": "Boulangerie Dupuis",
        "balance": 1250.00, "lastPurchaseAt": "2026-09-02" },
      { … }
    ],
    "nextCursor": "5"
  },
  "requestId": "6f1c2b0e-8d4a-4e7b-9a53-…"
}

De l’abonnement au premier appel

Tout se fait en ligne : aucun rendez-vous n’est nécessaire pour commencer avec l’API.

  1. Choisir un forfait

    Essentiel ou Illimité, selon votre volume d’appels.

  2. Payer en ligne

    Paiement sécurisé par Stripe ; abonnement mensuel, résiliable.

  3. Recevoir clé et agent

    Par courriel : votre clé de licence et le lien de téléchargement de l’agent.

  4. Installer et configurer

    L’agent Windows, puis, pour chaque compagnie, l’utilisateur et le mot de passe Acomba ou Avantage.

  5. Tester dans le playground

    Vos premiers appels en direct, avec votre clé.

Essayez avec la clé de démo, puis abonnez-vous

Le playground envoie de vrais appels à api.ponteo.ca. Avec votre propre clé, ils atteignent votre compagnie.

Ouvrir le playgroundS’abonner