Ponteo

Branchez vos outils sur ce qui compte : clients, stock, factures.

Dans une PME, les mêmes données vivent dans la boutique, le CRM, l’outil de comptes fournisseurs et le logiciel comptable. Ponteo Connect fait d’Acomba ou d’Avantage la source que tous ces outils consultent, par l’API, un connecteur e-commerce ou une intégration sur mesure.

Le trajet, étape par étape

Chaque scénario suit une donnée de votre application jusqu’au logiciel comptable, et retour.

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.

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 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.

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.

Boutique en ligne et inventaire

Ne vendez plus ce que vous n’avez pas

Le stock de la boutique est mis à jour à la main, en fin de journée. Entre-temps, des commandes arrivent pour des produits épuisés.

Aujourd’hui
Exportation de l’inventaire, import dans la boutique, écarts de prix et ruptures découvertes après la vente.
Avec Ponteo Connect
La boutique lit à intervalle régulier les produits modifiés depuis sa dernière synchronisation : quantité disponible, prix de vente et emplacement viennent directement de l’inventaire.
Bon à savoir
Suivez nextCursor jusqu’à null, puis conservez l’heure de départ comme prochain modifiedSince. Chaque lecture interroge Acomba en direct : le stock affiché est toujours celui du moment.
  • GET/v1/products
  • GET/v1/products/{number}
Requête
curl "https://api.ponteo.ca/v1/products?modifiedSince=2026-09-15T08:00:00&active=true&limit=100" \
  -H "Authorization: Bearer $PONTEO_KEY"
Réponse 200 (extrait)
{
  "ok": true,
  "data": {
    "items": [
      {
        "number": "P-10011",
        "description": "Gants de nitrile (boîte de 100)",
        "active": true,
        "group": "EPI",
        "location": "A2-2",
        "sellingPrice": 18.95,
        "stock": { "onHand": 40, "available": 34, "reserved": 6, "ordered": 100, "reorderPoint": 40 },
        "modifiedAt": "2026-09-15T10:42:18",
        "position": 2
      }
    ],
    "nextCursor": null
  },
  "requestId": "0b9d4f6e-3c1a-4a8e-b0d2-5f7e9a1c3b24"
}

CRM et équipe des ventes

Le bon contexte, avant de décrocher

Les fiches clients du CRM divergent de celles de la comptabilité, et personne ne sait qui a un solde en souffrance.

Aujourd’hui
Adresses et courriels corrigés dans un système mais pas dans l’autre ; un appel à la comptabilité pour connaître un solde.
Avec Ponteo Connect
Le CRM synchronise les clients modifiés et affiche, sur la fiche, le solde à recevoir, le total des achats et la date du dernier achat.
Bon à savoir
Filtrez les clients actifs avec active=true. Chaque lecture interroge Acomba en direct.
  • GET/v1/customers
  • GET/v1/customers/{number}
Requête
curl https://api.ponteo.ca/v1/customers/C2003 \
  -H "Authorization: Bearer $PONTEO_KEY"
Réponse 200 (extrait)
{
  "ok": true,
  "data": {
    "number": "C2003",
    "name": "Distribution Exemple inc.",
    "city": "Lévis",
    "phone": "418-555-3001",
    "email": "compta1@client-exemple.ca",
    "active": true,
    "termNumber": "30",
    "salesRepNumber": "V2",
    "receivable": 4210.37,
    "totalPurchases": 58140.12,
    "lastPurchaseDate": "2026-08-28",
    "modifiedAt": "2026-09-02T14:05:51",
    "position": 2
  },
  "requestId": "7a2e5c1d-9b4f-4d63-8e0a-2c6f1b3d5e79"
}

Automatisation des comptes fournisseurs

Approuvée une fois, saisie zéro fois

Votre outil de numérisation ou d’approbation fait le travail, puis quelqu’un ressaisit chaque facture dans Acomba.

Aujourd’hui
Double saisie, erreurs de répartition, et la crainte de saisir deux fois la même facture.
Avec Ponteo Connect
La facture approuvée est d’abord validée en simulation, puis écrite avec sa répartition et ses taxes. L’Idempotency-Key garantit qu’un envoi répété ne crée pas de doublon ; une facture déjà présente est signalée comme telle, sans être réécrite.
Bon à savoir
Les écritures doivent être permises par la licence et autorisées dans l’agent pour la compagnie.
  • POST/v1/invoices/ap?dryRun=true
  • POST/v1/invoices/ap
