DOCS

Manage products

/

Gestionar catálogo

Crea y modifica productos.

Aprende cómo agregar, modificar y eliminar tu(s) producto(s) del catálogo de Zonos en el Panel de control o a través de la API. Utiliza el Catálogo en el Panel de control para evitar escribir código o si estás realizando cambios pequeños. Si deseas integrarte directamente con el Catálogo para implementaciones en producción, utiliza la API.

Crear un producto

Panel de control
API

Crea un producto en el Catálogo:

  1. Ve a Catálogo y haz clic en Agregar producto en la esquina superior derecha.
  2. Agrega los detalles de tu producto. El único campo requerido para crear un producto es el campo SKU y/o ID del producto. Estos campos se utilizarán para hacer referencia a tus productos del catálogo. Obtén más información sobre los identificadores del Catálogo.
  3. Opcional—Agrega tu(s) código(s) HS.
  4. Opcional—Agrega tu información de envío (peso, dimensiones, unidades de medida, etc.).
  5. Opcional—Agrega países restringidos.
  6. Haz clic en guardar producto.

Crea varios productos en el Catálogo:

Sube varios productos o tu catálogo completo de productos a la vez.

Importante: Si intentas crear un producto que ya existe, Catalog reconocerá el producto basado en el SKU y/o ID del producto y sobrescribirá los detalles del producto original con los nuevos detalles.

Editar un producto

Editar productos te permite actualizar tus productos existentes con información adicional o actualizada de manera eficiente. En lugar de tener que eliminar y volver a subir el producto, puedes subir la información actualizada, y Catalog la emparejará con el producto existente usando tu SKU o ID del producto, dependiendo de tu preferencia de clave de artículo. De esta manera, puedes mantener tu catálogo actualizado con un esfuerzo mínimo, ya sea que uses el Tablero o la API para crear nuevos productos o editar productos existentes.

Si creas/editas un producto de catálogo que ya existe en Catalog, espera lo siguiente:

Catalog sobrescribirá los campos en blanco en los artículos existentes.

  • Por ejemplo, si un producto existente, SKU 321, no tenía un valor para el peso, y el mismo producto, SKU 321, tenía un peso de 1.3 lbs en la nueva carga, el peso de 1.3 lbs sobrescribirá el campo previamente en blanco.

Catalog sobrescribirá los campos existentes con nuevos valores de campo.

  • Por ejemplo, si un producto existente, SKU 123, tenía un precio de 18.99 USD y el mismo producto, SKU 123, tenía un precio actualizado de 22.99 USD, el nuevo precio de 22.99 USD sobrescribirá el precio anterior.

Catalog no sobrescribirá los valores existentes con campos en blanco.

  • Por ejemplo, si un producto existente, SKU 456, tenía un código HS de 6109.10, pero el código HS del producto actualizado, SKU 456, está en blanco, el código HS existente permanecerá.
Tablero
API

Para editar un producto:

  1. Haz clic en la pestaña Productos.
  2. Selecciona el producto que deseas editar.
  3. Realiza tus cambios.
  4. Haz clic en guardar producto.

Para editar múltiples o todos los productos a la vez, simplemente sube un archivo CSV actualizado al Catalog, incluyendo tus combinaciones de SKU/ID de producto. Esto desencadenará actualizaciones automáticas a tus artículos existentes.

Eliminar un producto

Tablero
API

Para eliminar un producto:

  1. Haga clic en la pestaña Productos en el Tablero.
  2. Seleccione el/los producto(s) que desea eliminar. Una vez seleccionado(s) el/los producto(s), aparecerá un botón de eliminar.
  3. Haga clic en Eliminar y luego en Eliminar todo para confirmar la eliminación.

Para eliminar todos los productos:

  1. Seleccione la pestaña Productos en el Tablero.
  2. Haga clic en Gestionar Catálogo en la esquina superior derecha y luego en Eliminar todo.
  3. Haga clic en Eliminar todo una vez más para confirmar la eliminación.

Tenga en cuenta que si está eliminando una gran cantidad de elementos (más de 20,000 productos aproximadamente), aparecerá una notificación indicando que su eliminación está en progreso. Durante este tiempo, no podrá interactuar con el Catálogo hasta que se complete la eliminación. Sin embargo, puede descartar la notificación y navegar a otra página sin interrumpir el proceso de eliminación.

