{"section":"tutorials","requestedLocale":"es","requestedSlug":"audit","locale":"es","slug":"audit","path":"docs/es/tutorials/seguridad/recursos-de-seguridad-de-la-plataforma/audit.md","branch":"main","content":"Para aumentar la transparencia y la confianza de los usuarios administrativos de tu tienda, VTEX registra varias operaciones junto con sus autores y marcas de hora en **Audit**, un módulo utilizado para consultar e investigar el historial por medio de filtros.\n\nPara acceder a la página de Audit en el Admin VTEX, ve a **Apps > Apps instaladas > Audit** o ingresa **Audit** en la barra de búsqueda. En esta página, puedes realizar las siguientes acciones:\n\n* [Consultar eventos en Audit](#consultar-eventos-en-audit)\n* [Verificar las últimas consultas realizadas en Audit](#verificar-las-ultimas-consultas-realizadas-en-audit)\n\n> ℹ️ Para visualizar los eventos de Audit, debe tener un [perfil de acceso](/es/docs/tutorials/roles) asociado al [recurso](/es/docs/tutorials/recursos-del-license-manager) *Insights Metrics*.\n\n\n\n## Consultar eventos en Audit\n\nAudit permite consultar eventos mediante filtros de aplicación, fecha, acción, autor y detalles del evento. A continuación, explicamos cómo utilizar los [filtros](#filtros) de Audit y la presentación de los [resultados](#resultados). También mostramos el uso de filtros con [ejemplos](#ejemplos-de-consultas) prácticos.\n\n### Filtros\n\nPara consultar un evento utilizando los filtros disponibles en Audit, sigue estos pasos:\n\n1. En el Admin VTEX, accede a **Apps > Apps instaladas > Audit** o ingresa _Audit_ en la barra de búsqueda. Se te redirigirá a la pestaña **Eventos de auditoría** en Audit.\n2. En el menú **Aplicación** dentro de la sección **Filtros**, selecciona la aplicación relacionada con la consulta.\n3. En el menú **Fecha**, escoge una de las fechas predefinidas para la consulta. Si prefieres definir el intervalo de fechas exacto, activa la opción de usar una fecha **Personalizada **y selecciona la fecha de **Inicio** y **Fin** para la consulta.\n\n > ℹ️ Solo se pueden consultar los registros de los últimos tres meses. Si necesitas datos más antiguos, abre un [ticket de soporte](https://help.vtex.com/es/support).\n\n4. Si lo desea, añada un filtro por Acción. Para ello, en el campo situado junto a `Acción debe ser`, escriba el nombre de la acción y pulse `Enter`. Puede introducir más de un valor pulsando `Enter` después de cada selección. Compruebe el nombre de cada acción en [Eventos disponibles en Audit](/es/docs/tutorials/eventos-disponibles-en-audit).\n5. Puedes agregar filtros más específicos para consultar eventos con más precisión haciendo clic en el botón `Agregar filtro`.\n6. Selecciona el parámetro del filtro (_Autor_ o _Detalles del evento_) e indica el valor al que se debe comparar. Puede introducir más de un valor pulsando `Enter` después de cada selección.\n\n Al agregar filtros con el mismo parámetro (ejemplo: `Acción = Change Promotion Configuration` o `Change Coupon Configuration`), los resultados incluyen eventos que sean iguales a cualquiera de los valores ingresados. Al agregar filtros con parámetros diferentes (ejemplo: `Acción = Change Coupon Configuration` y `Autor = email@email.com`), los criterios se suman.\n\n Ten en cuenta que puedes repetir los pasos 4 y 5 para agregar más filtros.\n\n Por ejemplo, la consulta que corresponde a la siguiente imagen devuelve resultados cuyas acciones son _Change Promotion Configuration_ o _Change Coupon Configuration_ y cuyo autor es `email@mail.com`.\n\n \n\n7. Haz clic en el botón `Aplicar` para obtener los eventos encontrados.\n\n Consulta la sección [Resultados](#resultados) para entender la presentación de los eventos.\n\n> ⚠️ Los resultados de consulta corresponden exactamente al contenido ingresado en la casilla del filtro. Para evitar resultados inesperados, comprueba que no se hayan ingresado espacios adicionales en los términos de consulta.\n\nSi lo deseas, puedes compartir la consulta con otro usuario haciendo clic en `Compartir consulta` en la parte superior derecha de la página. El enlace a la búsqueda de Audit se copiará en su portapapeles.\n\n### Resultados\n\nLa sección **Resultados** lista cada evento encontrado en la consulta y muestra la información de cada evento, según la tabla a continuación.\n\n| Columna | Descripción |\n|---|---|\n| __Copiar evento__ | Botón para copiar la información del evento que se muestra en la tabla al portapapeles. |\n| __Hora del evento__ | Fecha y hora en que ocurrió el evento, mostradas en la zona horaria del navegador o del sistema operativo. |\n| __Acción__ | Acción realizada en la aplicación seleccionada para la consulta. Consulta las posibles acciones en la [lista de eventos disponibles en Audit](/es/docs/tutorials/eventos-disponibles-en-audit). |\n| __Detalles del evento__ | Información adicional sobre el evento. Consulta los detalles de cada evento en la [lista de eventos disponibles en Audit](/es/docs/tutorials/eventos-disponibles-en-audit). |\n| __Autor__ | Email, ID o token del usuario que realizó el evento. |\n| __Más detalles__ | Botón que abre un modal con más información sobre el evento, cuando corresponda. Los detalles mostrados pueden incluir: - **Nombre de la entidad:** ID de la entidad modificada.
- **Entidad antes de la acción:** información de la entidad antes del evento, en formato [JSON](http://www.json.org/).
- **Entidad después de la acción:** información de la entidad después del evento, en formato [JSON](http://www.json.org/).
La exhibición completa de la información previamente mencionada puede variar dependiendo del evento. Por ejemplo, un evento para eliminar información mostrará únicamente la entidad antes de la acción. Sin embargo, un evento que implica agregar información solo mostrará la entidad después de la acción.
Algunos eventos no proporcionan ninguna información adicional. En estos casos, el modal aparece vacío. |\n\n### Exportar resultados\n\nAdemás de consultar la lista de eventos y su información, es posible exportar estos resultados para compartirlos con terceros.\n\nAl realizar una consulta, después de aplicar los filtros, el botón `Exportar a CSV`se habilitará automáticamente.\n\nHaz clic en `Exportar a CSV`para enviar el archivo con los eventos. El email se enviará a la dirección que está configurada actualmente en el Admin VTEX.\n\n> ℹ️ El envío del archivo exportado puede demorar aproximadamente 20 minutos en llegar por email.\n\nConsulta a continuación un ejemplo del archivo que se exportará:\n\n```csv\napp,source.application,source.author,source.entityName,source.eventTime,source.workflow,table,time\ncheckout,checkout,john.doe@example.com,Order,2025-10-28T21:01:01.165Z,order-processing,orders,2025-10-28T21:01:01.166Z\ninventory,inventory,jane.smith@example.com,Product,2025-10-28T21:01:01.166Z,inventory-management,products,2025-10-28T21:01:01.166Z\ncatalog,catalog,admin@example.com,Category,2025-10-28T21:01:01.166Z,catalog-update,categories,2025-10-28T21:01:01.166Z\npricing,pricing,pricing-bot@example.com,Price,2025-10-28T21:01:01.167Z,,,2025-10-28T21:01:01.167Z\n```\n\n> ⚠️ Los eventos de las siguientes aplicaciones no se pueden exportar: OMS, Catálogo (API), Catálogo (Admin), Suscripciones, Portal CMS y Portal.\n\n> ℹ️ Solo se puede exportar un evento por vez. Debes esperar a recibir el email con el archivo CSV antes de exportar otro evento.\n\n### Ejemplos de consultas\n\nA continuación, listamos algunos escenarios de consulta comunes para ilustrar cómo se deben componer los filtros con base en lo que deseas obtener.\n\n#### Activación de producto\n\nPara consultar si un producto fue activado en el Catálogo en determinada fecha:\n\n1. Selecciona la fecha deseada.\n2. En el menú **Aplicación**, selecciona _Catálogo (Admin)_.\n3. Agrega un filtro cuya **Acción** deba ser igual a `Product Activation`.\n4. Agrega un filtro cuyos **Detalles del evento** deban ser igual a `product id \"X\" activated`, donde `X` sea el ID del producto deseado.\n\n#### Cambio de precio\n\nPara consultar si el precio de un SKU fue modificado en determinada fecha:\n\n1. Selecciona la fecha deseada.\n2. En el menú **Aplicación**, selecciona _Precios_.\n3. Agrega un filtro cuya **Acción** sea igual a `Put Price`.\n4. Agrega un filtro cuyos **Detalles del evento** sean igual al ID del SKU del ítem deseado.\n\n> ℹ️ Para identificar si el cambio de precio se realizó mediante la importación de una lista de precios fija, verifica la columna **Autor** en los resultados de búsqueda. Si el autor es `vtex-service::pricing-wrk::Stable`, significa que el precio fue actualizado a través de una planilla importada. Si el autor es la dirección de correo electrónico de un usuario, el cambio fue realizado manualmente. \n\n#### Exclusión de stock\n\nPara consultar si un stock fue eliminado en determinada fecha:\n\n1. Selecciona la fecha deseada.\n2. En el menú **Aplicación**, selecciona _Stock y envío_.\n3. Agrega un filtro cuya **Acción** sea igual a `Warehouse Delete`.\n4. Agrega un filtro cuyos **Detalles del evento** sean igual al ID del ítem deseado.\n\n#### Exclusión de transportadora\n\nPara consultar si una transportadora fue eliminada en determinada fecha:\n\n1. Selecciona la fecha deseada.\n2. En el menú **Aplicación**, selecciona _Stock y envío_.\n3. Agrega un filtro cuya **Acción** sea igual a `Carrier Delete`.\n4. Agrega un filtro cuyos **Detalles del evento** sean igual al ID de la transportadora deseada.\n\n## Verificar las últimas consultas realizadas en Audit\n\nToda consulta realizada en Audit se guarda en la pestaña **Últimas consultas**. Para repetir una consulta en esta pestaña, haz clic en el botón correspondiente a la consulta que deseas rehacer.\n\nEsta pestaña contiene la siguiente información:\n\n| Columna | Descripción |\n|---|---|\n| Consultado el | Fecha y hora en que se realizó la consulta en Audit. |\n| Aplicación | Aplicación de VTEX en que se buscaron los eventos. |\n| Términos | Filtros utilizados en la consulta. |\n| Periodo | Fecha de inicio y fin del periodo seleccionado para la consulta. |\n| Rehacer consulta | Botón que permite repetir la consulta. |\n\n> ⚠️ Solo se almacenan 50 consultas en la pestaña **Últimas consultas**. Si deseas guardar consultas por encima de límite, agrégalas a los favoritos de tu navegador."}