> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/es/data-api/catalog-products-2/syncing-products-via-api.md). # Sincronizar productos mediante API ## Sincronización estándar de productos Una vez creado su catálogo, podrá sincronizar productos en él. El siguiente ejemplo describe un contexto estándar para sincronizar productos: ```http POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "catalogProducts": [ { "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "inventory": 50, "price": "19.99", "tags": [ "imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "category:Health&Beauty","category:Grocery","brand:Covergirl","Special_Flag:0" ] } ] } ``` Si se realiza correctamente, se devolverá el siguiente objeto: ```json { "catalogProducts": [ { "teamId": "e8158f9b-bbb9-49fb-93fe-3ad481ca8450", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "inventory": 50, "price": 19.99, "tags": [ "imageurl:https://your.image.host.com/image.jpg", "name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "category:Health&Beauty", "category:Grocery", "brand:Covergirl", "Special_Flag:0" ], "groups": [], "profit": null } ] } ``` En este contexto, los valores vacíos o nulos para grupos y ganancias se pueden ignorar. ## Sincronización de información de ubicación También puede sincronizar filtros para varias ubicaciones en las que sus productos están en la tienda. Esto es útil para la optimización a nivel de tienda/ubicación de la información de sus productos. ```http POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "catalogProducts": [ { "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "inventory": 50, "price": "19.99", "tags": [ "imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "category:Health&Beauty","category:Grocery","brand:Covergirl","Special_Flag:0","location:123","location:ABC" ] } ] } ``` Si se realiza correctamente, se devolverá el siguiente objeto: ```json { "catalogProducts": [ { "teamId": "e8158f9b-bbb9-49fb-93fe-3ad481ca8450", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "inventory": 50, "price": 19.99, "tags": [ "imageurl:https://your.image.host.com/image.jpg", "name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "category:Health&Beauty", "category:Grocery", "brand:Covergirl", "Special_Flag:0", "location:123", "location:ABC" ], "groups": [], "profit": null } ] } ``` ## Sincronización de información de HFSS En la sincronización de sus productos, deberá enviar un filtro de `hfss:true` or `hfss:false`. Esto permite que Epsilon Retail Media filtre nuestra interfaz adecuadamente. ```json POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "catalogProducts": [ { "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "inventory": 50, "price": "19.99", "tags": [ "imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "hfss:true","category:Health&Beauty","category:Grocery","brand:Covergirl","Special_Flag:0","location:123","location:ABC" ] } ] } ``` {% hint style="info" %} ¿Necesita saber más sobre HFSS? Consulte la publicación del Gobierno del Reino Unido aquí: {% endhint %} ## Sincronización de múltiples productos Si está sincronizando múltiples productos, puede secuenciar hasta 100 por solicitud. A continuación se describe un ejemplo de contexto para sincronizar dos productos: ```http POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "catalogProducts": [ { "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "inventory": 50, "price": "19.99", "tags": [ "imageurl:https://your.image.host.com/image.jpg", "name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "category:Health&Beauty", "category:Grocery", "brand:Covergirl", "Special_Flag:0" ], "profit": "1.50" }, { "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965738", "inventory": 26, "price": "8.50", "tags": [ "imageurl:https://your.image.host.com/image.jpg", "name:Kelloggs Froot Loops Breakfast Cereal 500g" ], "filters": [ "brand:Kelloggs", "category:Pantry", "category:BreakfastFoods", "category:Cereals", "Special_Flag:0" ], "profit": "0.50" } ] } ``` Si se realiza correctamente, se devolverá el siguiente objeto: ```json { "catalogProducts": [ { "gtin": "23556578965543", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "price": 19.99, "teamId": "e8158f9b-bbb9-49fb-93fe-3ad481ca8450", "groups": [], "tags": [ "imageurl:https://your.image.host.com/image.jpg", "name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "category:Health&Beauty", "category:Grocery", "brand:Covergirl", "Special_Flag:0" ], "inventory": 50, "profit": 1.50, "tags": [ "Natural", "Lasting", "Dry Skin", "Beige" ] }, { "gtin": "23556578965736688", "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "price": 8.50, "teamId": "e8158f9b-bbb9-49fb-93fe-3ad481ca8450", "groups": [], "tags": [ "imageurl:https://your.image.host.com/image.jpg", "name:Kelloggs Froot Loops Breakfast Cereal 500g" ], "filters": [ "brand:Kelloggs", "category:Pantry", "category:BreakfastFoods", "category:Cereals", "Special_Flag:0" ], "inventory": 26, "profit": 0.50, "tags": [ "Pantry", "BreakfastFoods", "Cereals", "Kelloggs" ] } ] } ``` ## Actualización del inventario de productos Para actualizar el inventario de un producto, deberá volver a sincronizar el producto con Epsilon Retail Media. En su sincronización, marque el inventario del producto como `0`. A continuación se describe un ejemplo: ```http POST $BASE_URL/v1/catalog-products?teamId= HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic { "catalogProducts": [ { "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", "gtin": "23556578965543", "inventory": 0, "price": "19.99", "tags": [ "imageurl:https://your.image.host.com/image.jpg","name:Covergirl Clean 120 Creamy Natural Liquid Foundation30mL" ], "filters": [ "category:Health&Beauty","category:Grocery","brand:Covergirl","Special_Flag:0" ] } ] } ```
## Actualización de imágenes de productos Epsilon almacena en caché las URL de las imágenes para garantizar un rendimiento constante y reducir las solicitudes a su servidor de imágenes. Si actualiza una imagen sin cambiar su URL, debe activar explícitamente una actualización en Epsilon. Para hacer esto: * Elimine el image\_url existente del producto. * Vuelva a enviar el mismo image\_url una vez que se haya completado la actualización. Como alternativa, si su servidor de imágenes lo admite, puede forzar una actualización añadiendo una cadena de consulta (por ejemplo, una versión o marca de tiempo) a la URL existente. Esto provocará Epsilon para volver a cargar la imagen.. {% hint style="info" %} Las imágenes solo se utilizan en la interfaz de usuario Las imágenes de productos no se sirven en las respuestas de los anuncios. Las actualizaciones de imágenes solo afectan a cómo se muestra el producto en la Epsilon UI mientras se produce la actualización de la caché. {% endhint %} ## Recuperar productos Una vez que tenga un producto en su catálogo, es posible que desee recuperar su información actual más adelante. Para hacer esto, puede realizar una solicitud HTTP **GET** con el formato de URL **`v1/catalog-products/catalogId/`**. El punto de enlace es capaz de aceptar un código de producto por solicitud. A continuación se describe una solicitud de ejemplo: ```http GET $BASE_URL/v1/catalog-products// HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` Debería recibir la información actual ingresada en el Epsilon Retail Media sistema para el código de producto. A continuación se muestra un ejemplo {% hint style="info" %} Publicar una actualización de producto no es instantáneo en el Epsilon Retail Media sistema, puede tardar un poco de tiempo para que Epsilon Retail Media ingrese completamente una actualización de producto. No se preocupe si la información de un producto no se actualiza instantáneamente al recuperar los detalles. {% endhint %} ## Eliminar productos Para eliminar un producto de su catálogo, envíe una solicitud HTTP DELETE utilizando el siguiente formato cuando el producto ya no sea necesario. ### Parámetros de la solicitud El punto de enlace acepta un código de producto por solicitud, normalmente su ID de GTIN. ```http DELETE $BASE_URL/v1/catalog-products// HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` ### Eliminar productos con ID de vendedor Si el producto incluye un ID de vendedor, especifíquelo como un parámetro de consulta al eliminar el producto: ```http DELETE $BASE_URL/v1/catalog-products//?sellerId=abc123> HTTP/1.1 accept: application/json content-type: application/json Authorization: Basic ``` ### Tiempo de procesamiento La eliminación del producto puede tardar entre 30 minutos y una hora en procesarse. {% hint style="info" %} Importante Si un producto está agotado, establezca su inventario en 0 en lugar de eliminarlo. Eliminar un producto quita la capacidad de que los anunciantes lo seleccionen en la Epsilon Retail Media plataforma, incluso cuando vuelva a estar disponible. {% endhint %} ### Gestión de errores Si recibe un error de "producto no encontrado", es probable que el producto no se haya ingresado en el Epsilon Retail Media sistema. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/integration/es/data-api/catalog-products-2/syncing-products-via-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.