Para programadores de agentes e negócios assistidos por IA

Dê aos seus agentes acesso a processos de negócio reais.

O seu agente liga a informação. A Ysend liga encomendas, stock, trabalho de armazém e progresso dos envios, para que uma decisão digital tenha um próximo passo operacional concreto.

O seu agente ou aplicação
Ysend API + TypeScript SDK
  • Stock
  • Encomendas
  • Envios
  1. Equipas de armazém
  2. Entrega à transportadora
  3. Progresso da entrega

Desenvolva com objetos de negócio que reconhece.

O TypeScript SDK disponibiliza stock, encomendas e envios como domínios tipados. Comece com um pequeno fluxo de leitura no servidor e confirme depois as operações de que a sua integração necessita.

TypeScript no servidor · SDK disponibilizado através do portal de programadores com acesso 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 });
Uma importação bem-sucedida pode conter linhas rejeitadas.

Consulte o motivo, corrija a linha ou a correspondência e volte a submetê-la.

Exemplo no servidor: result descreve a importação. queuePage é uma página da fila de quarentena da conta; percorra as páginas e associe as linhas ao lote correspondente.
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 };
}

A tecnologia por trás do fluxo

O seu agente pode consultar o stock, enviar encomendas, rever as encomendas a corrigir e depois acompanhar expedições e abrir devoluções através da API Ysend. Quando repete uma alteração, reutiliza a mesma chave de pedido para que nada seja criado duas vezes.

Na palma da mão

As equipas autorizadas acompanham encomendas e devoluções no espaço móvel do comerciante; os operadores usam percursos de leitura de códigos suportados nos terminais.

Aplicações

Acompanhar a operação

Como funciona o seu negócio.

Quem executa este passoA sua aplicação / agente

01. Decidir pelo disponível, referência a referência.

Consulte o saldo do armazém antes de transmitir a procura. A aplicação considera os compromissos existentes e aplica as suas regras de venda ao stock disponível antes de propor novas encomendas.

A próxima decisão

A aplicação pode propor esta procura. O stock do armazém continua sob controlo das operações físicas.

Quem executa este passoA sua integração → encomendas Ysend

02. Importar o lote e verificar o resultado.

Envie referências reconhecidas, dados dos destinatários e quantidades com uma referência de lote estável. A resposta distingue quantidades importadas de linhas retidas para correção; o sucesso do pedido, por si só, não basta.

A próxima decisão

Deixe avançar as encomendas aceites. Analise as exceções antes de considerar o lote completo.

Quem executa este passoA sua integração e o revisor do catálogo

03. Corrigir as referências e reenviar explicitamente.

Consulte a fila paginada de quarentena da conta e identifique as linhas afetadas. Resolva cada referência, corrija a linha e reenvie-a com uma chave de repetição estável e distinta para essa operação.

A próxima decisão

Corrigir e reenviar são ações separadas. Confirme cada resultado antes de encerrar a exceção.

Quem executa este passoOperador de armazém

04. Transformar encomendas aceites em volumes físicos.

O armazém executa a separação e a embalagem da procura aceite. Os operadores identificam o produto e cumprem as verificações; o agente acompanha o progresso sem declarar concluído o trabalho físico.

A próxima decisão

A equipa resolve uma leitura em falta ou uma exceção de embalagem antes de entregar o volume afetado ao transporte.

Quem executa este passoA sua aplicação e o apoio ao cliente

05. Usar os registos de expedição para identificar quem precisa de atenção.

A aplicação conserva o ID da expedição através da integração existente ou da passagem operacional. O SDK lê esse ID conhecido; não descobre a ligação encomenda–expedição.

A próxima decisão

A aplicação aplica as suas regras de comunicação aos eventos de expedição disponíveis.

Quem executa este passoApoio ao cliente → equipa de devoluções

06. Manter o pós-venda ligado à encomenda original.

Quando um cliente comunica danos após a entrega, abra uma devolução nessa encomenda e acrescente provas. A equipa regista o tratamento físico; a empresa decide a resposta comercial a partir desse registo.

A próxima decisão

Abrir uma devolução inicia o pós-venda. Inspeção, destino do stock e eventual reembolso continuam a ser decisões distintas.

O que incluir no seu modelo de custos

Operação logística
Acorde receção, armazenamento, separação, embalagem e materiais com a operação.
Transporte e pós-venda
Analise características dos volumes, destinos, exceções de entrega e devoluções separadamente.
A sua automação
Inclua alojamento do agente, utilização de modelos, loja e apoio ao cliente no modelo de negócio.

O que prepara a primeira operação

  1. Acesso e catálogo

    Uma chave no servidor tem os âmbitos previstos, e as referências identificam os artigos corretos no armazém.

  2. Um lote de teste completo

    Consegue consultar o resultado aceite, encontrar uma linha em quarentena, corrigi-la e confirmar o reenvio explícito.

  3. Um caso de cliente completo

    A equipa consegue ligar encomenda, expedição e devolução, com um responsável por cada decisão pendente.

Antes de começar

Posso ligar a minha própria framework de agentes?

Validamos a ligação da sua aplicação com as API suportadas e as permissões de conta necessárias. O SDK é um componente de integração; o acesso de agentes externos é preparado com a equipa Ysend.

Um agente substitui a equipa de armazém?

Os agentes podem trabalhar com dados operacionais disponibilizados e ações suportadas. O manuseamento físico, as decisões comerciais e as operações que exigem aprovação mantêm as respetivas equipas responsáveis e os seus controlos.

Como obtenho o SDK?

O SDK é disponibilizado como um pacote com versão através do portal de programadores com acesso autorizado. Confirmamos o ambiente, as credenciais e o âmbito da integração durante a configuração inicial.

Planeie o próximo passo

Comece com um fluxo de negócio real.

Diga-nos o que o agente deve consultar, que ações deve coordenar e onde gere hoje as encomendas e o stock. Planearemos a ligação com a sua equipa.

Preparar a primeira operação

  • Acordar catálogo, armazém e âmbito da integração.
  • Testar uma encomenda representativa e a respetiva exceção.
  • Definir as decisões permitidas à sua aplicação.