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/sdkimport { 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();Consejos profesionales:
- Valida siempre las direcciones antes de crear un envío
- Compara tarifas entre varios transportistas para conseguir el mejor precio
- Guarda los números de seguimiento para notificar a tus clientes
Próximos pasos
¿Listo para implementar estos ejemplos en tu aplicación?