Canada Post Universal Shipping para Magento® 2.x

Canada Post Universal Shipping es una extensión de Magento 2 que le permite gestionar el ciclo completo de envíos con Canada Post mediante la API de Canada Post.

Canada Post es el servicio postal nacional de Canadá: reparte en todas las direcciones del país y en más de 190 destinos internacionales. La extensión conecta su tienda con esa red de principio a fin — tarifas en tiempo real en el checkout, etiquetas y documentación aduanera desde la administración, seguimiento, cancelaciones, devoluciones, recogidas y manifiestos de fin de jornada.

Las principales ventajas de la extensión Canada Post Universal Shipping son:

Etiquetas de envío PDF y térmicas

La creación de etiquetas de envío es posible de forma manual, masiva desde la rejilla de pedidos, automática e incluso programada. La extensión asocia cada etiqueta a un pedido, un envío o una nota de crédito. Todas las etiquetas se guardan en su servidor y están disponibles en cualquier momento desde la interfaz de administración.
Antes de crear una etiqueta manualmente puede elegir el servicio de Canada Post que desee y ver de inmediato el coste del envío. En modo automático, las etiquetas se crean según el método que eligió el comprador o según un servicio nacional e internacional que usted configura. Las etiquetas llegan en PDF de 8.5x11, 4x6 y 3x5, o en ZPL para impresoras térmicas.

Tarifas y métodos de envío

Obtenga tarifas de envío en el checkout igual que en canadapost.ca. Los precios de envío dependen de los códigos postales de origen y destino, del peso, de las dimensiones, del tipo de dirección y de las opciones activas; la extensión tiene todo eso en cuenta. Las cotizaciones se almacenan en caché durante el intervalo que usted defina, de modo que un checkout con mucho tráfico no vuelva a preguntar al transportista por el mismo carrito. El coste de un método puede ser estático o dinámico, tanto los precios como la visualización se ajustan mediante límites y puede crear tantos métodos como quiera. Más información aquí.

Cuentas con y sin contrato

Un número de contrato comercial habilita las tarifas negociadas, la facturación en cuenta, los manifiestos y los Open Returns. Sin contrato también puede cotizar y enviar: la extensión cambia al endpoint sin contrato y cada etiqueta se liquida por envío. El transporte se paga únicamente a Canada Post — la extensión no cobra por el envío, ni por las etiquetas, ni por las consultas de tarifas.

Devoluciones

Dos flujos de devolución, ambos nativos de Canada Post. Un Authorized Return emite una etiqueta por bulto, con su dirección como destinatario. Un Open Return es una plantilla permanente de la que la tienda extrae etiquetas hasta agotar su cupo: créela con un botón en los ajustes de devoluciones y la extensión guardará el identificador de la plantilla. Los clientes pueden solicitar una etiqueta de devolución desde su cuenta y la reciben por correo con la plantilla que usted controle.

Recogida y seguimiento

Solicite la recogida de paquetes directamente desde el panel de administración de su tienda: a demanda para una franja concreta o con un calendario semanal fijo. La disponibilidad para un código postal se puede comprobar antes de reservar, y una recogida reservada se puede cancelar.

Una vez enviados sus paquetes, puede seguirlos con nuestra extensión. Verá todos los puntos por los que ha pasado el paquete y dónde se encuentra, ya sea en una ventana dentro de Magento o en el sitio web de Canada Post, y el número de seguimiento viaja en el correo del pedido.

Manifiestos

Los comercios con contrato pueden agrupar los envíos y transmitirlos de una vez al final del día en lugar de uno a uno. Cierre manualmente desde la administración o déjelo en manos del cron; el PDF del manifiesto que genera Canada Post se descarga y se guarda junto a las etiquetas, y el número de PO que firma el conductor queda registrado en cada etiqueta del grupo.

Aduanas y envíos internacionales

