Veamos juntos cómo actualizar sus fichas de proveedores con Postman: añadir o modificar los nombres y las descripciones en varios idiomas (descripción corta y/o larga).

Antes de empezar, le recomendamos consultar el artículo ✍️ Actualizar sus productos del catálogo mediante la API (Postman), que detalla cómo recuperar la clave API, el token y cómo configurar Postman.

Requisitos previos

Antes de lanzarse a la creación de su solicitud, asegúrese de haber recuperado los siguientes elementos:

Su clave API de Ezus → header x-api-key.
Un token válido (mediante /login, válido durante 12h) → header Authorization: Bearer …
El campo API: es una referencia única que permite identificar el/los proveedor(es) que desea modificar.

⚠️ Asegúrese de que los idiomas en los que desea actualizar sus fichas de proveedores estén correctamente activados en los ajustes de su cuenta Ezus. De lo contrario, la solicitud será rechazada por la API.

¿Dónde encuentro la referencia API de mi proveedor?

Directamente desde la ficha del proveedor:

Desde su catálogo:

Útil si desea recuperar la información de varios proveedores: también puede exportar estos datos haciendo clic en los tres puntitos y, a continuación, en el botón Exportar.

💡 Si no ve esta columna en su tabla, deberá añadirla. Para ello, haga clic en los tres puntitos a la derecha y, a continuación, en el botón «Editar columnas».

Añadir descripciones multilingües

Para añadir o modificar las descripciones, utilice la ruta suppliers-upsert con el bloque langs. Cada idioma es un objeto que contiene el nombre y las descripciones del proveedor en ese idioma.

Cualquier otra información de su ficha de proveedor (dirección, categoría, tags…) no se verá afectada.

Paso 1 — Crear la solicitud

Método POST, URL: https://api.ezus.app/suppliers-upsert

Paso 2 — Encabezados (Headers)

x-api-key → su clave API
Authorization → Bearer seguido de su token
Content-Type → application/json

Paso 3 — Contenido (Body → raw → JSON)

{ "reference": "REFERENCIA_DEL_PROVEEDOR", "langs": [ { "lang": "french", "name": "Nom du fournisseur", "short_description": "Une description courte en français", "long_description": "Une description longue en français" }, { "lang": "english", "name": "Supplier name", "short_description": "A short description in English", "long_description": "A long description in English" }, { "lang": "spanish", "name": "Nombre del proveedor", "short_description": "Una descripción corta en español", "long_description": "Una descripción larga en español" } ] }

Descripción de los campos:

reference: corresponde al dato Campo API en Ezus (obligatorio).
langs: un array, con un objeto por idioma.
lang: el idioma del objeto. Siempre en minúscula y en inglés: french, english, american, spanish, italian, german, dutch, portuguese…
name: el nombre mostrado del proveedor en ese idioma.
short_description: descripción corta.
long_description: descripción larga.

💡 Bueno saberlo: se recomienda actualizar todos los idiomas utilizados en una sola llamada (el bloque langs fija las descripciones para los idiomas proporcionados).

Paso 4 — Enviar y verificar

Haga clic en Send. Respuesta esperada:

{ "error": "false", "message": "ok", "action": "Supplier successfully updated", "reference": "REFERENCIA_DEL_PROVEEDOR" }

Le recomendamos verificar en Ezus que las descripciones aparecen correctamente en cada idioma.

¿Y las imágenes (logo, visuales, medios)?

A día de hoy, las imágenes de un proveedor no pueden añadirse mediante la API. La ruta suppliers-upsert no incluye ningún campo para el logo, los visuales o los medios. Estos elementos aparecen solo en modo de lectura al consultar una ficha (solicitud GET supplier), pero no son modificables mediante la API.

Para añadir imágenes a sus fichas de proveedores, dos opciones:

Desde la interfaz de Ezus: directamente desde la ficha del proveedor.
Mediante una importación: contacte con su Customer Success Manager para saber más.

Enriquecer varios proveedores de una vez

Agrupe una solicitud por proveedor en una colección y, a continuación, lance el Collection Runner:

Pase el cursor sobre la colección → ··· → Run collection.
Verifique las solicitudes marcadas, deje un retardo de aproximadamente 200 ms, mantenga marcada la opción «Stop run if an error occurs».
Haga clic en Run: estado Passed / Failed por proveedor.

💡 Le recomendamos probar primero una sola solicitud con éxito antes de lanzar el run completo.

Resolución de problemas comunes

Error 401 / 403: verifique la clave API y el token (regenérelo si ha caducado).
Idioma rechazado: el idioma debe estar activado en los Ajustes de la cuenta y escrito en inglés (french, english, spanish…).
La descripción no aparece: verifique que la reference corresponde efectivamente a un proveedor existente (columna campo API).

Actualizar sus fichas de proveedores mediante la API (Postman)