CONTEÚDO


01. OBJETIVO

Obter informações do custo histórico de um item e estabelecimento específico em um período. Retorna dados históricos de custo base, custo de reposição e custo de última entrada em períodos no passado.

02. API

Informações da API utilizada para busca dos dados e nome do cadastro de menu relacionado à API, caso o usuário queira restringir o acesso. Mais informações: Manutenção de Programa (MEN012AA)

MÉTODOGET
APIapi/csp/v1/svCustoItem
ROTA/getdata/
MENU*****Verificar

03. PERGUNTAS EXEMPLO (FEW-SHOTS)

Exemplos de perguntas que deverão ser respondidas por esse assunto.


Pergunta
1Quais os custos de última entrada do item <código> no estabelecimento <código> em <período>?
2Qual era o custo base do item <código> no estabelecimento <código> em <período>?
3Qual o último preço de reposição do item <código> no estabelecimento <código> em <período>?

04. PARÂMETROS

São os possíveis campos utilizados na busca dos dados pela API.

ParâmetroTipoDescriçãoObrigatório
itemCodestring

Código do item

Sim

siteCode

string

Código do Estabelecimento

sim

period

string

Período, onde deve ser enviado sempre no formato YYYYMM

sim

05. GLOSSÁRIO

O glossário é um conjunto de termos utilizados para definir a tradução das propriedades retornadas no JSON da API. Além disso, os campos apresentados são incluídos na cláusula FIELDS da query, ou seja, somente esses campos são retornados na resposta da API.

PropriedadeDescriçãoTipoFormato
custo-item_cod-estabelEstabelecimentocharacter
custo-item_data-baseData Basedate
custo-item_data-pr-fiscData Preço Fiscaldate
custo-item_data-ult-entData Últ. Entradadate
custo-item_data-ult-repData Reposiçãodate
custo-item_data-ult-saiData Ult. Saidadate
custo-item_it-codigoCódigo do Itemcharacter
custo-item_periodoPeríodocharacter
custo-item_preco-basePreço Basedecimal->>>>,>>>,>>9.9999
custo-item_preco-fiscalPreço Fiscaldecimal->>>>,>>>,>>9.9999
custo-item_preco-reposPreço Reposiçãodecimal->>>>,>>>,>>9.9999
custo-item_preco-ult-entPreço Última Entradadecimal->>>>,>>>,>>9.9999
desc_itemDescrição do Itemcharacter

06. AÇÕES RELACIONADAS

São sugestões de novas perguntas ou ações que serão sugeridas ao usuário após a execução desse assunto.