Per sviluppatori di agenti e imprese assistite dall'IA

Dai ai tuoi agenti accesso a processi aziendali reali.

Il tuo agente collega le informazioni. Ysend collega ordini, scorte, lavoro di magazzino e avanzamento delle spedizioni, perché una decisione digitale abbia un prossimo passo operativo concreto.

Il tuo agente o la tua applicazione
Ysend API + TypeScript SDK
  • Scorte
  • Ordini
  • Spedizioni
  1. Team di magazzino
  2. Affidamento al corriere
  3. Avanzamento della consegna

Sviluppa con oggetti aziendali che conosci.

Il TypeScript SDK espone scorte, ordini e spedizioni come domini tipizzati. Parti da un piccolo flusso di lettura lato server, poi verifica le operazioni necessarie alla tua integrazione.

TypeScript lato server · SDK fornito tramite il portale sviluppatori con accesso autorizzato
import { Ysend } from "@ysend/sdk";

const ysend = new Ysend({
  baseUrl: process.env.YSEND_API_BASE_URL!,
  apiKey: process.env.YSEND_API_KEY!,
});

const stock = await ysend.inventory.listBalances({ page: 1, pageSize: 20 });
const orders = await ysend.orders.list({ status: "Open", page: 1, pageSize: 20 });
const shipments = await ysend.shipments.list({ page: 1, pageSize: 20 });
Un’importazione riuscita può contenere righe rifiutate.

Esamina il motivo, correggi la riga o la sua associazione e reinviala.

Esempio lato server: result descrive l’importazione. queuePage è una pagina della coda in quarantena dell’account; scorri le pagine e associa le righe al lotto pertinente.
import type {
  Ysend, ImportPortalOrdersInput,
  CorrectPortalOrderImportRowInput, ResubmitOrderImportInput,
} from "@ysend/sdk";

export async function importBatch(
  ysend: Ysend, input: ImportPortalOrdersInput, operationKey: string,
) {
  const result = await ysend.orders.importManual(input, operationKey);
  // Quarantined rows are not imported orders. null means a count was not returned.
  return { imported: result.imported ?? null, quarantined: result.quarantined ?? null };
}

export async function listExceptionPage(ysend: Ysend, page: number) {
  // Tenant-wide queue, not this batch's results. Review further pages as needed.
  // Match batchReference and orderCode before choosing an exception to correct.
  return ysend.orders.listQuarantine({ page, pageSize: 20 });
}

export async function correctOrder(
  ysend: Ysend, exceptionId: number,
  correction: CorrectPortalOrderImportRowInput, operationKey: string,
) {
  // Saves the correction only. A separate, authorised action must resubmit it.
  await ysend.orders.correctQuarantinedRow(
    exceptionId, correction, operationKey,
  );
}

export async function resubmitOrder(
  ysend: Ysend, exceptionId: number,
  resubmission: ResubmitOrderImportInput, operationKey: string,
) {
  // Use this resubmission's own stable key; inspect the returned counts again.
  const result = await ysend.orders.resubmitQuarantinedRow(
    exceptionId, resubmission, operationKey,
  );
  return { imported: result.imported ?? null, quarantined: result.quarantined ?? null };
}

La tecnologia dietro il flusso

Il tuo agente può leggere le scorte, inviare ordini, controllare gli ordini da correggere e poi seguire spedizioni e aprire resi tramite l’API Ysend. Quando ripete una modifica, riusa la stessa chiave di richiesta, così nulla viene creato due volte.

A portata di mano

I team autorizzati seguono ordini e resi nello spazio mobile del commerciante; gli operatori usano i percorsi di scansione supportati sui terminali.

Applicazioni

Segui le operazioni

Come funziona la tua attività.

Chi esegue questo passaggioLa tua applicazione o il tuo agente

01. Decidi in base alla disponibilità di ogni SKU.

Leggi il saldo del magazzino prima di inviare domanda. La tua applicazione considera gli impegni esistenti e applica le proprie regole di vendita allo stock disponibile prima di proporre nuovi ordini.

La decisione successiva

La tua applicazione può proporre questa domanda. I movimenti di stock restano legati alle operazioni fisiche.

Chi esegue questo passaggioLa tua integrazione → ordini Ysend

02. Importa il lotto e leggi il risultato.

