{"section":"tutorials","requestedLocale":"es","requestedSlug":"master-data-es","locale":"es","slug":"master-data-es","path":"docs/es/tutorials/master-data/conceptos-básicos-de-master-data/master-data-es.md","branch":"main","content":"Master Data es una solución de la plataforma VTEX para bases de datos, altamente personalizable, que también permite la creación de aplicaciones.\n\nDe forma predeterminada, Master Data se usa para almacenar y organizar datos de clientes de tu tienda. Cuenta con un potente motor de búsqueda que te permite almacenar, buscar, expandir y personalizar datos.\n\nEn este artículo encontrarás más detalles sobre cada versión disponible de Master Data, conceptos importantes y cómo se utiliza.\n\n> ℹ️ Ten en cuenta que, dependiendo de la funcionalidad y la versión que desees utilizar, deberás ponerte en contacto con el equipo de desarrollo de tu operación.\n\n## Versiones disponibles\n\nActualmente existen dos versiones disponibles y puedes elegir la que mejor se adapte a las necesidades de tu operación. La principal diferencia entre las dos es que la versión v2 no tiene interfaz gráfica y solo puede utilizarse a través de la [Master Data API - v2](https://developers.vtex.com/docs/api-reference/master-data-api-v2), aunque cuenta con otras funcionalidades relevantes, como el uso de [JSON schemas](https://developers.vtex.com/docs/guides/starting-to-work-on-master-data-with-json-schema).\n\n> ℹ️ VTEX guarda automáticamente los datos de clientes de tu tienda en Master Data v1.\n\nConsulta la tabla a continuación para saber más sobre las funcionalidades de cada versión.\n\n| Funcionalidad | v1 | v2 | Más información |\n| :--- | :--- | :--- | :--- |\n| Interfaz gráfica | ✅ Sí | ❌ No | - |\n| API | ✅ Sí | ✅ Sí | - [Master Data API v1](https://developers.vtex.com/docs/api-reference/masterdata-api)
- [Master Data API v2](https://developers.vtex.com/docs/api-reference/master-data-api-v2#overview) |\n| Importación y exportación de hojas de cálculo | ✅ Sí | ❌ No | - [Importar datos en Master Data v1](https://help.vtex.com/es/docs/tutorials/importar-datos-en-master-data-v1)
- [Exportación de datos de Master Data v1](https://help.vtex.com/es/docs/tutorials/exportacion-de-datos) |\n| Adjuntos (imágenes) | ✅ Sí | ❌ No | - |\n| Triggers | ✅ Sí | ✅ Sí | - [Triggers](#triggers)
- [Crear trigger en Master Data v1](https://help.vtex.com/es/docs/tutorials/creando-trigger-en-el-master-data)
- [Setting up triggers on Master Data v2](https://developers.vtex.com/docs/guides/setting-up-triggers-in-master-data-v2) |\n| JSON Schemas | ❌ No | ✅ Sí | - [JSON Schemas](http://json-schema.org/)
- [JSON Schema reference](https://json-schema.org/understanding-json-schema)
- [Working with JSON Schemas in Master Data v2](https://developers.vtex.com/docs/guides/starting-to-work-on-master-data-with-json-schema)
- [Schema Lifecycle (Master Data v2)](https://developers.vtex.com/docs/guides/master-data-schema-lifecycle) |\n| Propiedades anidadas | ❌ No | ✅ Sí | - [Propiedades anidadas](#propiedades-anidadas) |\n| Entidades de datos | Referenciadas por acrónimos compuestos de dos letras mayúsculas. Por ejemplo, la entidad 'CL' almacena datos de clientes de la tienda y 'AD' los de direcciones. No pueden crearse por API. | Referenciadas por sus nombres. Por ejemplo, 'Notification'. Solo pueden crearse por API. | - [Entidades de datos](#entidades-de-datos)
- [Entidades de datos en Master Data v1](https://help.vtex.com/es/docs/tutorials/entidade-de-datos)
- [Creating relationships between data entities using Master Data v2](https://developers.vtex.com/docs/guides/creating-relationships-between-data-entities-using-api) |\n| Campos | Deben llenarse en el formato específico configurado en la entidad de datos. | En principio, no hay restricción de campos ni formatos. La validación del formato se realiza mediante JSON schemas. | - [Tipos de campos en Master Data v1](https://help.vtex.com/es/docs/tutorials/entidade-de-datos#tipos-de-datos)
- [JSON schemas](#v2-schemas) |\n| Índices | ✅ Sí | ✅ Sí | - [Índices en Master Data v1](https://help.vtex.com/es/docs/tutorials/indices-en-master-data)
- [Create index (Master Data v2)](https://developers.vtex.com/docs/api-reference/master-data-api-v2#put-/api/dataentities/-dataEntityName-/indices) |\n\n> ❗ Ten en cuenta que las entidades de datos de las dos versiones son independientes, aunque algunas pueden ser análogas. Un dato creado en una entidad de la v1 no puede consultarse ni editarse usando recursos de la v2 y viceversa.\n\n## Componentes básicos\n\nAmbas versiones de Master Data utilizan algunos componentes básicos que pueden corresponder a conceptos conocidos con otros nombres en otras soluciones de bases de datos, como registro o tabla. A continuación encontrarás más detalles sobre:\n\n- [Entidades de datos](#entidades-de-datos)\n- [Documentos](#documentos)\n- [Campos](#campos)\n- [Índices](#indices)\n\n### Entidades de datos\n\nLas entidades de datos son como tablas donde se registran documentos y campos.\n\nLas entidades de datos de Master Data v1 se referencian por acrónimos compuestos de dos letras mayúsculas. En la v2, puedes usar el nombre de la entidad de datos. Por ejemplo, en la v1 la entidad `CL` almacena datos de clientes de la tienda y `AD` guarda los datos de las direcciones de los clientes. Las entidades equivalentes en la v2 pueden referenciarse con nombres como `Client` y `Address`.\n\nEn una entidad de datos, la información se estructura en [documentos](#documentos) y [campos](#campos).\n\n### Documentos\n\nLos documentos son registros en una entidad de datos. Si las entidades de datos equivalen a tablas, cada documento corresponde a una fila de la tabla.\n\nPor ejemplo, dentro de una entidad que almacena datos de clientes de la tienda, como `CL` o `Client`, cada documento contiene información de un cliente.\n\nCada documento tiene un ID generado automáticamente por la plataforma en el momento de su creación, un código único que identifica ese registro.\n\n### Campos\n\nLos atributos que componen los documentos de Master Data se denominan campos. Al comparar las entidades de datos con tablas, podemos pensar en los campos como las columnas de una tabla.\n\nPor ejemplo, en una entidad que guarda datos de clientes de la tienda, como `CL` o `Client`, podemos llenar campos como **nombre**, **email**, **fecha de nacimiento** y **documento**.\n\nEn Master Data v1, los campos deben llenarse en el formato específico configurado en la entidad de datos. Consulta más información sobre los [tipos de campos en Master Data v1](https://help.vtex.com/es/docs/tutorials/entidade-de-datos#tipos-de-datos).\n\nEn la v2, en principio no hay restricción de campos ni formatos. La validación de formato se realiza mediante [JSON schemas](#v2-schemas).\n\n#### Propiedades anidadas\n\nMaster Data v2 te permite estructurar los datos con propiedades anidadas, una estructura que se encuentra frecuentemente en formato [JSON](https://www.json.org/json-en.html). Este concepto permite crear campos compuestos por otros campos para estructurar mejor los datos. Por ejemplo, un perfil de cliente puede tener el campo `Documento` que a su vez está compuesto de las propiedades `Tipo` y `Número`. También es posible crear [triggers](#triggers) anidados.\n\n### Índices\n\nLos índices se usan para especificar un documento al que se desea acceder, indicado por un campo indexado en lugar de su ID.\n\nComo se mencionó anteriormente, cada documento tiene un ID generado automáticamente por la plataforma en el momento de su creación. Si deseas consultar un documento y no sabes su ID, puedes usar índices.\n\nPor ejemplo, puedes consultar un documento con información de un cliente especificando el valor del campo `email` correspondiente al cliente.\n\n> ℹ️ Consulta cómo configurar [Índices en Master Data v1](https://help.vtex.com/es/docs/tutorials/indices-en-master-data) o configurar índices con la Master Data API - v2 [Create index](https://developers.vtex.com/vtex-rest-api/reference/putindices).\n\n## Triggers\n\nUn trigger de Master Data es un mecanismo que ejecuta una acción tras la creación o actualización de un documento, siempre que se cumplan las condiciones establecidas en la configuración. Estas acciones pueden ser de tres tipos:\n\n- Enviar solicitud HTTP.\n- Enviar email.\n- Guardar documento en otra entidad de datos.\n\nConsulta cómo [Crear triggers en Master Data v1](https://help.vtex.com/es/docs/tutorials/creando-trigger-en-el-master-data) o cómo configurarlos con [Master Data API - v2](https://developers.vtex.com/vtex-rest-api/docs/setting-up-triggers-in-master-data-v2)\n\n## v2 schemas\n\nMaster Data v2 te permite definir formatos de datos con JSON schemas. Este formato indica cómo Master Data debe validar e indexar documentos.\n\n> ℹ️ Consulta más información sobre [JSON schemas](https://json-schema.org/).\n\nPuedes guardar un documento en cualquier entidad de datos si el contenido es un JSON válido. Una entidad de datos puede tener uno o más JSON schemas asociados.\n\n\n\n> ℹ️ Un documento puede ser compatible con múltiples JSON Schemas, pero también puede no ser compatible con ninguno.\n\n## Entidades nativas de Master Data\n\nVTEX crea automáticamente algunas entidades de datos para admitir funcionalidades nativas de la plataforma.\n\n### Entidades nativas de Master Data v1\n\n| **Entidad** | **Descripción** |\n| :--- | :--- |\n| `ad` | Customer addresses |\n| `AS` | Availability Notifier (most likely source) |\n| `au` | Audit log |\n| `bb` | Buzz billing |\n| `bk` | Bucket (generic key/value) |\n| `bo` | BridgeOrder |\n| `bx` | Buzz extract |\n| `cl` | Customer accounts (clients) |\n| `CS` | Casino Gift Card |\n| `gc` | Gift cards |\n| `gt` | Gift card constraints |\n| `hl` | Holidays |\n| `il` | Internal logs |\n| `iw` | Internal warnings |\n| `iy` | Availability item |\n| `mb` | BridgeOrderMarketplace |\n| `od` | Orders |\n| `rd` | Order (mirror) |\n| `sb` | BridgeOrderSeller |\n| `se` | - |\n| `sl` | - |\n| `so` | Stores |\n| `SP` | Middleware Smiles Checkout |\n\n### Entidades nativas de Master Data v2\n\n| **Entidad** | **Descripción** |\n| :--- | :--- |\n| `account` | Digital Currency |\n| `affiliates` | Affiliates |\n| `affiliatesOrders` | Affiliates Commission Service |\n| `agentchangeappstate` | Agent change app state |\n| `aggregateddayorders` | Aggregated day orders |\n| `audit` | v2 Audit entity |\n| `b2b_profiles` | Storefront Permissions |\n| `b2b_quote_marketplace` | b2b_quote_marketplace |\n| `b2b_roles` | Storefront Permissions |\n| `b2b_seller_quote` | b2b_seller_quote |\n| `b2b_users` | Storefront Permissions (owner) |\n| `badges` | Badges |\n| `business` | Sales Autopilot Service |\n| `BusinessOrganization` | Easy Setup (legacy B2B seeder) |\n| `BusinessPermission` | Easy Setup (legacy B2B seeder) |\n| `BusinessRole` | Easy Setup (legacy B2B seeder) |\n| `buyerOrgConfiguration` | VTEX B2B Core |\n| `buyerOrgMember` | VTEX B2B Core |\n| `campaigns` | Opt-in Campaign Service (shared with Opt-in Campaign Listener) |\n| `CANCEL_ORDER_FISCAL_CODE` | Order SMS Notification |\n| `charge` | Digital Currency |\n| `checkoutcustom` | Checkout UI Custom |\n| `commissionBySKU` | Affiliates Commission Service |\n| `commissioningreportentry` | Commissioning report entry |\n| `commissioninvoices` | Mktplace Financial Commissions |\n| `contact_information` | contact_information |\n| `cost_centers` | B2B Organizations GraphQL |\n| `creditAccount` | Digital Currency |\n| `custom_prices` | Custom Prices (B2B) |\n| `customFieldSettings` | v2 custom field settings |\n| `customFieldValues` | v2 custom field values |\n| `dataentitysettings` | Data entity settings |\n| `defaultValues` | defaultValues |\n| `eventinfo` | Worldline Global Collect |\n| `eventRegistry` | Spreadsheet Event Broadcaster |\n| `evolutionAppsUpdateEvent` | Account Updates |\n| `evolutiondeloreanupdateevent` | Evolution Delorean update event |\n| `evolutionworkspacepromotion` | Evolution workspace promotion |\n| `exemption` | Avalara |\n| `externalinvoices` | Mktplace Financial Commissions |\n| `fbeconfiguration` | FBE configuration |\n| `fulfillment-points` | Admin Operational Capacity |\n| `giftCardList` | Gift Card List |\n| `import_session` | Products Import |\n| `import_session_config` | Products Import |\n| `instoreSettings` | Admin InStore (POS) |\n| `interaction` | Shipment Tracker |\n| `leyGondolas` | Admin Ley de Góndolas ARG |\n| `logisticsorderinfo` | Logistics order info |\n| `mcf_admin_app` | Amazon MCF Admin |\n| `module` | Sales Autopilot Service |\n| `multiTransaction` | Smiles Payment Provider MD |\n| `myWishlist` | Wishlist v2 |\n| `myWishlists` | myWishlists |\n| `notify` | Availability Notifier |\n| `onboarding` | Adyen Platforms |\n| `onboarding_modifications` | Orders GraphQL |\n| `ORDER_FISCAL_CODE` | Order SMS Notification |\n| `orderInfo` | Octopia (casino) |\n| `orders` | v2 Orders entity |\n| `ordersWithExternalPromotions` | External Promotion Monitoring GraphQL |\n| `organization_requests` | B2B Organizations GraphQL |\n| `organizations` | B2B Organizations GraphQL |\n| `packages` | Packages |\n| `paymentid2c2p` | Payment 2C2P |\n| `payuStatus` | PayU Europe Connector |\n| `pickup_points` | Pickup points |\n| `pins` | Sales Performance GraphQL |\n| `productInfo` | Octopia (casino) |\n| `productReviews` | Reviews and Ratings |\n| `productsWithError` | Products Monitoring Service |\n| `promotionsCron` | Opt-in Campaign Service |\n| `promotionsTrack` | Opt-in Campaign Service |\n| `proposal` | Sales Autopilot Service |\n| `queuemessagevo` | v2 queue message value object |\n| `quotes` | B2B Quotes GraphQL |\n| `rangeSafelist` | Opt-in Campaign Listener |\n| `report_generations` | Report generations |\n| `report_maps` | Report maps |\n| `Reseller` | Easy Setup (legacy B2B seeder) |\n| `ReturnApp` | ReturnApp |\n| `returnRequest` | Return App |\n| `scheduler` | v2 scheduler |\n| `sellerInfo` | Vertex O Series |\n| `sellersdashboards` | Mktplace Financial Commissions |\n| `shipment` | Shipment Tracker |\n| `shopper` | v2 shopper profile |\n| `smilesProductMapping` | Smiles Payment Provider MD |\n| `smilesSellerConfiguration` | Smiles Payment Provider MD |\n| `smilesTransaction` | Smiles Payment Provider MD |\n| `smsMessagesSchema` | Orange SMS Integration |\n| `SNA` | Seller Notification App |\n| `srapi` | SRAPI |\n| `statisticsdashboards` | Mktplace Financial Commissions |\n| `stores` | Stores |\n| `subscription` | v2 subscription (recurrent commerce) |\n| `subscription_cohort` | Subscription cohort |\n| `subscription_history` | Subscription history |\n| `subscription_orders` | Subscription orders |\n| `subscriptions` | Subscriptions |\n| `subscriptions_group` | Subscriptions group |\n| `subscriptions_thin` | Subscriptions thin |\n| `templates` | Marketing Autopilot Service |\n| `tms_orders` | TMS orders |\n| `tradePolicyConfig` | Vertex O Series |\n| `trainingBanners` | Training Banners App |\n| `transaction` | Digital Currency |\n| `transportation_order` | Transportation order |\n| `userAffiliation` | Affiliates |\n| `UserOrganization` | Easy Setup (legacy B2B seeder) |\n| `vendors` | Vendors |\n| `vendors_carts` | Vendors carts |\n| `views` | Sales Performance GraphQL |\n| `vtex_admin_cms_graphql_content` | Admin CMS GraphQL (declares this v2 native) |\n| `vtex_admin_cms_graphql_contentVariant` | Admin CMS GraphQL (declares this v2 native) |\n| `vtex_orders_graphql_onboardingusers` | Orders GraphQL onboarding users |\n| `wishlist` | Wishlist (legacy .NET) |\n| `wishlistitems` | Wishlist IO |\n| `wishlists` | Wishlist IO |\n\n## Entidades de datos personalizadas\n\nAdemás de las [entidades nativas](#entidades-nativas-de-master-data) que VTEX crea automáticamente, como `CL` (clientes), `AD` (direcciones) y demás entidades predeterminadas de la plataforma de comercio, tu operación puede crear entidades de datos personalizadas para almacenar información específica de tu negocio.\n\nLas entidades personalizadas se pueden crear:\n\n- En la v1, vía Admin VTEX. Consulta cómo [Crear una entidad de datos](https://help.vtex.com/es/docs/tutorials/entidade-de-datos).\n- En la v2, exclusivamente vía [Master Data API - v2](https://developers.vtex.com/docs/api-reference/master-data-api-v2).\n\n### Facturación\n\nEl uso de entidades nativas es gratuito. El uso de entidades personalizadas se factura mensualmente, en rangos que varían según el volumen total de documentos almacenados. Para fines de facturación, cada archivo de hasta 100 KB se contabiliza como un documento.\n\nPara ver los valores aplicables a tu operación, consulta tu contrato comercial o ponte en contacto con el [Soporte de VTEX](https://help.vtex.com/es/support).\n\nPor cada pago realizado durante la vigencia del contrato, se concede un crédito de facturación equivalente al 2% del valor neto pagado por los productos VTEX Commerce Platform y CX Commerce Platform. Los créditos se acumulan durante la vigencia del contrato y están disponibles para utilizarlos hasta su finalización.\n\nTanto la medición como la facturación siguen un ciclo mensual:\n\n- Al final de cada mes, se genera un snapshot del volumen de documentos almacenados en entidades no nativas.\n- Hasta el día 30 de cada mes, VTEX calcula los valores correspondientes al uso de Master Data y los créditos aplicables para la próxima factura.\n\n> ℹ️ Para hacer seguimiento del volumen de documentos en entidades personalizadas a lo largo del mes, consulta el dashboard **Uso de Master Data** en el Admin VTEX. Este dashboard se actualiza semanalmente y está destinado únicamente al seguimiento del uso. Las instrucciones de acceso están disponibles en Consultar el uso de Master Data en el Admin VTEX.\n\n> ℹ️ Para saber más sobre detalles de las facturas, consulta cómo [Descargar las facturas de VTEX](https://help.vtex.com/es/docs/tutorials/como-descargar-las-facturas-de-vtex).\n\n## Casos de uso\n\nAmbas versiones de Master Data son nativamente adecuadas para administrar datos de clientes de tu tienda. Pero como se mencionó anteriormente, son extremadamente flexibles y permiten atender diversas necesidades de tu tienda. Consulta a continuación algunos ejemplos de aplicación de las funcionalidades de Master Data más allá de la administración básica de datos de clientes.\n\n### Pruebas A/B\n\nCon los triggers de la v2, puedes establecer múltiples acciones para un mismo trigger, configurando el porcentaje de carga que cada acción debe recibir. Esto permite comparar el impacto de diferentes automatizaciones en tu tienda.\n\nConsulta cómo configurar pruebas A/B con Master Data v2 en [A/B testing Master Data v2 trigger actions](https://developers.vtex.com/vtex-rest-api/docs/setting-up-an-ab-test-with-master-data-v2-trigger).\n\n### Carrito abandonado\n\nMaster Data también puede utilizarse para crear integraciones de carrito abandonado. Es decir, la ejecución de acciones automáticas siempre que un cliente agregue productos al carrito de tu tienda y termine su sesión sin finalizar la compra.\n\nPara saber más, consulta la guía [Configurar carrito abandonado](https://help.vtex.com/es/docs/tutorials/configurar-carrito-abandonado)"}