Automatización de envíos por API: cotización, generación de guías y tracking

Cómo integrar un agregador de paquetería como Skydropx o Pakke para automatizar el flujo completo de envíos en un ecommerce desde el backend.

Read in English

El flujo completo: cotización → guía → tracking

Automatizar envíos en un ecommerce implica tres operaciones distintas: cotizar las opciones disponibles para una dirección y dimensiones de paquete, generar la guía una vez que el cliente elige el servicio, y hacer seguimiento del estado de la entrega. Cada una de esas operaciones puede fallar de forma independiente y necesita su propio manejo de errores.

El momento correcto para cotizar no siempre es el checkout. Depende del tipo de producto: si el peso y las dimensiones son conocidos, se puede cotizar en el carrito. Si varían (productos personalizados, bundles), conviene cotizar al preparar el paquete antes de generar la guía. Elegir bien ese momento evita diferencias de precio entre lo que el cliente pagó y lo que cuesta la guía real.

Cotización en tiempo real: qué datos necesita la API

Para cotizar con un agregador como Skydropx o Pakke se necesitan cuatro datos mínimos: código postal de origen, código postal de destino, peso del paquete y dimensiones (alto, ancho y largo). Con eso, la API devuelve las opciones disponibles de cada paquetería con precio, tiempo estimado de entrega y disponibilidad.

El código postal de origen es fijo por almacén. Si el negocio tiene múltiples bodegas, conviene cotizar desde el más cercano al destino o desde el que tiene el inventario disponible. Esa lógica vive en el backend, no en el frontend ni en la paquetería.

Cotización en tiempo real con la API de Skydropx.

async function getShippingRates(params: {
  zipFrom: string;
  zipTo: string;
  weight: number;
  height: number;
  width: number;
  length: number;
}) {
  const response = await fetch(
    'https://api.skydropx.com/v1/quotations',
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        Authorization: `Token token=${process.env.SKYDROPX_API_KEY}`,
      },
      body: JSON.stringify({
        zip_from: params.zipFrom,
        zip_to: params.zipTo,
        parcel: {
          weight: params.weight,
          height: params.height,
          width: params.width,
          length: params.length,
        },
      }),
    },
  );

  if (!response.ok) throw new Error('Quotation failed');

  const { data } = await response.json();

  return (data as ShippingRate[]).filter((r) => r.available);
}

Generación de guías: el momento en que se incurre el costo

La guía se genera con los datos del destinatario completos: nombre, dirección, colonia, municipio, estado, código postal y teléfono. También se necesita el `rate_id` de la cotización seleccionada, que identifica la paquetería y el servicio específico. Una guía generada tiene costo aunque el paquete nunca se entregue, así que no se debe generar antes de que el pedido esté listo para surtir.

La respuesta incluye la URL del PDF de la guía y el número de rastreo. Ambos se deben guardar en el pedido de inmediato. El PDF se puede servir directamente desde la URL del agregador o descargarse y guardarse en tu propio storage para no depender de la disponibilidad del proveedor.

Genera la guía solo cuando el pedido está confirmado y listo para empacar.
Guarda el tracking number y el PDF en el pedido antes de responder.
Implementa reintentos con backoff exponencial si la generación falla.

Rastreo: webhooks vs polling

Skydropx y Pakke ofrecen webhooks para actualizaciones de estado del envío. Cuando el paquete es recogido, está en tránsito o fue entregado, el agregador hace un POST a tu endpoint con el nuevo estado. Ese es el mecanismo correcto para sistemas en producción: no consume recursos de forma constante y la actualización llega en tiempo real.

Si el agregador no ofrece webhooks confiables o el sistema necesita verificar el estado bajo demanda, el polling es la alternativa. La práctica recomendada es hacer polling con frecuencia decreciente: cada hora durante el primer día, cada cuatro horas del segundo al quinto día, y una vez al día después. Hacer polling cada cinco minutos durante semanas consume recursos sin beneficio real.

Más artículos

Volver a artículos

Plataformas de pago en México: Stripe, Conekta, Mercado Pago y OpenPay

Comparativa técnica y comercial de las cuatro plataformas más usadas para aceptar pagos en proyectos digitales mexicanos.

3 de junio de 2026

7 min de lectura

Plataformas de envíos en México: Skydropx, EnviosPerros, Pakke y Enviame

Cómo elegir entre los principales agregadores de paquetería para ecommerce en México según volumen, operación y necesidades técnicas.

3 de junio de 2026

7 min de lectura

CMS headless en 2026: PayloadCMS, Strapi, Sanity y Directus

Qué CMS headless elegir según el tipo de proyecto, el control técnico que necesitas y cómo planeas modelar el contenido.

3 de junio de 2026

8 min de lectura