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.).
- Opcional—Agregue países restringidos.
- Haga clic en save product.
Cree varios productos en Catalog:
Cargue varios productos o todo su catálogo de productos a la vez.
Importante: Si intenta crear un producto que ya existe, Catalog reconocerá el producto según el SKU y/o ID de producto y sobrescribirá los detalles del producto original con los nuevos detalles.
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.
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.
mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) { catalogItemsCreate( input: [{ sku: $sku, name: $name, attributes: $attributes }] id name sku attributes key valueValores admitidos de mercancías peligrosas
| Value↕ | Categoría↕ |
|---|---|
NOT_RESTRICTED_A70 | 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. |
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.
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.
- Haga clic en save product.
Para restringir varios productos en Catalog:
- Haga clic en la pestaña Import/export.
- Descargue el Catalog template CSV.
- 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 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. - 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.
If you're using 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.
Para exportar todos los productos:
- Vaya a Dashboard -> Products -> Catalog.
- Haga clic en el menú desplegable Manage Catalog junto a Add product y haga clic en Export all.
- Encuentre su archivo de catálogo en sus descargas.
¿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:
- 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.
Classify 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ón CatalogItemsCreate.
Classify un producto del catálogo a 8+ dígitos (específico por país)
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á.
mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) { classificationsCalculateFromCatalog(input: $catalogItemToClassify) { id configuration { 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
| Error↕ | Resolució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
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.