Sviluppatori

Un'API, un SDK, webhook che arrivano.

Accedi all'API con un account attivato; l'SDK TypeScript si scarica dal portale sviluppatori, con le tue chiavi.

Portale sviluppatori: SDK TypeScript versionato (impronta SHA-256), avvio con una chiave API

Inizia

Inizia in tre passaggi

  1. Una chiave account

    La crei nel portale sviluppatori una volta attivato il tuo account.

  2. L'SDK TypeScript

    Versionato, scaricato dal portale, con impronta mostrata.

  3. La tua prima chiamata

    Crea una spedizione, ricevi l'URL di tracking.

Webhook

Webhook che arrivano

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

Cosa copre l'API

Ordini e spedizioni

Crea, leggi, traccia; preventivi firmati e acquisto etichetta.

Tracking

Eventi corriere, pagina di tracking pubblica.

Catalogo e stock

Riferimenti, mapping SKU, posizione di stock.

Resi

Resi con foto e rimessa a stock.

Checkout ospitato

Fasce orarie, punti di ritiro, coupon.

EDI e AS2

EDI X12, PIVOT/EANCOM, ricezione AS2.

Chiavi partner

Chiavi account, 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.

Crea una spedizione con l'SDK
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);

Ottieni un accesso API

Un account attivato dà accesso a API, SDK e webhook.

Ottieni un accesso APIVedi le integrazioni

Una persona configura il tuo account entro un giorno lavorativo.