Ir al contenido principal

Actualizar sus productos del catálogo mediante la API (Postman)

Procedimiento para actualizar de forma masiva los productos de su catálogo Ezus con Postman

No se necesita ninguna competencia técnica avanzada, basta con seguir los pasos a continuación:

Requisitos previos

💡 Bueno saberlo: la autenticación en la API se basa en dos elementos:

  • la clave API (x-api-key) que identifica su cuenta

  • el token (Authorization: Bearer) que autoriza cada solicitud

El token es válido durante 12 horas; transcurrido ese plazo, hay que regenerarlo.

Nota: la dirección de la API es https://api.ezus.app. La página api.ezus.io corresponde únicamente a la documentación.

Paso 1 — Preparar la solicitud de actualización de un producto

La actualización de un producto se realiza mediante la ruta products-upsert.

  1. Método POST, URL: {{baseUrl}}/products-upsert (o directamente https://api.ezus.app/products-upsert)
    ​

  2. Pestaña Headers:

    x-api-key → su clave API

    Authorization → Bearer seguido de su token

    Content-Type → application/json
    ​

  3. Pestaña Body → raw → JSON.

Ejemplo para actualizar el título de un producto:

{ "reference": "REFERENCIA_DEL_PRODUCTO", "title": "Nuevo título del producto" }

💡 Si desea actualizar la información de su producto en otro idioma (distinto del idioma predeterminado de su cuenta), deberá utilizar el bloque langs.

Por ejemplo, para actualizar el título de un producto en inglés:

{ "reference": "REFERENCIA_DEL_PRODUCTO", "langs": [ { "lang": "american", "name": "English product name" } ] }

Punto clave: la referencia

El campo reference es la clave que identifica el producto a actualizar. Corresponde a la columna «API field» de su exportación de productos (y no a la columna «Product reference», que corresponde al número de expediente info_number).

⚠️ Si la referencia proporcionada no existe, la API creará un nuevo producto en lugar de modificar uno. Por ello, le recomendamos verificar siempre la referencia.

💡 Solo se modifican los campos enviados: si únicamente envía reference y title, el resto de la información del producto (precio, categoría, descripciones…) permanece sin cambios.

Paso 2 — Probar una sola solicitud

Antes de cualquier actualización masiva, le recomendamos probar con un solo producto:

  1. Abra una solicitud, verifique la URL, los Headers y el Body.

  2. Haga clic en Send.

  3. En la zona Response, deberá ver un estado 200 OK y una respuesta del tipo:

    { "error": "false", "message": "ok", "action": "Product successfully updated", "reference": "REFERENCIA_DEL_PRODUCTO" }

  4. Verifique en Ezus que el producto se ha actualizado correctamente.

Paso 3 — Actualizar sus productos de forma masiva

Para modificar de forma masiva los títulos y descripciones de varios productos, puede utilizar una colección que contenga una solicitud por producto y lanzar el Collection Runner:

  1. Pase el cursor sobre el nombre de la colección en el panel de la izquierda → haga clic en los ··· → Run collection.

  2. Verifique que todas las solicitudes a ejecutar estén marcadas.

  3. Deje un retardo (Delay) de aproximadamente 200 ms entre las solicitudes.

  4. Deje marcada la opción «Stop run if an error occurs»: en caso de error, la ejecución se detiene, lo que permite identificar la solicitud afectada.

  5. Haga clic en Start run. Cada producto se muestra con un estado Passed o Failed.

Resolución de problemas comunes

  • Error 401 / 403: problema de autenticación. Verifique la clave API y el token, y asegúrese de que no haya ningún espacio superfluo. Si el token tiene más de 12 horas, regenérelo.
    ​

  • Se ha creado un nuevo producto en lugar de actualizarse: la reference enviada no coincidía con ningún producto existente. Utilice bien el valor de la columna «API field».
    ​

  • El bloque langs es rechazado: el idioma en cuestión (p. ej. «american») debe estar activado en su cuenta Ezus.

¿Ha quedado contestada tu pregunta?