Requête
curl -X POST https://api.ponteo.ca/v1/invoices/ap \
  -H "Authorization: Bearer $PONTEO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ap-1000-F-2026-0815" \
  --data-binary @facture.json
Réponse 201 (extrait)
{
  "ok": true,
  "data": {
    "status": "created",
    "invoice": {
      "supplierNumber": "1000",
      "invoiceNumber": "F-2026-0815",
      "date": "2026-09-12",
      "total": 303.89,
      "distribution": [ … ]
    }
  },
  "requestId": "c41f7b2a-6e3d-4b09-a8f5-1d2e3c4b5a60"
}

Le corps complet et les règles de répartition sont décrits dans la documentation.

Portail client B2B

Vos clients trouvent eux-mêmes leurs factures

« Pouvez-vous me renvoyer la facture de juillet ? » Une demande simple, répétée des dizaines de fois.

Aujourd’hui
Recherche dans le logiciel comptable, impression, courriel, puis le même exercice pour le solde.
Avec Ponteo Connect
Votre portail affiche, pour le client connecté, ses factures récentes, leur détail et son solde à recevoir, lus à la source.
Bon à savoir
L’API renvoie les données de la facture, pas un PDF : votre portail met en page (ou génère) son propre document. Les factures sont parcourues de la plus récente à la plus ancienne. Une page peut revenir incomplète avec un nextCursor non nul : continuez tant qu’il n’est pas null.
  • GET/v1/invoices/ar?customer=
  • GET/v1/customers/{number}
Requête
curl "https://api.ponteo.ca/v1/invoices/ar?customer=C2003&from=2026-07-01&to=2026-07-31" \
  -H "Authorization: Bearer $PONTEO_KEY"
Réponse 200 (extrait)
{
  "ok": true,
  "data": {
    "items": [
      {
        "customerNumber": "C2003",
        "customerName": "Distribution Exemple inc.",
        "invoiceNumber": "70412",
        "date": "2026-07-18",
        "reference": "CMD-5412",
        "subTotal": 1250.00,
        "total": 1437.19,
        "transactionType": 3,
        "paid": false,
        "salesRepNumber": "V2",
        "modifiedAt": "2026-07-18T15:02:11",
        "position": 413
      }
    ],
    "nextCursor": null,
    "scanned": 57
  },
  "requestId": "e8a1c3d5-2f4b-4c6d-9e8f-0a1b2c3d4e5f"
}

Tableaux de bord et BI

Le rapport du lundi, sans exportation

Chaque semaine, quelqu’un exporte ventes et achats, les colle dans un classeur et refait les mêmes formules.

Aujourd’hui
Exportations manuelles, fichiers en double, chiffres déjà périmés au moment de la réunion.
Avec Ponteo Connect
Votre outil de BI ou votre classeur (p. ex. Power BI, Excel) interroge directement les factures clients, les factures fournisseurs et la charte de comptes.
Bon à savoir
Une requête planifiée en dehors des heures de pointe ménage le serveur comptable. La pagination maximale est de 200 éléments par page. Pour un volume d’appels élevé, voyez le forfait Illimité.
  • GET/v1/invoices/ar
  • GET/v1/invoices/ap
  • GET/v1/accounts
PowerShell
# PowerShell : toutes les factures clients du mois, page par page
$headers = @{ Authorization = "Bearer $env:PONTEO_KEY" }
$base    = "https://api.ponteo.ca/v1/invoices/ar?from=2026-08-01&to=2026-08-31&limit=200"
$cursor  = $null
$rows    = @()
do {
  $url    = if ($cursor) { "$base&cursor=$cursor" } else { $base }
  $page   = Invoke-RestMethod -Uri $url -Headers $headers
  $rows  += $page.data.items
  $cursor = $page.data.nextCursor
} while ($cursor)
$rows | Export-Csv ventes-aout.csv -NoTypeInformation

Entrepôt et terrain

« Il en reste combien, et où ? »

Au comptoir, dans l’entrepôt ou chez le client, la réponse est dans le logiciel comptable… au bureau.

Aujourd’hui
Un appel au bureau, une vérification manuelle, une réponse approximative.
Avec Ponteo Connect
Une application interne sur tablette lit la fiche du produit : quantité en main, disponible, commandée, et emplacement.
Bon à savoir
La clé de licence reste sur votre serveur d’application : la tablette interroge votre service, jamais l’API directement.
  • GET/v1/products/{number}
