Consultar estoque

Consulte o estoque de produtos no Sankhya ERP através da API de serviços

Parâmetros

Parâmetros de configuração.

Campo	Tipo	Descrição
Conta de serviço	Select	Permite o acesso ao sistema através de credenciais fornecidas no painel de contas do Floui.
Filtro por campo	String	Utilize campos internos para aplicar filtros de buscas.
Valor	String	Define um valor associado ao filtro por campo.
Tipo do valor	Select	Define o tipo primitivo do valor aplicado.
Campos para retorno na consulta	String	Crie a sua estrutura de retorno esperada usando os campos internos.
Número de resultados por página	String	Define um número de itens encontrados por página.
Página atual	String	Define a página de visualização padrão.
Retorno em modo simplificado	Select	Retorna os dados de resultado da consulta em modo simplificado ao invés da resposta padrão da Sankhya.
Output path	String	Armazena os dados de saída do conector ao final da execução.
Descrição	String	Mensagem visual para descrever a função do conector no contexto do fluxo.

Consulta de Estoque

get

Regras de negócio

Dentro de uma empresa, o estoque é representado por produtos que estão armazenados em locais que são utilizados para a produção de seu produto ou para suprimir a necessidade da própria empresa.

No ERP Sankhya-Om devemos entender um local de estoque, como uma maneira de classificação e organização dos produtos no estoque da empresa; o destino dos itens a medida que as operações de compra, venda e movimentação interna são realizadas.
OBS: Caso tenha alguma necessidade de configuração do ERP procure “Consultor” ou acesso o link de apoio:
https://ajuda.sankhya.com.br/hc/pt-br/articles/360044602894-Locais

Dependências

Não possui dependências

Detalhes Técnicos

A entidade utilizada é a Estoque que por sua vez instancia a tabela TGFEST mapeando os campos principais.

Para realizarmos a busca através do Json, utilizamos o serviço "CRUDServiceProvider.loadRecords".

O serviço CRUDServiceProvider.loadRecords é um otimo serviço para ser utilizado para consulta de dados através do JSON.

No exemplo abaixo foi utilizado como filtro o campo CODPROD, porém você pode utilizar outros campos da entidade .

• CODPROD – Código do Produto.
Para utilizarmos o filtro, basta acrescentar no corpo da requisição o código abaixo utilizando o criteria:

    "criteria": {
      "expression": {
        "$": "this.CODPROD = 54"
      }
    }

Para melhor performance sempre utilize nas suas consultas apenas os campos necessários, para evitar tráfego de dados que não serão utilizados.

Descritivo de campos da entidade

Acesse aqui o dicionário de dados da tabela TGFEST

Exemplo de uso:

URL de chamada: https://api.sankhya.com.br/gateway/v1/mge/service.sbr?serviceName=CRUDServiceProvider.loadRecords&outputType=json

Corpo de requisição

{
  "serviceName": "CRUDServiceProvider.loadRecords",
  "requestBody": {
    "dataSet": {
      "rootEntity": "Estoque",
      "includePresentationFields": "S",
      "offsetPage": "0",
      "criteria": {
        "expression": {
          "$": "this.CODPROD = 54 AND this.CODLOCAL = 1100"
        }
      },
      "entity": {
        "fieldset": {
          "list": "CODPROD,WMSBLOQUEADO,CODLOCAL"
        }
      }
    }
  }
}

Retorno em json:

{
    "serviceName": "CRUDServiceProvider.loadRecords",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "C373171E3E6F607586E03A22E26F1AAC",
    "responseBody": {
        "entities": {
            "total": "1",
            "hasMoreResult": "false",
            "offsetPage": "0",
            "offset": "0",
            "metadata": {
                "fields": {
                    "field": [
                        {
                            "name": "CODPROD"
                        },
                        {
                            "name": "WMSBLOQUEADO"
                        },
                        {
                            "name": "CODLOCAL"
                        },
                        {
                            "name": "CODEMP"
                        },
                        {
                            "name": "CONTROLE"
                        },
                        {
                            "name": "CODPARC"
                        },
                        {
                            "name": "TIPO"
                        },
                        {
                            "name": "Produto_DESCRPROD"
                        },
                        {
                            "name": "LocalFinanceiro_DESCRLOCAL"
                        },
                        {
                            "name": "Empresa_NOMEFANTASIA"
                        },
                        {
                            "name": "Parceiro_NOMEPARC"
                        }
                    ]
                }
            },
            "entity": {
                "f6": {
                    "$": "P"
                },
                "f7": {
                    "$": "KIT 1 (WESLEY)"
                },
                "f8": {
                    "$": "Corredor A"
                },
                "f9": {
                    "$": "EMPRESA MODELO"
                },
                "f10": {
                    "$": "<SEM PARCEIRO>"
                },
                "_rmd": {
                    "CODPROD": {
                        "$": "{\"decVlr\":2,\"decQtd\":0,\"controle\":{\"tipoContEst\":\"N\",\"listaContEst\":[\"\"]}}",
                        "provider": "PRODUTORMP"
                    }
                },
                "f0": {
                    "$": "54"
                },
                "f1": {
                    "$": "0"
                },
                "f2": {
                    "$": "1100"
                },
                "f3": {
                    "$": "2"
                },
                "f4": {},
                "f5": {
                    "$": "0"
                }
            }
        }
    }
}

Responses

201

Consulta efetuada com sucesso

No content

400

Requisição inválida

500

Erro interno do servidor

get/Estoque

GET /Estoque HTTP/1.1
Accept: */*

No content