Veez – Envíos Express, Despachos & Shipping for WooCommerce

Veez (by VeezDelivery) is the official on-demand logistics, express courier dispatch, and real-time shipping calculation plugin for WooCommerce in Chile and Latin America.

Connect your online store directly to the Veez fleet of couriers and drivers. Calculate dynamic shipping rates at checkout based on real-time distance and package weight, validate Chilean RUT with the Modulo 11 algorithm (in both Classic Checkout and Gutenberg Blocks), automate courier dispatches as soon as payment is confirmed, and provide customers with live GPS route tracking and secure Delivery PIN codes.

(Descripción en español disponible a continuación)

Key Features (English)

• Real-Time Dynamic Shipping Rates: Calculates live shipping costs and delivery estimates at checkout from your pickup warehouse to the customer’s delivery address.
• Automated Courier Dispatch: Automatically creates dispatch orders for the Veez courier fleet whenever an order reaches your selected status (e.g. Processing / Paid).
• Chilean RUT Validation (Modulo 11): Native formatting (dots and hyphen) and mathematical verification compatible with Classic Checkout and Gutenberg Blocks (React 18).
• HPOS Ready: Full declared compatibility with WooCommerce High-Performance Order Storage (custom tables) and classic postmeta.
• Secure Delivery PIN Code: Generates a unique verification PIN for each delivery, displayed on the thank-you page and in customer emails to prevent handover fraud.
• Live GPS Tracking: Provides interactive tracking links in order confirmations and emails so customers can follow their courier on a live map.
• Built-in Sandbox / Test Mode: Simulate live rate quotes and test checkouts without incurring real shipping costs or dispatching physical couriers.
• Integrated System Log Viewer: Inspect API requests, webhook events, and synchronization status directly within your WooCommerce admin dashboard.
• Bidirectional Webhook & Cron Sync: Immediate order status updates via secure REST webhooks, plus automatic background reconciliation every 30 minutes via WP-Cron.
• Custom “Delivered” Order Status: Registers native wc-delivered status in WooCommerce, automatically updating completed orders upon driver confirmation.

Descripción en Español (Spanish Description)

Veez (VeezDelivery) es el plugin oficial de logística express, despachos de repartidores y cálculo de tarifas de envío en tiempo real para WooCommerce en Chile y Latinoamérica.

Conecta tu tienda online directamente con la red de repartidores de Veez. Optimiza las ventas calculando tarifas dinámicas en tiempo real en el checkout según peso, distancia y disponibilidad de flota. Automatiza el despacho de pedidos a conductores tan pronto como se confirma el pago, valida el RUT chileno con algoritmo Módulo 11 (en Checkout Clásico y Bloques Gutenberg), y ofrece seguimiento GPS en vivo con código PIN de entrega segura.

Características Principales (Español)

• Cotización de Tarifas en Tiempo Real: Calcula el valor del envío y tiempos de entrega estimados en el checkout según la ubicación de tu bodega de despacho y la dirección del cliente.
• Despacho Automático de Repartidores: Emite solicitudes de despacho automáticas a la flota de Veez cuando un pedido cambia al estado configurado (ej: Procesando o Pagado).
• Validación de RUT Chileno (Módulo 11): Validación matemática y formateo automático de RUT (con puntos y guion) compatible de forma nativa con Checkout Clásico y Bloques Gutenberg (React 18).
• Compatibilidad Total con HPOS: Soporte oficial y declarado para el almacenamiento de pedidos de alto rendimiento de WooCommerce (High-Performance Order Storage).
• Código PIN de Entrega Segura: Genera un código PIN de verificación único para cada despacho para una entrega verificada sin fraudes ni suplantaciones.
• Seguimiento GPS en Vivo: Inserta enlaces interactivos de rastreo en tiempo real en los detalles de compra y notificaciones por correo para que el cliente siga la ruta del repartidor.
• Modo Pruebas / Sandbox Integrado: Realiza simulaciones completas de cotización y compras de prueba sin incurrir en costos de envío ni notificar a repartidores reales.
• Visor de Logs del Sistema: Monitorea peticiones a la API, eventos de webhooks y sincronizaciones de pedidos directamente desde el panel de administración de WooCommerce.
• Sincronización Bidireccional Segura: Actualización inmediata de estados de entrega mediante Webhooks REST cifrados y conciliación automática en segundo plano cada 30 minutos vía WP-Cron.
• Nuevo Estado de Pedido “Entregado”: Registra el estado nativo wc-delivered en WooCommerce para marcar automáticamente las órdenes completadas con éxito por el conductor.

External Service Disclosure

