Integración · Operar tienda y pedidos
Andreani + agentes de IA de Meteor
Conecta la API de Andreani con un agente de IA de Meteor: cotiza con tu contrato, da de alta envíos, rastrea y busca sucursales. 12 herramientas reales.
¿Cómo se conecta Andreani con Meteor?
Meteor se conecta con la API de Andreani para que tu Met cotice un envío en Argentina con el contrato del propio cliente, dé de alta la orden y devuelva el número de envío, siga la trazabilidad evento por evento, y encuentre la sucursal o el punto de retiro que le sirve a quien recibe. Son 12 herramientas, y solo una escribe: el alta de la orden, que exige una confirmación explícita porque Andreani no permite cancelar un envío por API. Las credenciales salen de tu propio contrato con Andreani, y el conector arranca apuntando al ambiente de pruebas.
Dónde aplica: Argentina. Andreani entrega un número de contrato por modalidad: uno para entrega a domicilio y otro para sucursal o punto de retiro. Son distintos y dan precios distintos.
Qué automatiza
Lo que un agente de Meteor hace con Andreani
Cotizar el envío antes de cerrar la venta
El cliente da su código postal y tu Met cotiza contra tu contrato con los bultos reales, eligiendo la modalidad que corresponde. El valor que comunica es el que devolvió Andreani, sin sumarle nada del lado de Meteor, así que lo que promete es lo que se cobra.
Despachar sin salir de la conversación, y con freno
Cuando el comprador confirma, tu Met valida la dirección contra Andreani, resuelve el código de la provincia y da de alta la orden. El alta no se dispara sola: la herramienta exige una confirmación explícita, porque una orden creada por error no se cancela desde ninguna parte.
Contestar «¿dónde va mi paquete?» con el desenlace correcto
Tu Met devuelve los eventos de trazabilidad con su fecha y su sucursal. Cuando el envío parece detenido, consulta la orden en vez de deducir el final: es ahí donde vive el estado que confirma la entrega.
Ofrecer retiro donde de verdad le queda cerca
Con el código postal de quien recibe, tu Met muestra las sucursales que lo atienden con su horario, y también los puntos de retiro de la red de terceros, que suelen abrir más horas. La elección se hace en el chat y viaja al alta de la orden.
12 herramientas
Todo lo que el agente puede pedirle a Andreani
Cada una es una acción real del conector. Puedes desactivar las que no quieras que use.
| Herramienta | Qué hace |
|---|---|
andreani_consultar_conexion | Hace el login real contra Andreani y reporta el ambiente activo, el código de cliente y qué contratos hay cargados. |
andreani_cotizar_envio | Cotización real por código postal de destino, contrato y bultos, con el valor declarado que define el seguro. El precio es el que devuelve Andreani. |
andreani_crear_orden | Da de alta la orden de envío y devuelve el número de Andreani. Exige confirmación explícita. |
andreani_consultar_orden | Devuelve la orden por su número, con su estado. Es la fuente confiable para afirmar que algo se entregó. |
andreani_obtener_etiqueta | Sube el PDF de la etiqueta al almacenamiento privado de Meteor y devuelve un enlace firmado de siete días para imprimirla, sin traer el archivo al chat. |
andreani_rastrear_envio | Devuelve la trazabilidad del envío: los eventos con su fecha, su estado y la sucursal donde ocurrieron. |
andreani_consultar_envio | Ficha del envío con su estado, sus bultos y los datos de la entrega, con la información personal recortada. |
andreani_buscar_envios | Busca tus envíos por rango de fechas de creación, documento del destinatario o identificador de producto. |
andreani_buscar_sucursales | Busca sucursales por código postal y devuelve dirección, horario, coordenadas y qué códigos postales atienden. |
andreani_buscar_puntos_de_tercero | Busca puntos de retiro de la red de terceros, que suelen tener más cobertura y mejor horario que las sucursales. |
andreani_consultar_provincias | Lista las provincias argentinas con el código normalizado que el alta de orden exige en el campo de región. |
andreani_validar_direccion | Valida y geolocaliza una dirección argentina contra Andreani, devolviendo latitud y longitud. |
Los límites
Qué NO hace la integración con Andreani
Preferimos decirlo aquí que descubrirlo en la implementación.
-
No cancela ni anula un envío. Andreani no expone esa operación por API, y por eso el alta de orden exige una confirmación explícita: lo que se da de alta por error no se deshace desde Meteor, hay que resolverlo con la transportadora.
-
No mete el PDF de la etiqueta en la conversación. Lo sube al almacenamiento privado de Meteor y devuelve un enlace firmado que vence a los siete días: sirve para imprimir, no para archivar. Y como la etiqueta lleva impresos el nombre y la dirección de quien recibe, ese enlace es para quien despacha, no para reenviarlo al cliente.
-
No calcula el precio ni el peso aforado. El valor que se comunica es el que devuelve Andreani para tu contrato, tal cual, porque un flete calculado del lado nuestro es un flete inventado.
-
No deduce la entrega de la ausencia de eventos. La trazabilidad más reciente no emite el evento de entrega, así que afirmar que algo llegó se hace consultando la orden.
-
No expone los datos personales del destinatario por defecto. Documento, correo y teléfono se recortan de la respuesta salvo que el caso lo pida explícitamente.
Antes de empezar
Qué necesitas para conectar Andreani
- 1
Usuario y clave de la API de Andreani
Los entrega Andreani al firmar el contrato. El par del ambiente de pruebas y el de producción son distintos, y el ambiente se declara al configurar la integración.
- 2
Tu código de cliente
Es el que figura en tu contrato con Andreani. Se usa para cotizar y para buscar tus propios envíos por fecha o por documento del destinatario.
- 3
Los números de contrato de cada modalidad
Andreani entrega uno para entrega a domicilio y otro para sucursal o punto de retiro. Sin el que corresponde no se puede cotizar esa modalidad, y usar el otro devuelve un precio que no es el tuyo.
- 4
Sucursal de imposición y ambiente (opcionales)
La sucursal desde la que despachas se configura una vez para no repetirla en cada consulta; si no la declaras, Andreani usa la del contrato. El ambiente arranca en pruebas.
Preguntas frecuentes
Preguntas sobre Andreani y Meteor
Solo si alguien confirma. La herramienta de alta exige que el parámetro de confirmación llegue en verdadero, y ese valor está pensado para ponerse después de que una persona aprobó los datos. Es la única escritura del conector, y existe así porque Andreani no permite cancelar un envío por API.
Es la de tu contrato. La cotización viaja con tu código de cliente y con el número de contrato de la modalidad elegida, que es de donde sale el precio. Por eso el conector pide los dos contratos: el de domicilio y el de sucursal dan valores distintos.
Sí. Andreani publica un ambiente de pruebas y el conector arranca apuntando ahí, así que se puede montar el flujo completo, cotizar y dar de alta órdenes de prueba antes de mover el interruptor a producción.
Con el código postal de quien recibe. Una herramienta trae las sucursales propias con su horario y sus coordenadas, y otra los puntos de retiro de terceros. Se puede filtrar por los que admiten imposición o por los que entregan, según lo que necesites.
Sí. El conector baja el PDF de Andreani, lo guarda en el almacenamiento privado de Meteor y devuelve un enlace firmado que dura siete días. Lo abres y lo imprimes; el archivo nunca entra en la conversación. Es privado a propósito: la etiqueta lleva el nombre y la dirección de quien recibe, así que el enlace se comparte con quien despacha y no se publica.
Porque la versión más reciente de la trazabilidad de Andreani no emite ese evento. El conector usa por defecto la que sí lo trae y, cuando hay dudas, la orden es la que dice el estado real. Nunca se afirma una entrega por el hecho de que dejaron de llegar eventos.
Operar tienda y pedidos
Otras integraciones de la misma familia
¿Quieres ver a un agente operando Andreani?
Te lo mostramos con tu propia cuenta conectada, no con una demostración enlatada.