Regras de negócio

Para realizar consulta de veículos é necessário efetuar cadastro pois é primordial para funcionamento da rotina de controle de veículos.Depois de efetuados os cadastros corretamente e realizados os lançamentos dos devidos registros como por exemplo, nota de compra, despesas ou requisições referentes ao veículo.
Nota: É possível realizar o cadastro de vários veículos no ERP para o mesmo produto desde que o código vinculado seja diferente uns dos outros. Por outro lado, caso seja cadastrado outro veículo com o mesmo Produto e Código do bem já utilizado,será apresentada a seguinte mensagem no sistema.
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/360045111533-Ve%C3%ADculos-

Dependências

Não possui dependências

Detalhes Técnicos

A entidade utilizada é a Veiculo que por sua vez instancia a tabela TGFVEI 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 CODPARC, para poder pesquisar os veículos cadastrados dos parceiros, porém você pode utilizar outros campos da entidade .

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

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

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 TGFVEI

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": "Veiculo",
      "includePresentationFields": "N",
      "offsetPage": "0",
      "criteria": {
        "expression": {
          "$": "this.CODPARC = ?"
        },
        "parameters":[
          {
             "type":"I",
             "value":"1"
          }
        ]
      },
      "entity": {
        "fieldset": {
              "list":"CODPARC,CODVEICULO,PLACA,MARCAMODELO,ANOFABRIC"
        }
      }
    }
  }
}

Retorno em json:

{
    "serviceName": "CRUDServiceProvider.loadRecords",
    "status": "1",
    "pendingPrinting": "false",
    "transactionId": "E5FFE235E263FE4F4396735332007FA2",
    "responseBody": {
        "entities": {
            "total": "11",
            "hasMoreResult": "false",
            "offsetPage": "0",
            "offset": "0",
            "metadata": {
                "fields": {
                    "field": [
                        {
                            "name": "CODPARC"
                        },
                        {
                            "name": "CODVEICULO"
                        },
                        {
                            "name": "PLACA"
                        },
                        {
                            "name": "MARCAMODELO"
                        },
                        {
                            "name": "ANOFABRIC"
                        }
                    ]
                }
            },
            "entity": [
                {
                    "f0": {
                        "$": "1"
                    },
                    "f1": {
                        "$": "1"
                    },
                    "f2": {
                        "$": "AAAA123"
                    },
                    "f3": {
                        "$": "VM"
                    },
                    "f4": {
                        "$": "2012"
                    }
                }
            ]
        }
    }
}