Voor agentontwikkelaars & bedrijven met AI-ondersteuning
Uw agent legt de verbanden. Ysend verbindt orders, voorraad, magazijnwerk en de voortgang van zendingen. Zo krijgt een digitale beslissing een concrete volgende stap in uw operatie.
De TypeScript SDK biedt voorraad, orders en zendingen als getypeerde domeinen aan. Begin met een klein leesproces aan de serverzijde en bepaal vervolgens welke handelingen uw integratie nodig heeft.
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 });Bekijk de reden, corrigeer de regel of koppeling en dien hem opnieuw in.
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 };
}Je agent kan via de Ysend-API voorraad lezen, orders versturen, orders die correctie nodig hebben bekijken en daarna zendingen volgen en retouren openen. Herhaalt hij een wijziging, dan gebruikt hij dezelfde aanvraagsleutel zodat niets dubbel wordt aangemaakt.
Bevoegde teams volgen orders en retouren in de mobiele verkopersomgeving. Magazijnmedewerkers gebruiken ondersteunde scanprocessen op handhelds.
ApplicatiesVolg de operatie
Wie deze stap uitvoertUw applicatie / agent
Lees het saldo van het betreffende magazijn voordat u vraag doorgeeft. Uw applicatie houdt rekening met bestaande toewijzingen en past haar verkoopregels toe op de beschikbare voorraad voordat zij nieuwe bestellingen voorstelt.
Uw applicatie kan deze vraag voorstellen. Fysieke magazijnprocessen blijven de voorraad beheren.
Wie deze stap uitvoertUw integratie → Ysend-bestellingen
Stuur herkende productreferenties, ontvangersgegevens en aantallen met een vaste batchreferentie. Het resultaat scheidt geaccepteerde regels van regels die correctie vereisen; een geslaagd verzoek alleen is onvoldoende.
Laat geaccepteerde bestellingen doorgaan. Onderzoek de uitzonderingen voordat u de batch afrondt.
Wie deze stap uitvoertUw integratie en cataloguscontroleur
Doorloop de gepagineerde uitzonderingswachtrij van het account. Zoek en corrigeer iedere betrokken productreferentie; dien de regel opnieuw in met een afzonderlijke vaste herhaalsleutel voor die bewerking.
Corrigeren en opnieuw indienen zijn afzonderlijke acties. Bevestig ieder resultaat voordat u de uitzondering sluit.
Wie deze stap uitvoertMagazijnmedewerker
Het magazijn verzamelt en verpakt de geaccepteerde vraag. Medewerkers identificeren producten en voeren controles uit; uw agent volgt de voortgang en markeert fysieke werkzaamheden niet zelf als voltooid.
Het magazijn lost ontbrekende scans of verpakkingsafwijkingen op vóór overdracht van het betrokken pakket aan transport.
Wie deze stap uitvoertUw applicatie en klantenservice
Uw applicatie bewaart de zendingsidentificatie uit haar integratie of operationele overdracht en leest daarmee de zending. De SDK-leesactie vereist die bekende identificatie en ontdekt geen bestel-zendingkoppeling.
Uw applicatie past haar communicatieregels toe op beschikbare zendingsgebeurtenissen.
Wie deze stap uitvoertKlantenservice → retourteam
Als een klant na bezorging schade meldt, opent u een retour bij die bestelling en voegt u bewijs toe. Het retourteam registreert fysieke verwerking; uw bedrijf bepaalt vanuit dat dossier de commerciële oplossing.
Een retour openen start de nazorg. Inspectie, voorraadbestemming en eventuele terugbetaling blijven aparte beslissingen.
Een serversleutel heeft de bedoelde rechten; productreferenties wijzen naar de juiste magazijnartikelen.
U kunt geaccepteerde regels lezen, een uitzondering vinden, corrigeren en de expliciete herindiening bevestigen.
Uw team verbindt bestelling, zending en retour met een verantwoordelijke voor iedere open beslissing.
We beoordelen de aansluiting van uw applicatie op basis van de ondersteunde APIs en de vereiste accountrechten. De SDK is een bouwsteen voor integraties. Toegang voor externe agents wordt samen met het Ysend-team voorbereid.
Agents kunnen werken met beschikbare operationele gegevens en ondersteunde handelingen. Fysieke goederenbehandeling, commerciële beslissingen en handelingen waarvoor goedkeuring nodig is, behouden hun eigen verantwoordelijke teams en controles.
De SDK wordt als pakket met versienummer aangeboden via het ontwikkelaarsportaal waarvoor u toegang hebt gekregen. Tijdens de onboarding bevestigen we uw omgeving, inloggegevens en integratiebereik.
Plan uw volgende stap
Vertel ons wat uw agent moet lezen, welke acties deze moet coördineren en waar orders en voorraad nu worden beheerd. We brengen de aansluiting samen met uw team in kaart.