L’API de taxe de vente pour le calcul, la TVA et les déclarations

Qu’est-ce qu’une API de taxe de vente?

Ce que fait l’API Kintsugi

• Calcul des taxes

  Estimez la taxe au paiement ou sur une facture. Renvoie la taxe, le montant taxable et le taux par article, ventilés selon les territoires qui la perçoivent, avec le motif de toute exemption. Rien n’est enregistré : appelez-la aussi souvent que le panier change.

  • POST /v1/tax/estimate

• Transactions et remboursements

  Enregistrez chaque vente conclue et chaque remboursement. Kintsugi utilise ces transactions synchronisées pour suivre votre nexus et préparer vos déclarations.

  • POST /v1/transactions
  • POST /v1/transactions/{original_transaction_id}/credit_notes

• Validation d’adresse

  Normalisez l’adresse d’un client avant le calcul. La réponse complète des champs comme le comté, dont dépendent les taux locaux.

  • POST /v1/address_validation/search
  • POST /v1/address_validation/suggestions

• Produits et taxabilité

  Créez votre catalogue une seule fois et classez chaque produit dans une catégorie et une sous-catégorie Kintsugi, qui déterminent son imposition dans chaque État.

  • POST /v1/products
  • GET /v1/products/categories

• Clients et exemptions

  Enregistrez vos clients et leurs certificats d’exemption : Kintsugi applique l’exemption à chaque estimation qui fait référence au client.

  • POST /v1/customers
  • POST /v1/exemptions
  • POST /v1/exemptions/{exemption_id}/attachments

• Nexus

  Consultez où vous avez un nexus et enregistrez votre nexus physique, comme des bureaux, des employés ou des stocks, pour qu’il soit pris en compte avec le nexus économique.

  • GET /v1/nexus
  • POST /v1/nexus/physical_nexus

• Inscriptions

  Lancez et suivez les inscriptions à la taxe de vente, à la TVA et à la TPS depuis votre propre produit, y compris les champs propres à chaque territoire.

  • POST /v1/registrations
  • GET /v1/registrations/jurisdictions

• Déclarations

  Affichez la liste des déclarations que Kintsugi prépare pour vous, consultez les transactions de chacune et approuvez une déclaration au moyen de l’API.

  • GET /v1/filings
  • PUT /v1/filings/{filing_id}/approve

Consultez tous les points de terminaison dans la référence de l’API (en anglais).

Calculez la taxe en une seule requête

Authentifiez-vous avec votre clé API et votre identifiant d’organisation, envoyez la vente et lisez la taxe dans la réponse. Les montants sont renvoyés sous forme de chaînes décimales : traitez-les avec un type qui préserve la précision décimale.

curl -X POST https://api.trykintsugi.com/v1/tax/estimate \
  -H "x-api-key: $KINTSUGI_API_KEY" \
  -H "x-organization-id: $KINTSUGI_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-01-15T10:00:00Z",
    "external_id": "EST-2026-001",
    "currency": "USD",
    "transaction_items": [
      {
        "external_id": "ITEM-001",
        "date": "2026-01-15T10:00:00Z",
        "external_product_id": "PROD-12345",
        "quantity": 1,
        "amount": 100.00
      }
    ],
    "addresses": [
      {
        "type": "SHIP_TO",
        "street_1": "123 Main St",
        "city": "Seattle",
        "state": "WA",
        "postal_code": "98101",
        "country": "US"
      }
    ]
  }'

Tiré du guide de calcul de la taxe de vente (en anglais), qui détaille les champs obligatoires, les exemptions et la réponse complète.

SDK officiels

• Pythonpip install kintsugi-tax-platform-sdk
• TypeScriptnpm add @kintsugi-tax/tax-platform-sdk
• Javacom.trykintsugi:kintsugi-tax-java-sdk
• PHPcomposer require kintsugi-tax/tax-platform-sdk
• Rubygem install kintsugi_sdk

Ressources pour les développeurs

• Premiers pas

  Connectez vos données et faites votre premier appel authentifié.

• Référence de l’API

  Tous les points de terminaison, avec les schémas de requête et de réponse.

• Guide de calcul de la taxe de vente

  Quand appeler le point de terminaison d’estimation et comment structurer la requête.

• SDK

  Clients Python, TypeScript, Java, PHP et Ruby.

• API Lab

  Exécutez chaque processus de façon interactive dans un bac à sable simulé.

• Kintsugi MCP

  Donnez à votre assistant de programmation IA la spécification et la documentation à jour de l’API.

• Migrer depuis Avalara ou TaxJar

  Associez vos appels existants aux points de terminaison Kintsugi et faites la transition en douceur.