DT API Permitir identificar o local/armazém do estoque - Smart Hub Protheus

01. DADOS GERAIS

Linha de Produto:	TOTVS Varejo Lojas
Segmento:	Varejo
Módulo:	SigaLoja (Controle de Loja)
Função:	estoqueobj estoqueapi
Ticket:	Não há.
Story:	DVARLOJ1-10687

02. SITUAÇÃO/REQUISITO

Disponibilizar alguma maneira de consultar o estoque, onde seja possível visualizar os produtos com estoque e quebra por Armazém/Local de Estoque.

03. SOLUÇÃO

Foi disponibilizada API no seguinte caminho: http://{urlRest}/api/retail/v1/estoque/lista para habilitar a quebra por Armazém/Local de Estoque, para isto deverá configurar o parâmetro MV_PSHLOCA de modo exclusivo para cada filial, com o conteúdo do campo NNR_CODIGO do armazém.

A API utiliza o método POST, caso queria informar parâmetros para filtro os mesmos devem ser passados no corpo.

Exemplo:

{
    "idRetaguardaProduto": [
        "LJTEST01"
    ],
    "idRetaguardaLojasConsultaEstoque": [
        "D MG 01 "
    ],
    "idRetaguardaLojaOrigem": "D MG 01 "
}

Parâmetros de entrada (Request):

Parâmetro	Tipo	Obrigatório	Objetivo
idRetaguardaProduto	Lista	Sim	Lista de produtos que deseja realizar a consulta.
idRetaguardaLojasConsultaEstoque	Lista	Não	Quando informado, irá pesquisar estoque somente das lojas informadas, quando não, irá devolver o estoque de todas as Lojas
idRetaguardaLojaOrigem	String	Sim	Identificar qual loja está realizando a consulta de estoque (não é a loja onde possui o saldo de estoque

Retorno:

Json Retorno

{
    "success": true,
    "message": "",
    "data": [
        {
            "idRetaguardaProduto": "241190         ",
            "estoque": [
                {
                    "quantidade": 9862,
                    "armazem": {
                        "id": "01",
                        "descricao": "PADRAO         "
                    },
                    "loja": {
                        "idRetaguarda": "01",
                        "descricao": "TESTE - 1302603",
                        "endereco": "AMAZONAS - RUA CAMILO CASTELO BRANCO, 10"
                    }
                },
                {
                    "quantidade": 100,
                    "armazem": {
                        "id": "02",
                        "descricao": "ESTOQUE 2      "
                    },
                    "loja": {
                        "idRetaguarda": "01",
                        "descricao": "TESTE - 1302603",
                        "endereco": "AMAZONAS - RUA CAMILO CASTELO BRANCO, 10"
                    }
                }
            ]
        }
    ],
    "hasNext": false
}

Valores de retorno (Response): Retorna uma lista de produtos

Campo	Tipo	Objetivo
idRetaguardaProduto	String
estoque	Lista[]	Lista com todas as lojas do Protheus onde houve a consulta de estoque. Ex: Quando não informar onde quer consultar o estoque, será retornada uma lista de todas as lojas e quando não possuir o saldo, será retornada a quantidade = 0.
quantidade	Float	Total disponível em todos os locais de estoque da Loja.
armazem	String	Agrupador para informações do Local de Estoque
id	String	Codigo do Local de Estoque NNR_CODIGO
descricao	String	Descrição do Local do Estoque B2_LOCALIZ
loja	Objeto	Agrupador para as informações da loja.
idRetaguarda	String	Id da Loja que possui o estoque, estará dentro do objeto loja.
descricao	String	Descrição da Loja, estará dentro do objeto loja. Será composto pela junção dos campos M0_NOME + M0_FILIAL, para dar uma melhor visibilidade.
endereco	String	Endereço da Loja, estará dentro do objeto loja.

04. DEMAIS INFORMAÇÕES

Não há

05. ASSUNTOS RELACIONADOS

Árvore de páginas