Las declaraciones aduaneras de las etiquetas internacionales se construyen a partir de los productos facturados del pedido. El motivo de exportación, la moneda de aduanas, los aranceles prepagados, los números de licencia y certificado de exportación, el registro IOSS para la UE y la declaración AES para Estados Unidos son configurables, y puede enviarse un destinatario «sold to» distinto cuando difiere del consignatario.

Buscador de oficinas de correos

Deje que el comprador elija la oficina donde recoger el paquete. El buscador trabaja alrededor del código postal de entrega dentro del radio que usted fije y muestra los resultados como lista o sobre un mapa de Google o de Bing. La oficina elegida se traslada a la etiqueta como entrega en punto de recogida.

Impresión

La impresión es uno de los pasos más importantes al trabajar con etiquetas de envío. Use nuestra aplicación para imprimir etiquetas PDF y térmicas en impresoras locales y de red. Puede obtenerla aquí. Cada tipo de documento —etiqueta de envío, albarán, factura— puede dirigirse a su propia impresora.

Configuración

Las posibilidades de nuestro módulo son prácticamente ilimitadas gracias a unos ajustes flexibles. Al mismo tiempo, los ajustes son intuitivos y muchos vienen configurados por defecto. Puede configurar la extensión para una tienda concreta o para un país concreto. Puede aplicar unos ajustes a los envíos nacionales y otros a los internacionales, y también son posibles ajustes distintos para las etiquetas de devolución.

Qué necesita

Una cuenta en el Canada Post Developer Program, que emite una clave API y la vincula a su número de cliente, y una dirección de origen canadiense: Canada Post envía desde Canadá.

Demo

Puede probar esta extensión durante 30 días. Solicite la demo en esta página con Solicitar demo; cómo funciona se explica en Pruebe una extensión durante 30 días.

Hyva Theme y Hyva Checkout

Compatible con Hyva Theme y Hyva Checkout

La extensión se instala con Composer. Qué repositorio añada depende de dónde la haya comprado; la instalación en sí es la misma en ambos casos.

1. Conectar el repositorio

Comprada en extmag.com. Su página de cuenta muestra la dirección del repositorio y sus credenciales personales, junto con los dos comandos composer config que hay que pegar. Ejecútelos una vez por proyecto; después, todas las extensiones que posea estarán disponibles desde el mismo repositorio.

Comprada en el Adobe Commerce Marketplace. El paquete se sirve desde repo.magento.com, que la mayoría de las tiendas ya tiene configurado. Si no es así, añada las Access Keys de su cuenta de Adobe en My Profile -> Access Keys.

2. Instalar la extensión

Ejecute en la raíz del proyecto:

composer require extmag/canadapostshipping
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Composer resuelve los paquetes compartidos de Extmag de los que depende la extensión, así que no hay que requerir nada más a mano.

Cierre la sesión de la administración y vuelva a entrar: la extensión está lista.

3. Obtener sus credenciales de Canada Post

Regístrese en el Canada Post Developer Program. El registro emite una clave API —un nombre de usuario y una contraseña— y la vincula a su número de cliente. Canada Post entrega dos claves distintas, una para la pasarela de desarrollo y otra para producción; no son intercambiables. Mantenga una cuenta de expedidor para cada una y cambie entre ellas con el interruptor Live Account del formulario de la cuenta.

El número de contrato comercial es opcional: sin él, la extensión sigue cotizando y enviando, con tarifas publicadas y liquidación por etiqueta. La facturación en cuenta, los manifiestos y los Open Returns requieren contrato.

Requisitos

• Magento 2.4.x (Open Source o Adobe Commerce)
• PHP 8.1 o superior, Composer 2.x
• Una clave API del Canada Post Developer Program y el número de cliente
• Una dirección de origen canadiense: Canada Post envía desde Canadá
• Acceso HTTPS saliente a soa-gw.canadapost.ca y ct.soa-gw.canadapost.ca

Cron

