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}/<path-do-endpoint>/" \
  -H "Authorization: Bearer ${SENIOR_ACCESS_TOKEN}" \
  -H "Content-type: application/json" \
  -H "client_id: ${SENIOR_CLIENT_ID}" \
  -d '{
    "deposito": "<codigo>",
    "itens": ["SKU1", "SKU2"]
  }'

Notas:

• Substitua <path-do-endpoint> 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.”