Shopify API 2026-07: taxSettings en Customer accesible vía GraphQL

El problema: el número de IVA existía, pero las API no lo devolvían

Cualquiera que haya construido una integración fiscal o contable sobre Shopify conoce bien la frustración: el cliente introduce su número de IVA durante el checkout, Shopify lo recoge y lo valida, pero en el momento de sincronizar ese dato con un ERP o un sistema contable externo, la información no es accesible a través de las API estándar.

Hasta ahora. Con la versión 2026-07 de la Admin GraphQL API, Shopify introduce un cambio estructural que resuelve exactamente este problema.

Qué cambia en la versión API 2026-07

El campo taxSettings en el objeto Customer pasa a ser accesible públicamente. Anteriormente, para obtener información fiscal asociada a un cliente era necesario recurrir a soluciones alternativas, accesos protegidos o lógicas personalizadas que incrementaban la complejidad de las integraciones.

Desde la versión 2026-07, con los permisos read_customers o read_taxes activos en la aplicación, es posible ejecutar queries GraphQL estándar y obtener directamente el campo taxId, que devuelve:

• Una cadena de texto con el número de IVA o VAT number, si el cliente proporcionó el dato durante el checkout
• null, si el campo no fue completado

Sin configuración adicional ni proceso de aprobación especial: basta con actualizar la versión API de destino y verificar los scopes activos.

Alcance del cambio: solo lectura

Es importante aclarar desde el principio los límites de esta novedad para evitar expectativas incorrectas durante la planificación de integraciones.

El cambio es exclusivamente de lectura. No es posible escribir ni actualizar el taxId mediante esta API pública.

Además, el campo taxIdValidation, que contiene el estado de validación del número fiscal, no está incluido en el acceso público. Para obtener el detalle del estado de validación es necesario solicitar acceso a los datos protegidos del cliente a través del proceso de aprobación específico que Shopify tiene previsto. Se trata de un procedimiento separado que debe planificarse con antelación si la integración lo requiere.

Casos de uso concretos para desarrolladores y merchants

Este cambio abre escenarios prácticos relevantes, especialmente para quienes operan en el mercado europeo o gestionan clientes business fuera del circuito B2B estructurado de Shopify.

Sincronización con ERP y sistemas contables

Uno de los casos de uso más inmediatos es la sincronización automática del VAT number hacia sistemas como SAP, Microsoft Dynamics, Holded o cualquier otro ERP que requiera el número fiscal del cliente para generar facturas conformes. Hasta ahora, este dato debía recuperarse manualmente o mediante soluciones alternativas. Con taxSettings accesible vía API, el flujo puede automatizarse por completo.

Lógicas de compliance fiscal

Para quienes venden en Europa, la correcta gestión del IVA intracomunitario depende de la disponibilidad y validez del VAT number del cliente. Contar con acceso programático a este campo permite:

• Construir reglas de precios y tributación dinámicas
• Verificar la presencia del dato antes de emitir documentos fiscales
• Integrar controles de compliance directamente en el flujo de pedidos

Alineación con el B2B de Shopify

Para los clientes que utilizan las funcionalidades B2B nativas de Shopify, el campo taxSettings en el objeto CompanyLocation está disponible desde la versión API 2025-01. La nueva accesibilidad en el objeto Customer en la versión 2026-07 representa una alineación importante, extendiendo el mismo nivel de acceso también a los clientes business no estructurados como Company en Shopify.

Cómo actualizar tu integración

Si estás desarrollando o manteniendo integraciones fiscales o ERP sobre Shopify Plus, los pasos operativos a seguir son los siguientes:

• Actualiza la versión API de destino a 2026-07 en el manifest de tu app o en las llamadas directas
• Verifica los scopes activos: asegúrate de que read_customers o read_taxes estén incluidos entre los permisos solicitados por la app
• Gestiona el caso null: implementa la lógica para manejar correctamente los clientes sin tax ID, ya que el campo devolverá null cuando no exista el dato
• Planifica el acceso protegido si tu integración también necesita el campo taxIdValidation: el proceso de aprobación de Shopify requiere tiempo y documentación

Para una visión completa de los costes y las opciones de desarrollo disponibles, puedes consultar nuestra página con los planes y precios para desarrolladores.

Conclusión

El acceso público a taxSettings en la Admin GraphQL API versión 2026-07 es un cambio técnicamente acotado, pero con un impacto práctico significativo para cualquiera que construya integraciones fiscales sobre Shopify. Elimina un obstáculo concreto que obligaba a los equipos de desarrollo a recurrir a soluciones manuales o workarounds frágiles, y alinea el acceso a los datos fiscales de los clientes consumer con lo que ya estaba disponible para los clientes B2B estructurados. Planificar la migración con tiempo es la decisión correcta.