OdooWiki OCA HUB

Avalara Avatax Certified Connector

account_avatax_oca folder_open OCA/account-fiscal-rule open_in_new
Accounting Licencia: AGPL-3

¡CERTIFICACIÓN DE AVALARA PENDIENTE!

Odoo proporciona integración con AvaTax, un software de solución de impuestos de Avalara que incluye el cálculo del impuesto sobre las ventas para todos los estados y territorios de EE. UU. y todas las provincias y territorios de Canadá (incluidos GST, PST y HST).

Este módulo es capaz de detectar automáticamente el origen (Output Warehouse) y el destino (Client Address), luego calcular y reportar impuestos a la cuenta de Avalara del usuario, así como registrar los impuestos sobre las ventas correctos para las direcciones validadas dentro de Odoo ERP.

Este módulo es compatible tanto con las ediciones Odoo Enterprise como Odoo Community.

Se necesita una cuenta de Avatax. La información de la cuenta para acceder al panel de Avatax se puede obtener a través del sitio web de Avalara aquí:

Una vez configurado, el módulo opera en segundo plano y realiza cálculos y reportes sin problemas al servidor de AvaTax.

Esta guía incluye instrucciones para los siguientes elementos:

  • Activar la cuenta de AvaTax de su organización y descargar el producto
  • Introducir las credenciales de AvaTax en su base de datos de Odoo y configurarla para usar los servicios y funciones de AvaTax dentro de Odoo

Nota: Pruebe el módulo antes de implementarlo en un entorno en vivo. Todos los cambios en la configuración de AvaTax deben ser realizados por un usuario con derechos de acceso administrativo.

IMPORTANTE - resolución del conflicto de nombres con Odoo EE

El soporte de Avatax se añadió a Odoo EE 14 y 15. Desafortunadamente, los nombres de los módulos utilizados son los mismos que los de OCA, y debido a esta colisión de nombres los módulos de OCA se vieron obligados a cambiar de nombre.

El módulo principal fue renombrado de account_avatax (ahora utilizado por Odoo EE) a account_avatax_oca.

Para aplicar este cambio en su base de datos de odoo y continuar usando el conector certificado de Avalara de OCA:

> 1. Asegúrese de tener la última versión de OCA, y de que ve account_avatax_oca > en su lista de Aplicaciones. > > 2. Instale el nuevo módulo account_avatax_oca > > 3. Desinstale el módulo account_avatax > > 4. Confirme que sus configuraciones se mantuvieron seguras, en particular: > Avatax API, la Posición fiscal predeterminada "Avatax", y el registro de > impuesto predeterminado "Avatax".

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Conecta Odoo con Avalara AvaTax para calcular automáticamente el impuesto sobre las ventas de EE. UU./Canadá en facturas y pedidos de venta, validar las direcciones de los clientes y registrar o anular transacciones fiscales en AvaTax.

Este módulo añade una conexión de AvaTax a Odoo Accounting. Después de introducir tu número de cuenta de Avalara, la clave de licencia y el código de empresa en la pantalla de configuración de AvaTax, Odoo puede enviar cada factura de venta o nota de crédito a AvaTax y recibir el impuesto sobre las ventas correcto.

  • En las facturas y notas de crédito obtienes un importe de AvaTax, un importe de AvaTax por línea, un código de almacén/ubicación y una opción para gravar la dirección de envío o la dirección del cliente. Los botones te permiten calcular los impuestos, confirmarlos en AvaTax o anularlos cuando restableces una factura a borrador.
  • Las direcciones de los clientes se pueden validar con AvaTax desde el formulario de contacto; se almacenan la fecha y el método de la última validación. Puedes exigir direcciones validadas antes de que se calculen los impuestos.
  • Los clientes se pueden marcar como exentos de impuestos con un número de exención y un código de exención, y las exenciones se encuentran automáticamente a partir del país y el estado de la dirección de entrega.
  • Los productos y las categorías de productos pueden llevar un código de impuesto de AvaTax, y una opción de UPC puede enviar el código de barras en lugar de la referencia interna.
  • Las opciones de configuración incluyen la URL de sandbox o de producción, el tiempo de espera de las solicitudes, el registro de las solicitudes a la API, la validación automática de direcciones, la generación automática del código de cliente, la desactivación del cálculo de impuestos y la desactivación del registro de documentos.
  • Aparecen menús en la configuración de Accounting: AvaTax API, Exemption Code y Product Tax Codes. Se proporcionan asistentes para probar la conexión, elegir el código de empresa de AvaTax y validar una dirección.

El módulo toca account.move, account.move.line, account.tax, account.fiscal.position, res.partner, res.company, product.template, product.category, stock.warehouse y añade avalara.salestax, exemption.code, product.tax.code y varios asistentes.

Depende de

sale_stockbase_geolocalize

