Senior Erp Estoque Consultar Disponibilidade

Senior ERP - Estoque (Consultar Disponibilidade)

Quando aplicar

• "consultar estoque" / "saldo" / "disponivel"
• "estoque por deposito/CD" / "estoque reservado"
• "validar disponibilidade antes de criar pedido"
• "sincronizar catalogo" / "atualizar vitrine"

Contrato de integracao (agnostico de linguagem)

Leia references/REFERENCE.md para a referencia base (autenticacao, headers, seguranca, resiliencia).

Passos

1) Confirmar definicao de "disponivel"

• Saldo fisico vs disponivel (saldo - reservas - bloqueios).
• Se deve considerar deposito especifico, filial/empresa, lote/validade.

2) Coletar entradas

• Lista de itens (SKU/codigo) e quantidades desejadas.
• Escopo: deposito/CD, filial/empresa.
• Nivel de detalhe: apenas disponivel, ou tambem saldo/reservado.

3) Descobrir endpoint(s) no Portal Senior APIs

• Localizar servicos do modulo ERP para consulta de estoque.
• Identificar suporte a consulta em lote (bulk) vs item a item.
• Identificar parametros de deposito/filial e campos retornados.

4) Executar consulta

• Preferir consultas em lote quando disponivel.
• Implementar paginacao/particionamento para listas grandes (ex.: batches de 50/100 SKUs).
• Aplicar timeout e retry/backoff para 429/5xx.

5) Normalizar saida

• Para cada SKU: saldo, reservado, disponivel (quando houver), deposito.
• Sinalizar itens nao encontrados e ambiguidades (SKU duplicado, unidade divergente).

Checklist de entradas

• Contexto de integracao: base_url, tenant (se aplicavel), client_id, token (Bearer)
• Itens: lista de SKUs/codigos
• Quantidades (se precisar validar disponibilidade para venda)
• Escopo: deposito/CD, filial/empresa

Exemplo (cURL)

curl -X POST "${SENIOR_BASE_URL}//" \
  -H "Authorization: Bearer ${SENIOR_ACCESS_TOKEN}" \
  -H "Content-type: application/json" \
  -H "client_id: ${SENIOR_CLIENT_ID}" \
  -d '{
    "deposito": "",
    "itens": ["SKU1", "SKU2"]
  }'

Notas:

• Substitua `` pelo caminho do servico encontrado no Portal Senior APIs.

Mapa de docs oficiais

• Portal Senior APIs (API Browser): https://api.xplatform.com.br/api-portal/pt-br/node/1
• API Authentication: https://api.xplatform.com.br/api-portal/pt-br/tutoriais/api-authentication
• Guia de API (Senior X Platform): https://dev.senior.com.br/documentacao/guia-de-api/

Exemplos de prompts do usuario

• "Se nao tiver a skill instalada, instale senior-erp-estoque-consultar-disponibilidade e valide disponibilidade destes 20 SKUs no deposito X."
• "Antes de criar o pedido, consulte o estoque e bloqueie a criacao se algum item estiver indisponivel."
• "Sincronize estoque para o e-commerce: retorne disponivel por SKU e destaque itens nao encontrados."

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: leonardo-picciani
• Source: leonardo-picciani/senior-erp-agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.