Integración
Integra sin problemas Landed Cost con tu tienda Magento siguiendo los pasos de esta sección.
Empezar
Comienza completando nuestro formulario de registro. El proceso de incorporación comenzará una vez que se haya establecido el acuerdo de tu cuenta.
Incorporación
En un plazo de 24 horas después de registrarte, un representante de incorporación dedicado se pondrá en contacto contigo para iniciar un proceso de integración personalizado.
Importante: Los pasos enumerados a continuación son para tu referencia y serás guiado a través de ellos por tu representante de incorporación.
Instalar las extensiones de Zonos
-
Inicia sesión en tu cuenta de administrador de Magento.
-
"Compra" ambas extensiones de Zonos en el mercado de Magento:
- Duty & Tax
- Hello
- Las extensiones estarán vinculadas a tus claves de autenticación de Magento y permitirán la instalación de las extensiones a través de Composer.
-
Sigue las instrucciones de Adobe para instalar una extensión para completar la instalación a través de Composer.
Nota: Hello se instalará automáticamente durante la instalación de la extensión Duty & Tax porque está listado como una dependencia en el archivo composer.json de la extensión Duty & Tax.
Importante: Si no "compras" tanto Hello como Duty & Tax en el mercado, la instalación fallará con un error de paquete no encontrado.
Configurar Magento
Configurar la extensión de Duty & Tax en tu administración de Magento:
-
Haz clic en Stores en la barra lateral.
-
Haz clic en Configuration en el menú emergente.
-
Luego haz clic en Zonos en la barra lateral blanca en la siguiente página.
-
Configura las siguientes opciones según las instrucciones a continuación:
-
Enable - Selecciona Yes en el menú desplegable Yes/No junto al campo “Enabled” en la configuración de la extensión de Magento. Esto permite que Zonos muestre cotizaciones de derechos, impuestos y envío a tus compradores en los países seleccionados y especificados.
-
Store ID - Copia tu número de cuenta de Zonos desde Dashboard y pégalo en Magento bajo “Store ID.”
-
Service Token - Copia tu clave API de Zonos desde Dashboard y pégala en Magento bajo “Service Token.”
-
Carrier Title - “International” se mostrará por defecto para distinguir las cotizaciones de Zonos, pero puedes cambiarlo al título de transportista que prefieras.
-
Disable for U.S. Addresses - Por defecto, esto está configurado en YES porque Zonos no está destinado a cotizar pedidos nacionales, por lo que seleccionarías YES para deshabilitar direcciones de EE. UU. Sin embargo, puedes seleccionar NO si deseas que Zonos cotice pedidos con direcciones de EE. UU. Generalmente, si estás ubicado fuera de EE. UU., selecciona NO para habilitar pedidos con direcciones de EE. UU.
-
Ship to Applicable Countries - Configurado en All Allowed Countries por defecto para proporcionar una cotización de landed cost para cualquier país que hayas habilitado y configurado tarifas de envío en Dashboard. Si deseas cotizar solo para países específicos, selecciona Specific Countries, luego elige los países a los que deseas enviar en la sección “Ship to Specific Countries”.
-

-
Displayed Error Message - Escribe el mensaje que deseas mostrar a tu cliente si no se puede proporcionar una cotización de envío internacional, o se mostrará un mensaje predeterminado (mostrado en la imagen anterior).
-
Cart Item Attribute Mapping - Hay información a nivel de producto/artículo que Zonos utiliza para calcular derechos e impuestos que Magento no tiene campos para, como códigos HS. Puedes usar cualquiera de estos campos abiertos para agregar información adicional del artículo a tu catálogo.
Mapea tus campos personalizados, o aquellos que faltan en Magento, a cualquiera de estos campos disponibles en el sistema de Zonos para que Zonos reconozca lo que comunican tus campos personalizados. Puede que necesites información que no se pasa por defecto para reglas personalizadas.
- Length, Width, and Height - Aunque la extensión incluye la longitud, ancho y altura del envío en la descripción, las medidas requieren un mapeo antes de que se extraigan. Al igual que los códigos HS, hay un menú desplegable bajo Cart Item Attribute Mapping (en la imagen de abajo). Nuevamente, debes seleccionar los campos correspondientes de longitud, ancho, altura y código HS para ingresar su información.

Configurar Hello en tu administración de Magento:
-
Obtén tu clave de sitio desde Dashboard.
-
Ve a administración de Magento -> Stores -> Configuration -> Zonos -> Zonos Hello.
-
Configura las siguientes opciones según las instrucciones a continuación:
- Enable - Selecciona Yes en el menú desplegable Yes/No junto a “Module Enable” en la configuración de la extensión de Magento. Esto permite que el widget Hello muestre cotizaciones de derechos e impuestos mientras los clientes visitan tus páginas de productos.
- Store ID - Ingresa tu clave de sitio proporcionada por Zonos obtenida del paso 1 en Magento bajo “Store ID.”
- Currency Conversion Selectors - Si deseas que Hello convierta moneda, pega tus selectores CSS aquí. Múltiples selectores se separan con una coma, por ejemplo,
.price,.__current-price,.__subtotal,.__original-price
. - Hide Domestic Elements (opcional) - Si necesitas o deseas ocultar elementos nacionales para tus clientes internacionales, ingresa selectores CSS para los elementos que deseas ocultar, por ejemplo,
.nav-6,.action-add
.

