# Automatically collect tax on invoices Learn how to automatically calculate tax on your invoices. En una *factura* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice), Stripe Tax calcula el impuesto sobre las ventas, el IVA y el GST. Para calcularlos por cada partida individual, Stripe usa lo siguiente: - Tu [configuración de impuestos](https://dashboard.stripe.com/settings/tax) - La configuración fiscal y la ubicación del cliente - El código fiscal del producto y el comportamiento fiscal del precio Stripe calcula el impuesto a la tasa publicada en el momento de finalizar la factura. Por ejemplo, si inicias un borrador de factura el 20 de diciembre y lo estableces para finalizar el 15 de enero, entonces el 1 de enero introduces una nueva tasa impositiva. Posteriormente, Stripe calcula la factura a la nueva tasa. [Watch on YouTube](https://www.youtube.com/watch?v=_A2tC63ooSs) ## Configurar el cliente Utilizamos la ubicación del cliente para determinar los impuestos pertinentes a cobrar. Los diferentes países tienen diferentes requisitos de configuración: - Los clientes fuera de Estados Unidos deben proporcionar al menos una dirección a nivel de país. - Los clientes en Estados Unidos deben proporcionar un código postal de 5 dígitos. - Los clientes en Canadá deben proporcionar ya sea la provincia o el código postal. #### Dashboard Puedes agregar información de la ubicación del cliente en la página **Datos del cliente** haciendo click en **Editar** junto a **Datos**. Para agregar la ubicación de un cliente desde el [editor de facturas](https://dashboard.stripe.com/invoices/create), haz clic en el menú de contenido adicional (⋯) junto al cliente. Selecciona **Editar información del cliente**, haz clic en **Agregar datos adicionales** y desplázate hacia abajo hasta **Datos de facturación**. Después de actualizar la ubicación, haz click en **Actualizar cliente**. Stripe aplica la nueva ubicación a todas las facturas futuras de tus clientes a menos que la actualices. Para obtener más información, consulta [Determinar las ubicaciones de los clientes](https://docs.stripe.com/tax/customer-locations.md). #### API #### Cliente v1 Crea un cliente y proporciona la mayor cantidad de información posible para identificar su ubicación y requisitos fiscales. Te recomendamos completar [customer.address](https://docs.stripe.com/api/customers/create.md#create_customer-address) con la dirección de facturación completa de tu cliente. Validar la dirección del cliente en el momento de la creación mediante [tax[validate_location]=“immediately”](https://docs.stripe.com/api/customers/create.md#create_customer-tax-validate_location). También puedes [expandir](https://docs.stripe.com/api/expanding_objects.md) el parámetro [de impuesto](https://docs.stripe.com/api/customers/create.md#create_customer-tax) para confirmar la ubicación identificada de Stripe Tax para tu cliente. ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ -d "description=a new user" \ -d "address[line1]=510 Townsend St" \ -d "address[city]=San Francisco" \ -d "address[state]=CA" \ -d "address[country]=US" \ -d "address[postal_code]=94103" \ -d "tax[validate_location]=immediately" \ -d "expand[]=tax" ``` En lugar de una dirección, puedes proporcionar su dirección IP: ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ -d "description=a new user" \ -d "tax[ip_address]=203.0.113.0" \ -d "tax[validate_location]=immediately" \ -d "expand[]=tax" ``` El campo `tax` expandido indica la ubicación fiscal calculada y si el cliente es compatible con el cálculo automático de impuestos: ```json { "id": ""{{CUSTOMER_ID}}"", "object": "customer", // ... other fields omitted "tax": { "location": { "country": "US", "state": "CA", "source": "billing_address" }, "ip_address": null,"automatic_tax": "supported" } } ``` El parámetro [tax[automatic_tax]](https://docs.stripe.com/api/customers/object.md#customer_object-tax-automatic_tax) tiene los siguientes valores: | Estado | Descripción | Acción posible | | ----------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `supported` | El cálculo automático de impuestos es totalmente compatible. | No es necesario hacer nada más. | | `unrecognized_location` | La dirección no es válida para determinar una ubicación fiscal. | Solicita al cliente una nueva dirección y establece `customer.address` en el nuevo valor. | | `not_collecting` | La dirección se puede resolver en una ubicación para la que no configuraste un registro. | Dependiendo de tus obligaciones fiscales, puedes continuar y Stripe Tax no aplicará ningún impuesto, o puedes [agregar un nuevo registro](https://docs.stripe.com/tax/registering.md) para la jurisdicción de este cliente. | | `failed` | Se produjo un error con los servidores de Stripe. Esto es raro. | Vuelve a intentarlo o ponte en contacto con soporte de Stripe para recibir ayuda adicional. | ## Configura partidas Para calcular impuestos en cada ítem de una factura, debes establecer un comportamiento fiscal y, opcionalmente, un código fiscal. ### Personaliza la configuración de impuestos para partidas de factura puntuales Personaliza las partidas en el editor de facturas seleccionando el comportamiento fiscal en el menú desplegable **Incluir impuestos en el precio**. ### Personaliza la configuración de impuestos para ítems de factura basados en productos Puedes usar tanto el Dashboard como la API para personalizar la configuración de impuestos de las partidas individuales basadas en productos. #### Dashboard En la [página de productos](https://dashboard.stripe.com/products), puedes seleccionar tanto el comportamiento fiscal de un precio en particular como el código fiscal opcional del producto. El comportamiento fiscal es por precio. No puedes cambiar el comportamiento fiscal después de seleccionarlo, pero puedes crear precios nuevos o archivar los antiguos. Para configurar un comportamiento fiscal, haz clic en **Agregar un precio** (o en **Agregar otro precio** si ya tienes uno) y selecciónalo en el menú desplegable **Comportamiento fiscal**. Para configurar un código fiscal, selecciónalo en el menú desplegable **Código fiscal** al crear un nuevo producto o editar los datos de uno existente. #### API Stripe Tax usa la información almacenada en los objetos [Products](https://docs.stripe.com/api/products.md) y [Prices](https://docs.stripe.com/api/prices.md) para determinar las tasas y reglas que se aplicarán para calcular los impuestos. Actualiza los productos y precios que usas con las facturas para incluir: - [Comportamiento fiscal](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#tax-behavior), ya sea *incluido* o *no incluido*. Esto determina si el impuesto ya está incluido o no en tu precio. Por ejemplo, una partida incluida con un importe de USD 10 totaliza USD 10, mientras que una partida no incluida con un importe de USD 10 totaliza USD 10 más el impuesto. No incluir el impuesto en el precio es una práctica común en los mercados estadounidenses y para las ventas B2B, mientras que incluir el impuesto es una práctica común para los compradores B2C en muchos mercados fuera de los EE. UU. Establecer el comportamiento fiscal de manera explícita en un precio es opcional si [configuras el comportamiento fiscal predeterminado](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#set-tax-behavior-on-price) en la [configuración de Stripe Tax](https://dashboard.stripe.com/login?redirect=%2Fsettings%2Ftax). Puedes anular la configuración del comportamiento fiscal predeterminado estableciendo un comportamiento fiscal en un precio. - [Código fiscal](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md) (opcional): una selección de una lista de opciones que determinan qué tipo de producto es. Algunos ejemplos son «Libro de audio», «Tarjeta de regalo» o «Software como servicio». Si no lo estableces explícitamente, se aplica tu código fiscal preestablecido. > No puedes cambiar `tax_behavior` después de haberlo establecido como *exclusivo* o *inclusivo*. Si quieres cambiar el comportamiento fiscal de un precio, tienes que crear un nuevo precio con el comportamiento deseado y archivar el precio anterior. ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d unit_amount=5000 \ -d currency=usd \ -d tax_behavior=exclusive \ -d "product_data[name]=A new product" ``` ## Habilitar cálculo automático de impuestos #### Dashboard > [Inicia sesión](https://dashboard.stripe.com/settings/tax) o [crea un cuenta](https://dashboard.stripe.com/register) para que Stripe habilite Stripe Tax. Activa la opción **Usar cobro automático de impuestos** en la página de [configuración de impuestos](https://dashboard.stripe.com/settings/tax/integrations) para habilitar automáticamente el cálculo de impuestos en facturas *nuevas* creadas en el Dashboard. ### Actualiza facturas no gravadas Para habilitar el cálculo automático de impuestos para facturas existentes: 1. Haz clic en **Editar factura** en la página **Datos de factura** o haz clic en el menú de contenido adicional de la factura (⋯) y luego en **Editar factura** desde la [página Facturas](https://dashboard.stripe.com/test/invoices) para crear un nuevo borrador en el **Editor de facturas**. 1. En el editor, activa la opción **Cobrar impuestos automáticamente**. 1. Si al cliente le falta la información de la dirección necesaria para el cálculo de impuestos, un identificador de notificación te avisa y proporciona instrucciones para resolver el problema. 1. Guarda la factura para habilitar los cálculos de impuestos automáticos en todas las instancias futuras de la factura. Obtén más información sobre [cómo editar facturas después de la finalización](https://docs.stripe.com/invoicing/invoice-edits.md). ### Actualiza las facturas con las tasas impositivas existentes Para reemplazar las [tasas impositivas](https://docs.stripe.com/billing/taxes/tax-rates.md) de la factura por el cálculo automático de impuestos, sigue los pasos anteriores para editar la factura. A continuación, elimina las tasas impositivas aplicadas y activa la opción **Cobrar impuestos automáticamente**. #### API #### Cliente v1 Después de especificar un comportamiento y un código fiscales, puedes agregar el precio al cliente como una partida de factura: ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "pricing[price]={{PRICE_ID}}" ``` En la API, especifica el campo `automatic_tax` para habilitar o deshabilitar el cálculo automático de impuestos. ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "automatic_tax[enabled]=true" ``` Para habilitar el cálculo automático de impuestos cuando actualices una factura, establece `automatic_tax [enabled]` en `true`: ```curl curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}} \ -u "<>:" \ -d "automatic_tax[enabled]=true" ``` ## See also - [Determine customer locations](https://docs.stripe.com/tax/customer-locations.md) - [Understand zero tax amounts](https://docs.stripe.com/tax/zero-tax.md) - [Reporting and filing](https://docs.stripe.com/tax/reports.md) - [Use Stripe Tax with Connect](https://docs.stripe.com/tax/connect.md) - [Calculate tax in your custom checkout flow](https://docs.stripe.com/tax/custom.md)