Migrar datos comerciales a Square no consiste en copiar campos. Square representa el catálogo, las existencias, los Customers y las transacciones mediante objetos conectados que cumplen funciones operativas diferentes. Un Product de la tienda de origen puede convertirse en un artículo del catálogo con una o varias variaciones. Un valor seleccionable puede definir una opción del artículo, una variación vendible, un modificador o información aportada por el comprador. El inventario pertenece a una variación concreta dentro de una ubicación determinada. Un Order histórico conserva lo que ocurrió, pero no se convierte en la configuración que controla futuros pagos, procesamiento de pedidos, impuestos o presentación online.
Por eso, la pregunta central al trasladar el modelo de datos no es si Square dispone de un campo con un nombre conocido. La cuestión es si el registro de destino pertenece al objeto correcto de Square y sigue conectado con los registros que le dan significado comercial. Cuando esas relaciones se conservan, el equipo puede vender la variación correcta, entender las existencias por ubicación, localizar Customers y Orders, conciliar identificadores externos y publicar contenido coherente en Square Online. Cuando las relaciones se aplanan, los datos pueden parecer completos y aun así funcionar de forma incorrecta.
El significado de los datos en Square se construye con objetos comerciales relacionados
El catálogo de Square está formado por objetos tipados, no por un único registro universal de Product. Los artículos del catálogo describen productos o servicios. Las variaciones representan versiones que se pueden comprar. Las opciones del artículo pueden estandarizar los valores que definen esas variaciones. Las listas de modificadores describen cambios o añadidos seleccionados durante la venta. Las Categories organizan los artículos. Los impuestos, descuentos, reglas de precios, imágenes, unidades de medida y atributos personalizados también pueden participar en relaciones más amplias del catálogo.
Una plataforma de origen puede guardar varios de esos significados en una sola tabla de Product, en un Product configurable o en una estructura propiedad de una aplicación. El traslado exige separar el registro de origen en los objetos de destino que realmente son responsables de cada función.
| Suposición en la tienda de origen | Significado de la relación en Square | Consecuencia para el traslado |
|---|---|---|
| Una fila de Product constituye toda la unidad vendible | El artículo y su variación pueden ser objetos separados pero conectados | Conserva el artículo principal y asigna SKU, precio, existencias y demás identidad vendible a la variación correcta. |
| Cada opción es una variante | Algunas elecciones definen variaciones; otras son modificadores o datos introducidos por el comprador | Clasifica el efecto comercial de la elección antes de crear los registros de destino. |
| Una sola cantidad de existencias pertenece al Product | El inventario está vinculado a la variación y a la ubicación | Una cantidad queda incompleta sin la variación vendible y la ubicación operativa correspondientes. |
| Las Categories reconstruyen toda la tienda online | Las Categories del catálogo y la estructura del sitio de Square Online están relacionadas, pero no son equivalentes | Conserva la clasificación del catálogo por separado de las páginas, la navegación y la presentación de las URL. |
| El historial del Customer recrea el funcionamiento de la cuenta | Los perfiles de Customer conservan identidad y relaciones comerciales, no todos los modelos de acceso o membresía de origen | Mantén los datos duraderos del Customer separados del acceso y del funcionamiento específico de aplicaciones en el origen. |
| Los Orders importados configuran las ventas futuras | Los Orders registran transacciones históricas o actuales; la configuración sigue perteneciendo a pagos, procesamiento de pedidos, impuestos y otros ajustes de Square | Conserva la instantánea de la transacción sin tratarla como configuración operativa. |
Esta visión basada en objetos también explica por qué importan los identificadores externos. Un ID de Product de origen, una clave de almacén, un ID de Customer del CRM o una referencia contable deben asociarse al objeto de Square que reconoce el sistema conectado. Una nota genérica en el artículo principal no sustituye adecuadamente a un identificador de almacén a nivel de variación cuando el almacén trata cada variación como una unidad de stock independiente.
Artículos, variaciones, opciones y modificadores representan significados de venta distintos
La distinción más importante del catálogo está entre el artículo y la variación del artículo. El artículo describe la familia del producto o servicio. La variación identifica una versión que se puede comprar y puede tener su propio SKU, precio, unidad de medida, relación de imagen y significado de inventario. Incluso un Product de origen sin opciones visibles puede convertirse en un artículo de Square con una variación predeterminada o única, porque la variación es el objeto vendible que utilizan otras relaciones de Square.
Las opciones del artículo ofrecen una forma estandarizada de describir atributos de las variaciones, como talla, color o estilo. Una variación puede hacer referencia a los valores de opción seleccionados, lo que permite a Square entender la combinación sin depender únicamente de un nombre de presentación inconsistente. Por tanto, las variantes de origen deben interpretarse tanto por su Product principal como por los valores que hacen distinta cada combinación vendible.
Los modificadores cumplen otra función. Representan un cambio o añadido elegido durante la venta y no definen automáticamente una identidad independiente con control de stock. Queso extra, envoltorio para regalo, preferencia de preparación o un servicio opcional pueden funcionar como modificadores. Una talla con SKU e inventario propios normalmente se comporta como una variación. Tratar un modificador como variación crea registros de stock falsos; tratar una variación real como modificador elimina la identidad vendible que necesitan el inventario y los sistemas externos.
| Patrón de origen | Responsable probable en Square | Significado que debe mantenerse |
|---|---|---|
| Product simple con un SKU | Artículo más una variación | Descripción del Product a nivel de artículo; SKU vendible, precio e identidad de stock a nivel de variación. |
| Combinaciones de talla y color | Opciones del artículo, valores de opción y variaciones | Cada combinación comprable sigue siendo distinguible y conectada al artículo principal correcto. |
| Extra opcional o servicio adicional | Lista de modificadores y modificador | Elección realizada durante la venta y efecto sobre el precio sin inventar un SKU independiente con inventario. |
| Grabado o instrucción del comprador | Modificador, entrada personalizada, nota de línea de Order o registro de aplicación conectada, según el funcionamiento compatible | El valor aportado por el Customer permanece unido a la línea comprada y visible para el procesamiento del pedido. |
| Kit, paquete o paquete | Artículo, relación de componentes, regla de precios, aplicación conectada o estructura de un sistema externo | Se asignan explícitamente la identidad de los componentes, la formación del precio, la propiedad del stock y el propósito de los informes. |
| Servicio, cita, suscripción o derecho digital | Artículo del catálogo más el área de producto de Square o el sistema conectado que controla programación, recurrencia o acceso | El registro del catálogo permanece separado del sistema que controla tiempo, facturación o derecho de acceso. |
Las imágenes, impuestos, descuentos, unidades de medida y atributos personalizados deben asignarse con la misma disciplina. Una imagen puede pertenecer al artículo, a una variación o a una relación con una Category. Un impuesto o descuento puede ser un objeto reutilizable del catálogo al que hacen referencia artículos y Orders. Un atributo personalizado debe tener un consumidor conocido, como el equipo, los informes, una integración u otro flujo de Square. Los valores sin un responsable claro en el destino generan ruido en lugar de conservar significado empresarial.
Categories, menús, imágenes y relaciones de merchandising
Las Categories de origen suelen cumplir varias funciones a la vez: jerarquía, navegación, merchandising, informes, control de acceso, páginas de destino SEO y presentación de campañas. Las Categories del catálogo de Square conservan la clasificación del catálogo, mientras que las páginas, la navegación y la presentación comercial de Square Online pueden introducir relaciones distintas a nivel del sitio. Una migración debe conservar la finalidad duradera de la clasificación sin asumir que el árbol de la antigua tienda se puede reproducir únicamente mediante registros de Category.
Una jerarquía profunda en el origen puede convertirse en una clasificación de catálogo más plana combinada con navegación o estructura de páginas en Square Online. Una colección de origen puede ser un departamento permanente, una campaña temporal, el resultado de un filtro o una página editorial de destino. Esos significados no deben fusionarse simplemente porque los cuatro aparecían como enlaces en la tienda anterior.
| Estructura de origen | Pregunta sobre la propiedad en el destino |
|---|---|
| Jerarquía permanente de departamentos | ¿Qué Categories de Square conservan la clasificación duradera de Products? |
| Colección temporal de campaña | ¿La relación pertenece a una Category, una página de Square Online, una presentación de merchandising o una regla de precios/descuentos? |
| Agrupación por marca o fabricante | ¿Pertenece a la clasificación del catálogo, a un atributo personalizado, al contenido buscable o a un sistema externo de información de Products? |
| Filtro técnico | ¿El valor se usa para comparación, búsqueda, informes o selección de Products, y qué objeto de Square o sistema conectado es responsable de ese uso? |
| Galería de Product e imagen de variación | ¿Qué imagen pertenece a la familia del artículo y cuál identifica una variación vendible concreta? |
| Etiqueta de menú y página de destino | ¿El registro apunta a una Category, un artículo, una página de Square Online, una URL externa o un destino de campaña? |
Esta separación protege tanto el comercio como el contenido. Una Category puede seguir siendo la referencia para clasificar Products mientras una página de Square Online controla cómo se presenta ese grupo. Un enlace de menú puede dirigir al destino adecuado sin convertirse en propietario de la relación del catálogo. Las imágenes pueden seguir asociadas al artículo o variación correctos aunque cambie el diseño online.
Las ubicaciones y el inventario forman una relación operativa
El inventario de Square no es una cantidad única copiada en un artículo. Está vinculado a la variación del artículo y a la ubicación donde se aplica un estado de stock. Square también registra el inventario mediante recuentos físicos y transiciones de estado, por lo que la cantidad actual es el resultado de un historial de inventario, no un campo aislado del Product.
Una tienda, almacén, sucursal, bolsa de stock o canal de origen puede no corresponder uno a uno con una ubicación de Square. El traslado debe identificar qué cantidad de origen pertenece a qué ubicación de destino y a qué variación vendible. Combinar varios almacenes de origen en un único total solo es apropiado si el destino utiliza intencionadamente una sola bolsa de stock. Repartir un total de origen entre varias ubicaciones exige una asignación respaldada por una fuente autorizada, no una estimación.
| Señal de inventario | Relación en el destino |
|---|---|
| Stock a nivel de Product sin variantes | La cantidad pertenece a la única variación del artículo en la ubicación de Square prevista. |
| Stock a nivel de variante | Cada combinación vendible de origen se relaciona primero con su variación de Square y después se asocia el stock. |
| Cantidad específica de almacén | El almacén o sucursal de origen se concilia con la ubicación de Square responsable de esa cantidad. |
| Stock reservado, dañado, devuelto o en tránsito | El significado del estado se conserva solo cuando el destino o el sistema de inventario conectado reconoce el mismo ciclo de vida. |
| Sistema externo como autoridad del inventario | El ID de variación y la clave externa de stock son más duraderos que una cantidad importada una sola vez. |
| Ajuste histórico de inventario | El registro permanece separado del recuento físico actual salvo que una integración de inventario o un sistema de auditoría necesite ese historial. |
El límite del sistema que actúa como fuente de verdad es crítico. Si Square será responsable del inventario después del lanzamiento, las cantidades y relaciones de variaciones deben ser coherentes dentro de Square. Si un ERP, sistema de almacén o hub de mercado en lÃnea sigue siendo la autoridad, Square necesita identificadores estables de variación y ubicación que permitan a la integración mantener el stock. En ese caso, la cantidad importada es únicamente el estado inicial, no la fuente permanente de verdad.
Customers, grupos, segmentos y relaciones de identidad
Los perfiles de Customer de Square pueden contener nombres, información de empresa, direcciones de correo electrónico, teléfonos, direcciones, notas, IDs de referencia, pertenencia a grupos, relaciones con segmentos, datos de preferencias de marketing y atributos personalizados. Los IDs de Customer también conectan Customers con Orders y otros registros de Square. Estas funciones no convierten un perfil de Customer de Square en equivalente a cualquier modelo de cuenta de origen.
Una cuenta de origen también puede contener contraseñas, roles de comprador, jerarquías organizativas, exenciones fiscales, saldos de fidelización, membresías, suscripciones, instrumentos de pago guardados, acceso a portales o preferencias propiedad de aplicaciones. Algunos de esos valores pueden pertenecer a los datos de Customer de Square, mientras otros corresponden a un área de producto de Square, una aplicación conectada o un sistema externo.
La identificación de coincidencias debe evitar tanto fusiones erróneas como duplicados innecesarios. El correo electrónico, el teléfono, el ID de Customer de origen, el ID externo del CRM, la relación con Orders y el contexto de empresa pueden contribuir a la decisión. Un correo compartido por una familia no significa automáticamente que dos compradores sean la misma persona. Un correo cambiado no implica necesariamente que el Customer sea nuevo. Los Orders de invitados deben conservar el contexto del comprador sin inventar una relación de cuenta permanente que no existía.
| Patrón de identidad de origen | Significado en Square |
|---|---|
| Customer minorista registrado | Perfil de Customer conectado con datos de contacto compatibles, direcciones, grupos, segmentos, atributos y Orders. |
| Comprador invitado | Contexto de Customer a nivel de Order, con perfil permanente únicamente cuando las reglas de identidad del destino lo permiten. |
| Contacto de empresa | Perfil de Customer más datos de empresa/referencia o un responsable B2B/CRM conectado; no equivale automáticamente a una jerarquía organizativa completa. |
| Miembro de programa de fidelización | Identidad del Customer conectada al registro de fidelización de Square o de un sistema externo que controla saldos y actividad. |
| Suscriptor de marketing | Preferencia del Customer o registro del sistema de marketing con el significado del consentimiento conservado por separado del historial de compras. |
| Cuentas de origen duplicadas | Se consolidan solo cuando la evidencia de identidad, el consentimiento, la propiedad de Orders y las referencias externas respaldan la fusión. |
El objetivo duradero es una relación de Customer que el equipo y los sistemas conectados puedan entender. Una nota importada genérica no basta cuando el mismo valor debería poder buscarse como ID de referencia, estructurarse como atributo personalizado o pertenecer a un CRM.
Los Orders conservan relaciones de transacción, no configuración futura
Los Orders de Square pueden contener líneas, referencias a variaciones, modificadores, cantidades, impuestos, descuentos, cargos por servicio, propinas, datos de procesamiento del pedido, ubicación, origen del Order, vínculos con Customer, totales y contexto de pago o reembolso. Estas relaciones hacen que los Orders históricos sean útiles para atención al Customer, conciliación e informes, pero no configuran transacciones futuras.
La línea debe conservar el Product o la variación que se compró en ese momento, incluso si el catálogo actual cambia después. Las selecciones de modificadores y las instrucciones del comprador pertenecen a la línea adquirida. Los valores de impuestos, descuentos, cargos por servicio y propinas explican cómo se formó el total histórico. Los datos de procesamiento explican si el Order se recogió, envió, entregó, canceló o gestionó de otra forma. El origen y la ubicación identifican dónde se generó la transacción.
| Valor histórico | Significado en el Order de Square |
|---|---|
| Número de Order de origen | Referencia duradera para soporte, finanzas y trazabilidad entre sistemas. |
| Línea de Product o variación | Identidad vendible comprada, cantidad, precio e instantánea descriptiva. |
| Modificador o personalización | Elección realizada durante la venta y asociada a la línea correcta. |
| Impuesto, descuento, cargo por servicio o propina | Componente del total histórico, no una regla activa de precios. |
| Referencia de pago o medio de pago | Evidencia de la transacción completada o intentada, no configuración de pago reutilizable. |
| Procesamiento y seguimiento | Contexto histórico de entrega o recogida, no definición de los métodos actuales de procesamiento. |
| Reembolso o ajuste | Historial financiero vinculado al Order y a la transacción originales. |
| Ubicación y origen | Procedencia operativa del Order y relación con Square o con el canal externo. |
Las líneas históricas ad hoc también requieren cuidado. Un Order de origen puede hacer referencia a un Product que ya no existe o a un cargo generado por una aplicación sin equivalente actual en el catálogo. El Order puede conservar la descripción y el importe históricos, pero ese registro no debería crear un artículo actual artificial salvo que el negocio pretenda volver a venderlo.
Contenido, URL y propiedad del sitio en Square Online
Square Online añade una capa de sitio alrededor de los datos comerciales de Square. Los artículos del catálogo y las Categories pueden participar en la venta online, pero las páginas, la navegación, los dominios, las rutas URL, redirecciones, campos SEO, contenido de políticas, Blog Posts, ubicación de medios y presentación personalizada tienen significado propio a nivel del sitio.
Una URL de Product del origen puede cambiar cuando el Product pasa a ser una página de artículo de Square Online. Una página de destino de una Category de origen puede necesitar un destino de Square Online y no únicamente una Category del catálogo. Una CMS Page puede convertirse en página del sitio, consolidarse con otra página o permanecer fuera del sitio comercial. Los Blog Posts, colecciones editoriales, recursos descargables y páginas de campaña deben conservar sus relaciones de contenido y el destino previsto aunque se reconstruya el diseño visual.
| Recurso web de origen | Responsable en el destino |
|---|---|
| Título, descripción y medios del Product | Artículo del catálogo y su relación de presentación online. |
| URL de Product o Category | Ruta de Square Online más cualquier relación de redirección necesaria entre origen y destino. |
| Página de políticas o informativa | Página de Square Online u otro destino de contenido definido. |
| Blog Post o archivo editorial | Destino de publicación compatible o sistema de contenido gestionado por separado. |
| Elemento de menú | Relación de navegación del sitio que apunta a un artículo, Category, página o URL externa. |
| Bloque de tema, script personalizado o widget de aplicación | Configuración de presentación del sitio o de integración, no contenido ordinario del catálogo. |
| Dominio y redirección | Configuración del sitio y de rutas conectada con el destino de contenido conservado. |
Por tanto, el modelo de contenido debe mantener separados los datos comerciales que son fuente de verdad de los componentes del sitio que los muestran. Un Product sigue siendo un artículo del catálogo aunque varias páginas de Square Online lo enlacen. Una página sigue siendo contenido aunque incluya referencias a Products. Una redirección sigue siendo una relación de enrutamiento, no un sustituto del registro de destino.
Atributos personalizados, aplicaciones e identificadores externos
Square admite atributos personalizados en varios tipos de objetos, mientras muchos negocios también utilizan aplicaciones de contabilidad, CRM, fidelización, entrega, restauración, comercio minorista, programación, informes, mercados en lÃnea e inventario. Que exista un campo personalizado en ambos sistemas no demuestra que ambos campos tengan el mismo responsable o ciclo de vida.
Los datos personalizados deben clasificarse por objeto principal, finalidad empresarial, sistema que actúa como autoridad y consumidor que seguirá utilizándolos. Una clave de almacén a nivel de variación pertenece a la variación y a la relación con el almacén. Un ID de Customer del CRM pertenece al Customer y a la relación con el CRM. Un ID de mercado en lÃnea en un Order pertenece al Order y a la relación con el canal. Un ajuste de script del sitio pertenece a la configuración del sitio, no a un registro de Customer o Product.
| Señal personalizada o externa | Definición correcta de propiedad |
|---|---|
| Clave de Product del ERP | Artículo o variación reconocidos por el ERP, según la granularidad con la que el propio ERP define el producto. |
| SKU de almacén | Variación con inventario más relación con ubicación o almacén. |
| ID de Customer del CRM | Perfil de Customer más el CRM externo que considera ese ID como referencia. |
| ID de publicación en mercado en lÃnea | Relación artículo/variación/canal, no una nota genérica del Product. |
| Saldo de fidelización o ID de membresía | Customer más el sistema de fidelización responsable del libro de saldos y del estado. |
| Atributo personalizado de Order | Order o línea más la aplicación que creó y consume el valor. |
| Datos de widget de Square Online | Configuración del sitio o de la aplicación más referencias a los registros comerciales subyacentes. |
| Tabla de origen no compatible | Entidad principal, clave, ciclo de vida y responsable de destino definidos explícitamente antes de conservar cualquier valor. |
Este modelo de propiedad evita dos errores: forzar cada valor de origen dentro del campo de Square más cercano y conservar datos personalizados sin saber a qué pertenecen. Un valor solo es útil cuando el equipo puede saber qué registro lo controla, qué sistema lo reconoce y si describe una entidad actual, una transacción histórica o un aspecto de presentación.
Decisiones de traslado para patrones habituales del origen
El modelo final de Square como plataforma de destino debe expresarse mediante relaciones, no como una lista de campos. Los patrones representativos hacen visibles esas relaciones antes de definir una asignación a gran escala.
| Patrón de origen | Relación en el destino Square |
|---|---|
| Product de ropa configurable | Artículo → opciones del artículo → valores de opción → variaciones → imágenes/SKU de variación → inventario por ubicación. |
| Artículo de restaurante con extras | Artículo/variación → lista de modificadores → modificadores → selecciones en líneas de Order → contexto de procesamiento. |
| Catálogo con varios almacenes | Variación → ubicación de Square o almacén externo → estado de inventario → clave externa de stock. |
| Customer minorista con fidelización | Customer → datos de contacto/referencia → Orders → registro de fidelización propiedad de Square o de un sistema conectado. |
| Order de mercado en lÃnea | Order → referencia de origen/canal → variación en la línea o instantánea ad hoc → historial de pago/procesamiento → ID externo del mercado en lÃnea. |
| Página de Category sensible para SEO | Category del catálogo → destino de Square Online → enlace de navegación → redirección desde la URL de origen → artículos referenciados. |
| Configurador de Product personalizado | Artículo/variación del catálogo → configuración propiedad de la aplicación → resultado en línea de Order → identificadores externos de procesamiento. |
Estas cadenas de relaciones hacen explícito el alcance de la migración al identificar el responsable en el destino, los registros dependientes y el funcionamiento externo que continúa fuera del catálogo principal. También muestran dónde un único registro de origen debe convertirse en varios objetos conectados de Square. Una cadena solo está completa cuando el equipo y los sistemas conectados pueden seguir el artículo, Customer, Order, contenido o identificador externo en el destino sin depender de la plataforma de origen para interpretarlo.
Conclusión
Trasladar el modelo de datos a Square depende de asignar cada valor de origen al objeto de Square que posee su significado comercial. Los artículos, variaciones, opciones, modificadores, Categories, ubicaciones, inventario, Customers, Orders, contenido de Square Online, atributos personalizados e identificadores externos están conectados, pero no son intercambiables.
Un modelo de destino sólido conserva las relaciones entre registros principales y dependientes, además de las relaciones entre sistemas. Mantiene la identidad de las variaciones conectada con existencias y ubicaciones, la identidad del Customer conectada con Orders y referencias externas, las transacciones históricas separadas de la configuración futura y la presentación de Square Online separada de los registros autorizados del catálogo. Esa estructura hace que los datos migrados sean comprensibles y utilizables, no simplemente presentes.
Preguntas frecuentes
¿Cuál es la diferencia entre una variación de artículo de Square y un modificador?
Una variación es una versión comprable de un artículo y puede contener SKU, precio, imagen, unidad de medida y significado de inventario. Un modificador suele ser un añadido, eliminación o preferencia seleccionados durante la venta. El destino correcto depende de si la elección crea una identidad vendible distinta y controlada por inventario.
¿Debe cada opción de Product de origen convertirse en una opción de artículo de Square?
No. Las opciones del artículo son apropiadas cuando sus valores definen elecciones estandarizadas de variación. La personalización, extras opcionales, instrucciones del comprador o elecciones controladas por aplicaciones pueden pertenecer a modificadores, datos de línea de Order, atributos personalizados u otro sistema responsable.
¿Por qué importa la ubicación de Square al migrar el inventario?
El inventario de Square tiene significado para una variación y una ubicación concretas. Una cantidad sin la relación correcta de variación y ubicación puede ser numéricamente exacta y aun así asignar el stock al contexto operativo equivocado.
¿Pueden los perfiles de Customer de Square reproducir todas las funciones de una cuenta de origen?
No. Los perfiles de Customer pueden conservar identidad, contacto, grupos, segmentos, preferencias, atributos personalizados y relaciones con Orders que sean compatibles. Las contraseñas, jerarquías B2B, membresías, libros de fidelización, suscripciones y permisos propiedad de aplicaciones pueden tener responsables diferentes en el destino.
¿Los Orders migrados a Square configuran pagos y procesamiento de pedidos?
No. Los Orders conservan líneas, ajustes, ubicación, origen, contexto de pago, historial de procesamiento y demás evidencia de la transacción. La configuración actual de pagos, impuestos, procesamiento, notificaciones y aplicaciones se mantiene por separado.
¿Cómo deben representarse en Square los campos personalizados y los IDs externos?
Asocia cada valor al artículo, variación, Customer, Order, línea, registro del sitio, aplicación o sistema externo que sea responsable de él. El campo también debe conservar la clave que necesita el sistema consumidor; colocar todos los valores personalizados en una nota genérica elimina el significado de la relación.