Shopify ha actualizado el modelo de direcciones de Customer Account API. La versión 2026-10 añade countryCode a CustomerAddressInput y CustomerAddress y deja territoryCode como campo deprecado.
La modificación figura en las notas oficiales de Shopify 2026-10. El nuevo campo utiliza códigos de país de dos letras y tiene prioridad si una integración envía simultáneamente los dos valores.
Un cambio pequeño que puede romper mapeos
Las integraciones que conectan Shopify con CRM, ERP, logística o sistemas de atención al cliente suelen transformar direcciones entre distintos esquemas. Cambiar el nombre del campo obliga a revisar esos mapeos antes de eliminar la compatibilidad antigua.
La versión estable también trae más cambios que requieren adaptación, especialmente en áreas de pedidos, impuestos y metafields.
En internacionalización, Shopify ha mejorado además la identificación de conversiones de divisa y ha ampliado datos disponibles para mercados.
Qué deberían hacer las aplicaciones
Las apps deberían empezar a leer y escribir countryCode y mantener compatibilidad con territoryCode solo mientras sea necesario. También conviene revisar validaciones y transformaciones internas.
La actualización puede combinarse con una auditoría de otros puntos de integración: webhooks de inventario, suscripciones en pedidos y callbacks de Shopify Flow.
Más coherencia con estándares internacionales
Utilizar countryCode hace el esquema más intuitivo para integraciones que ya trabajan con códigos ISO de país.
Las tiendas que no desarrollan software propio dependerán de sus proveedores de apps. Aun así, es recomendable verificar que las herramientas críticas están certificadas para la API 2026-10 y que no siguen dependiendo exclusivamente de campos deprecados.
También conviene revisar otros campos de cliente que Shopify está reestructurando, como el consentimiento de marketing por SMS.
Fotografía: Kindel Media / Pexels.