Lo necesitan otros módulos

account_avatax_exemptionaccount_avatax_oca_logaccount_avatax_repair_ocaaccount_avatax_sale_oca

Menús que añade

AvaTaxAvaTax APImenu_action_exemption_code_detailsProduct Tax Codes
Modelos y campos (14)
  • account.tax · amplía un modelo existenteis_avatax
  • res.company · amplía un modelo existente
  • res.partner · amplía un modelo existentetax_exempt (Is Tax Exempt (Deprecated))), customer_code, date_validation (Last Validation Date), exemption_number (Exemption Number (Deprecated)), exemption_code_id, validated_on_save, validation_method, property_tax_exempt (Is Tax Exempt), property_exemption_number (Exemption Number), property_exemption_code_id, property_exemption_country_wide (Exemption Applies Country Wide)
  • account.move · amplía un modelo existenteis_avatax, warehouse_id, avatax_amount (AvaTax), location_code, so_partner_id (SO Partner), exemption_code (Exemption Number), hide_exemption (Hide Exemption & Tax Based on shipping address), invoice_doc_no (Source/Ref Invoice No), tax_address_id, exemption_locked, exemption_code_id, avatax_request_log (Avatax API Request Log), avatax_response_log (Avatax API Response Log), calculate_tax_on_save, tax_on_shipping_address (Tax based on shipping address)
  • exemption.code · modelo nuevocode, name
  • avalara.salestax · modelo nuevoactive, logging (Log API Requests), company_id, upc_enable (Enable UPC Taxability), country_ids, license_key, service_url (Service URL), company_code, account_number, hide_exemption (Hide Exemption & Tax Based on shipping address), request_timeout, use_so_partner_id (Use Sale Customer Code on Invoice), company_partner_id (Company Address), validation_on_save (Automatic Address Validation), result_in_uppercase (Return validation results in upper case), disable_tax_reporting (Disable Document Recording/Commiting), invoice_calculate_tax (Auto Calculate Tax on Invoice Save), disable_tax_calculation (Disable AvaTax Calculation), force_address_validation (Require Validated Addresses), disable_address_validation, auto_generate_customer_code (Automatically generate missing customer code)
  • product.category · amplía un modelo existentetax_code_id, applicable_tax_code_id
  • product.tax.code · modelo nuevoname (Code), type, description
  • product.template · amplía un modelo existentetax_code_id, applicable_tax_code_id
  • account.move.line · amplía un modelo existenteavatax_amt_line (AvaTax Line)
  • avalara.salestax.ping · modelo nuevoname
  • account.fiscal.position · amplía un modelo existenteis_avatax (Use Avatax API)
  • avalara.salestax.getcompany · modelo nuevocompany_code (Select a Company)
  • avalara.salestax.address.validate · modelo nuevozip, city, state, street, country, street2, original_zip, original_city, original_state, date_validation, original_street, original_country, original_street2, partner_latitude (Latitude), partner_longitude (Longitude), validation_method

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 5 confirmadas, 4 sin información de 9 versiones.

Fuentes · Odoo 17.0

Confirmado el 2026-11-03 en la rama 17.0 de OCA/account-fiscal-rule.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Instalación

Fuente · Odoo 18.0

Antes de instalar la aplicación Avatax, el cliente Python de Avalara debe estar instalado en tu sistema. Está disponible en .

Normalmente se puede instalar en tu sistema usando pip:

pip3 install Avalara

La aplicación base, account_avatax_oca, añade soporte de Avatax a las facturas de cliente. En la tienda oficial de aplicaciones:

La extensión account_avatax_sale añade soporte a los presupuestos / pedidos de venta. En la tienda oficial de aplicaciones:

En la mayoría de los casos querrás descargar e instalar ambos módulos.

Para instalar la aplicación Avatax:

  • Descarga los módulos de AvaTax
  • Extrae los archivos descargados
  • Sube los directorios extraídos a tu directorio de módulos/addons de Odoo
  • Inicia sesión en Odoo como Administrador y activa el Modo Desarrollador, en 'Settings'
  • Ve a 'Apps', selecciona el menú 'Update Apps List', para que aparezcan las nuevas aplicaciones en la lista.
  • En la lista de Apps, busca 'AvaTax'
  • Haz clic en el botón Install. Si está disponible, el módulo account_avatax_sale_oca también se instalará automáticamente.

Configuración

Fuente · Odoo 18.0

Para configurar una compañía de Odoo para usar Avatax, siga estos pasos. Tenga en cuenta que algunos de ellos pueden estar configurados de forma predeterminada para la compañía predeterminada de Odoo.

  • Configure AvaTax API Connection
  • Configure Company Taxes
  • Configure Customers
  • Configure Products

Configure Avatax API Connection

