Para sincronizar los productos, se necesita una catalogId a la que incorporarlos. En la mayoría de las integraciones, el administrador técnico de la cuenta lo creará en su nombre. Una vez que se crea el catálogo, el administrador técnico de su cuenta debe hacerlo visible dentro de su portal de CitrusAd.

Contexto de creación de catálogo

A continuación se muestra un contexto de ejemplo para crear un catálogo:

POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogs": [
        {
            "name": "Retailer A"
        }
    ]
}

Si se realiza correctamente, se devolverá el siguiente objeto:

{
    "catalogs": [
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer A",
            "id": "216af452-d219-4807-b8ca-578bba446541"
        }
    ]
}

❗️
Una vez que un objeto se haya devuelto correctamente, recibirá una id para su nuevo catálogo. Si envía la misma solicitud de nuevo, recibirá una nueva id, lo que creará dos catálogos.

📘
La necesitará id para la sincronización del producto.

Creación de varios catálogos

Si va a crear varios catálogos, puede secuenciar hasta 100 por solicitud. A continuación se muestra un contexto de ejemplo para crear dos catálogos:

POST $BASE_URL/v1/catalogs HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "catalogs": [
        {
            "name": "Retailer A"
        },
        {
            "name": "Retailer B"
        }
    ]
}

Si se realiza correctamente, se devolverá el siguiente objeto (cada catálogo tendrá su propia ID individual id):

{
    "catalogs": [
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer A",
            "id": "216af452-d219-4807-b8ca-578bba446541"
        },
        {
            "teamId": "9f48572c-0a5b-4997-9a0e-ed74f4d32dc6",
            "name": "Retailer B",
            "id": "75047339-65f5-41b8-8f2c-e76b04716cd4"
        }
    ]
}

🚧
Un catálogo se oculta de forma predeterminada una vez creado. Póngase en contacto con el administrador técnico de su cuenta para que su catálogo sea visible en su espacio de nombres.