get https://example.com/MetasProdutos
Regras de negócio
Para realizar consultas de metas por produtos é necessário efetuar configurações no ERP e definir “Metas por Produto” .Uma vez que as metas já estão configuradas, você poderá definir metas por períodos mensais. Estas metas podem ser estabelecidas para Produtos e ainda configurar se a meta será lançada em termos de "quantidade", "peso", ou "valor". No painel “produto” teremos além dos recursos de filtros rápidos, a opção de se exibir o complemento do produto de modo a se obter maior agilidade na consulta e visualização dos itens.O sistema permite a escolha da apresentação ou não do complemento do produto. Se a opção "Exibir o complemento" estiver marcada, será exibida a descrição do produto acompanhada do complemento do produto, na mesma linha mas separado por colchetes. Se não existir complemento cadastrado para o “produto” o sistema exibe apenas a descrição.
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/360045117773-Metas-Simplificadas-de-Vendas
Dependências
Não possui dependênciasDetalhes Técnicos
A entidade utilizada é a MetaAtual que por sua vez instancia a tabela TGMMET 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.
"criteria": {
"expression": {
"$": "this.CODPROD = ?"
},
"parameters":[
{
"type":"I",
"value":"368"
}
]
}
Descritivo de campos da entidade
Acesse aqui o dicionário de dados da tabela TGMMETExemplo 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": "MetaAtual",
"includePresentationFields": "S",
"offsetPage": "0",
"criteria": {
"expression": {
"$": "this.CODPROD = ?"
},
"parameters":[
{
"type":"I",
"value":"368"
}
]
},
"entity": {
"fieldset": {
"list":"CODMETA,DTREF,CODEMP"
}
}
}
}
}
Retorno em json:
{
"serviceName": "CRUDServiceProvider.loadRecords",
"status": "1",
"pendingPrinting": "false",
"transactionId": "43C20E373580387C83508906C69A1A96",
"responseBody": {
"entities": {
"total": "2",
"hasMoreResult": "false",
"offsetPage": "0",
"offset": "0",
"metadata": {
"fields": {
"field": [
{
"name": "CODMETA"
},
{
"name": "DTREF"
},
{
"name": "CODEMP"
},
{
"name": "CODPROD"
},
{
"name": "CODGRUPOPROD"
},
{
"name": "CODLOCAL"
},
{
"name": "CODPROJ"
},
{
"name": "CODCENCUS"
},
{
"name": "CODNAT"
},
{
"name": "CODREG"
},
{
"name": "CODGER"
},
{
"name": "CODVEND"
},
{
"name": "CODPARC"
},
{
"name": "CODUF"
},
{
"name": "CODCID"
},
{
"name": "CODPAIS"
},
{
"name": "CODTIPPARC"
},
{
"name": "CONTROLE"
},
{
"name": "MARCA"
},
{
"name": "DIA"
},
{
"name": "CODGRUPONAT"
},
{
"name": "ConfiguracaoMeta_DESCRMETA"
},
{
"name": "Empresa_NOMEFANTASIA"
},
{
"name": "Produto_DESCRPROD"
},
{
"name": "GrupoProduto_DESCRGRUPOPROD"
},
{
"name": "LocalFinanceiro_DESCRLOCAL"
},
{
"name": "Projeto_IDENTIFICACAO"
},
{
"name": "CentroResultado_DESCRCENCUS"
},
{
"name": "Natureza_DESCRNAT"
},
{
"name": "Regiao_NOMEREG"
},
{
"name": "Gerente_APELIDO"
},
{
"name": "Vendedor_APELIDO"
},
{
"name": "Parceiro_NOMEPARC"
},
{
"name": "UnidadeFederativaOrigem_UF"
},
{
"name": "Cidade_NOMECID"
},
{
"name": "Pais_DESCRICAO"
},
{
"name": "Perfil_DESCRTIPPARC"
},
{
"name": "GrupoNaturezas_DESCRGRUPONAT"
}
]
}
},
"entity": [
{
"f30": {
"$": "<SEM VENDEDOR>"
},
"f10": {
"$": "0"
},
"f32": {
"$": "<SEM PARCEIRO>"
},
"f31": {
"$": "<SEM VENDEDOR>"
},
"f12": {
"$": "0"
},
"f34": {
"$": "<SEM DESCRIÇÃO>"
},
"f11": {
"$": "0"
},
"f33": {
"$": "0"
},
"f14": {
"$": "0"
},
"f36": {
"$": "<SEM TIPO PARCEIRO>"
},
"f13": {
"$": "0"
},
"f35": {
"$": "<SEM PAIS>"
},
"f0": {
"$": "48"
},
"f16": {
"$": "0"
},
"f1": {
"$": "01/04/0001"
},
"f15": {
"$": "0"
},
"f37": {
"$": "<SEM GRUPONATUREZA>"
},
"f2": {
"$": "1"
},
"f18": {},
"f3": {
"$": "368"
},
"f17": {},
"f4": {
"$": "0"
},
"f5": {
"$": "0"
},
"f19": {
"$": "0"
},
"f6": {
"$": "0"
},
"f7": {
"$": "0"
},
"f8": {
"$": "0"
},
"f9": {
"$": "0"
},
"f21": {
"$": "48-Metas sem componentes"
},
"f20": {
"$": "0"
},
"f23": {
"$": "COMPONENTE 2 - CESTA MASTER 1"
},
"f22": {
"$": "WCS PRESTAÇÃO DE SERVIÇOS"
},
"f25": {
"$": "<SEM LOCAL>"
},
"f24": {
"$": "<SEM GRUPO>"
},
"f27": {
"$": "<SEM CENTRO DE RESULTADO>"
},
"f26": {
"$": "<SEM PROJETO>"
},
"f29": {
"$": "<SEM REGIAO>"
},
"f28": {
"$": "<SEM NATUREZA>"
}
}
]
}
}
}