Bienvenido a la API de Fletea

La API REST v1 te permite conectar tu sistema con Fletea para crear envios, rastrear paquetes, cotizar y recibir notificaciones -- todo de forma programatica.

app.fletea.mx

Tu portal de API con documentacion, ejemplos y API Keys

🔑

Autenticacion

Obtener tu API Key y empezar a hacer llamadas

Ver mas →

📦

Ordenes

Crear envios, consultar estado y descargar guias

Ver mas →

📍

Rastreo

Seguir tus paquetes en tiempo real

Ver mas →

💰

Cotizaciones

Obtener precios antes de crear un envio

Ver mas →

🔔

Webhooks

Recibir notificaciones automaticas de cambios

Ver mas →

URL Base

Todos los endpoints usan esta URL como prefijo:

https://app.fletea.mx/api/v1

Por ejemplo, para crear una orden: POST https://app.fletea.mx/api/v1/orders

Tu primer envio en 3 pasos

1

Obtener tu API Key

Ve a Dashboard > Configuracion > API Keys y crea una key. Todas empiezan con el prefijo flt_.

2

Cotizar el envio

Llama a POST /api/v1/quotes con origen, destino y peso para saber el precio antes de crear la orden.

3

Crear la orden

Llama a POST /api/v1/orders con las direcciones y datos del paquete. Fletea genera la guia automaticamente.

Ejemplo rapido

curl -X POST https://app.fletea.mx/api/v1/orders \
  -H "Authorization: Bearer flt_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "pickupAddress": { "..." },
    "deliveryAddress": { "..." },
    "package": { "weight": 2.5 }
  }'

Flujo general

Asi funciona una integracion tipica con Fletea:

📤Tu sistema envia POST /orders

→

⚙️Fletea crea el envio con el proveedor

→

📋Recibes orderId + trackingNumber

→

🔔Fletea te notifica cambios via webhook

→

Content-Type

Todas las peticiones deben incluir:

Content-Type: application/json

Versionamiento

La API usa versionamiento por URL. La version actual es v1. Cuando se publiquen nuevas versiones, la anterior seguira funcionando por un periodo de transicion.

https://app.fletea.mx/api/v1/orders     ← Version actual
https://app.fletea.mx/api/v2/orders     ← Futuras versiones

Rate Limiting

Capa	Limite	Aplica a
Global (IP)	120 peticiones/minuto	Todos los endpoints /api/*
Por API Key	1,000 peticiones/hora	Endpoints autenticados /api/v1/*

Cuando excedes el limite, recibes un error 429:

{
  "error": "Excediste el limite de 1000 peticiones por hora. Espera un momento o contacta soporte para aumentar tu limite."
}

🚀

Necesitas mas capacidad?

Contacta al equipo de soporte para evaluar un limite personalizado.

Formato de respuesta

Respuesta exitosa

Las respuestas exitosas devuelven directamente el objeto o arreglo de datos con codigo HTTP 200 (OK) o 201 (Created):

{
  "orderId": "uuid-de-la-orden",
  "guideNumber": "HEX-123456",
  "trackingNumber": "HEX-123456"
}

Respuesta de error

Los errores devuelven un objeto con la propiedad error:

{
  "error": "Descripcion del error en espanol"
}

Codigos de estado HTTP

Codigo	Significado	Cuando ocurre
200	OK	Peticion exitosa
201	Created	Recurso creado exitosamente
400	Bad Request	Datos faltantes o invalidos en la peticion
401	Unauthorized	API Key faltante, invalida, revocada o expirada
402	Payment Required	Saldo insuficiente (modelo prepago)
403	Forbidden	La API Key no tiene permisos para esta operacion
404	Not Found	El recurso solicitado no existe
429	Too Many Requests	Excediste el limite de peticiones
500	Internal Server Error	Error interno del servidor

💡

Errores en espanol

Todos los mensajes de error se devuelven en espanol para facilitar la integracion con sistemas en Mexico.