Cómo integrar ZOOM, MRW y Tealca a su tienda o sistema

Mensajero revisando los paquetes en su moto antes de salir a entregar

Decidir si conviene integrar o cambiar de ERP suele plantearse mal: se discute el sistema entero cuando, casi siempre, el problema está en las costuras entre sistemas. Esta guía le da un marco para elegir entre integrar, extender o reemplazar. Incluye las señales que lo justifican, los riesgos de migrar según fuentes reconocidas y el efecto de la facturación electrónica de cada país.

Para integrar ZOOM, MRW y Tealca a su tienda o sistema, construya una capa propia que hable con cada transportadora y le entregue a su operación un solo formato. ZOOM publica API con consultas públicas y credenciales para crear guías; Tealca documenta una API en connect.tealca.com; de MRW no hay documentación pública, así que se gestiona con la empresa.

Si usted dirige una tienda en línea, una distribuidora, un negocio de dropshipping o un operador de envíos en Venezuela, esta guía le explica qué se puede automatizar, qué accesos pedir, cómo certificar y qué errores evitar. Está escrita para quien decide la tecnología, no para quien ya programa el conector.

En resumen
  • Se automatiza todo el ciclo: cotizar, generar guía, imprimir etiqueta, rastrear, avisar al cliente y gestionar novedades y devoluciones.
  • ZOOM: API en JSON; rastreo, tarifas y oficinas son públicos, y las guías exigen credenciales, ambiente de pruebas y certificación.
  • Tealca: API documentada en connect.tealca.com (v1.6.0). MRW: sin documentación pública hallada; consulte a la empresa.
  • Arquitectura: una capa única que unifica las tres y normaliza los estados, para no reprogramar su tienda cada vez que cambie de transportadora.

¿Qué se puede automatizar con una integración de transportadoras?

Se puede automatizar el recorrido completo del paquete, desde el precio que ve el cliente hasta la devolución. Cada tramo ahorra digitación y reduce errores de dirección, peso o guía repetida.

1. Cotizar2. Generarguía3. Imprimiretiqueta4. Rastrear5. Avisar alclientepública (ZOOM)con credencialespública (ZOOM)su sistema
Cinco tramos del envío que una integración puede resolver sin digitar. Los dos primeros y el rastreo dependen de lo que cada transportadora exponga.
  • Cotizar: mostrar el costo de envío según ciudad, peso y valor declarado en el carrito.
  • Generar la guía: crear el envío desde el pedido, sin entrar al portal de la transportadora.
  • Imprimir la etiqueta: descargar el PDF de la guía para la bodega.
  • Rastrear: consultar el estado del paquete de forma automática.
  • Notificar: avisar al cliente por WhatsApp o correo cuando el estado cambia.
  • Novedades y devoluciones: detectar un paquete no entregado y abrir el caso a tiempo.

Según la búsqueda en Google Venezuela, términos como «mrw tracking» (cerca de 90.500 búsquedas al mes) o «tealca» (cerca de 49.500) son de uso: la gente rastrea y consulta. Eso indica que sus clientes ya preguntan «¿dónde está mi pedido?»; automatizar el aviso le quita esa carga al equipo de atención.

¿Qué es público y qué exige credenciales?

En ZOOM, lo público es consultar y lo privado es crear. Su documentación indica que las API públicas sirven para rastreo, cálculo de precios y oficinas, sin credenciales, mientras que las privadas permiten generar e imprimir guías y abrir casos de atención.

Las credenciales no se descargan de un portal: se entregan cuando usted inicia el enrolamiento con el equipo de Ventas de ZOOM, y la frase privada es única por cliente. Por eso el primer paso de cualquier proyecto no es técnico, es comercial.

Consejo: abra la conversación comercial con las tres transportadoras el mismo día que arranca el desarrollo. Los accesos suelen ser el cuello de botella, no el código.

Con Tealca, el portal connect.tealca.com publica la API en su versión 1.6.0, en español e inglés, con envíos, preenvíos, cálculo de precio, etiquetas, seguimiento, incidencias, comprobante de entrega, manifiestos, inventario y órdenes de bodega. Su esquema de seguridad usa autenticación básica y token de portador (JWT). Cómo se otorga el acceso a su cuenta debe confirmarlo con Tealca. Con MRW Venezuela no encontramos documentación pública de API; la integración se gestiona directamente con la empresa.

¿Cómo se comparan ZOOM, MRW y Tealca?