Restrict un producto

Si deseas evitar envíos a un determinado país (o países), puedes agregar restricciones al crear o actualizar un producto.

Tablero
API

Para restrict un solo producto en el Catálogo:

  1. Haz clic en la pestaña Productos.
  2. Selecciona el producto al que deseas agregar una restricción, lo que abrirá la página de edición.
  3. Encuentra la sección Países restringidos en la parte inferior de la página de edición.
  4. Agrega los países a los que deseas restrict tu producto seleccionando o escribiendo el nombre del país (o países).
  5. Haz clic en guardar producto.

Para restrict múltiples productos en el Catálogo:

  1. Haz clic en la pestaña Importar/exportar.
  2. Descarga la plantilla CSV del Catálogo.
  3. Completa la plantilla con los detalles de tu producto, incluyendo tu SKU/ID de Producto y los países restringidos. Ingresa el código ISO de 2 dígitos separado por barras verticales (por ejemplo, AU|KR|MY|SG). Para restrict todos los países, simplemente ingresa ALL como valor. Si deseas restrict todos los países excepto uno o unos pocos, ingresa ALL- seguido de los países que deseas desrestringir, separados por barras verticales (por ejemplo, ALL-CA|FR|US). Aprende más sobre el formato CSV. Si deseas eliminar todos los países restringidos existentes, ingresa NONE como valor.
  4. Guarda tu archivo como CSV y súbelo al Catálogo arrastrando y soltando o seleccionando tu archivo haciendo clic en examinar en la misma página desde la que descargaste el CSV.
  5. Revisa tus productos subidos en la vista previa screen y haz clic en subir.

Filtrar productos restringidos:

Puedes filtrar productos restringidos directamente en el catálogo descargando todo tu catálogo en formato CSV desde el Tablero y abriéndolo en Excel o Google Sheets. Desde allí, puedes usar la función de filtrado para ver solo los productos restringidos. Esto te permite localizar y gestionar fácilmente los productos restringidos en tu catálogo.

Si necesitas actualizar tu catálogo después de hacer cambios en tu CSV, vuelve a subir el archivo y cualquier producto coincidente será reemplazado con la versión actualizada. Esto se hace identificando y coincidiendo el SKU y/o ID del producto.

Si estás utilizando Checkout, se mostrará un mensaje de restricción en tu checkout cuando un producto esté restringido para el país del cliente. Por defecto, el mensaje dirá "Este artículo está restringido para la importación a tu país", pero puedes personalizar tu propio mensaje de restricción proporcionándolo en el campo restrictedCountriesMessage al agregar tus restricciones de país.

Filtrar un producto

Puedes buscar productos en el Catálogo a través del Tablero o mediante la API utilizando el SKU o el ID del producto. Ten en cuenta que solo las coincidencias exactas devolverán resultados; las coincidencias parciales no serán reconocidas.

Tablero
API

Para filtrar por SKU o ID de producto:

  1. Haz clic en la pestaña Productos.
  2. Selecciona SKU o ID de Producto en la esquina superior izquierda de tu Catálogo.
  3. Ingresa tu SKU o ID de producto.
  4. Haz clic en Aplicar para ver tu(s) producto(s) filtrado(s).

Exporta tus productos

Si seleccionas 50 elementos o menos de la tabla de Catálogo, tu catálogo se descargará directamente desde el Tablero. Sin embargo, si seleccionas Exportar todo o más de 50 elementos, tu CSV se exportará por correo electrónico.

Para exportar 50 elementos o menos, sigue estos pasos:

  1. Selecciona 50 elementos o menos directamente desde la tabla de Catálogo.
  2. Haz clic en Exportar en la esquina superior derecha.
  3. Encuentra tu archivo CSV en tu bandeja de entrada de correo electrónico.

Para exportar todos los productos:

Tablero
API
  1. Ve a Tablero -> Productos -> Catálogo.
  2. Haz clic en el menú desplegable Administrar Catálogo junto a Agregar producto y haz clic en Exportar todo.
  3. Encuentra tu archivo de catálogo en tus descargas.

¿Problemas para descargar desde tu correo electrónico?