Antes de poder configurar el conector de Odoo Avatax, necesitará tener listos algunos detalles de conexión:

  • Inicie sesión en
  • Navegue a Settings \>\> All AvaTax Settings. Allí verá los detalles de la compañía.
  • Tome nota del Account ID y el Company Code
  • Navegue a Settings \>\> License and API Keys. En la pestaña "Reset License Key", haga clic en el botón "Generate License Key" y tome nota de él.

Para configurar el conector de AvaTax en Odoo:

  • Navegue a: Accounting/Invoicing App \>\> Configuration \>\> AvaTax \>\> AvaTax API
  • Haga clic en el botón Create
  • Complete el formulario con los elementos recopilados del sitio web de AvaTax:
  • Account ID
  • License Key
  • Service URL: normalmente Production, o Sandox si lo tiene disponible.
  • Company Code
  • Haga clic en el botón Test Connection
  • Haga clic en el botón Save

Otras configuraciones avanzadas de Avatax API:

  • Pestaña Tax Calculation:
  • Disable Document Recording/Commiting: las facturas no se almacenarán en Avalara
  • Enable UPC Taxability: esto transmitirá el número ean13 del producto de Odoo en lugar de su Internal Reference. Si no hay ean13, entonces se enviará automáticamente el Internal Reference.
  • Hide Exemption & Tax Based on shipping address -- esto dará al usuario la capacidad de ocultar o mostrar los campos Tax Exemption y Tax Based on shipping address a nivel de factura.
  • Pestaña Address Validation:
  • Automatic Address Validation: intenta validar automáticamente al crear y actualizar el registro del cliente; la última fecha de validación será visible y se almacenará
  • Require Validated Addresses: si la validación para el cliente es obligatoria pero no es válida, la validación se forzará
  • Return validation results in upper case: los resultados de la validación se devolverán en mayúsculas
  • Pestaña Advanced:
  • Automatically generate missing customer code: genera un código de cliente al crear y actualizar el perfil del cliente
  • Log API requests: habilita el registro detallado de transacciones de AvaTax dentro de la aplicación
  • Request Timeout: el valor predeterminado es 300ms
  • Countries: países donde se puede usar AvaTax.

Configure Company Taxes

Cada compañía vinculada a AvaTax y sus almacenes asociados deben configurarse para garantizar que el impuesto correcto se calcule y aplique en todas las transacciones.

Validate Company Address:

  • En el formulario de configuración de AvTax API, haga clic en el enlace "Company Address"
  • En el formulario de dirección de la compañía, haga clic en el botón "validate" en la pestaña "AvaTax"

Validate Warehouse Address:

  • Navegue a: Inventory \>\> Configuration \>\> Warehouse Management \>\> Warehouses
  • Para cada almacén, abra la vista correspondiente
  • En el formulario de Warehouse, haga clic en el enlace "Address"
  • En el formulario de dirección del almacén, haga clic en el botón "validate" en la pestaña "AvaTax"

Fiscal Positions es lo que le indica al conector de AvaTax si el servicio de AvaTax debe usarse para un Sales Order o Invoice en particular.

Configure Fiscal Position:

  • Navegue a: Accounting/Invoicing App \>\> Configuration \>\> Accounting \>\> Fiscal Positions
  • Asegúrese de que exista un registro de Fiscal Position para la Compañía, con la casilla "Use Avatax API" marcada

Cuando se esté usando la Fiscal Position adecuada y se recupere una tasa de impuesto de AvaTax, entonces el Tax correspondiente se creará automáticamente en Odoo usando un registro de impuesto de plantilla, que debe tener las configuraciones contables adecuadas.

Configure Taxes:

  • Navegue a: Accounting/Invoicing App \>\> Configuration \>\> Accounting \>\> Taxes
  • Asegúrese de que exista un registro de Tax para la Compañía, con la casilla "Is Avatax" marcada (visible en la pestaña "Advanced Options"). Este Tax debe tener:
  • Tax Type: Sales
  • Tax Computation: Percentage of Price
  • Amount: 0.0%
  • Distribution for Invoices: asegúrese de que la configuración de la cuenta sea correcta
  • Distribution for Credit Notes: asegúrese de que la configuración de la cuenta sea correcta

Configure Customers

Los códigos de exención están permitidos para los usuarios donde puedan aplicarse (ej. entidades gubernamentales). Navegue a: Accounting or Invoicing App \>\> Configuration \>\> AvaTax \>\> Exemption Code

El módulo se instala con 16 códigos de exención predefinidos. Puede agregar, eliminar y modificar códigos de exención.

Configurar correctamente cada cliente garantiza que el impuesto correcto se calcule y aplique en todas las transacciones.

Create New Customer

  • Navegue a Contacts
  • Haga clic en el botón Create