La diferencia que más pesa hoy es cuánto está documentado en público. La tabla recoge solo lo que pudimos verificar; donde no hay dato, dice «confirmar».

AspectoZOOMTealcaMRW Venezuela
Documentación públicaSí, con guía en su sitio y colección en PostmanSí, en connect.tealca.com (v1.6.0, ES y EN)No encontrada
Consultas sin credencialesRastreo, tarifas y oficinasConfirmar con TealcaConfirmar con MRW
Crear guíasCon credenciales, tras enrolarse con VentasDocumentado (envíos y preenvíos), con token; confirmar cómo se otorga el accesoConfirmar con MRW
Órdenes de bodegaNo verificadoDocumentadas en la API (órdenes de entrega e inventario)Confirmar con MRW
Ambiente de pruebasSí, disponible las 24 horasConfirmar con TealcaConfirmar con MRW
Certificación para producciónSí: Sistemas revisa evidencias antes de dar credencialesConfirmar con TealcaConfirmar con MRW
FormatoJSON sobre HTTPS (GET y POST)API REST documentada con esquema OpenAPIConfirmar con MRW

¿Cómo se integra paso a paso?

Se integra en seis pasos, y el desarrollo es solo uno de ellos. El orden evita perder semanas esperando accesos.

  1. Pida accesos. Contacte a Ventas de ZOOM para el enrolamiento, a Tealca por su acceso a la API y a MRW por sus opciones de integración corporativa.
  2. Defina su modelo de datos. Pedido, destinatario, ciudad, peso, valor declarado y guía. Es el formato de su capa, no el de ninguna transportadora.
  3. Construya un conector por transportadora. Cada uno traduce su formato al suyo y viceversa.
  4. Pruebe en sandbox. ZOOM ofrece ambiente de pruebas las 24 horas; confirme el equivalente con las otras dos.
  5. Certifique. En ZOOM, usted avisa a Ventas al terminar y Sistemas pide evidencias: números de guía, PDF de guías impresas y consultas de rastreo.
  6. Salga a producción con pruebas controladas. Con las credenciales de producción, empiece con pocos pedidos antes de abrir todo el volumen.
Ojo: ZOOM recomienda probar valores extremos de peso y valor declarado y ciudades inexistentes para validar los mensajes de error. Hágalo: es donde las integraciones fallan en producción.

¿Prefiere no construirlo desde cero? En MTechnology diseñamos la capa que conecta transportadoras con su tienda, bodega y mensajeros.

Ver soluciones para logística

¿Qué arquitectura evita reprogramar todo al cambiar de transportadora?

La que pone una capa propia entre su tienda y las transportadoras. Su tienda habla con esa capa en un solo idioma, y la capa traduce a ZOOM, MRW o Tealca según el pedido.

¿Por qué normalizar los estados?

Porque cada transportadora nombra distinto lo mismo. Si su tienda lee los estados directamente, cada cambio rompe pantallas, reportes y mensajes al cliente. Defina seis estados propios y deje que la capa traduzca.

Estado de la transportadora AEstado de la transportadora BEstado de la transportadora CTraductorde estadosSus estadosCreadaEn tránsitoEn oficina o repartoEntregadaNovedadDevuelta
Un traductor convierte los estados de cada transportadora en los seis estados que usan su tienda, su bodega y sus reportes.

¿Qué más debe hacer esa capa?

  • Guardar cada guía con su pedido y su historial de estados.
  • Reintentar con criterio cuando una transportadora no responde, sin duplicar guías.
  • Mostrar a vendedor, bodega, mensajero y transportadora solo lo que a cada uno le corresponde.
  • Dejar bitácora de cada llamada para resolver discusiones sobre «quién dijo qué».

Es el enfoque que aplicamos en la plataforma que construimos para Dropanas, una operación en Venezuela: integra por API ZOOM, Tealca y MRW, con guías y estados visibles para vendedor, bodega, mensajero y transportadora. Es un desarrollo propio; no existe alianza ni integración oficial con ninguna de las tres transportadoras.

Si además su operación cobra en pago móvil o Zelle, lea cómo conciliar pago móvil y Zelle, y si trabaja con mensajeros propios, cómo hacer el cierre de mensajeros en dólares y bolívares. Para una visión general de lo que hacemos en el país, consulte nuestra página de Venezuela.

¿Qué errores se repiten en estas integraciones?

