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

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á.

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

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 prevenir envíos a un cierto país (o países), puedes agregar restricciones al crear o actualizar un producto.

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.
  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 el Catálogo plantilla CSV.
  3. Completa la plantilla con los detalles de tu producto, incluyendo tu SKU/ID de producto y 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 te gustaría desrestringir, separados por barras verticales, por ejemplo, ALL-CA|FR|US. Aprende más sobre 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 explorar en la misma página de donde descargaste el CSV.
  5. Revisa tus productos subidos en la vista previa screen y haz clic en subir.

Filtrando productos restringidos:

Puedes filtrar productos restringidos directamente en el catálogo descargando tu catálogo completo 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 por la versión actualizada. Esto se hace identificando y emparejando el SKU y/o ID de 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.

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:

  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 API y resoluciones

ErrorResolució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 artículo del catálogo. Para resolver esto, añade un SKU y/o ID de producto.
El producto que intentas editar no existe*No puedes editar un producto que no existe. Para resolver esto, crea 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 que se alinea con el límite de caracteres más común para las facturas comerciales.
Tipo de producto inválido. El catálogo admite los siguientes tipos de productos: digital_good. Para bienes físicos, déjalo en blanco.El catálogo solo admite los siguientes tipos de productos: digital_good y physical_good. Si tu producto es un bien físico (lo más común), deja este campo en blanco.
Preferencia de embalaje inválida. El catálogo admite las siguientes preferencias de embalaje: ships_alone y consolidated. Si tu producto puede ser consolidado con otros productos, déjalo en blanco.Preferencia de embalaje inválida. El catálogo admite las siguientes preferencias de embalaje: ships_alone y consolidated. Si tu producto puede ser consolidado con otros productos, puedes dejarlo en blanco ya que consolidated es el predeterminado.
Se debe especificar un país al proporcionar un código HSSi proporcionas un código HS específico del país al crear un artículo, se requiere un país de envío. Para resolver esto, añade un país de envío.
El precio debe ser mayor que 0El catálogo no admite valores de precio negativos. Para resolver esto, añade un precio mayor que cero.
Se debe proporcionar un código de moneda cuando se suministra un valor de precioSi proporcionas un precio, se requiere un código de moneda. Para resolver esto, añade un código de moneda.
Se debe proporcionar un precio cuando se suministra un código de monedaSi proporcionas un código de moneda, se requiere un precio. Para resolver esto, añade un precio.
El campo dimensional correspondiente no puede quedar en blancoSi se proporciona un campo dimensional, se requieren los otros dos, por ejemplo, si proporcionas 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, añade un valor mayor que cero.
Al proporcionar un valor dimensional, las unidades dimensionales no pueden quedar vacíasSi proporcionas un valor dimensional, se requiere una unidad dimensional. Para resolver esto, añade una unidad dimensional.
Al proporcionar un valor de peso, la unidad de peso no puede quedar vacíaSi proporcionas un valor de peso, se requiere una unidad de peso. Para resolver esto, añade una unidad de peso.

* Error de API solamente

¿Fue útil esta página?