La extensión registra una tarea horaria que cierra los grupos de manifiesto cuando la estrategia de manifiesto está fijada en el cron diario. Con la estrategia por defecto, cada envío se transmite en cuanto se crea y la tarea termina de inmediato. El cron de Magento debe estar en marcha para que la variante programada cierre algo.

Impresión de etiquetas

Para imprimir etiquetas en una impresora local o de red, instale nuestro software de impresión desde aquí y siga después Instalación y configuración de el-Print.

Hyva Theme y Hyva Checkout

Las tiendas sobre Hyva necesitan un paquete más:

composer require extmag/shiplab-hyva
composer require magewirephp/magewire

La integración sustituye una plantilla de Hyva, view/frontend/templates/checkout/shipping/method-list.phtml. Si su tema ya sobrescribe ese archivo, combine los cambios en lugar de reemplazarlo.

Probarla antes de comprar

Puede solicitar una demo de 30 días de esta extensión e instalarla exactamente como arriba: mismo paquete, mismo repositorio, mismos comandos. Cómo funcionan las demos.

Instalación sin Composer

El archivo puede descomprimirse en app/code/Extmag/, pero eso deja la extensión fuera de la gestión de dependencias: sus paquetes compartidos hay que instalarlos a mano y las actualizaciones nunca le llegan. Use Composer en cualquier tienda que gestione, también en la demo.

Para cualquier duda sobre la instalación, póngase en contacto con nuestro soporte técnico.

Canada Post se configura desde el menú Extmag de la administración de Adobe Commerce (Magento). Añada la cuenta del transportista, la dirección canadiense desde la que envía, las cajas en las que empaqueta y los métodos de envío que ven los clientes, y después ajuste la configuración del transportista.

Cuenta de Canada Post

1. Si todavía no tiene credenciales de la API de Canada Post, regístrese en el Canada Post Developer Program. El registro emite una clave API —un nombre de usuario y un secreto— y la vincula a su número de cliente.
2. Vaya a Admin Main Menu -> Extmag -> Shipper Accounts.
   
3. Pulse el botón «Add New Shipper Account».
4. Elija Canada Post como transportista, introduzca el nombre de usuario de la clave API, el secreto y su número de cliente como Shipper Number, y pulse «Save». Deje Live Account en No mientras hace pruebas: Canada Post emite claves distintas para la pasarela de desarrollo y para la de producción, y no son intercambiables. Cree una cuenta por clave y cambie entre ellas desde la configuración.
   

Direcciones

1. Vaya a Admin Main Menu -> Extmag -> Settings -> Addresses.
2. Pulse el botón «Add New Address».
3. Rellene el nombre de la empresa, el contacto, el teléfono y la dirección completa, y pulse «Save». El origen debe ser canadiense —Canada Post envía desde Canadá— con un código de provincia real de dos letras y un código postal con el formato A1A1A1. Se usan dos direcciones por transportista: la Shipper Address impresa en la etiqueta y la Ship From Address donde se recoge el paquete, que además es el punto de expedición del manifiesto cuando ambas difieren.

Package Boxes

1. Vaya a Admin Main Menu -> Extmag -> Settings -> Package Boxes.
2. Pulse el botón «Add New Box».
3. Introduzca las dimensiones interiores y exteriores, el peso en vacío y la carga máxima, y pulse «Save». El empaquetador reparte el pedido entre paquetes a partir de estas cajas, así que cuantas más cajas reales estén listadas, más se acercará la tarifa cotizada a la que le facturen. Canada Post admite hasta 30 kg por paquete.

Métodos de envío

1. Vaya a Admin Main Menu -> Extmag -> Shipping Methods.
2. Pulse el botón «Add New Shipping Method».
3. Elija Canada Post como transportista, decida qué servicios mostrar —todos, una lista concreta, o solo el más barato o el más caro— y restrinja el método por sitio web y grupo de clientes si lo necesita. Pulse «Save». La lista de servicios se filtra por el país de origen, de modo que un origen canadiense ofrece los grupos nacional, Estados Unidos e internacional.
   