Configure and Validate Customer Address

  • Introduzca Customer Address
  • En AvaTax \>\> Validation, haga clic en el botón Validate
  • El AvaTax Module intentará hacer coincidir la dirección que introdujo con una dirección válida en su base de datos. Haga clic en el botón Accept si la dirección es válida.

Tax Exemption Status

  • Si el cliente está exento de impuestos, marque la casilla en AvaTax \>\> Tax Exemption \>\> Is Tax Exempt y
  • Seleccione el Tax Exempt Code deseado en el menú desplegable.

Configure Products

Cree códigos de impuesto de producto para asignarlos a productos y/o categorías de productos. Navegue a: Accounting or Invoicing App \>\> Configuration \>\> AvaTax \>\> Product Tax Codes.

Desde aquí puede agregar, eliminar y modificar los códigos de impuesto de producto.

Los productos en Odoo normalmente se asignan a categorías de productos. La configuración de AvaTax también se puede asignar a la categoría de producto cuando se crea una categoría de producto.

  • Create New Product Category
  • Navegue a: Inventory \>\> Configuration \>\> Products \>\> Product Categories
  • Haga clic en el botón Create
  • Configure Product Category Tax Code
  • En AvaTax Properties \>\> Tax Code
  • Seleccione el Tax Code deseado

Uso

Fuente · Odoo 18.0

Facturas de clientes

El módulo AvaTax está integrado en las facturas de ventas y se aplica a cada transacción. El registro de transacciones en el panel de AvaTax muestra los detalles de la factura e indica si la transacción está en estado no confirmado o confirmado.

Una factura validada tendrá el estado Committed y una factura cancelada tendrá el estado Voided.

El módulo comprobará si hay un almacén seleccionado y determinará automáticamente la dirección del almacén y la ubicación de origen. Si no hay ninguna dirección asignada al almacén, se utiliza la dirección de la empresa.

Los descuentos se gestionan cuando están habilitados en la configuración de Odoo. Se calculan como una deducción neta sobre el coste de la línea antes de enviar el total a AvaTax.

Crear nueva factura de cliente

  • Navegue a: Accounting o Invoicing \>\> Customers \>\> Invoices.
  • Haga clic en el botón Create.

Validar factura

  • Asegúrese de que la opción Tax based on shipping address esté marcada.
  • Las líneas deben tener AVATAX seleccionado en Taxes para los registros internos.
  • Para completar la factura, haga clic en el botón Validate.
  • El pedido de venta aparecerá ahora en el panel de AvaTax.

Registrar pago

  • Haga clic en el botón Register Payment para finalizar la factura.

Reembolsos de clientes

Odoo aplica reembolsos en lugar de anulaciones en su módulo de contabilidad. Al igual que con las facturas de clientes, el módulo AvaTax está integrado con los reembolsos de clientes y se aplica a cada transacción.

Las transacciones de facturas reembolsadas se indicarán con un total negativo en la interfaz de AvaTax.

Iniciar reembolso de cliente

  • Navegue a: Accounting o Invoicing \>\> Customers \>\> Invoices
  • Seleccione la factura que desea reembolsar
  • Haga clic en el botón Add Credit Note

Crear nota de crédito

  • En Credit Method, seleccione Create a draft credit note.
  • Introduzca un motivo.
  • Haga clic en el botón Add Credit Note.

Nota: Se le llevará a la vista de lista de Credit Notes

Validar reembolso

  • Seleccione la nota de crédito que desea validar, revísela y, a continuación, haga clic en el botón Validate.

Registrar pago del reembolso

  • Haga clic en el botón Register Payment para completar un reembolso

Pedidos de venta

El módulo AvaTax está integrado en los pedidos de venta y permite el cálculo de impuestos. Las transacciones de pedidos de venta no aparecen en la interfaz de AvaTax.

La información introducida en el pedido de venta pasará automáticamente a la factura en el servidor de Avalara y podrá consultarse en el panel de control de AvaTax.

Los descuentos se gestionan cuando están habilitados en la configuración de Odoo. Se informarán como una deducción neta sobre el coste de la línea.

Crear nuevo pedido de venta

  • Navegue a: Sales \>\> Orders \>\> Orders
  • Haga clic en el botón Create

Calcular impuestos con AvaTax

  • El módulo calculará los impuestos cuando se confirme el pedido de venta, o navegando a Action \>\> Update taxes with Avatax. En este paso, el pedido de venta obtendrá el importe de los impuestos de Avalara, pero no informará de la transacción al panel de AvaTax. Solo la actividad de facturas, reembolsos y pagos se informa al panel.
  • El módulo comprobará si hay un almacén seleccionado y determinará automáticamente la dirección del almacén y la ubicación de origen. Si no hay ninguna dirección asignada al almacén, el módulo utilizará automáticamente la dirección de la empresa como origen. El código de ubicación se rellenará automáticamente con el código del almacén, pero puede modificarse si es necesario.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.