Invia riferimenti riconosciuti, dati di consegna e quantità con un riferimento di lotto stabile. La risposta separa le righe accettate da quelle trattenute per correzione; il successo della richiesta non basta.

La decisione successiva

Gli ordini accettati possono avanzare. Esamina le eccezioni prima di considerare concluso il lotto.

Chi esegue questo passaggioLa tua integrazione e il responsabile del catalogo

03. Correggi i riferimenti, poi reinvia esplicitamente.

Consulta la coda paginata di quarantena dell’account e individua le righe interessate. Risolvi ogni riferimento, correggi la riga e reinviala con una chiave di ritentativo stabile e distinta per quell’operazione.

La decisione successiva

Correzione e reinvio sono azioni separate. Conferma ogni risultato prima di chiudere l’eccezione.

Chi esegue questo passaggioOperatore di magazzino

04. Trasforma gli ordini accettati in pacchi fisici.

Il magazzino esegue prelievo e imballaggio della domanda accettata. Gli operatori identificano il prodotto e completano i controlli richiesti; il tuo agente segue l’avanzamento dell’ordine.

La decisione successiva

Il personale risolve una scansione mancante o un’anomalia di imballaggio prima di affidare il pacco al trasporto.

Chi esegue questo passaggioLa tua applicazione e il servizio clienti

05. Usa i dati della spedizione per decidere chi seguire.

La tua applicazione conserva l’identificativo della spedizione ricevuto dall’integrazione o dal coordinamento operativo e consulta quella spedizione. L’SDK richiede l’identificativo noto; non individua il collegamento ordine-spedizione.

La decisione successiva

La tua applicazione applica le regole di comunicazione agli eventi di trasporto disponibili.

Chi esegue questo passaggioServizio clienti → gestione resi

06. Mantieni l’assistenza collegata all’ordine originale.

Quando un cliente segnala un danno dopo la consegna, apri un reso su quell’ordine e aggiungi le prove. Il team registra la gestione fisica; la tua azienda decide la risposta commerciale in base a quei dati.

La decisione successiva

Aprire il reso avvia l’assistenza. Ispezione, destinazione dello stock ed eventuale rimborso richiedono decisioni distinte.

Cosa includere nel modello dei costi

Fulfilment
Concorda ricevimento, stoccaggio, prelievo, imballaggio e materiali con l’operazione.
Trasporto e assistenza
Valuta separatamente caratteristiche dei pacchi, destinazioni, anomalie di consegna e gestione dei resi.
La tua automazione
Includi hosting dell’agente, utilizzo dei modelli, negozio e servizio clienti nel modello economico.

Cosa prepara la prima operazione

  1. Accesso e catalogo

    Una chiave lato server ha gli ambiti previsti e i riferimenti identificano gli articoli corretti del magazzino.

  2. Un lotto di prova completo

    Puoi leggere le righe accettate, individuare una riga trattenuta, correggerla e confermarne il reinvio esplicito.

  3. Un caso cliente completo

    Il team collega un ordine alla spedizione e al reso, con un responsabile per ogni decisione aperta.

Prima di iniziare

Posso collegare il mio framework per agenti?

Verifichiamo la connessione della tua applicazione rispetto alle API supportate e alle autorizzazioni richieste per l'account. L'SDK è un componente per l'integrazione; l'accesso degli agenti esterni viene preparato con il team Ysend.

Un agente sostituisce il team di magazzino?

Gli agenti possono lavorare con i dati operativi esposti e le azioni supportate. La movimentazione fisica, le decisioni commerciali e le operazioni soggette ad approvazione mantengono i propri team responsabili e controlli.

Come posso ottenere l'SDK?

L'SDK viene fornito come pacchetto versionato attraverso il portale sviluppatori con accesso autorizzato. Confermiamo ambiente, credenziali e ambito dell'integrazione durante l'onboarding.

Pianifica il prossimo passo

Parti da un processo aziendale reale.

Raccontaci cosa deve leggere il tuo agente, quali azioni deve coordinare e dove gestisci oggi ordini e scorte. Progetteremo la connessione insieme al tuo team.

Prepara la prima operazione

  • Concordare catalogo, magazzino e ambito dell’integrazione.
  • Provare un ordine rappresentativo e la sua eccezione.
  • Definire le decisioni consentite all’applicazione.