Integración · Operar tienda y pedidos
Skydropx PRO + agentes de IA de Meteor
Conecta Skydropx PRO con Meteor: cotiza 20 transportadoras en Colombia, México y Chile; crea envíos, agenda recolecciones y hace tracking.
¿Cómo se conecta Skydropx PRO con Meteor?
Meteor se conecta con Skydropx PRO, que es un agregador de paquetería y no una transportadora: con una sola cuenta es el cotizador de envíos de veinte transportadoras en Colombia, México y Chile. Le pides la ruta y recibe en un solo llamado todas las que la sirven, ordenadas de menor a mayor precio; con la tarifa que elija una persona crea la guía, devuelve el número de tracking y la etiqueta, comprueba si la transportadora pasa a recoger en esa dirección y agenda la visita, busca los puntos de retiro cercanos y explica los cargos extra que aparecen en la factura. Son 15 herramientas, nombradas por operación y no por transportadora: cuál sirve esa ruta y a qué precio es justo lo que le estás preguntando al agregador. Cubre cuatro de las cinco etapas logísticas y es el único conector del catálogo que agenda recolección. Nunca elige la tarifa por ti ni contesta «la más barata».
Dónde aplica: Colombia, México, Chile. El país es un dato, no un conector distinto: la misma API atiende a los tres. Lo que sí cambia por cuenta es el host de producción y qué transportadoras tiene habilitadas ese cliente, así que la lista real de una ruta sale de la cotización y no del catálogo de referencia.
Qué automatiza
Lo que un agente de Meteor hace con Skydropx PRO
Una sola pregunta, veinte respuestas
Tu Met pide la cotización de la ruta y recibe en un llamado todas las transportadoras que la sirven, con servicio, total, moneda y días de entrega, ordenadas de menor a mayor precio. En Colombia son Interrapidísimo, Servientrega, Coordinadora, Envía, TCC y Deprisa; en México, Estafeta, Redpack, Paquetexpress, 99 Minutos, J&T, Sendex y AMPM; en Chile, Starken, Blue Express, Chilexpress, Correos de Chile y J&T. Y en los tres países, los couriers internacionales: DHL, FedEx y UPS.
Cotizar con la transportadora que pidió el cliente
Cuando alguien escribe «cotízame con Interrapidísimo», la transportadora entra como parámetro de la cotización y de la consulta de cobertura. No hay una herramienta por transportadora, y es a propósito: elegir la herramienta sería elegir la transportadora antes de tener el precio, que es justo el dato que se está pidiendo.
Crear la guía solo después de un sí explícito
Crear la guía gasta el saldo real de tu cuenta, así que la herramienta exige el identificador de la tarifa ya cotizada y una confirmación aparte. El orden correcto es mostrar transportadora, servicio y total, esperar la respuesta de la persona y recién ahí despachar. El conector nunca completa ese paso solo.
Hacer tracking con el número que le llegó al cliente
Tu Met rastrea por número de guía y transportadora, porque el mismo número puede existir en dos. La respuesta dice de qué fuente salió el estado, así quien la lee sabe si tiene el historial completo de movimientos o solamente el estado actual del envío.
Mirar el saldo antes de despachar y agendar la recolección
Sin saldo, la creación de la guía falla con un error que no siempre nombra la plata, así que tu Met puede consultar los créditos antes de despachar. Y cuando ya hay paquetes listos, primero pregunta si la transportadora pasa a recoger en esa dirección y recién ahí agenda la visita, en la fecha acordada y dentro de la franja horaria que le digas, sobre varios envíos a la vez. Es el único conector del catálogo que llega hasta ahí: los demás cotizan, despachan o rastrean, pero la visita del mensajero se pide por fuera. Con eso cubre cuatro de las cinco etapas logísticas; la quinta, la entrega, la hace la transportadora.
Cuando el cliente prefiere ir a recoger
Alguien no quiere esperar en casa. Tu Met busca los puntos de retiro y las oficinas cercanas a su código postal, con dirección, ciudad, horario y a qué transportadora pertenece cada uno, y le pasa los que le sirven. El mismo listado le sirve al comercio que prefiere dejar sus envíos en mostrador en vez de esperar al mensajero.
Explicar el descuento que el comercio no reconoce
Aparece un cobro que nadie pidió y el panel no lo explica. Tu Met lista los cargos extra que Skydropx le facturó a la cuenta —reexpediciones, diferencias de peso o de medidas, devoluciones, zonas extendidas— con su concepto, su monto y a qué envío corresponde. Los informa tal como vienen: no suma ni recalcula nada, porque contra lo que se reclama es contra la factura.
15 herramientas
Todo lo que el agente puede pedirle a Skydropx PRO
Cada una es una acción real del conector. Puedes desactivar las que no quieras que use.
| Herramienta | Qué hace |
|---|---|
skydropx_consultar_conexion | Verifica contra el servidor que las credenciales funcionen e informa ambiente, host y país configurados. |
skydropx_cotizar_envio | Cotiza la ruta con todas las transportadoras que la sirven, con varios bultos y valor declarado, y devuelve la lista ordenada de menor a mayor precio. Si lo pides, también las tarifas que la transportadora rechazó, con su motivo. |
skydropx_consultar_cobertura | Responde si hay envío hasta un destino y con qué transportadoras, cotizando un paquete mínimo y sin mostrar precios. |
skydropx_listar_transportadoras | Lista las transportadoras: las reales de una ruta si le das origen y destino, o el catálogo de referencia del país si no. |
skydropx_crear_envio | Crea la guía a partir de una tarifa ya cotizada y devuelve el número de tracking y la dirección de la etiqueta. |
skydropx_cancelar_envio | Solicita la cancelación de una guía ya creada, que después aprueba o rechaza la transportadora. |
skydropx_consultar_envio | Ficha de un envío por su identificador interno: estado, transportadora, número de rastreo y etiqueta. |
skydropx_rastrear_envio | Rastrea por número de guía y transportadora, y dice de qué fuente salió el estado que devuelve. |
skydropx_listar_envios | Lista los envíos de la cuenta paginados, hasta veinte por página, para encontrar uno del que solo se recuerda la fecha. |
skydropx_obtener_etiqueta | Devuelve la dirección de la etiqueta imprimible de un envío, nunca el archivo ni su contenido codificado. |
skydropx_buscar_puntos_de_retiro | Busca puntos de retiro y oficinas de las transportadoras, con su dirección, su ciudad, su horario y a qué transportadora pertenece cada uno. |
skydropx_consultar_cobertura_recoleccion | Responde si la transportadora pasa a recoger en una dirección, que no es la misma pregunta que si llega a un destino. Cuando la respuesta no permite saberlo, devuelve desconocido. |
skydropx_consultar_cargos_extra | Lista los cargos extra que Skydropx le facturó a la cuenta: reexpediciones, diferencias de peso o de medidas, devoluciones y zonas extendidas, con su concepto y su monto. |
skydropx_agendar_recoleccion | Agenda que la transportadora pase a recoger varios envíos en una fecha y, si quieres, dentro de una franja horaria. La respuesta dice si se aceptó. Exige confirmación de una persona. |
skydropx_consultar_saldo | Consulta el saldo y los créditos de la cuenta, que es lo que se gasta cada vez que se crea una guía. |
Los límites
Qué NO hace la integración con Skydropx PRO
Preferimos decirlo aquí que descubrirlo en la implementación.
-
No elige la tarifa. Devuelve la lista completa ordenada por precio y la decisión queda en quien tiene el contexto: nunca contesta «la más barata» ni descarta opciones por su cuenta.
-
No enlaza tu convenio propio con una transportadora. Ese paso es humano y se hace una sola vez en el panel de Skydropx, en «Conexiones → Paqueterías»: no hay ningún endpoint para crearlo desde Meteor, así que tampoco lo hay desde tu Met.
-
No afirma que una tarifa sea la tuya cuando no lo sabe. Si la respuesta no trae con qué distinguirlo, la marca queda en «desconocido» y no en «no»: inventar un «no» sería negar tu convenio sin tener el dato para negarlo.
-
No avisa por su cuenta cuando un envío cambia de estado. Skydropx tiene webhooks, pero la firma con la que los envía no está documentada y no se declararon a propósito: un verificador inventado es peor que no tener webhooks.
-
No trae respuestas confirmadas contra una cuenta real. El sandbox de Skydropx exige un registro que hay que hacer a mano, así que las rutas están verificadas por sondeo y la forma exacta de cada respuesta no lo está.
-
No cancela un envío por su cuenta. Solicita la cancelación y la aprueba o la rechaza la transportadora, que puede negarla si el paquete ya se recogió.
-
No reemplaza a los conectores directos con una transportadora. Chilexpress y TCC tienen el suyo, con lo que su propia API expone de más; aquí aparecen como una opción más de la lista.
-
No cubre la quinta etapa. Cotiza, despacha, comprueba la recolección, agenda la visita y rastrea, pero la entrega la hace la transportadora y las novedades del reparto se resuelven con ella, no desde aquí.
-
No suma ni recalcula los cargos extra. Los informa tal como Skydropx los facturó, con su concepto y su monto: un total recalculado por el conector no cuadraría con la factura, y la factura es contra lo que se reclama.
Antes de empezar
Qué necesitas para conectar Skydropx PRO
- 1
Client ID y Client Secret de Skydropx PRO
Los copias de tu panel de Skydropx PRO, en «Conexiones → API». Es autoservicio: no hay que pedirlos por soporte ni esperar a que alguien habilite la cuenta.
- 2
Ambiente de pruebas o de producción
Arranca en pruebas, que es gratis y no consume saldo. Producción se pide explícitamente, y las credenciales de un ambiente no funcionan en el otro.
- 3
País de la cuenta
Colombia, México o Chile. Es el país por defecto de las direcciones y el que filtra el catálogo de transportadoras de referencia. Se configura una sola vez.
- 4
Host de producción, si tu cuenta no está en el dominio principal
Algunas cuentas colombianas viven en un host propio de Skydropx. El contrato de la API es idéntico, así que basta con escribir ese host en la configuración del conector.
- 5
Código postal de origen y la marca de convenio propio (opcionales)
El código postal desde el que despachas evita repetirlo en cada cotización. La marca de convenio propio hace que la respuesta avise cuando ninguna tarifa negociada aparece.
Preguntas frecuentes
Preguntas sobre Skydropx PRO y Meteor
Porque cotizar es un solo llamado que devuelve todas las de la ruta: siete herramientas harían siete veces la misma petición y tirarían el resto de la respuesta. Y sobre todo te obligarían a elegir la transportadora antes de tener el precio, que es justo lo que le estás preguntando al agregador. La transportadora va como parámetro, en la cotización y en la consulta de cobertura.
Sí, si antes enlazaste tu convenio en el panel de Skydropx, en «Conexiones → Paqueterías». Ese enlace es un paso humano que se hace una sola vez y no tiene endpoint. A partir de ahí tus precios negociados llegan en la misma lista que los del agregador, y si declaraste que tienes convenio y ninguna tarifa vuelve marcada, la respuesta te lo advierte en vez de cotizarte caro en silencio.
No, y es una regla dura del conector. Devuelve la lista completa ordenada de menor a mayor precio, con transportadora, servicio, total y días de entrega, y la decisión la toma quien conoce el caso: a veces lo que manda no es el precio sino la fecha de entrega.
Sí. El conector arranca en el ambiente de pruebas de Skydropx, que es gratis y no consume saldo. Crear una guía en producción sí gasta el saldo real de tu cuenta, y por eso esa herramienta exige una confirmación explícita además de la tarifa ya elegida.
El contrato de la API es uno solo y el país viaja como dato, así que el conector no cambia entre mercados. Lo que no está verificado es si una cuenta de un país puede cotizar rutas de otro: por eso el país y el host se configuran por separado y puedes tener una configuración por mercado.
No, y confundirlas cuesta una visita perdida. La cobertura dice si la transportadora llega a un destino; la cobertura de recolección dice si pasa a recoger en un origen. Se consulta antes de agendar, porque agendar donde no pasan es un fallo que el comercio descubre tarde, cuando el mensajero no llegó. Y si la respuesta no permite saberlo, vuelve como desconocido y nunca como un no: negar la recolección sin el dato es peor que no responder.
Chilexpress tiene un conector directo contra su propia API, y esa página responde por lo que Chilexpress expone de más, como la cobertura por comuna sin credenciales. Esta página responde por el agregador: una cuenta, veinte transportadoras y una cotización que las compara entre sí. Chilexpress también aparece aquí, como una opción más de la lista.
Paso a paso
Automatizaciones que usan Skydropx PRO
Tareas completas, con los pasos y las herramientas que se ejecutan en cada uno.
Operar tienda y pedidos
Otras integraciones de la misma familia
¿Quieres ver a un agente operando Skydropx PRO?
Te lo mostramos con tu propia cuenta conectada, no con una demostración enlatada.