This plugin communicates directly with the Veez cloud logistics platform (https://veez.cl) via secure REST API endpoints (https://api.veez.cl/api/v1) to calculate real-time shipping rates, geocode addresses, and automatically dispatch couriers.

Data sent to Veez:
* Destination address, commune/city, region, and coordinates for route and pricing calculation.
* Total cart weight, dimensions, and item breakdown to verify vehicle capacity limits.
* Customer name, contact telephone, and RUT for package delivery verification.
* Origin pickup address (store/warehouse) and WooCommerce order reference number.

Data received from Veez:
* Available shipping services, dynamic rates, and estimated delivery windows.
* Driver assignment, vehicle details, delivery status transitions, and live GPS tracking URL.
* Secure Delivery PIN code for customer verification at handover.

Third-Party Terms and Privacy:
* Terms of Service
* Privacy Policy

English

1. Upload the veezdelivery-shipping-for-woocommerce folder to /wp-content/plugins/ or install via Plugins > Add New > Upload Plugin.
2. Activate the plugin through the Plugins screen in WordPress.
3. Navigate to WooCommerce > Settings > Integration > VeezDelivery.
4. Enter your Production (Live) and/or Sandbox API Keys from your Veez merchant dashboard (https://veez.cl).
5. Go to WooCommerce > Settings > Shipping > Shipping Zones, add or edit a zone, and add the VeezDelivery – Express Shipping method.
6. Select your physical origin warehouse and save changes.

Español

1. Sube la carpeta veezdelivery-shipping-for-woocommerce al directorio /wp-content/plugins/ de tu sitio WordPress, o instala directamente el archivo .zip desde Plugins > Añadir nuevo > Subir plugin.
2. Activa el plugin a través del menú Plugins en WordPress.
3. Ve a WooCommerce > Ajustes > Integración > VeezDelivery.
4. Introduce tu clave API de Producción y/o Sandbox obtenida desde el panel de comercio de Veez (https://veez.cl).
5. Dirígete a WooCommerce > Ajustes > Envío > Zonas de envío, añade o edita una zona e incorpora el método de envío VeezDelivery – Envíos Express.
6. Selecciona la bodega física de despacho correspondiente y guarda los cambios.

What is Veez? / ¿Qué es Veez?

EN: Veez is an on-demand express courier and delivery technology platform in Chile that provides instant and scheduled parcel deliveries for e-commerce stores, connecting merchants with a distributed fleet of couriers.
ES: Veez es una plataforma tecnológica de logística express y delivery en Chile que permite realizar envíos inmediatos y programados para tiendas de comercio electrónico, conectando comercios con una flota distribuida de repartidores.

How do I get my Veez API credentials? / ¿Cómo obtengo mis credenciales de API?

EN: You can generate your Live and Sandbox API keys directly from your Veez merchant dashboard at https://veez.cl under the Integrations & Developers section.
ES: Puedes generar tus claves API (Producción y Sandbox) directamente desde tu panel de comercio en https://veez.cl en la sección de integraciones y desarrolladores.

How are real-time shipping rates calculated? / ¿Cómo se calculan las tarifas en tiempo real?

EN: When a customer enters their delivery address at checkout, the plugin sends the cart package weight and distance from your origin warehouse to the Veez API, instantly returning available vehicle options and exact shipping rates.
ES: Al momento en que el cliente ingresa su dirección en el checkout, el plugin envía el peso de los productos y la distancia desde tu bodega de despacho a los servidores de Veez, devolviendo de inmediato las opciones de transporte disponibles y su costo exacto.

Does Chilean RUT validation work with Gutenberg Checkout Blocks? / ¿Funciona el validador de RUT con bloques Gutenberg?

EN: Yes. The validator includes native compatibility with React 18 and the WooCommerce Checkout Blocks event dispatcher, automatically formatting dots and hyphens and validating the check digit via the Modulo 11 algorithm.
ES: Sí. El validador incluye compatibilidad nativa con React 18 y el sistema de eventos del Checkout de Bloques de WooCommerce, formateando automáticamente con puntos y guion y validando el dígito verificador mediante el algoritmo Módulo 11.

Is Veez compatible with WooCommerce HPOS? / ¿Es compatible con HPOS?

EN: Yes. The plugin features official declared compatibility for High-Performance Order Storage (HPOS) custom order tables.
ES: Sí. El plugin cuenta con compatibilidad oficial declarada para las tablas de pedidos de alto rendimiento (HPOS) de WooCommerce.

What is the Delivery PIN Code? / ¿Qué es el Código PIN de Entrega?

EN: It is a unique security code generated upon dispatch. The customer sees it on their order confirmation page and receipt email, and provides it to the driver upon package handover for proof of delivery.
ES: Es un código de seguridad único generado al momento del despacho. El cliente lo visualiza en su comprobante y correos de compra, y debe entregárselo al repartidor al recibir el paquete para verificar la entrega conforme.

How does the Sandbox / Test Mode work? / ¿Cómo funciona el Modo Sandbox?

EN: Enabling Test Mode in settings routes all requests through the Veez Sandbox API. You can test live checkout rate calculations and place mock orders without incurring fees or notifying real drivers.
ES: Al activar el Modo Test en los ajustes de integración, el plugin utiliza la API Sandbox de Veez. Esto permite probar cotizaciones en el carrito y simular compras completas sin generar cargos reales ni notificar a conductores en calle.

2.1.0

• SEO & Brand: Optimized plugin title, tags, and bilingual documentation for high discoverability of “Veez” on WordPress.org and Google.
• Multi-language: Full bilingual support with English (en_US), Chilean Spanish (es_CL), and Standard Spanish (es_ES) Gettext catalogs.
• Architecture: Modularized core into decoupled services and shipping method traits for enhanced performance and maintainability.
• Automated Dispatch: Decoupled order dispatch event handling into VeezDelivery_Order_Dispatcher.
• Order Status: Native registration and automatic handling of the custom “Delivered” (wc-delivered) status.
• Standards: Full compliance with WordPress.org coding standards, data sanitization, and HPOS declaration.

2.0.2

• HPOS: Official declared compatibility with WooCommerce High-Performance Order Storage.
• Security: Explicit capability checks (manage_woocommerce) on debug log management.
• Terminology: Unified “Delivery PIN Code” (“Código PIN de Entrega”) across receipts, notes, and emails.
• Optimization: Static asset versioning for reliable production browser caching.

2.0.1

• Real-time Chilean RUT formatting and Modulo 11 validation in Classic Checkout and Gutenberg Blocks.
• Persistent warehouse origin selection per shipping zone in WordPress database.

2.0.0

• Initial public release with real-time rate calculation, automated dispatch, and bidirectional webhooks.