Páginas filhas
  • DVARHAN-7161 DT API Estoque Produtos

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


01. DADOS GERAIS

Produto:

TOTVS Varejo Food Service

Solucoes_totvs
Solucao

Solucoes_totvs_cross
SolucaoCross

Solucoes_totvs_parceiros
SolucaoParceiros

Solucoes_totvs_parceirosexptotvs
SolucaoParcsExpsTOTVS

Linha de Produto:

 

Linhas_totvs

Segmento:

Fly01 

Segmentos_totvs
Segmento

Módulo:ChefWebAPI
Função:API Estoque Produtos
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DVARHAN-7161


02. 
SITUAÇÃO/REQUISITO

Disponibilizar uma API para listagem do estoque das lojas

03. SOLUÇÃO

Foi disponibilizada uma API para listar o estoque da(s) loja(s) e está disponível no endpoint abaixo: 

...

       {
             "Estoque": [
              {
                     "skuId""ITALG0249A16",
                     "lotId""01",
                     "quantity"11,
                     "locationId"50,
                     "stockType""PHYSICAL",
                     "updatedAt""2021-06-01T08:56:54",
                     "unit""UN"
               },
              {
                     "skuId""ATKRA0149A16",
                     "lotId""01",
                     "quantity"11,
                     "locationId"50,
                     "stockType""PHYSICAL",
                     "updatedAt""2021-06-01T08:56:54",
                     "unit""UN"
               },
               {
                     "skuId""ATKRA0149A16",
                     "lotId""01",
                     "quantity"0,
                     "locationId"50,
                     "stockType""PHYSICAL",
                     "updatedAt""2021-06-01T08:56:54",
                     "unit""UN"
               }
               ],
              "Sucesso"true,
              "Erros": []
       }

04. DEMAIS INFORMAÇÕES

  • O parâmetro "Completa" da requisição é do tipo lógico. Sendo assim os valores possíveis são: 0 e 1 ou False e True;
  • Para a consulta completa, há uma limitação diária de 2 consultas por loja no máximo. Quando atingido o limite, a api retornará o erro abaixo:

Payload request (exemplo):

{
    "Token""8fdef75e-0422-4748-bfb8-dc1a75a0e7b2",
    "CodigoLoja""50",
    "Completa"1,
    "Produtos""",
    "CodigoComplementar""" 
}

Payload response (exemplo):

{
    "Estoque": [],
    "Sucesso"false,
    "Erros": [
        {
            "CodigoErro"20,
            "DescricaoErro""A consulta completa não pode ser realizada pois já atingiu a quantidade máxima liberada para o dia!"
        }
    ]
}

  • A api disponibiliza os produtos pelo código do sistema ou pelo código complementar que pode ser configurável no cadastro dos produtos. Para a consulta ser realizada e retornada com o código do sistema, o campo "CodigoComplementar" da requisição deve ser passado vazio. O campo "skuId" do resultado será o código do sistema. Exemplos de requisições:

...

{
    "Estoque": [
        {
            "skuId""9944",
            "lotId""01",
            "quantity"0,
            "locationId"50,
            "stockType""PHYSICAL",
            "updatedAt""2021-06-01T10:34:51",
            "unit""UN"
        },
        {
            "skuId""12514",
            "lotId""01",
            "quantity"11,
            "locationId"50,
            "stockType""PHYSICAL",
            "updatedAt""2021-06-01T10:34:51",
            "unit""UN"
        },
        {
            "skuId""11846",
            "lotId""01",
            "quantity"11,
            "locationId"50,
            "stockType""PHYSICAL",
            "updatedAt""2021-06-01T10:34:51",
            "unit""UN"
        }
    ],
    "Sucesso"true,
    "Erros": []
}

05. ASSUNTOS RELACIONADOS

        Não se aplica



Templatedocumentos

...