Die Sales-Tax-API für Berechnung, Umsatzsteuer und Steuererklärungen

Was ist eine Sales-Tax-API?

Was die Kintsugi API kann

• Steuerberechnung

  Ermitteln Sie die Steuer im Checkout oder auf einer Rechnung. Liefert Steuer, steuerpflichtigen Betrag und Steuersatz pro Position, aufgeschlüsselt nach den erhebenden Steuergebieten, samt Grund für eine etwaige Befreiung. Es wird nichts gespeichert, Sie können die Abfrage also bei jeder Änderung des Warenkorbs wiederholen.

  • POST /v1/tax/estimate

• Transaktionen und Erstattungen

  Erfassen Sie jeden abgeschlossenen Verkauf und jede Erstattung. Anhand der synchronisierten Transaktionen verfolgt Kintsugi Ihren Nexus und erstellt Ihre Steuererklärungen.

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

• Adressprüfung

  Vereinheitlichen Sie die Adresse eines Kunden vor der Berechnung. Die Antwort ergänzt Felder wie das County, von dem lokale Steuersätze abhängen.

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

• Produkte und Steuerpflicht

  Legen Sie Ihren Katalog einmal an und ordnen Sie jedes Produkt einer Kategorie und Unterkategorie von Kintsugi zu. Daraus ergibt sich, wie es in jedem Bundesstaat besteuert wird.

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

• Kunden und Befreiungen

  Speichern Sie Kunden und ihre Befreiungszertifikate. Kintsugi wendet die Befreiung dann bei jeder Berechnung an, die auf den Kunden verweist.

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

• Nexus

  Rufen Sie ab, wo Sie Nexus haben, und erfassen Sie physischen Nexus wie Büros, Mitarbeitende oder Lagerbestände, damit er neben dem wirtschaftlichen Nexus berücksichtigt wird.

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

• Registrierungen

  Starten und verfolgen Sie Registrierungen für Sales Tax, Umsatzsteuer und GST direkt aus Ihrem Produkt, einschließlich der Angaben, die jedes Steuergebiet verlangt.

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

• Steuererklärungen

  Listen Sie die Steuererklärungen auf, die Kintsugi für Sie erstellt, sehen Sie die enthaltenen Transaktionen ein und geben Sie eine Steuererklärung über die API frei.

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

Alle Endpunkte finden Sie in der API-Referenz (auf Englisch).

Steuer mit einer einzigen Anfrage berechnen

Authentifizieren Sie sich mit Ihrem API-Schlüssel und Ihrer Organisations-ID, senden Sie den Verkauf und lesen Sie die Steuer aus der Antwort. Beträge werden als Dezimalzeichenketten zurückgegeben. Verarbeiten Sie sie daher mit einem Datentyp, der Dezimalzahlen exakt abbildet.

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"
      }
    ]
  }'

Aus dem Leitfaden zur Sales-Tax-Berechnung (auf Englisch), der Pflichtfelder, Befreiungen und die vollständige Antwort beschreibt.

Offizielle SDKs

• 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

Ressourcen für Entwickler

• Erste Schritte

  Verbinden Sie Ihre Daten und senden Sie Ihre erste authentifizierte Anfrage.

• API-Referenz

  Alle Endpunkte mit Request- und Response-Schemas.

• Leitfaden zur Sales-Tax-Berechnung

  Wann Sie den Estimate-Endpunkt aufrufen und wie Sie die Anfrage aufbauen.

• SDKs

  Clients für Python, TypeScript, Java, PHP und Ruby.

• API Lab

  Jeden Ablauf interaktiv in einer simulierten Sandbox ausprobieren.

• Kintsugi MCP

  Geben Sie Ihrem KI-Coding-Assistenten die aktuelle API-Spezifikation und Dokumentation.

• Umstieg von Avalara oder TaxJar

  Ordnen Sie Ihre bestehenden Aufrufe den Kintsugi-Endpunkten zu und wechseln Sie sauber.