Inicio rápido
Genera tu primera guía de envío en menos de 5 minutos. Compara tarifas de USPS, UPS y FedEx con una sola llamada a la API.
Antes de empezar
Cuenta de atoship
Regístrate gratis en atoship.com — sin tarjeta de crédito
Agrega saldo
Agrega fondos a tu monedero para comprar guías. Paga solo por lo que uses.
Obtén tu API key
Ve a Panel → Configuración → API Keys para generar tu clave
Consulta las tarifas de envío
Envía las dimensiones de tu paquete y las direcciones para obtener tarifas en tiempo real de todas las paqueterías. atoship compara automáticamente USPS, UPS y FedEx para encontrar los mejores precios.
// Consulta tarifas de envío de varias paqueterías
const response = await fetch('https://atoship.com/api/v1/rates', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
from_address: {
name: "Your Store",
street1: "123 Store Street",
city: "San Francisco",
state: "CA",
zip: "94102",
country: "US"
},
to_address: {
name: "John Customer",
street1: "456 Customer Ave",
city: "Los Angeles",
state: "CA",
zip: "90210",
country: "US"
},
parcel: {
weight: 16, // onzas
length: 12,
width: 8,
height: 6
}
})
});
const rates = await response.json();
// Devuelve tarifas de USPS, UPS y FedEx con precios y tiempos de entrega estimadosUSPS
Priority Mail, Ground Advantage, First Class
UPS
Ground, 2-Day, Next Day Air
FedEx
Ground, Express, Home Delivery
Genera una guía
Elige la mejor tarifa y genera tu guía de envío. El costo se descuenta del saldo de tu monedero.
// Genera una guía de envío
const response = await fetch('https://atoship.com/api/v1/labels', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
rate_id: "rate_abc123", // De la respuesta de tarifas
label_format: "PDF" // PDF, PNG o ZPL
})
});
const label = await response.json();
console.log('Tracking:', label.tracking_number);
console.log('Label URL:', label.label_url);
// ¡Descarga e imprime la guía!¡Tu guía está lista!
La respuesta incluye tu número de rastreo y una URL para descargar el PDF de la guía. ¡Imprímela, pégala en tu paquete y llévalo a la paquetería!
{
"id": "lbl_abc123",
"tracking_number": "9400111899223344556677",
"label_url": "https://labels.atoship.com/lbl_abc123.pdf",
"carrier": "usps",
"service": "priority_mail",
"cost": 8.45
}¿Qué sigue?
Conceptos clave
Aprende sobre direcciones, tarifas, guías, rastreo y más
Referencia de la API
Explora todos los endpoints: tarifas, guías, rastreo, direcciones
Área de pruebas de la API
Prueba llamadas a la API de forma interactiva en tu navegador
Librerías cliente
SDK oficiales para Node.js, Python, PHP y más