Si tienes problemas para descargar el CSV desde el enlace del correo electrónico, esto puede deberse a que tu navegador está bloqueando la descarga. Si es así, sigue estos pasos:

  1. Haz clic derecho en el botón "Descargar" en tu correo electrónico.
  2. Selecciona "Copiar dirección del enlace" para copiar la URL de descarga.
  3. Pega la URL copiada en tu navegador y presiona enter.
  4. Tu catálogo se descargará directamente desde tu navegador.

Classify un producto

Puedes classify un producto de tu catálogo con la API utilizando el catalogItemId en la mutación ClassificationsCreateFromCatalog.

Ten en cuenta que se requiere un name para classify un producto de tu catálogo. Consulta la referencia de la API GraphQL para una lista completa de campos de catálogo y clasificación.

Para crear y classify un producto del catálogo simultáneamente, añade la mutación ClassificationsCreateFromCatalog a continuación a tu mutación CatalogItemsCreate.

Classify un producto del catálogo al código HS de 8+ dígitos (específico del país)

Cuando el campo shipToCountries está poblado, la clasificación será un código HS de 8+ dígitos (específico del país). Si no se proporcionan shipToCountries, la clasificación por defecto será un código HS de 6 dígitos (universal). Aprende más sobre las diferencias entre códigos HS universales y específicos del país.

En el ejemplo a continuación, se proporciona el campo shipToCountries para generar un código específico del país para Canadá.

Mutación

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

Aquí tienes un ejemplo de una solicitud. Si bien Zonos Classify generará una clasificación solo con un nombre, recomendamos encarecidamente agregar tantos detalles como sea posible para obtener los mejores resultados de clasificación.

Variables

1
2
3
4
5
6
7
8
9
10
{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

Respuesta

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

Errores de la API y soluciones

ErrorSolución
Se requiere un SKU o ID de producto para crear un productoSe requiere un identificador (SKU/ID de producto) para crear, editar o eliminar un elemento del catálogo. Para resolver esto, agregue un SKU y/o ID de producto.
El producto que intenta editar no existe*No se puede editar un producto que no existe. Para resolver esto, cree un nuevo producto con el SKU y/o ID de producto deseado.
La descripción de aduanas excede el límite de caracteres de 30 caracteres.Por defecto, las descripciones de aduanas están limitadas a 30 caracteres, lo cual se alinea con el límite de caracteres más común para las facturas comerciales.
Tipo de producto no válido. El catálogo admite los siguientes tipos de producto: digital_good. Para productos físicos, déjelo en blanco.El catálogo solo admite los siguientes tipos de producto: digital_good y physical_good. Si su producto es un producto físico (el más común), deje este campo en blanco.
Preferencia de embalaje no válida. El catálogo admite las siguientes preferencias de embalaje: ships_alone y consolidated. Si su producto se puede consolidar con otros productos, déjelo en blanco.Preferencia de embalaje no válida. El catálogo admite las siguientes preferencias de embalaje: ships_alone y consolidated. Si su producto se puede consolidar con otros productos, puede dejarlo en blanco ya que consolidated es el valor predeterminado.
Se debe especificar el país al proporcionar un código HSSi proporciona un código HS específico del país al crear un elemento, se requiere un país de envío. Para resolver esto, agregue un país de envío.
El precio debe ser mayor que 0El catálogo no admite valores de precio negativos. Para resolver esto, agregue un precio mayor que cero.
Se debe proporcionar el código de moneda cuando se suministra un valor de precioSi proporciona un precio, se requiere un código de moneda. Para resolver esto, agregue un código de moneda.
Se debe proporcionar el precio cuando se suministra un código de monedaSi proporciona un código de moneda, se requiere un precio. Para resolver esto, agregue un precio.
El campo dimensional acompañante no puede dejarse en blancoSi se proporciona un campo dimensional, se requieren los otros dos. Por ejemplo, si proporciona un ancho de "8 pulgadas", entonces se requerirían la altura y la longitud.
El valor de la medida debe ser mayor que 0El catálogo no admite valores de medida negativos o cero. Para resolver esto, agregue un valor mayor que cero.
Al proporcionar un valor dimensional, las unidades dimensionales no pueden dejarse vacíasSi proporciona un valor dimensional, se requiere una unidad dimensional. Para resolver esto, agregue una unidad dimensional.
Al proporcionar un valor de peso, la unidad de peso no puede dejarse vacíaSi proporciona un valor de peso, se requiere una unidad de peso. Para resolver esto, agregue una unidad de peso.

* Solo error de la API

¿Fue útil esta página?