Los más comunes son de proceso, no de programación. Esta lista sirve como control antes de salir a producción.

  • Empezar por el código y descubrir semanas después que la credencial depende de un proceso comercial.
  • Acoplar la tienda a una sola transportadora: cambiar o sumar otra obliga a rehacer todo.
  • No normalizar estados, de modo que el cliente recibe mensajes distintos según quién entregue.
  • No validar ciudades y direcciones antes de crear la guía, y pagar por envíos mal digitados.
  • Ignorar los errores de la API en lugar de mostrarlos al operador con un mensaje claro.
  • No guardar evidencias de guías y rastreos, que son justo lo que se pide al certificar.
  • Dejar fuera las devoluciones: sin ese flujo, el inventario y la caja no cuadran.
Checklist antes de producción: accesos y credenciales de las tres · sandbox probado · certificación aprobada donde aplique · estados normalizados · pruebas con peso, valor y ciudades extremas · bitácora de llamadas · flujo de novedades y devoluciones · quién atiende cada alerta.

¿Conviene una plataforma tipo Dropi o una integración propia?

Depende del volumen y de qué tan particular sea su operación; ninguna opción gana siempre. Una plataforma lista se activa rápido; una integración propia se adapta a su forma de trabajar.

CriterioPlataforma lista (tipo Dropi)Integración propia
Puesta en marchaRápida, con flujos ya hechosMás lenta: accesos, desarrollo y certificación
Control de reglasLimitado a lo que la plataforma ofreceTotal: bodegas, mensajeros, conciliación
CostoSuscripción o comisión continuaInversión inicial y mantenimiento
Cambio de transportadoraDepende de las que soporteSe añade un conector nuevo
Le conviene siEmpieza o vende por dropshipping con flujo estándarTiene volumen o procesos propios que una plataforma no cubre

Una ruta frecuente es empezar con una plataforma y migrar a una capa propia cuando las reglas del negocio la superan. Si quiere evaluar ese punto, revise cómo trabajamos software para empresas de logística y envíos.

Preguntas frecuentes

¿ZOOM tiene API pública para integrar envíos?

Sí. ZOOM publica documentación de API en formato JSON sobre HTTPS. Las consultas públicas (rastreo, cálculo de precios y oficinas) no requieren credenciales; crear y imprimir guías exige credenciales que se entregan al enrolarse con el equipo de Ventas de ZOOM.

¿Tealca tiene API para tiendas y sistemas?

Sí. Tealca publica su API en connect.tealca.com (versión 1.6.0 al momento de escribir este artículo), con documentación en español e inglés. Antes de programar, confirme con Tealca cómo se otorga el acceso a su cuenta y qué permisos incluye.

¿MRW Venezuela tiene API pública?

No encontramos documentación pública de una API de MRW Venezuela. La vía realista es consultar a MRW qué opciones de integración ofrece a clientes corporativos y qué datos entrega para cotizar, generar guías y rastrear. No asuma endpoints ni formatos sin confirmarlos por escrito.

¿Cuánto tarda integrar las tres transportadoras?

Depende menos del código que de los accesos: credenciales, ambiente de pruebas y certificación pueden tardar más que el desarrollo. Pida a cada transportadora sus plazos desde el primer día y avance en paralelo con la capa interna y los estados normalizados.

¿Conviene una plataforma tipo Dropi o una integración propia?

Si vende por dropshipping con volumen moderado y le sirven los flujos estándar, una plataforma lista le ahorra desarrollo. Si necesita reglas propias (varias bodegas, mensajeros propios, conciliación de cobros, varias transportadoras con la misma lógica), una integración propia le da control a cambio de inversión y mantenimiento.

¿Puedo integrar las tres sin que la transportadora me autorice?

Solo en lo público. Con ZOOM puede consultar rastreo, tarifas y oficinas sin credenciales; para generar guías necesita autorización. Con Tealca y MRW confirme el alcance del acceso con cada empresa antes de construir algo que dependa de él.

¿Quiere conectar sus envíos sin atarse a una sola transportadora? Cuéntenos su operación y le decimos qué accesos pedir y por dónde empezar.

Hablar con MTechnology
Facebook
WhatsApp
Twitter
LinkedIn
Pinterest

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

AUTOR

Camilo Bermudez

Somos luz en este mundo, dejando una huella al ayudar a empresas y emprendedores a superar sus retos y alcanzar sus sueños, construyendo un legado duradero