Regras de negócio

Um projeto pode ser definido como uma decisão empresarial cujos resultados devem ser apurados separadamente do restante do negócio, de modo a avaliar se aquela iniciativa estará gerando os resultados financeiros esperados.
Para realizar uma consulta de Projetos no ERP o usuário deverá efetuar cadastro preenchendo os campos obrigatórios.
Nota: As opções no sistema de "Ativo" e "Analítico" são automáticas do sistema, tem-se que estas já estarão marcadas na inclusão de um novo projeto. Nas demais rotinas do sistema, apenas serão aceitas as linhas "Analíticas", ou seja, os projetos analíticos.
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/360045109073-Projetos

Dependências

Não possui dependências

Detalhes Técnicos

A entidade utilizada é a Projeto que por sua vez instancia a tabela TCSPRJ mapeando os campos principais pertinentes ao cadastro de projeto.

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 CODPROJ, porém você pode utilizar outros campos da entidade.

Para utilizarmos o filtro para os campos citados acima, basta acrescentar o corpo da requisição o código abaixo utilizando o criteria:

    "criteria": {
      "expression": {
        "$": "this.CODPROJ = ?"
      },
      "parameters":[
        {
           "type":"I",
           "value":"7"
        }
      ]
    }

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 TCSPRJ

Exemplo de uso:

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

Corpo de requisição

{
  "serviceName": "CRUDServiceProvider.loadRecords",
  "requestBody": {
    "dataSet": {
      "rootEntity": "Projeto",
      "includePresentationFields": "S",
      "offsetPage": "0",
      "criteria": {
        "expression": {
          "$": "this.CODPROJ = ?"
        },
        "parameters":[
          {
             "type":"I",
             "value":"7"
          }
        ]
      },
      "entity": {
        "fieldset": {
          "list": "CODPROJ,IDENTIFICACAO"
        }
      }
    }
  }
}

Retorno em json:

{
  "serviceName": "CRUDServiceProvider.loadRecords",
  "status": "1",
  "pendingPrinting": "false",
  "transactionId": "C7A0275CD886A6FDFD9201917C9A60D5",
  "responseBody": {
      "entities": {
          "total": "1",
          "hasMoreResult": "false",
          "offsetPage": "0",
          "offset": "0",
          "metadata": {
              "fields": {
                  "field": [
                      {
                          "name": "CODPROJ"
                      },
                      {
                          "name": "IDENTIFICACAO"
                      }
                  ]
              }
          },
          "entity": {
              "f0": {
                  "$": "1020000"
              },
              "f1": {
                  "$": "Projeto 2"
              }
          }
      }
  }
}