A API de imposto sobre vendas para cálculo, IVA e apresentação

O que é uma API de imposto sobre vendas?

O que a API da Kintsugi faz

• Cálculo de imposto

  Calcule o imposto no checkout ou em uma fatura. Retorna imposto, valor tributável e alíquota por item, detalhados pelas jurisdições que o cobram, com o motivo de qualquer isenção. Nada é armazenado, então você pode chamar a API sempre que o carrinho mudar.

  • POST /v1/tax/estimate

• Transações e reembolsos

  Registre cada venda concluída e cada reembolso. As transações sincronizadas são o que a Kintsugi usa para monitorar o nexo e preparar suas declarações.

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

• Validação de endereço

  Padronize o endereço do cliente antes de calcular. A resposta preenche campos como o condado, dos quais dependem as alíquotas locais.

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

• Produtos e tributação

  Monte seu catálogo uma vez e classifique cada produto em uma categoria e subcategoria da Kintsugi, que define como ele é tributado em cada estado.

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

• Clientes e isenções

  Armazene clientes e seus certificados de isenção, e a Kintsugi aplica a isenção em toda estimativa que se refira ao cliente.

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

• Nexo

  Consulte onde você tem nexo e registre o nexo físico, como escritórios, funcionários ou estoque, para que ele conte junto com o nexo econômico.

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

• Registros

  Inicie e acompanhe registros de imposto sobre vendas, IVA e GST dentro do seu próprio produto, incluindo os campos específicos de cada jurisdição.

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

• Declarações

  Liste as declarações que a Kintsugi prepara para você, veja as transações de cada uma e aprove uma apresentação pela API.

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

Veja todos os endpoints na referência da API.

Calcule o imposto com uma única requisição

Autentique-se com sua chave de API e o ID da organização, envie a venda e leia o imposto na resposta. Os valores voltam como strings decimais, então use um tipo decimal seguro para convertê-los.

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

Do guia de cálculo de imposto sobre vendas, que cobre os campos obrigatórios, as isenções e a resposta completa.

SDKs oficiais

• 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

Recursos para desenvolvedores

• Primeiros passos

  Conecte seus dados e faça sua primeira chamada autenticada.

• Referência da API

  Todos os endpoints, com os esquemas de requisição e resposta.

• Guia de cálculo de imposto sobre vendas

  Quando chamar o endpoint de estimativa e como montar a requisição.

• SDKs

  Clientes em Python, TypeScript, Java, PHP e Ruby.

• API Lab

  Execute cada fluxo de forma interativa em um ambiente de teste simulado.

• Kintsugi MCP

  Dê ao seu assistente de programação com IA a especificação e a documentação atualizadas da API.

• Migração da Avalara ou da TaxJar

  Mapeie suas chamadas atuais para os endpoints da Kintsugi e faça a transição sem sobressaltos.