Requête
curl https://api.ponteo.ca/v1/products/P-10011 \
  -H "Authorization: Bearer $PONTEO_KEY"
Réponse 200 (extrait)
{
  "ok": true,
  "data": {
    "number": "P-10011",
    "description": "Gants de nitrile (boîte de 100)",
    "unitCode": "UN",
    "location": "A2-2",
    "stock": { "onHand": 40, "available": 34, "reserved": 6, "ordered": 100, "reorderPoint": 40 }
  },
  "requestId": "5d3c1b2a-7e6f-4a9b-8c0d-1e2f3a4b5c6d"
}

Tout ce que l’API permet, concrètement

Les opérations courantes d’une PME, avec la route à appeler. Chaque ligne indique honnêtement son état : vérifiée sur une vraie compagnie Acomba, disponible mais à valider sur votre installation, ou non disponible (avec la solution de rechange).

  • Disponible vérifiée sur une compagnie Acomba réelle
  • À valider route disponible (ressource du SDK), non vérifiée sur des données réelles
  • Selon module exige un module Acomba ou Avantage
  • Non disponible hors de portée de l’API, pour l’instant

Clients

Je veux…RouteÉtat
Lister mes clients actifs, ou ceux modifiés depuis une date
GET/v1/customers?active=true&modifiedSince=…
 Disponible
Lire une fiche client : coordonnées, solde à recevoir, total des achats, dernier achat
GET/v1/customers/{number}
 Disponible
Créer un clientActif par défaut. Un numéro déjà utilisé est refusé (409).
POST/v1/customers
 Disponible
Mettre à jour une fiche client : adresse, téléphone, télécopieur, courriel, représentant, territoireSeuls les champs envoyés changent.
PATCH/v1/customers/{number}
 Disponible
Désactiver ou supprimer un clientDésactiver : {"active": false}.
PATCH/v1/customers/{number}
DELETE/v1/customers/{number}
 Disponible
Consulter les paiements reçus d’un clientLecture.
GET/v1/customer-payments
GET/v1/customer-payment-lines
 Disponible
Enregistrer un paiement reçuRessource du SDK, champs d’origine ; à valider sur une copie de votre compagnie.
POST/v1/customer-payments
 À valider
Gérer représentants, territoires, conditions de paiement, escomptes, modes de livraisonCréation, modification et suppression vérifiées.
GET/v1/sales-reps
POST/v1/territories
 Disponible

Produits et inventaire

Je veux…RouteÉtat
Lire la quantité en main, disponible, réservée, commandée et le point de commande d’un produit
GET/v1/products/{number}
 Disponible
Synchroniser le catalogue d’une boutique (produits modifiés depuis la dernière fois)
GET/v1/products?modifiedSince=…
 Disponible
Changer le nom (description), le prix de vente, l’emplacement ou le point de commande d’un produitPrix : liste de prix 1, niveau 1 ; les autres niveaux par la ressource générique (PrSellingPrice[liste,niveau]).
PATCH/v1/products/{number}
 Disponible
Créer ou supprimer un produitLe groupe de produits est obligatoire à la création.
POST/v1/products
DELETE/v1/products/{number}
 Disponible
Suivre les mouvements d’inventaire d’un produitLecture.
GET/v1/product-trails
 Disponible
Lire les groupes de produits
GET/v1/product-groups
 Disponible
Lire les fournisseurs d’un produit, les numéros de série, les composantes
GET/v1/product-suppliers
GET/v1/product-serials
 À valider
Faire un ajustement d’inventaire (entrée ou sortie de stock)Non exposé par l’API pour l’instant ; réalisable en intégration sur mesure. — Non disponible

Ventes et factures clients

Je veux…RouteÉtat
Lister les factures d’un client sur une période
GET/v1/invoices/ar?customer=…&from=…&to=…
 Disponible
Lire une facture client : total, taxes, répartition, statut payé
GET/v1/invoices/ar/{customer}/{number}
 Disponible
Créer une facture client comptable (commande web, abonnement, frais), sans doublonCompte clients en négatif, ventes et taxes en positif. Règles.
POST/v1/invoices/ar
 Disponible
Créer une note de crédit client"type": "credit", signes inversés.
POST/v1/invoices/ar
 Disponible
Supprimer une facture clientRefusée si elle est payée.
DELETE/v1/invoices/ar/{customer}/{number}
 Disponible
Lire les commandes, soumissions et factures du module Facturation, avec leurs lignes de produitsLecture.
GET/v1/sales-documents
GET/v1/sales-document-lines
 Disponible
