Centro de ayudaGitHub

Ejemplos interactivos

Aprende haciendo, con ejemplos de código paso a paso en varios lenguajes

Principiante
5 min
Crea tu primer envío
Aprende a crear un envío con validación de direcciones y selección de transportista
Intermedio
10 min
Seguimiento de paquetes en tiempo real
Implementa actualizaciones de seguimiento con webhooks para notificaciones automáticas
Avanzado
15 min
Generación de etiquetas por lotes
Procesa cientos de pedidos de forma eficiente con operaciones por lotes
Crea tu primer envío
Aprende a crear un envío con validación de direcciones y selección de transportista
Principiante
5 min
npm install @atoship/sdk
import { atoshipSDK } from '@atoship/sdk';

const atoship = new atoshipSDK({
  apiKey: 'your_api_key'
});

async function createShipment() {
  try {
    // Crear el envío
    const shipment = await atoship.shipments.create({
      from_address: {
        name: "John Doe",
        company: "atoship Inc",
        street1: "123 Main St",
        city: "San Francisco",
        state: "CA",
        zip: "94105",
        country: "US",
        phone: "415-123-4567"
      },
      to_address: {
        name: "Jane Smith",
        street1: "456 Oak Ave",
        city: "Los Angeles",
        state: "CA",
        zip: "90001",
        country: "US",
        phone: "213-987-6543"
      },
      parcel: {
        length: 10,
        width: 8,
        height: 4,
        weight: 16 // onzas
      }
    });

    console.log('Shipment created:', shipment.id);
    console.log('Tracking number:', shipment.tracking_number);

    // Obtener las tarifas del envío
    const rates = await atoship.shipments.getRates(shipment.id);
    console.log('Available rates:', rates);

    // Elegir la tarifa más económica
    const cheapestRate = rates.sort((a, b) => a.amount - b.amount)[0];
    console.log('Selected rate:', cheapestRate);

    // Comprar la etiqueta
    const label = await atoship.labels.create({
      shipment_id: shipment.id,
      rate_id: cheapestRate.id
    });

    console.log('Label URL:', label.label_url);
    return label;

  } catch (error) {
    console.error('Error creating shipment:', error);
  }
}

// Ejecutar el ejemplo
createShipment();
Próximos pasos
¿Listo para implementar estos ejemplos en tu aplicación?
atoship © 2026