Configurar Zonos
Después de configurar Duty & Tax y Hello desde tu administración de Magento, necesitarás configurar sus ajustes en Dashboard. Sigue las instrucciones a continuación para completar las configuraciones de Dashboard y ajustar cómo se calculará tu landed cost.
Configurar cómo se calcula landed cost en Dashboard:
- Inicia sesión en tu cuenta de Dashboard.
- Visita la página de configuración de Landed Cost para aprender cómo configurar los detalles de cómo se calculará tu landed cost.
Configurar tus tarifas de envío en Dashboard:
- Visita la página de configuración de envío para aprender cómo configurar tus ajustes de envío.
Probar
-
Habilita o activa tu extensión dentro de tu administración de Magento una vez que se hayan configurado todos los ajustes para una prueba precisa.
- Si hay más cambios que deseas hacer después de la prueba, selecciona No en el menú desplegable Yes/No junto al campo “Enabled” hasta que hayas ajustado todo a tu gusto. Cuando estés listo para que Zonos esté habilitado y activo en tu sitio, selecciona Yes en el menú desplegable Yes/No junto al campo “Enabled.”
-
Ve a tu sitio web de negocios y agrega artículos a tu carrito. Es mejor tener un carrito por encima del valor de de minimis para cualquier país para el que estarás probando tarifas, de modo que se deban derechos e impuestos, y así recibirás una cotización total de landed cost.
-
Haz clic en Checkout.
-
Agrega una dirección internacional a tu checkout. (Nota: Si estás conectado a la API de tu transportista a través de la conexión de cuenta de transportista para tarifas de envío, necesitarás usar una dirección legítima, o no recibirás cotizaciones de vuelta.)
- Usa este enlace para generar direcciones válidas en el país que estás probando.
-
La pestaña Shipping debería tener una sección para ingresar información de “Shipping Address” y una sección para elegir “Shipping Methods.”
-
Si completaste la configuración correctamente, verás las opciones de envío que configuraste en Dashboard, junto con una cotización de los derechos, impuestos y tarifas en los métodos de envío ofrecidos.
Desinstalar o deshabilitar extensiones de Zonos
Cómo desinstalar Hello y Duty & Tax
Si necesita desactivar o desinstalar cualquiera de las extensiones de Zonos, siga las instrucciones de Desinstalación de módulos de Adobe Commerce.
Desactivar Hello y Duty & Tax
Desactive las extensiones Hello y Duty & Tax seleccionando No en el menú desplegable de Sí/No junto al campo "Habilitado" en la configuración de ajustes de extensión de Magento.
Preguntas frecuentes
¿Qué información del producto debo proporcionar para obtener una cotización más precisa sobre aranceles, impuestos y costos de envío?
La información del producto puede afectar la cantidad de aranceles e impuestos adeudados y el costo de envío. Cuanta más información del producto proporcione a Zonos, más precisa será la cotización devuelta. Zonos puede generar una cotización incluso cuando esta información no está disponible, pero recomienda proporcionar los siguientes detalles clave del producto para mejorar la precisión:
- Peso: El peso afecta su costo de envío, lo que puede afectar los aranceles o impuestos. Los pesos en sus listados de productos de Magento se utilizan automáticamente por Zonos cuando están presentes.
- Dimensiones: Las dimensiones pueden afectar su costo de envío, lo que puede afectar los aranceles o impuestos. Zonos puede utilizar las dimensiones del producto (longitud, ancho y altura) establecidas en cada producto en Magento, pero debe mapearlas en la aplicación de Zonos para una integración adecuada.
- Códigos HS: Los códigos HS afectan las tasas de aranceles y a veces pueden afectar los impuestos. Zonos puede utilizar los códigos HS establecidos en sus listados de productos en Magento, pero debe mapear el campo de código HS en la aplicación de Zonos.
- País de origen: El país de origen de un producto afecta las tasas de aranceles y puede afectar los impuestos. El país de origen establecido en sus listados de productos de Magento se utiliza automáticamente por Zonos cuando está presente.
Detalles del producto pasados a Zonos por Magento
Detalles del producto | Pesos | Dimensiones | Código HS | País de origen |
---|---|---|---|---|
Pasado automáticamente | ||||
Debe ser mapeado |
Nota: Alternativamente, puede ingresar la información en el Catálogo, anulando la información almacenada y pasada desde Magento.
Aprenda más sobre la información del producto por plataforma.
Landed Cost para Magento
Integra la extensión de Landed Cost.Aprende cómo integrar la extensión de Zonos Duty & Tax para Magento para proporcionar un costo total de landed cost en tu checkout nativo.
Con nuestra extensión de Duty & Tax para Magento, puedes ofrecer a los clientes internacionales un costo total de landed cost dentro de tu checkout de Magento, incluyendo cálculos de impuestos, aranceles y tarifas de corretaje con opciones de prepago. Puedes personalizar tus opciones de envío internacional utilizando los transportistas y niveles de servicio de tu elección.
La instalación de la extensión descrita a continuación debe ser realizada por un desarrollador experimentado de Magento. Si tienes preguntas, por favor contáctanos.
Para que Zonos Landed Cost funcione correctamente, se deben "comprar" dos extensiones: