Consulta de Metas por Produtos

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ências

Detalhes 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.

Para utilizarmos o filtro, basta acrescentar no corpo da requisição o código abaixo utilizando o criteria:
    "criteria": {
      "expression": {
        "$": "this.CODPROD = ?"
      },
      "parameter":[
        {
           "type":"I",
           "value":"368"
        }
      ]
    }

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 TGMMET

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": "MetaAtual",
      "includePresentationFields": "S",
      "offsetPage": "0",
    "criteria": {
      "expression": {
        "$": "this.CODPROD = ?"
      },
      "parameter":[
        {
           "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>"
                    }
                }
            ]
        }
    }
}
Language
Authorization
Header
URL
Click Try It! to start a request and see the response here!