Para desarrolladores de agentes y negocios asistidos por IA

Dé a sus agentes acceso a operaciones de negocio reales.

Su agente conecta la información. Ysend conecta pedidos, stock, trabajo de almacén y progreso de los envíos, para que una decisión digital tenga un siguiente paso operativo concreto.

Su agente o aplicación
Ysend API + TypeScript SDK
  • Stock
  • Pedidos
  • Envíos
  1. Equipos de almacén
  2. Entrega al transportista
  3. Progreso de la entrega

Desarrolle con objetos de negocio que reconoce.

El TypeScript SDK expone stock, pedidos y envíos como dominios tipados. Empiece con un pequeño flujo de lectura en el servidor y confirme después las operaciones que necesita su integración.

TypeScript en el servidor · SDK disponible a través de su portal de desarrolladores autorizado
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 });
Una importación correcta puede contener filas rechazadas.

Consulta el motivo, corrige la fila o su correspondencia y vuelve a enviarla.

Ejemplo en el servidor: result describe la importación. queuePage es una página de la cola de cuarentena de la cuenta; recorre las páginas y vincula las filas al lote correspondiente.
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 tecnología detrás del proceso

Tu agente puede consultar el stock, enviar pedidos, revisar los pedidos que deben corregirse y después seguir envíos y abrir devoluciones mediante la API de Ysend. Si repite un cambio, reutiliza la misma clave de solicitud para que nada se cree dos veces.

Al alcance de su mano

Los equipos autorizados siguen pedidos y devoluciones en el espacio móvil del comerciante; el almacén utiliza los flujos de escaneo compatibles en terminales.

Aplicaciones

Seguir la operación

Cómo funciona su actividad.

Quién realiza este pasoSu aplicación o agente

01. Decida según el stock disponible de cada SKU.

Consulte el saldo del almacén antes de enviar demanda. Su aplicación tiene en cuenta las reservas existentes y aplica sus reglas de venta al stock disponible antes de proponer pedidos nuevos.

La siguiente decisión

Su aplicación puede proponer esta demanda. Los movimientos de stock siguen dependiendo de las operaciones físicas.

Quién realiza este pasoSu integración → pedidos Ysend

02. Importe el lote y revise el resultado.

Envíe referencias reconocidas, datos de entrega y cantidades con una referencia estable de lote. La respuesta distingue las filas aceptadas de las retenidas para corregir; el éxito de la solicitud no basta.

La siguiente decisión

Los pedidos aceptados pueden avanzar. Revise las excepciones antes de dar el lote por terminado.

Quién realiza este pasoSu integración y responsable del catálogo

03. Corrija las referencias y reenvíe explícitamente.

Revise la cola paginada de cuarentena de la cuenta e identifique las filas afectadas. Resuelva cada referencia, corrija la fila y reenvíela con una clave estable de reintento distinta para esa operación.

La siguiente decisión

Corregir y reenviar son acciones separadas. Confirme cada resultado antes de cerrar la excepción.

Quién realiza este pasoOperario de almacén

04. Convierta los pedidos aceptados en paquetes.

El almacén ejecuta la preparación y el embalaje de la demanda aceptada. Los operarios identifican el producto y realizan los controles necesarios; su agente sigue el progreso del pedido.

La siguiente decisión

El personal resuelve una lectura ausente o una incidencia de embalaje antes de entregar el paquete al transporte.

Quién realiza este pasoSu aplicación y atención al cliente

05. Use los datos del envío para decidir quién necesita atención.

Su aplicación conserva el identificador de envío recibido mediante su integración o coordinación operativa y consulta ese envío. El SDK necesita ese identificador conocido; no descubre la relación entre pedido y envío.

La siguiente decisión

Su aplicación aplica sus reglas de comunicación a partir de los eventos de transporte disponibles.

Quién realiza este pasoAtención al cliente → equipo de devoluciones

06. Vincule la posventa al pedido original.

Cuando un cliente comunica un daño tras la entrega, abra una devolución contra ese pedido y añada evidencia. El equipo registra la gestión física; su empresa decide la respuesta comercial con esa información.

La siguiente decisión

Abrir una devolución inicia la posventa. La inspección, el destino del stock y un posible reembolso requieren decisiones distintas.

Qué incluir en su modelo de costes

Fulfilment
Acuerde recepción, almacenamiento, preparación, embalaje y materiales con la operación.
Transporte y posventa
Revise por separado características del paquete, destinos, incidencias de entrega y devoluciones.
Su automatización
Incluya alojamiento del agente, uso de modelos, tienda y atención al cliente en su modelo de negocio.

Qué prepara la primera operación

  1. Acceso y catálogo

    Una clave de servidor tiene los permisos previstos y las referencias identifican los artículos correctos del almacén.

  2. Un lote de prueba completo

    Puede revisar filas aceptadas, localizar una retenida, corregirla y confirmar su reenvío explícito.

  3. Un caso de cliente completo

    Su equipo conecta un pedido con su envío y devolución, con un responsable para cada decisión pendiente.

Antes de empezar

¿Puedo conectar mi propio framework de agentes?

Validamos la conexión de su aplicación con las API compatibles y los permisos de cuenta necesarios. El SDK es un componente de integración; el acceso de agentes externos se prepara con el equipo de Ysend.

¿Un agente sustituye al equipo de almacén?

Los agentes pueden trabajar con los datos operativos expuestos y las acciones compatibles. La manipulación física, las decisiones comerciales y las operaciones que requieren aprobación mantienen sus propios equipos responsables y controles.

¿Cómo obtengo el SDK?

El SDK se proporciona como un paquete versionado a través del portal de desarrolladores autorizado. Confirmamos su entorno, credenciales y alcance de integración durante la incorporación.

Planifique el siguiente paso

Empiece con un flujo de negocio real.

Cuéntenos qué debe consultar su agente, qué acciones debe coordinar y dónde gestiona hoy los pedidos y el stock. Planificaremos la conexión con su equipo.

Prepare su primera operación

  • Acordar catálogo, almacén y alcance de integración.
  • Probar un pedido representativo y su incidencia.
  • Definir qué decisiones puede tomar tu aplicación.