Ordini e spedizioni
Crea, leggi, traccia; preventivi firmati e acquisto etichetta.
Sviluppatori
Accedi all'API con un account attivato; l'SDK TypeScript si scarica dal portale sviluppatori, con le tue chiavi.

Inizia
La crei nel portale sviluppatori una volta attivato il tuo account.
Versionato, scaricato dal portale, con impronta mostrata.
Crea una spedizione, ricevi l'URL di tracking.
Webhook
Crei un abbonamento, lo testi con un ping, leggi lo storico di consegna. Ogni evento parte da una outbox e viene ritentato fino alla consegna; ciò che fallisce durevolmente resta visibile nel dead-letter.
Ambito
Crea, leggi, traccia; preventivi firmati e acquisto etichetta.
Eventi corriere, pagina di tracking pubblica.
Riferimenti, mapping SKU, posizione di stock.
Resi con foto e rimessa a stock.
Fasce orarie, punti di ritiro, coupon.
EDI X12, PIVOT/EANCOM, ricezione AS2.
Chiavi partner
Le tue chiavi account si creano e si rinnovano dal portale sviluppatori. Le chiavi con ambito partner — per un corriere o un magazzino del network — sono emesse da un amministratore Ysend, con ambito limitato all'account.
import { YsendClient } from "@ysend/sdk";
const ysend = new YsendClient({ apiKey: process.env.YSEND_API_KEY });
const shipment = await ysend.shipments.create({
orderRef: "SHIP-2026-0501",
parcels: [{ weightKg: 1.2 }],
to: { country: "FR", postalCode: "06700" },
});
console.log(shipment.trackingUrl);Un account attivato dà accesso a API, SDK e webhook.
Una persona configura il tuo account entro un giorno lavorativo.