Pour les développeurs d’agents et les entreprises assistées par l’IA

Donnez à vos agents une activité à piloter.

Votre agent fait le lien entre les informations. Ysend relie commandes, stock, travail en entrepôt et suivi des expéditions : une décision numérique trouve sa prochaine étape sur le terrain.

Votre agent ou votre application
API Ysend + SDK TypeScript
  • Stock
  • Commandes
  • Expéditions
  1. Équipes entrepôt
  2. Remise au transporteur
  3. Suivi de livraison

Développez avec des objets métier que vous connaissez.

Le SDK TypeScript expose le stock, les commandes et les expéditions sous forme de domaines typés. Commencez par un parcours de lecture simple côté serveur, puis qualifiez les opérations nécessaires à votre intégration.

TypeScript côté serveur · SDK fourni via le portail développeur auquel vous êtes autorisé à accéder
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 import réussi peut contenir des lignes refusées.

Examinez le motif, corrigez la ligne ou sa correspondance, puis soumettez-la à nouveau.

Exemple côté serveur : le résultat décrit l’import. queuePage contient une page de la file de quarantaine du compte ; parcourez les pages et rapprochez les lignes du lot concerné.
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 technologie derrière le parcours

Votre agent peut lire le stock, envoyer des commandes, consulter les commandes à corriger, puis suivre les expéditions et ouvrir des retours via l’API Ysend. Lorsqu’il relance une modification, il réutilise la même clé de requête pour que rien ne soit créé deux fois.

À portée de main

Les équipes habilitées suivent commandes et retours dans l’espace marchand mobile ; les opérateurs utilisent les parcours de scan pris en charge sur terminal.

Applications

Suivre les opérations

Votre activité, étape par étape

Qui intervient à cette étapeVotre application / agent

01. Décider à partir du disponible, référence par référence.

Consultez le solde de l'entrepôt avant de transmettre la demande. Votre application applique ses règles de vente au stock disponible après les engagements existants avant de proposer de nouvelles commandes.

La décision suivante

Votre application peut proposer cette demande. Les opérations physiques gardent la maîtrise du stock.

Qui intervient à cette étapeVotre intégration → commandes Ysend

02. Importer le lot et examiner le résultat.

Transmettez références produit reconnues, coordonnées destinataires et quantités avec une référence de lot stable. La réponse distingue les quantités importées des lignes à corriger ; le seul succès de la requête ne suffit pas.

La décision suivante

Laissez avancer les commandes acceptées. Examinez les exceptions avant de considérer le lot complet.

Qui intervient à cette étapeVotre intégration et le responsable catalogue

03. Corriger les références, puis renvoyer explicitement les lignes.

Parcourez la file paginée de quarantaine du compte pour identifier les lignes concernées. Résolvez chaque référence produit, corrigez la ligne et renvoyez-la avec une clé de reprise stable distincte pour cette opération.

La décision suivante

Correction et renvoi sont deux actions distinctes. Confirmez chaque résultat avant de clôturer l'exception.

Qui intervient à cette étapeOpérateur d'entrepôt

04. Transformer les commandes acceptées en colis physiques.

L'entrepôt prélève et emballe la demande acceptée. Les opérateurs identifient le produit et réalisent les contrôles requis ; votre agent suit la progression sans déclarer lui-même le travail physique terminé.

La décision suivante

L'équipe résout tout scan manquant ou écart d'emballage avant de remettre le colis concerné au transport.

Qui intervient à cette étapeVotre application et le service client

05. Utiliser les preuves d'expédition pour cibler les relances.

Votre application conserve l'ID d'expédition transmis par l'intégration existante ou un relais opérationnel. Le SDK lit cet ID connu ; il ne découvre pas le lien commande–expédition.

La décision suivante

Votre application applique ses règles de communication à partir des événements d'expédition disponibles.

Qui intervient à cette étapeService client → équipe retours

06. Rattacher l'après-vente à la commande d'origine.

Lorsqu'un client signale un dommage après livraison, ouvrez un retour sur sa commande et ajoutez les preuves. L'équipe retours enregistre le traitement physique ; votre entreprise décide de la réponse commerciale à partir de ce dossier.

La décision suivante

Ouvrir un retour lance le traitement après-vente. Inspection, devenir du stock et éventuel remboursement restent des décisions distinctes.

Les éléments de votre modèle de coûts

Exécution logistique
Convenez de la réception, du stockage, du prélèvement, de l'emballage et des matériaux avec l'exploitation.
Transport et après-vente
Examinez séparément caractéristiques des colis, destinations, incidents de livraison et traitement des retours.
Votre automatisation
Intégrez hébergement de l'agent, utilisation des modèles, boutique et service client à votre modèle économique.

Ce qui prépare la première opération

  1. Accès et catalogue

    Une clé côté serveur dispose des droits prévus, et vos références correspondent aux bons articles de l'entrepôt.

  2. Un lot de test complet

    Vous savez lire le résultat accepté, retrouver une ligne en quarantaine, la corriger et confirmer son renvoi explicite.

  3. Un dossier client complet

    Votre équipe sait relier commande, expédition et retour, avec un responsable pour chaque décision en suspens.

Avant de vous lancer

Puis-je connecter mon propre framework d’agents ?

Nous qualifions la connexion de votre application au regard des API disponibles et des permissions requises sur le compte. Le SDK est une brique d’intégration ; l’accès d’agents externes se prépare avec l’équipe Ysend.

Un agent remplace-t-il l’équipe entrepôt ?

Les agents peuvent utiliser les données opérationnelles exposées et les actions disponibles. La manutention, les décisions commerciales et les opérations soumises à validation conservent leurs propres responsables et contrôles.

Comment obtenir le SDK ?

Le SDK est fourni sous forme de paquet versionné via le portail développeur autorisé. Nous confirmons votre environnement, vos identifiants et le périmètre d’intégration lors de la mise en place.

Préparer la prochaine étape

Commencez par un parcours métier réel.

Indiquez ce que votre agent doit consulter, les actions qu’il doit coordonner et où se trouvent vos commandes et votre stock aujourd’hui. Nous définirons la connexion avec votre équipe.

Préparer votre démarrage

  • Définir le catalogue, l’entrepôt et le périmètre de connexion.
  • Tester une commande représentative et son traitement d’exception.
  • Préciser les décisions autorisées à votre application.