Integración
Integra sin problemas Checkout con tu tienda BigCommerce siguiendo los pasos de esta sección:
Comienza
Comienza completando nuestro formulario de registro. El proceso de incorporación comenzará una vez que se haya establecido tu acuerdo de 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 aplicaciones
Tanto Checkout como Hello deben estar instalados para que Checkout funcione correctamente, ya que Hello informará cuándo redirigir a los clientes internacionales a nuestro Checkout.
- Instala la aplicación Checkout desde BigCommerce Marketplace haciendo clic en Obtener esta aplicación.
- Instala la aplicación Hello desde BigCommerce Marketplace haciendo clic en Obtener esta aplicación.
Configurar Checkout
Una vez que hayas instalado ambas aplicaciones, configura tus ajustes:
- Dentro de tu backend de BigCommerce, ve a Aplicaciones → Mis aplicaciones → Zonos Checkout.
- Ingresa tus credenciales de integración para vincular tus ajustes de Dashboard a tu sitio de BigCommerce.
- Habilita la aplicación en modo de prueba o en vivo:
- Bajo Zonos Checkout, selecciona Habilitar.
- Bajo Modo de prueba, selecciona Habilitar. Cuando este modo esté activado, debes agregar
?zonos=true
a la URL para habilitar la funcionalidad de Zonos, lo que te permitirá probar Zonos mientras tus compradores siguen experimentando tu flujo nativo. Cambia esto a Desactivar cuando estés listo para ir en vivo.
- Personaliza nuestra aplicación para que funcione según las necesidades de tu sitio:
- Bajo Crear cliente en importación de pedido, selecciona tu preferencia.
- Bajo Reservar stock de producto durante el checkout, selecciona Habilitar si deseas que Zonos reserve el stock del producto mientras está en nuestro Checkout. Aprende cómo funciona esto en las preguntas frecuentes en la parte inferior de esta página.
- Bajo Mostrar proveedor de pago como personalizado, selecciona Habilitado si deseas que todos tus pedidos de Zonos muestren Personalizado como el proveedor de pago en BigCommerce.
- Haz clic en Actualizar ajustes para guardar tus selecciones.
Configurar Hello
- Dentro de tu backend de BigCommerce, ve a Aplicaciones → Mis aplicaciones → Zonos Hello.
- Copia tu clave API de Hello desde Dashboard e ingrésala como tu Clave del sitio.
- Habilita la aplicación Hello cambiando Zonos Hello a habilitar. Hello puede habilitarse antes que Checkout y no redirigirá a Zonos Checkout a menos que también se habilite Checkout.
- Cambia Cotización de aranceles e impuestos a habilitar.
- Si deseas que Zonos aproveche la conversión de moneda de BigCommerce, cambia Conversión de moneda a habilitar. Al hacerlo, Hello permitirá habilitar las monedas para ti en Configuración → Monedas. Verifica tus ajustes de moneda allí para asegurarte de que los pagos se realicen en la moneda que prefieras.
- Haz clic en Actualizar ajustes para guardar tus selecciones.
Agregar información de producto faltante
Las versiones de BigCommerce anteriores a V3 tienen limitaciones con los datos que envían a Zonos para cotizaciones de landed cost. Aprende qué información de producto recibe Zonos de cada versión de BigCommerce y cuándo debes usar Zonos Catalog para agregar información específica del producto necesaria para nuestros cálculos.
Información de producto opcional
La información específica del producto no es necesaria para que Zonos devuelva una cotización. Zonos puede usar los valores predeterminados de tu cuenta para los códigos HS y el país de origen, estimar el peso con un factor personalizado y cotizar sin dimensiones. Sin embargo, cuanto más específica sea la información del producto proporcionada, más precisos serán nuestros cálculos.
Información del producto enviada desde BigCommerce
- Pesos
- Dimensiones
- Códigos HS*
- País de origen*
*Solo se importa si se utiliza la experiencia de producto BigCommerce V3
Si no estás utilizando BigCommerce V3, agrega tus productos con sus códigos HS y país de origen a Catalog. Aprende cómo usar Catalog.
Si agregas peso, dimensiones, código(s) HS o país de origen a Catalog, Catalog siempre usará esos campos. Si alguna información está presente tanto en tu plataforma de comercio electrónico como en Catalog, la información en Catalog anulará la información enviada desde la plataforma de comercio electrónico al realizar nuestros cálculos. Por ejemplo, supongamos que el peso de un producto está presente en Shopify y Catalog. En ese caso, Zonos utilizará el peso en Catalog para calcular el envío.
Prueba tu integración
Ahora que has configurado tu cuenta y tu aplicación, estás listo para probar tu integración. Necesitarás habilitar Checkout y Hello en BigCommerce mientras pruebas. Para hacerlo:
- Dentro de tu backend de BigCommerce, ve a Apps → My apps → Zonos Hello.
- Cambia Zonos Hello a habilitar.
- Luego ve a Apps → My apps → Zonos Checkout.
- Bajo Zonos Checkout, selecciona Habilitar.
- Bajo Modo de prueba, selecciona Habilitar.
Cuando este modo está habilitado, debes agregar ?zonos=true
a la URL para habilitar la funcionalidad de Zonos, permitiéndote probar Zonos mientras tus compradores aún experimentan tu flujo nativo.
Después de completar las pruebas, habilita Zonos configurando Modo de prueba a Deshabilitar.
Algunas cosas a recordar:
- De minimis—Si el subtotal del carrito de tu pedido está por debajo del De minimis del país de envío, puede que no haya derechos o impuestos a pagar. Esto se refleja en nuestros cálculos.
- Reembolsos y cancelaciones—Estamos recolectando el pago, así que si necesitas hacer algún reembolso o cancelación, por favor procesa estos en Dashboard.
- Etiquetas—Imprime etiquetas para todos los pedidos internacionales en Dashboard, a menos que hayas sido certificado para imprimir etiquetas fuera de Dashboard. Esto nos permite pagar los derechos e impuestos en tu nombre.
Nota: Si necesitas que hagamos ajustes, por favor contacta a Zonos soporte para asistencia.
Opciones de configuración avanzada
Ocultar elementos domésticos
Si tienes elementos que necesitas ocultar solo para usuarios internacionales (por ejemplo, proveedores de pago solo para EE. UU., estimadores de envío, banners con mensajes solo para EE. UU., etc.) entonces usa los siguientes pasos para ocultarlos cuando el país de Zonos Hello sea internacional. Para solucionar esto, ve a Panel de administración de BigCommerce -> Storefront -> Script Manager -> Crear Script.
Para ocultar los elementos domésticos, sigue los pasos a continuación:
-
Ve a BigCommerce Storefront -> Script Manager -> Crear Script.
-
Crea un nuevo script personalizado para Zonos utilizando lo siguiente:
- Nombre del script: Zonos Personalizado - [nombre relevante del script]
- Descripción: [Qué hace este script]
- Ubicación: Pie de página
- Localización: Todas las páginas
- Categoría del script: Esencial
- Tipo de script: Script
- Contenido del script: Copia lo siguiente y pégalo en el contenido del script.
-
En el script a continuación, edita los selectores en
var domesticElements =
haciendo lo siguiente:- Encuentra los selectores de elementos que deseas ocultar para usuarios internacionales en tu sitio actual de BigCommerce.
- Una vez que tengas esos selectores, agrégales donde dice
.hide-me
. - Asegúrate de rodear cada selector con comillas y separarlos por una coma, ve el siguiente ejemplo:
[".hide-1", ".hide-2", ".hide-3", ".hide-4"]
- Una vez que el script esté listo y guardado, prueba yendo a la página donde se ocultaron los elementos y alterna el país de Zonos Hello de EE. UU. a internacional, y de vuelta a EE. UU. Esos elementos deberían estar ocultos cuando se selecciona un país internacional.
Zonos script de integración
<script>
var domesticElements = ['.hide-me'];
let cssElement = document.createElement('style'),
sheet;
document.head.appendChild(cssElement);
sheet = cssElement.sheet;
let count = 0;
for (let domesticHide of domesticElements) {
sheet.insertRule(`.z-intl ${domesticHide} { display:none; }`, count);
count++;
}
</script>
Solución de problemas
Botones de Checkout que no redirigen
Si el Zonos Checkout está en modo de prueba o configurado como en vivo (y los botones de checkout no se redirigen a Zonos), puede ser debido a los selectores de botones de checkout. Nuestra aplicación de Zonos Checkout utiliza una lista predefinida de selectores de botones de checkout. Si un usuario internacional no está siendo redirigido, es posible que esos selectores necesiten ajustarse.
Para solucionar este problema, siga los pasos a continuación:
-
Vaya a Panel de administración de BigCommerce -> Apariencia de la tienda -> Gestor de scripts -> Crear script.
-
Cree un nuevo script personalizado para Zonos utilizando lo siguiente:
- Nombre: Zonos Personalizado - [nombre relevante del script]
- Descripción: [Lo que hace este script]
- Ubicación en la página: Pie de página
- Seleccionar páginas donde se agregará el script: Todas las páginas
- Contenido del script: Copie lo siguiente y péguelo en el contenido del script.
-
Una vez que tenga el código a continuación en el contenido del script, deberá ajustar uno de los selectores para que coincida con sus botones de checkout actuales o puede agregar un nuevo selector a la lista.
-
Asegúrese de guardar este nuevo script y probar el sitio.
Zonos script de integración
<script>
window.onload = () => {
selectors = {
'.previewCartCheckout .button--primary': 'checkout',
'.cart-actions .button--primary': 'Check out',
'.previewCartAction-checkout': 'Check out now',
'.ProceedToCheckout .btn': 'Proceed To Checkout',
'.CheckoutLink': 'Checkout',
'.button--primary': 'Checkout',
'.button-checkout': 'Checkout',
'.btn': 'Proceed To Checkout',
'.CheckoutButton': 'Proceed To Checkout',
};
for (let key in selectors) {
let button = contains(key, selectors[key]);
for (i = 0; i < button.length; i++) {
button[i].addEventListener('click', function (e) {
zonosCheckout(e);
});
}
}
};
</script>
Preguntas frecuentes
¿Cómo sé si estoy en el tema de Stencil?
Para determinar si estás utilizando el tema de Stencil, en el Panel de Administración de BigCommerce, si Storefront -> Footer Scripts es una opción, tu tienda está utilizando un tema de Stencil.
¿Qué información del producto debo proporcionar para obtener la 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 a pagar y el costo de envío. Cuanta más información del producto proporciones 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 el costo de envío, lo que puede afectar los aranceles o impuestos. Los pesos en tus listados de productos de BigCommerce se utilizan automáticamente por Zonos cuando están presentes.
- Dimensiones: Las dimensiones pueden afectar el 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 BigCommerce.
- Códigos HS: Los códigos HS afectan las tasas de aranceles y a veces pueden afectar los impuestos. BigCommerce no puede enviar códigos HS a Zonos, por lo que deben agregarse utilizando el Catálogo de Zonos. Si estás utilizando la experiencia de producto BigCommerce V3, se reciben los códigos HS.
- País de origen: El país de origen de un producto afecta las tasas de aranceles y puede afectar los impuestos. BigCommerce no puede enviar códigos HS a Zonos, por lo que deben agregarse utilizando el Catálogo de Zonos. Si estás utilizando la experiencia de producto BigCommerce V3, se recibe el país de origen.
Detalles del producto enviados a Zonos por BigCommerce
Detalles del producto | Pesos | Dimensiones | Código HS | País de origen |
---|---|---|---|---|
Enviados automáticamente | ||||
Agregar con Catálogo |
Detalles del producto enviados a Zonos por BigCommerce V3
Detalles del producto | Pesos | Dimensiones | Código HS | País de origen |
---|---|---|---|---|
Enviados automáticamente |
Nota: Alternativamente, puedes ingresar cualquiera de la información anterior en el Catálogo, anulando la información almacenada y enviada desde BigCommerce.
Aprende más sobre la información del producto por plataforma.
Checkout para BigCommerce
Integra el plugin Checkout para BigCommerce.Antes de integrar Checkout, asegúrate de que funcione como esperas. Cuando utilizas Checkout: