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 = ?"
      },
      "parameter": [
         {
           "$": "24",
           "type": "I"
         }
      ]
    }

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 = ?"
        },
        "parameter": [
           {
             "$": "24",
             "type": "I"
           }
        ]
      },
      "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"
                }
            }
        }
    }
}