La API del impuesto sobre las ventas para cálculo, IVA y declaraciones

¿Qué es una API del impuesto sobre las ventas?

Qué hace la API de Kintsugi

• Cálculo de impuestos

  Cotice el impuesto al pagar o en una factura. Devuelve el impuesto, el monto gravable y la tasa de cada partida, desglosados por las jurisdicciones que lo cobran, con el motivo de cualquier exención. No se guarda nada, así que puede llamarla cada vez que cambie el carrito.

  • POST /v1/tax/estimate

• Transacciones y reembolsos

  Registre cada venta y cada reembolso completados. Las transacciones sincronizadas son las que Kintsugi usa para monitorear el nexo y preparar sus declaraciones.

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

• Validación de direcciones

  Estandarice la dirección de un cliente antes de calcular. La respuesta completa campos como el condado, del que dependen las tasas locales.

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

• Productos y gravabilidad

  Cree su catálogo una sola vez y clasifique cada producto en una categoría y subcategoría de Kintsugi, que determina cómo se grava en cada estado.

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

• Clientes y exenciones

  Almacene clientes y sus certificados de exención, y Kintsugi aplica la exención en cada estimación que haga referencia al cliente.

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

• Nexo

  Consulte dónde tiene nexo y registre el nexo físico, como oficinas, empleados o inventario, para que cuente junto con el nexo económico.

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

• Registros

  Inicie y dé seguimiento a registros de impuesto sobre las ventas, IVA y GST desde su propio producto, incluidos los campos específicos que cada jurisdicción requiere.

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

• Declaraciones

  Liste las declaraciones de impuestos que Kintsugi prepara por usted, vea las transacciones de cada una y apruebe una declaración mediante la API.

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

Consulte todos los endpoints en la referencia de la API.

Calcule el impuesto con una sola solicitud

Autentíquese con su clave de API y el ID de su organización, envíe la venta y lea el impuesto en la respuesta. Los montos regresan como cadenas decimales, así que procéselos con un tipo de dato decimal seguro.

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

Tomado de la guía de cálculo del impuesto sobre las ventas, que explica los campos obligatorios, las exenciones y la respuesta completa.

SDK oficiales

• 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 desarrolladores

• Primeros pasos

  Conecte sus datos y haga su primera llamada autenticada.

• Referencia de la API

  Todos los endpoints, con esquemas de solicitud y respuesta.

• Guía de cálculo del impuesto sobre las ventas

  Cuándo llamar al endpoint de estimación y cómo armar la solicitud.

• SDK

  Clientes de Python, TypeScript, Java, PHP y Ruby.

• API Lab

  Ejecute cada flujo de trabajo de forma interactiva en un entorno de pruebas simulado.

• Kintsugi MCP

  Dé a su asistente de programación con IA la especificación y la documentación de la API en vivo.

• Migración desde Avalara o TaxJar

  Asigne sus llamadas actuales a los endpoints de Kintsugi y haga el cambio sin contratiempos.