Árvore de páginas

Objetivo

A finalidade deste método é possibilitar a consulta de descrições especiais dos produtos.

Chamada

GET [URLAPI]/SMProdutosAPI/api/v4/produtos/locais-produtos

Permissionamento

Antes de prosseguir, certifique-se de que o usuário, utilizado para autenticação de uso na API, está com as devidas permissões no Sistema/Módulo/Aplicações e na empresa desejada.

Para isso, acesse o módulo SegurançaWeb > Permissões > Associação de Permissão Usuário / Grupo >  Sistemas/Módulo/Aplicações > Comercial Web > API Produtos > API Produtos

Imagem 01 - Configurações de Sistemas/Módulos/Aplicações

Assuntos Relacionados

Para saber mais sobre permissionamentos acesse Permissões - Segurança Web.

Informações para Requisição (Request Information)

Parâmetros URI (URI Parameters)

Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
modelo.nroEmpresaParâmetro para filtrar o número da empresa.IntegerObrigatório, caso o CNPJ seja nulo
modelo.CNPJEmpresaCNPJ da empresa utilizada como filtro de informações, sem traços ou pontos. Formato: 00000000000000stringObrigatório, caso o NroEmpresa seja nulo
modelo.statusVendaFiltro de retorno dos produtos: A = ativo (devolve apenas produtos ativos para venda), I = inativo (devolve apenas produtos inativos para venda), S = suspenso (devolve apenas produtos suspensos para venda), T = todos (Retorna todos os produtos). Padrão: A.stringNão há
modelo.idFamiliaCódigo sequencial do cadastro de família do produtoIntegerNão há
modelo.Local

Código do Local de Estoque

IntegerNão há.
modelo.idProdutoCódigo sequencial do cadastro do produtoIntegerNão há
modelo.CodigoAcessoCódigo de acesso do produtoIntegerNão há
modelo._pageNo


modelo._pageSize
IntegerNão há

Parâmetros do Corpo (Body Parameters)

Não há.

Informações para Resposta (Response Information)

Descrição do Recurso (Resource Description)



Nome (Name)Descrição (Description)Tipo (Type)Informações Adicionais (Adittional Information)
LocalLocal onde o produto estáArray of objects (DescricoesEspeciaisRespostaDTO)Não há
NroEmpresaNúmero da empresaStringNão há
EstoqueQuantidade de estoque onde o produto estáIntegerNão há
RuaRuaIntegerNão há
PredioPredioIntegerNão há
ApartamentoApartamentoStringNão há
SalaSalaStringNão há
FrenteFrenteIntegerNão há
StatusVendaStatus de venda do produtoStringNão há
LadoLadoIntegerNão há
BaseBaseIntegerNão há
CodigoAcessoPrincipalCódigo de acesso principalStringNão há
IdProdutoIdentificador único do produtoIntegerNão há
IdFamiliaIdentificador único da famíliaIntegerNão há
IdProdutoBaseIdentificador do produto baseIntegerNão há
DataUltimaAtualizacaoData da ultima atualizaçãoStringNão há


Formatos de Resposta (Response Formats)

application/json, text/json

Exemplo (Sample):

[
  {
    "Local": "string",
    "NroEmpresa": 0,
    "Estoque": 0,
    "Rua": "string",
    "Predio": "string",
    "Apartamento": "string",
    "Sala": "string",
    "Frente": 0,
    "StatusVenda": "string",
    "Lado": 0,
    "Base": 0,
    "CodigoAcessoPrincipal": "string",
    "IdProduto": 0,
    "IdFamilia": 0,
    "IdProdutoBase": 0,
    "DataUltimaAtualizacao": "2025-08-27T20:47:55.641Z"
  }
]

  • Sem rótulos