Configuración

1. Vaya a Admin Main Menu -> Extmag -> Settings -> Canada Post Configuration.
2. Abra primero la pestaña General y seleccione la cuenta de expedidor, la Shipper Address y la Ship From Address creadas antes. Añada su número de contrato comercial si lo tiene: sin él, la tarificación y el envío recurren a las tarifas publicadas.
   
3. Recorra las pestañas restantes y rellene lo que corresponda a su cuenta.

Las pestañas cubren:

• General: cuenta, direcciones, número de contrato, números de cliente de Mailed By y Mailed On Behalf Of, tipo de destino y descripción del envío.
• Packaging: las unidades de peso y dimensiones. Canada Post codifica el embalaje en el código de servicio y calcula el peso volumétrico por su cuenta.
• Returns: Authorized Returns u Open Returns, el servicio de devolución, el botón de creación de plantilla Open Return, el cupo de etiquetas y lo que el cliente puede hacer desde su área.
• References: el centro de coste y las dos referencias de cliente que se escriben en un envío con contrato.
• Payments: moneda, quién paga el transporte y quién los aranceles, el método de pago, el valor asegurado, el contra reembolso y la clave de cuenta de Zonos que exigen los destinos de Estados Unidos.
• Notification: los eventos que Canada Post notifica por correo, su idioma y los destinatarios.
• Printing: tamaño de papel (8.5x11, 4x6, 3x5), codificación PDF o ZPL y qué se imprime en la etiqueta.
• Pickups: cómo se factura la recogida, adónde debe acudir el mensajero, los indicadores de camión y muelle, y el calendario semanal que sigue el cron.
• Tracking: si el seguimiento se abre en una ventana dentro de Magento o como enlace al sitio de Canada Post.
• Post Office Locator: la recogida en oficina en el checkout, el radio de búsqueda, la vista en lista o mapa y la clave de Google o Bing.
• International Invoice: el bloque aduanero: moneda, motivo de exportación, aranceles prepagados, números de licencia y certificado, registro IOSS, identificador de declaración para Estados Unidos y el destinatario «sold to».
• Manifest / Closeout: transmitir cada envío al crearlo, cerrar a mano o dejarlo al cron diario, además de la dirección impresa en el manifiesto.
• Automatic, Mass Actions y Manual Actions: cuándo se crean etiquetas sin operador, de forma masiva desde la rejilla de pedidos o de una en una.
• Other Options: envíos sin contrato, tipo de cotización, cuánto se cachea una tarifa, el número de seguimiento en el correo del pedido, la gestión de envíos no entregables y las opciones de entrega por defecto.

Cada ajuste puede aplicarse por sitio web, por dirección y por país de destino, de modo que una regla que solo tiene sentido para un mercado no afecte al resto.

Devoluciones

La pestaña Returns decide cuál de los dos flujos de devolución de Canada Post usa la tienda. Un Authorized Return emite una etiqueta por bulto. Un Open Return es una plantilla permanente: pulse «Create Template» y la extensión la registra en Canada Post, guarda el identificador de plantilla y extrae etiquetas de ella hasta agotar el cupo. La misma pestaña controla si un cliente puede solicitar o reimprimir una etiqueta de devolución desde su área y qué plantilla de correo la transporta.

Etiquetas de envío

Una vez configurado el transportista, cada etiqueta que crea la tienda aparece en Admin Main Menu -> Extmag -> Shipping Labels -> Canada Post, con su número de seguimiento, su coste, su estado de manifiesto y los documentos adjuntos. Las etiquetas se crean desde la vista del pedido, de forma masiva desde la rejilla de pedidos o automáticamente: lo deciden las pestañas Automatic, Mass Actions y Manual Actions.