Lista de verificación de integración
Siga esta lista de verificación completa para configurar su cuenta de Zonos Dashboard e integrar la extensión Zonos Checkout para WooCommerce.
Crear una cuenta de Zonos
Para comenzar, contacte a nuestro equipo de ventas para crear una cuenta y firmar un acuerdo. Una vez firmado el acuerdo, recibirá dos microdepósitos en su cuenta que deben verificarse.
Envíe por correo electrónico estos montos de microdepósito a accounting@zonos.com con el ID de tienda de Dashboard (con copia a su representante de ventas).
Una vez verificados, sus datos bancarios se mostrarán en Dashboard -> Settings -> Billing.
Configurar Dashboard y los ajustes de Checkout
Después de crear su cuenta de Zonos, deberá configurar los ajustes en Dashboard para garantizar que Checkout funcione correctamente con su tienda. Esta sección cubre todas las configuraciones esenciales de Dashboard.
Configurar pagos
Conecte una cuenta bancaria para recibir pagos oportunos de Checkout. Los pagos se procesan diariamente con un retraso de 2 días desde el pago capturado. Para hacerlo, siga estos pasos:
- Vaya a Dashboard -> Settings -> Checkout settings .
- Haga clic en Add bank account.
- Será llevado a un portal de Stripe para completar la configuración y proporcionar la siguiente información:
- Información de la cuenta bancaria.
- EIN de la empresa.
- Número de Seguro Social de un propietario con el 25% de la empresa. Para más detalles sobre por qué esto es necesario, consulte la documentación de Stripe.
Nota: Si necesita actualizar su calendario de pagos, contacte a support@zonos.com
Configurar dominios permitidos
Zonos Checkout requiere una lista de dominios permitidos por motivos de seguridad. Esto evita que sitios no autorizados carguen Checkout y garantiza que solo se ejecute en sus dominios aprobados. Sin esta configuración, Checkout devolverá errores de permiso.
Para configurarlo:
- Vaya a Dashboard -> Settings -> Checkout settings.
- En URLs, agregue su dominio completo y cualquier subdominio donde se utilizará Checkout. Por ejemplo, si su dominio es
example.com, debe agregarexample.comytest.example.com.
Personalizar ajustes de marca
Configure sus ajustes de marca en Dashboard para que coincidan con el aspecto de su tienda.
Para hacerlo, siga estos pasos:
- Vaya a Dashboard -> Settings -> Checkout settings -> Branding
- Configure los siguientes ajustes:
- Logo.
- Color de marca y de acento.
- Tema, estilo y fuente.
Para más información sobre los ajustes de marca, consulte nuestra documentación.
Conectar un transportista de envío
Para cotizar el envío en el checkout, deberá conectar un transportista de envío a su cuenta de Zonos. Esto le permitirá habilitar niveles de servicio de envío específicos en el checkout.
Para conectar un transportista de envío, siga estos pasos:
- Vaya a Dashboard -> Settings -> Shipping -> Rates.
- Haga clic en Add carrier.
- Siga las instrucciones de configuración del transportista.
Para más detalles sobre la conexión de cuentas de transportistas, consulte nuestra documentación.
Configurar zonas de envío
Las zonas de envío le permiten configurar qué transportistas y niveles de servicio están disponibles para diferentes regiones del mundo.
Para configurar zonas de envío, siga estos pasos:
- Vaya a Dashboard -> Settings -> Shipping -> Locations.
- Haga clic en New zone.
- Ingrese un nombre de zona y seleccione los países a los que desea enviar.
- Seleccione el transportista y el nivel de servicio que desea ofrecer.
Para más detalles sobre zonas de envío, consulte nuestra documentación.
Configurar un país de origen y código HS de respaldo
El país de origen y el código HS se utilizan para calcular aranceles e impuestos precisos.
Si no proporciona un país de origen o código HS específico, utilizaremos los valores de respaldo configurados en Dashboard.
Para configurar su país de origen y código HS de respaldo:
- Vaya a Dashboard -> Settings -> Shipping -> Catalog.
- Para el país de origen, seleccione el país donde se fabrica la mayoría de sus productos.
- Para el código HS, ingrese el código HS de su producto más común. Si no tiene un código HS, vaya a Classify en Dashboard e ingrese el nombre y la descripción de su producto para generar un código HS preciso.
Instalar y configurar la extensión Checkout para WooCommerce
Siga estos pasos para instalar y configurar la extensión Checkout para WooCommerce.
Instalar la extensión
- Inicie sesión en su administrador de WordPress.
- En plugins, busque la extensión Zonos Checkout para WooCommerce.
- Haga clic en Install and activate.
Conectar la extensión a su cuenta de Zonos
-
En su administrador de WordPress, haga clic en la extensión Zonos Checkout en la navegación del lado izquierdo.
-
Haga clic en General Settings.
-
Ingrese su Private API key y Store ID para vincular los ajustes de Zonos Dashboard a su sitio de WooCommerce.
-
Localice la clave de API privada de su tienda en Dashboard. Hay varias claves de API disponibles. Seleccione la clave de API que tenga el nombre de su tienda, el Type sea Secret y el Token comience con
credential_live. Ingrese esta clave de API en el campo Private API Key en General settings de la extensión. -
Copie su Store ID desde Dashboard e ingréselo en el campo Store ID en General settings de la extensión.
-
-
Habilite la aplicación en modo de prueba.
- De forma predeterminada, Test mode está activado. Cuando el modo de prueba está habilitado, los compradores no serán dirigidos a Zonos Checkout.
Configurar su botón de checkout internacional
Tiene dos opciones para configurar cómo los compradores internacionales acceden a Zonos Checkout.
Use su botón de checkout actual para compradores nacionales e internacionales:
Configure su botón de checkout actual para redirigir automáticamente a los compradores internacionales a Zonos Checkout mientras mantiene a los compradores nacionales en su flujo de checkout estándar. Para hacerlo, siga estos pasos:
- En General settings de la extensión, ingrese el selector CSS de su botón de checkout (p. ej.,
#checkout-buttono.woocommerce-checkout-button). - Haga clic en Save general settings.
Para encontrar su selector CSS, haga clic con el botón derecho en su botón de checkout, seleccione "Inspect" y busque el atributo id o class en el HTML. Si tiene varios botones de checkout, incluya el selector CSS de cada botón o configure todos los botones para redirigir a la página del carrito y use el selector del botón de checkout de la página del carrito.
Agregar un botón de checkout internacional dedicado
Cree un botón de checkout internacional dedicado, ideal si tiene muchos usuarios de VPN o compradores de EE. UU. que necesitan enviar a una dirección internacional.
Para crear un botón separado para compradores internacionales:
-
En General settings de la extensión, ingrese el selector CSS de su botón de checkout (p. ej.,
#checkout-buttono.woocommerce-checkout-button). -
Active International checkout button hacia la derecha.
-
Configure la apariencia del botón:
- Ingrese el texto del botón (p. ej., "International Checkout" o "Global Checkout").
- (Opcional) Agregue CSS personalizado para que coincida con el diseño de su tienda como se muestra en el ejemplo a continuación. Si no se proporciona CSS personalizado, el botón usará de forma predeterminada el esquema de colores principal de su tienda. Recomendamos probar la apariencia del botón tanto en dispositivos de escritorio como móviles.
-
Haga clic en Save general settings.
Habilite EE. UU. en zonas de envío: Cuando está habilitado, el botón de checkout internacional dedicado aparecerá para todos los compradores. Para permitir que los compradores de EE. UU. usen el checkout internacional (por ejemplo, al usar una VPN o enviar a una dirección internacional), debe habilitar EE. UU. en Shipping zones en Dashboard. Sin este ajuste, los compradores de EE. UU. no serán redirigidos a Zonos Checkout.
Mapear ajustes de WooCommerce
Personalice Zonos para integrarse sin problemas con su tienda WooCommerce, garantizando cálculos precisos de aranceles, impuestos y envío. Use la pestaña Mapping settings para alinear los detalles y atributos de productos con su configuración de comercio electrónico. Aunque se proporcionan valores predeterminados, puede configurar estos ajustes para adaptarlos a los requisitos únicos de su tienda.
Detalles de producto, detalles personalizados, peso y dimensiones
Estos campos se mapean a valores comunes predeterminados. Los valores marcados con un asterisco (*) son obligatorios. Si usa una aplicación de terceros que anula cualquier campo (*), asegúrese de que estos campos (*) estén mapeados correctamente a los valores que usa la aplicación de terceros.
Atributos de producto
Si sus productos tienen atributos únicos como color o talla aplicados a variaciones, deberá mapear estos atributos en la extensión de Zonos. Esto garantiza que, cuando se cumpla un pedido, su tienda WooCommerce y el inventario se actualicen con el producto correcto que se envió. Para mapear atributos, siga los pasos descritos en nuestra documentación de mapeo de atributos de producto de WooCommerce.
Nota: Si tiene preguntas o necesita ayuda para mapear variaciones de productos, contacte a support@zonos.com.
Probar su integración
Ahora que ha configurado su cuenta y su aplicación, está listo para probar su integración.
Para realizar un pedido de prueba en el checkout:
- Agregue
?zonosTestMode=1a la URL de su tienda para ser dirigido a Zonos Checkout. - Cambie Zonos Hello al país que desea probar haciendo clic en la bandera de Hello y seleccionando el país que desea probar. Esto es necesario o de lo contrario no será redirigido a Zonos Checkout si usa un solo botón de checkout. Puede actualizar Hello cambiando zCountry= en la URL al país que desea probar. Por ejemplo, si desea probar Canadá, ingresaría CA en zCountry=CA.
- Complete el proceso de checkout y realice un pedido. Consulte nuestra documentación general de pruebas para más detalles.
- Después de completar las pruebas, habilite Zonos desactivando Test mode. Esto activará su integración y permitirá que los compradores internacionales usen Zonos Checkout.
Algunas cosas a recordar:
- De minimis—Si el subtotal del carrito de su pedido está por debajo del de minimis del país de destino, es posible que no correspondan aranceles ni impuestos. Esto se refleja en nuestros cálculos.
- Reembolsos y cancelaciones—Nosotros cobramos el pago, por lo que si necesita realizar reembolsos o cancelaciones, procéselos en Dashboard.
- Etiquetas—Imprima etiquetas para todos los pedidos internacionales en Dashboard, a menos que haya sido certificado para imprimir etiquetas fuera de Dashboard. Esto es necesario para que Zonos pague los aranceles e impuestos en su nombre.
Post-integración
Su extensión de Zonos importará automáticamente los pedidos de Zonos a WooCommerce. Sin embargo, puede haber casos poco frecuentes en los que un pedido no se importe o el estado de un pedido en WooCommerce no esté sincronizado con Dashboard. Puede usar las siguientes funciones de la extensión para importar pedidos, sincronizar estados de pedidos manualmente y habilitar ajustes avanzados para solucionar problemas.
Importar pedidos manualmente
Si un pedido de Zonos no se ha importado a WooCommerce, puede usar la pestaña Order import para importar pedidos manualmente a WooCommerce:
- Inicie sesión en Dashboard.
- Vaya a Orders.
- Haga clic en el pedido que necesita importarse y copie el Zonos order number.
- En el administrador de WordPress, vaya a la pestaña Order import en la extensión de Zonos e ingrese el número de pedido de Zonos en el campo Zonos order number.
- Haga clic en Import order. Si el pedido se importó correctamente, el pedido se mostrará en WooCommerce y verá el banner "Order imported successfully" en la parte superior de la página. Si el pedido no se importó, verá un banner con los detalles del mensaje de error.
Sincronizar pedidos manualmente
Si el estado de un pedido en WooCommerce no coincide con el estado en Zonos, puede sincronizar el pedido manualmente.
- Inicie sesión en Dashboard.
- Vaya a Orders.
- Haga clic en el pedido que necesita importarse y copie el Zonos order number.
- En el administrador de WordPress, vaya a la pestaña Order sync en la extensión de Zonos e ingrese el número de pedido de Zonos en el campo Zonos order number.
- Haga clic en Sync order. El estado del pedido en WooCommerce ahora debería coincidir con el estado del pedido en Dashboard.
Ajustes avanzados
Modo de depuración
Active Debug mode para enviar a Zonos registros detallados que le ayuden a diagnosticar cualquier problema y mejorar el rendimiento de su integración.
Límite de velocidad
Número máximo de solicitudes de webhook permitidas por dirección IP por minuto. El valor predeterminado es 30 para proteger contra posibles abusos.
Solución de problemas comunes
Si usa una aplicación de caché como WP Rockett, deberá borrar su caché cuando realice cambios en su extensión de Zonos.
Preguntas frecuentes
¿Qué información de producto debo proporcionar para obtener la cotización más precisa de aranceles, impuestos y costos de envío?
La información del producto puede afectar el monto de aranceles e impuestos adeudados y el costo total de envío. Cuanta más información de 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 aranceles o impuestos. Los pesos en sus listados de productos de WooCommerce son utilizados automáticamente por Zonos cuando están mapeados. También puede agregar peso a Catalog en Dashboard para garantizar cálculos de envío precisos.
- Dimensiones: Las dimensiones se utilizan para calcular el peso dimensional. Los transportistas cobrarán el peso mayor entre el peso físico y el peso dimensional. Zonos puede utilizar las dimensiones del producto (largo, ancho y alto) configuradas en cada producto de WooCommerce para calcular el peso dimensional y garantizar que cobre el monto correcto de envío a sus clientes. También puede agregar dimensiones a Catalog en Dashboard para garantizar cálculos de envío precisos.
- Códigos HS: Los códigos HS afectan las tasas arancelarias y a veces pueden afectar los impuestos. Puede mapear valores de código HS en WooCommerce o usar Catalog en Dashboard.
- País de origen: El país de origen de un producto afecta las tasas arancelarias y puede afectar los impuestos. Puede mapear valores de país de origen en WooCommerce o usar Catalog en Dashboard.
Zonos Checkout para WooCommerce
Integre la extensión Checkout para WooCommerce.