Aprenda a agregar, modificar y eliminar sus productos de Zonos Catalog en Dashboard o a través de la API. Utilice Catalog en Dashboard para evitar escribir código o si está realizando cambios pequeños. Si desea integrarse directamente con Catalog para implementaciones de producción, utilice la API.
Crear un producto
Cree un producto en Catalog:
Vaya a Catalog y haga clic en Add product en la esquina superior derecha.
Agregue los detalles de su producto. El único campo obligatorio para crear un producto es el SKU y/o el(los) campo(s) de ID de producto. Estos campos se utilizarán para hacer referencia a los productos de su catálogo. Obtenga más información sobre los identificadores de Catalog.
Opcional—Agregue su(s) código(s) HS.
Opcional—Agregue su información de envío (peso, dimensiones, unidades de medida, etc.).
Etiquetar un producto como mercancías peligrosas (DHL)
Para envíos de DHL, puede etiquetar un producto como mercancías peligrosas para que el servicio de valor agregado correcto de DHL se aplique automáticamente cada vez que cree una etiqueta para ese producto. Esto cubre las clases de mercancías reguladas de "bajo riesgo" o exentas: artículos que técnicamente están regulados pero se envían bajo una disposición especial o una exención por cantidad.
Una etiqueta de mercancías peligrosas se almacena como un atributo del artículo del catálogo: un par key/value en el producto. Los atributos se configuran a través de la API (catalogItemsCreate o catalogItemsUpdate); no hay un campo en Dashboard ni una columna CSV para ellos.
Solo DHL
El etiquetado de mercancías peligrosas solo afecta los envíos de DHL. La etiqueta se ignora para
otros transportistas.
Clave de atributo admitida
DANGEROUS_GOODS es una clave de atributo admitida para el etiquetado de mercancías peligrosas de DHL.
Aún no figura entre las claves aprobadas en la
referencia ItemAttributeInput, pero la API la acepta.
Para etiquetar un producto, agregue un atributo con la clave DANGEROUS_GOODS y un valor de una de las categorías admitidas que se indican a continuación.
No restringido, disposición especial A70: artículos presurizados, como amortiguadores de gas y absorbeimpactos (UN3164).
NOT_RESTRICTED_A67
No restringido, disposición especial A67: motores o maquinaria accionados por líquido inflamable (UN3528).
NOT_RESTRICTED_A02
No restringido, disposición especial A02: exento según la disposición de carga pequeña de transporte por carretera ADR.
LIMITED_QUANTITY
Cantidad limitada (ADR): mercancías peligrosas empaquetadas en pequeñas cantidades dentro de los límites reglamentarios.
EXCEPTED_QUANTITY
Cantidad exceptuada (IATA): cantidades muy pequeñas exentas de la mayoría de las normas de mercancías peligrosas para transporte aéreo.
CONSUMER_COMMODITY
Mercancía de consumo ID8000: productos cotidianos listos para la venta minorista con contenido peligroso menor, como aerosoles y perfume.
MAGNETIZED_MATERIAL
Material magnetizado (UN2807): artículos con un campo magnético lo suficientemente fuerte como para afectar los instrumentos de la aeronave.
BIOLOGICAL_SUBSTANCE
Sustancia biológica (UN3373): sustancias biológicas de categoría B, como muestras de diagnóstico o clínicas.
Aplicar etiquetas automáticamente en las etiquetas de envío
Etiquetar un producto es el primer paso. Para que Zonos aplique la categoría a sus
etiquetas de DHL automáticamente, active Ship dangerous goods en
label settings. También puede
seleccionar una categoría manualmente en una sola etiqueta; consulte
declare dangerous goods.
Editar un producto
La edición de productos le permite actualizar sus productos existentes con información adicional o actualizada de manera eficiente. En lugar de tener que eliminar y volver a cargar el producto, puede cargar la información actualizada y Catalog la hará coincidir con el producto existente utilizando su SKU o ID de producto, según su preferencia de clave de artículo. De esta manera, puede mantener su catálogo actualizado con un esfuerzo mínimo, ya sea que utilice Dashboard o la API para crear productos nuevos o editar productos existentes.
Si crea/edita un producto del catálogo que ya existe en Catalog, espere lo siguiente:
Catalog sobrescribirá los campos en blanco de 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 lb sobrescribiría el campo previamente en blanco.
Catalog sobrescribirá los campos existentes con los 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ía 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 se mantiene.
Para editar un producto:
Haga clic en la pestaña Products.
Seleccione el producto que desea editar.
Realice sus cambios.
Haga clic en save product.
Para editar varios productos o todos los productos a la vez, simplemente cargue un archivo CSV actualizado en Catalog, incluyendo su SKU o ID de producto. Esto activará actualizaciones automáticas de sus artículos existentes.
Eliminar un producto
Para eliminar un producto:
Haga clic en la pestaña Products en Dashboard.
Seleccione el(los) producto(s) que desea eliminar. Una vez que su(s) producto(s) estén seleccionados, aparecerá un botón de eliminación.
Haga clic en Delete y luego en Delete all para confirmar la eliminación.
Para eliminar todos los productos:
Seleccione la pestaña Products en Dashboard.
Haga clic en Manage Catalog en la esquina superior derecha y luego en Delete all.
Haga clic en Delete all una vez más para confirmar la eliminación.
Tenga en cuenta que si está eliminando una gran cantidad de artículos (más de 20,000 productos aproximadamente), aparecerá una notificación que indica que su eliminación está en curso. Durante este tiempo, no podrá interactuar con Catalog hasta que se complete la eliminación. Sin embargo, puede descartar la notificación y navegar fuera sin interrumpir el proceso de eliminación.
Restringir un producto
Si desea impedir envíos a un país o varios países, puede agregar restricciones al crear o actualizar un producto.
Las aplicaciones Zonos Duty & Tax no admiten restricciones a nivel de artículo que eliminen productos específicos de pedidos internacionales. Si un artículo restringido está en el carrito, todo el carrito debe bloquearse para envíos a ese país. Esto se gestiona mediante una regla de restricción a nivel de carrito, que debe configurarse con anticipación durante la incorporación. Si bien Catalog es compatible con las aplicaciones Duty & Tax, las restricciones a nivel de artículo solo se admiten cuando se utiliza Zonos Checkout.
Para restringir un solo producto en Catalog:
Haga clic en la pestaña Products.
Seleccione el producto al que desea agregar una restricción, lo que abrirá la página de edición.
Busque la sección Restricted countries en la parte inferior de la página de edición.
Agregue los países a los que desea restringir su producto seleccionando o escribiendo el(los) nombre(s) del país.
Complete la plantilla con los detalles de su producto, incluyendo su SKU/ID de producto y los países restringidos. Ingrese el código ISO de 2 dígitos separado por barras verticales, por ejemplo, AU|KR|MY|SG. Para restringir todos los países, simplemente ingrese ALL como valor. Si desea restringir todos los países excepto uno o algunos, ingrese ALL- seguido de los países que desea dejar sin restricción, separados por barras verticales, por ejemplo, ALL-CA|FR|US. Obtenga más información sobre el formato CSV. Si desea eliminar todos los países restringidos existentes, ingrese NONE como valor.
Guarde su archivo como CSV y cárguelo en Catalog arrastrándolo y soltándolo o seleccionando su archivo haciendo clic en browse en la misma página desde la que descargó el CSV.
Revise sus productos cargados en la pantalla de vista previa y haga clic en upload.
Filtrar productos restringidos:
Puede filtrar productos restringidos directamente en el catálogo descargando todo su catálogo en formato CSV desde Dashboard y abriéndolo en Excel o Google Sheets. Desde allí, puede utilizar la función de filtrado para ver solo los productos restringidos. Esto le permite localizar y gestionar fácilmente los productos restringidos en su catálogo.
Si necesita actualizar su catálogo después de realizar cambios en su CSV, vuelva a cargar el archivo y cualquier producto coincidente se reemplazará con la versión actualizada. Esto se hace identificando y haciendo coincidir el SKU y/o el ID de producto.
Si usa Checkout, se mostrará un mensaje de restricción en su checkout cuando un producto esté restringido para el país del cliente. De forma predeterminada, el mensaje dirá "This item is restricted from import to your country."
Filtrar un producto
Puede buscar productos en Catalog a través de Dashboard o mediante la API utilizando el SKU, el ID de producto o el nombre del producto. Para búsquedas por SKU e ID de producto, solo las coincidencias exactas devolverán resultados; no se admiten coincidencias parciales. Sin embargo, al buscar por nombre de producto, sí se admiten coincidencias parciales.
Para filtrar por SKU o ID de producto:
Haga clic en la pestaña Products en Dashboard.
Seleccione SKU o Product ID en la parte superior izquierda de su Catalog.
Ingrese su SKU, ID de producto o nombre del producto.
Haga clic en Apply para ver su(s) producto(s) filtrado(s).
Para buscar el nombre de un producto:
Haga clic en la pestaña Products en Dashboard.
En la parte superior derecha de su Catalog, escriba el nombre del producto en el campo de búsqueda.
Vea su(s) producto(s) filtrado(s).
Exportar sus productos
Si elige 50 artículos o menos de la tabla de Catalog, su catálogo se descargará directamente desde Dashboard. Sin embargo, si selecciona Export all o más de 50 artículos, su CSV se exportará por correo electrónico.
Para exportar 50 artículos o menos, siga estos pasos:
Seleccione 50 artículos o menos directamente de la tabla de Catalog.
Haga clic en Export en la esquina superior derecha.
Localice su archivo CSV en la bandeja de entrada de su correo electrónico.
Si tiene problemas para descargar el CSV desde el enlace del correo electrónico, esto puede deberse a que su navegador bloquea la descarga. Si es así, siga estos pasos:
Haga clic con el botón derecho en el botón "Download" de su correo electrónico.
Seleccione "Copy link address" para copiar la URL de descarga.
Pegue la URL copiada en su navegador y presione enter.
Su catálogo se descargará directamente desde su navegador.
Clasificar un producto
Puede clasificar un producto de su catálogo con la API utilizando el catalogItemId en la mutación ClassificationsCreateFromCatalog.
Tenga en cuenta que se requiere un name para clasificar un producto de su catálogo. Consulte la referencia de la API GraphQL para obtener una lista completa de campos de catálogo y clasificación.
Para crear y clasificar un producto del catálogo simultáneamente, agregue la mutación ClassificationsCreateFromCatalog que se muestra a continuación a su mutaciónCatalogItemsCreate.
Cuando el campo shipToCountries está completado, la clasificación será un código HS de 8+ dígitos (específico por país). Si no se proporcionan shipToCountries, la clasificación será un código HS de 6 dígitos (universal) de forma predeterminada. Obtenga más información sobre las diferencias entre códigos HS universales y específicos por país.
En el ejemplo a continuación, se proporciona el campo shipToCountries para generar un código específico por país para Canadá.
A continuación se muestra un ejemplo de solicitud. Si bien Zonos Classify generará una clasificación solo con un name, le recomendamos encarecidamente agregar tantos detalles como sea posible para obtener los mejores resultados de clasificación.
A SKU or product ID is required to create a product
Se requiere un identificador (SKU/ID de producto) para crear, editar o eliminar un artículo del catálogo. Para resolverlo, agregue un SKU y/o un ID de producto.
The product you are trying to edit does not exist*
No puede editar un producto que no existe. Para resolverlo, cree un producto nuevo con el SKU y/o ID de producto deseado.
Customs description exceeds character limit of 30 characters.
De forma predeterminada, las descripciones aduaneras están limitadas a 30 caracteres, lo que coincide con el límite de caracteres más común para facturas comerciales.
Product type invalid. Catalog supports the following product types: digital_good. For physical goods, leave it blank.
Catalog solo admite los siguientes tipos de producto: digital_good y physical_good. Si su producto es un bien físico (lo más común), deje este campo en blanco.
Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank.
Preferencia de empaque no válida. Catalog admite las siguientes preferencias de empaque: ships_alone y consolidated. Si su producto puede consolidarse con otros productos, puede dejarlo en blanco, ya que consolidated es el valor predeterminado.
Country must be specified when providing an HS code
Si proporciona un código HS específico por país al crear un artículo, se requiere un país de destino. Para resolverlo, agregue un país de destino.
Price must be greater than 0
Catalog no admite valores de precio negativos. Para resolverlo, agregue un precio mayor que cero.
Currency code must be provided when a price value is supplied
Si proporciona un precio, se requiere un código de moneda. Para resolverlo, agregue un código de moneda.
Price must be provided when a currency code is supplied
Si proporciona un código de moneda, se requiere un precio. Para resolverlo, agregue un precio.
The accompanying dimensional field cannot be left blank
Si se proporciona un campo dimensional, los otros dos son obligatorios; por ejemplo, si proporciona un ancho de 8 pulgadas, entonces la altura y la longitud serían obligatorias.
Measurement value must be greater than 0
Catalog no admite valores de medida negativos o cero. Para resolverlo, agregue un valor mayor que cero.
When providing a dimensional value, dimensional units cannot be left empty
Si proporciona un valor dimensional, se requiere una unidad dimensional. Para resolverlo, agregue una unidad dimensional.
When providing a weight value, the weight unit cannot be left empty
Si proporciona un valor de peso, se requiere una unidad de peso. Para resolverlo, agregue una unidad de peso.
* Solo error de API
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Gestionar productos
Gestionar Catalog
Cree y modifique productos.Aprenda a agregar, modificar y eliminar sus productos de Zonos Catalog en Dashboard o a través de la API. Utilice Catalog en Dashboard para evitar escribir código o si está realizando cambios pequeños. Si desea integrarse directamente con Catalog para implementaciones de producción, utilice la API.
Crear un producto
Cree un producto en Catalog:
Cree varios productos en Catalog:
Cargue varios productos o todo su catálogo de productos a la vez.
Etiquetar un producto como mercancías peligrosas (DHL)
Para envíos de DHL, puede etiquetar un producto como mercancías peligrosas para que el servicio de valor agregado correcto de DHL se aplique automáticamente cada vez que cree una etiqueta para ese producto. Esto cubre las clases de mercancías reguladas de "bajo riesgo" o exentas: artículos que técnicamente están regulados pero se envían bajo una disposición especial o una exención por cantidad.
Una etiqueta de mercancías peligrosas se almacena como un atributo del artículo del catálogo: un par
key/valueen el producto. Los atributos se configuran a través de la API (catalogItemsCreateocatalogItemsUpdate); no hay un campo en Dashboard ni una columna CSV para ellos.El etiquetado de mercancías peligrosas solo afecta los envíos de DHL. La etiqueta se ignora para otros transportistas.
DANGEROUS_GOODSes una clave de atributo admitida para el etiquetado de mercancías peligrosas de DHL. Aún no figura entre las claves aprobadas en la referenciaItemAttributeInput, pero la API la acepta.Para etiquetar un producto, agregue un atributo con la clave
DANGEROUS_GOODSy un valor de una de las categorías admitidas que se indican a continuación.mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) {catalogItemsCreate(input: [{ sku: $sku, name: $name, attributes: $attributes }]idnameskuattributeskeyvalueValores admitidos de mercancías peligrosas
NOT_RESTRICTED_A70NOT_RESTRICTED_A67NOT_RESTRICTED_A02LIMITED_QUANTITYEXCEPTED_QUANTITYCONSUMER_COMMODITYMAGNETIZED_MATERIALBIOLOGICAL_SUBSTANCEEtiquetar un producto es el primer paso. Para que Zonos aplique la categoría a sus etiquetas de DHL automáticamente, active Ship dangerous goods en label settings. También puede seleccionar una categoría manualmente en una sola etiqueta; consulte declare dangerous goods.
Editar un producto
La edición de productos le permite actualizar sus productos existentes con información adicional o actualizada de manera eficiente. En lugar de tener que eliminar y volver a cargar el producto, puede cargar la información actualizada y Catalog la hará coincidir con el producto existente utilizando su SKU o ID de producto, según su preferencia de clave de artículo. De esta manera, puede mantener su catálogo actualizado con un esfuerzo mínimo, ya sea que utilice Dashboard o la API para crear productos nuevos o editar productos existentes.
Si crea/edita un producto del catálogo que ya existe en Catalog, espere lo siguiente:
Catalog sobrescribirá los campos en blanco de los artículos existentes.
Catalog sobrescribirá los campos existentes con los nuevos valores de campo.
Catalog no sobrescribirá los valores existentes con campos en blanco.
Para editar un producto:
Para editar varios productos o todos los productos a la vez, simplemente cargue un archivo CSV actualizado en Catalog, incluyendo su SKU o ID de producto. Esto activará actualizaciones automáticas de sus artículos existentes.
Eliminar un producto
Para eliminar un producto:
Para eliminar todos los productos:
Tenga en cuenta que si está eliminando una gran cantidad de artículos (más de 20,000 productos aproximadamente), aparecerá una notificación que indica que su eliminación está en curso. Durante este tiempo, no podrá interactuar con Catalog hasta que se complete la eliminación. Sin embargo, puede descartar la notificación y navegar fuera sin interrumpir el proceso de eliminación.
Restringir un producto
Si desea impedir envíos a un país o varios países, puede agregar restricciones al crear o actualizar un producto.
Las aplicaciones Zonos Duty & Tax no admiten restricciones a nivel de artículo que eliminen productos específicos de pedidos internacionales. Si un artículo restringido está en el carrito, todo el carrito debe bloquearse para envíos a ese país. Esto se gestiona mediante una regla de restricción a nivel de carrito, que debe configurarse con anticipación durante la incorporación. Si bien Catalog es compatible con las aplicaciones Duty & Tax, las restricciones a nivel de artículo solo se admiten cuando se utiliza Zonos Checkout.
Para restringir un solo producto en Catalog:
Para restringir varios productos en Catalog:
AU|KR|MY|SG. Para restringir todos los países, simplemente ingreseALLcomo valor. Si desea restringir todos los países excepto uno o algunos, ingreseALL-seguido de los países que desea dejar sin restricción, separados por barras verticales, por ejemplo,ALL-CA|FR|US. Obtenga más información sobre el formato CSV. Si desea eliminar todos los países restringidos existentes, ingreseNONEcomo valor.Filtrar productos restringidos:
Puede filtrar productos restringidos directamente en el catálogo descargando todo su catálogo en formato CSV desde Dashboard y abriéndolo en Excel o Google Sheets. Desde allí, puede utilizar la función de filtrado para ver solo los productos restringidos. Esto le permite localizar y gestionar fácilmente los productos restringidos en su catálogo.
Si necesita actualizar su catálogo después de realizar cambios en su CSV, vuelva a cargar el archivo y cualquier producto coincidente se reemplazará con la versión actualizada. Esto se hace identificando y haciendo coincidir el SKU y/o el ID de producto.
Si usa Checkout, se mostrará un mensaje de restricción en su checkout cuando un producto esté restringido para el país del cliente. De forma predeterminada, el mensaje dirá "This item is restricted from import to your country."
Filtrar un producto
Puede buscar productos en Catalog a través de Dashboard o mediante la API utilizando el SKU, el ID de producto o el nombre del producto. Para búsquedas por SKU e ID de producto, solo las coincidencias exactas devolverán resultados; no se admiten coincidencias parciales. Sin embargo, al buscar por nombre de producto, sí se admiten coincidencias parciales.
Para filtrar por SKU o ID de producto:
Para buscar el nombre de un producto:
Exportar sus productos
Si elige 50 artículos o menos de la tabla de Catalog, su catálogo se descargará directamente desde Dashboard. Sin embargo, si selecciona Export all o más de 50 artículos, su CSV se exportará por correo electrónico.
Para exportar 50 artículos o menos, siga estos pasos:
Para exportar todos los productos:
¿Problemas para descargar desde su correo electrónico?
Si tiene problemas para descargar el CSV desde el enlace del correo electrónico, esto puede deberse a que su navegador bloquea la descarga. Si es así, siga estos pasos:
Clasificar un producto
Puede clasificar un producto de su catálogo con la API utilizando el
catalogItemIden la mutaciónClassificationsCreateFromCatalog.Tenga en cuenta que se requiere un
namepara clasificar un producto de su catálogo. Consulte la referencia de la API GraphQL para obtener una lista completa de campos de catálogo y clasificación.Para crear y clasificar un producto del catálogo simultáneamente, agregue la mutación
ClassificationsCreateFromCatalogque se muestra a continuación a su mutaciónCatalogItemsCreate.Clasificar un producto del catálogo a 8+ dígitos (específico por país)
Cuando el campo
shipToCountriesestá completado, la clasificación será un código HS de 8+ dígitos (específico por país). Si no se proporcionanshipToCountries, la clasificación será un código HS de 6 dígitos (universal) de forma predeterminada. Obtenga más información sobre las diferencias entre códigos HS universales y específicos por país.En el ejemplo a continuación, se proporciona el campo
shipToCountriespara generar un código específico por país para Canadá.mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) {classificationsCalculateFromCatalog(input: $catalogItemToClassify) {idconfiguration {shipToCountries}hsCode {code}name}}A continuación se muestra un ejemplo de solicitud. Si bien Zonos Classify generará una clasificación solo con un
name, le recomendamos encarecidamente agregar tantos detalles como sea posible para obtener los mejores resultados de clasificación.{"catalogItemToClassify": [{"catalogItemId": "catalog_item_893jkdkllg03k9khjd9","configuration": {"shipToCountries": ["CA"]}}]}Errores de la API y resoluciones
digital_goodyphysical_good. Si su producto es un bien físico (lo más común), deje este campo en blanco.ships_aloneyconsolidated. Si su producto puede consolidarse con otros productos, puede dejarlo en blanco, ya queconsolidatedes el valor predeterminado.ItemAttributeInput
¿Fue útil esta página?