Intégrations

Comptabilité, PGI, commerce en ligne, paie, paiements : une seule porte d'entrée pour les dossiers et les documents, avec le consentement du client.

Une intégration est une connexion entre votre application et un profil fiscal client, dans un environnement, avec les autorisations que le propriétaire du profil a accordées : records.import, records.read, documents.write. Le propriétaire l'accorde et peut la révoquer depuis les paramètres du profil; vous pouvez aussi y mettre fin. Chaque catégorie nommée par le site est une catégorie de connexion (ACCOUNTING, ERP, ECOMMERCE, PAYROLL, PAYMENTS, CUSTOM), de sorte que la base est la même, que les dossiers viennent d'un grand livre, d'un flux de commandes, d'une paie ou d'un rapport de versements.

Deux façons de se connecter

Invitation : POST /v1/connections avec le courriel du client; TaxPio lui envoie un lien, il choisit un profil et les autorisations, et la connexion devient ACTIVE. Vous recevez connection.activated.
Code de connexion : chaque application a un code de connexion (tpapp_…) dans la console des développeurs. Le client le saisit depuis la page Applications connectées de son profil. Même résultat, sans courriel.

Inviter un client

curl https://api.taxpio.com/v1/connections \
  -H "Authorization: Bearer tp_test_…" \
  -H "Content-Type: application/json" \
  -d '{"client_email":"owner@example.com","client_name":"Acme Widgets","category":"ACCOUNTING","system_name":"QuickBooks Online","permissions":["records.import","records.read","documents.write"]}'

Envoyer des dossiers

POST /v1/connections/{connectionId}/records avec jusqu'à 500 dossiers. Chacun porte votre external_id stable, une date, une description et un montant signé dans la devise du profil (négatif pour l'argent sortant). Une répétition du même external_id est comptée comme doublon et jamais écrite deux fois; rejouer une journée est donc sûr. Les dossiers arrivent comme opérations non révisées avec des suggestions d'association de reçus, exactement comme une synchronisation bancaire; le propriétaire les confirme dans TaxPio. Une contrepartie que vous envoyez est intégrée à la description lorsqu'elle n'y est pas déjà nommée, et la catégorie suit dans la piste d'audit de l'importation; la classification propre à TaxPio est établie à la révision. Vous recevez records.imported.

curl https://api.taxpio.com/v1/connections/con_…/records \
  -H "Authorization: Bearer tp_test_…" \
  -H "Idempotency-Key: 2026-09-07-batch-1" \
  -H "Content-Type: application/json" \
  -d '{"records":[{"external_id":"inv-1042","occurred_at":"2026-09-01","description":"Invoice 1042 · Northwind","amount":"1250.00","counterparty":"Northwind Traders","category":"Sales"},{"external_id":"bill-88","occurred_at":"2026-09-02","description":"Hosting September","amount":"-89.00","counterparty":"Cloud Host Inc"}]}'

Catégorie	Ce qu'il faut envoyer comme dossier
`ACCOUNTING`	Chaque ligne de journal ou de flux bancaire que le client veut dans TaxPio : les factures comme argent entrant, les factures fournisseurs et les dépenses comme argent sortant, avec les identifiants propres au grand livre.
`ERP`	Les opérations comptabilisées des grands livres auxiliaires que vous détenez (ventes, achats, dépenses); gardez le numéro de document du PGI comme external_id.
`ECOMMERCE`	Les versements ou commandes réglées, nets des frais en lignes distinctes (commande comme argent entrant, frais comme argent sortant), les remboursements en lignes négatives.
`PAYROLL`	Les totaux de chaque paie comme argent sortant (salaire brut, cotisations de l'employeur) avec l'identifiant de la paie; le détail par employé reste dans la paie.
`PAYMENTS`	Les règlements et frais du processeur, une ligne par règlement et une par frais, avec les identifiants d'opération du processeur.
`CUSTOM`	Toute autre chose avec un identifiant stable, une date, une description et un montant signé.

Téléverser des documents

POST /v1/connections/{connectionId}/documents en multipart/form-data avec le fichier (PDF, JPEG, PNG ou WebP, jusqu'à 15 Mo) : factures, reçus, relevés. La chaîne de traitement du coffre et les suggestions de l'IA s'exécutent comme pour toute saisie, et le propriétaire voit le document sous Documents avec sa provenance.

Rien de ce qu'une application envoie n'est produit. Les dossiers arrivent non révisés; les documents arrivent comme pièces; la transmission gouvernementale exige toujours l'autorisation de la personne elle-même dans TaxPio.