Créer une facture, une commande ou une soumission à lignes de produits (sortie d’inventaire)Pas encore pris en charge ; sur mesure. — Non disponible
Obtenir le PDF d’une factureLe SDK d’Acomba ne produit pas de document : générez le PDF dans votre système à partir de GET /v1/invoices/ar/…. — Non disponible
Envoyer une facture par courriel depuis AcombaEnvoyez-la depuis votre système avec les données lues par l’API. — Non disponible

Fournisseurs et comptes payables

Je veux…RouteÉtat
Lister, créer, modifier ou supprimer un fournisseur
GET/v1/suppliers
POST/v1/suppliers
 Disponible
Lister les factures d’un fournisseur ou d’une période
GET/v1/invoices/ap?supplier=…&from=…
 Disponible
Lire une facture fournisseur avec sa répartition
GET/v1/invoices/ap/{supplier}/{number}
 Disponible
Écrire une facture fournisseur approuvée : simulation, puis écriture sans doublon
POST/v1/invoices/ap?dryRun=true
POST/v1/invoices/ap
 Disponible
Écrire une note de crédit fournisseur"type": "credit".
POST/v1/invoices/ap
 Disponible
Supprimer une facture fournisseur non payéeUne facture payée est refusée (409).
DELETE/v1/invoices/ap/{supplier}/{number}
 Disponible
Consulter les paiements faits aux fournisseursLecture.
GET/v1/supplier-payments
GET/v1/supplier-payment-lines
 Disponible
Émettre un paiement ou un chèque fournisseurÀ valider sur une copie de votre compagnie.
POST/v1/supplier-payments
 À valider

Comptabilité générale

Je veux…RouteÉtat
Lire la charte comptable
GET/v1/accounts
 Disponible
Créer, renommer ou désactiver un compte
POST/v1/accounts
PATCH/v1/accounts/{number}
 Disponible
Lire les écritures du grand livreEn-têtes des écritures.
GET/v1/gl-entries
GET/v1/journal-transactions
 Disponible
Passer une écriture de journal généralPas encore pris en charge ; sur mesure. — Non disponible
Lire les taxes et les groupes de taxes
GET/v1/taxes
GET/v1/tax-groups
 Disponible
Obtenir les montants calculés du bilan ou de l’état des résultatsLes ressources balance-sheet et income-statement décrivent la présentation, pas les montants. — Non disponible
Lire les projets et leurs soldes
GET/v1/projects
GET/v1/project-balances
 Disponible

Entreprise, paramètres et suivi

Je veux…RouteÉtat
Vérifier que la compagnie répond, la version de l’agent et les modules actifs
GET/v1/health
GET/v1/company
 Disponible
Lire ou mettre à jour le nom, l’adresse et les numéros de taxes de l’entreprise
GET/v1/company-information
PATCH/v1/company-information
 Disponible
Lire les paramètres des modulesModification possible pour les clients, l’inventaire, les commandes et les cartes-cadeaux ; grand livre, fournisseurs, paie et CRM en lecture seule.
GET/v1/settings-customers
 Disponible
Employés, paie, feuilles de tempsModule Paie.
GET/v1/employees
GET/v1/timesheets
 Selon module
Contacts et appels du CRM
GET/v1/addresses
GET/v1/calls
 À valider
Analyses des ventes et des achats (BI)Module d’analyse ; sinon MODULE_INACTIVE.
GET/v1/bi-sales-by-customer
 Selon module

Référence complète des 90 ressources, avec leurs routes et leur état : documentation de l’API. Toute écriture exige qu’elle soit permise par la licence et autorisée dans l’agent pour la compagnie.

Des commandes WooCommerce ou Shopify créées dans Acomba

Transformer automatiquement une commande web en facture dans Acomba ou Avantage, c’est le rôle des connecteurs e-commerce Ponteo Connect, qui synchronisent aussi produits, prix, inventaire et clients.

Aujourd’hui, la commande est enregistrée comme facture client comptable (compte clients, ventes, taxes), sans doublon. La facture à lignes de produits du module Facturation, qui fait sortir la marchandise de l’inventaire, n’est pas encore prise en charge par l’API : elle se réalise en intégration sur mesure.

Découvrir les connecteurs

Votre cas n’est pas dans la liste ?

Décrivez-nous les données à synchroniser et les outils à relier : la soumission pour une intégration sur mesure est gratuite.

Décrire mon besoinDocumentation