PUBLICAÇÃO WEB SERVICE REST DO CADASTRO DE TALHÕES (APENAS CONSULTA)

Características do Requisito

Pré-requisito

  No que diz respeito ao sistema, a funcionalidade de integração está funcional. Porém, é necessário configurar o AppServer para que o Protheus disponibilize a URL de acesso ao serviço de Web Service REST do sistema. Uma vez configurado o serviço, a integração está pronta para ser utilizada.

  Para isso, segue link para consulta: 1. Configuração do REST do Protheus

Descrição

  Para os usuários que possuem algum aplicativo customizado, e que precisam efetuar a consulta de talhões no produto Gestão Agroindústria (SIGAAGR), foi disponibilizado o método Web Service REST. 

Método Publicado

_{OBS: Para esta rotina, somente a consulta foi disponibilizada, o cadastro não é possível via REST.}

Exemplo de Utilização

Para realizar testes, pode-se utilizar qualquer programa de sua preferência, que teste API Web Service REST. O SoapUI e a extensão Postman do Navegador Chrome são exemplos de bons programas para isso. 

Consultando informações

Abaixo, uma consulta dos dados da tabela NN3 e NN4 através do método GET.

Caso se deseje filtrar os resultados que serão trazidos, basta colocar as regras nos params. Porém, por se tratar de duas tabelas (pai - filho), um parâmetro é obrigatório (FIRSTLEVEL = FALSE) para que o retorno da consulta contemple os dados por completo.

Existem várias possibilidades de se restringir quais dados o GET irá retornar. Segue link da documentação relativa a este assunto: http://tdn.totvs.com.br/pages/viewpage.action?pageId=271671548

Campo: NN3_SAFRA, Tipo: Caracter, Tamanho: 15, Descrição: Código da Safra;

Campo: NN3_FAZ, Tipo: Caracter, Tamanho: 2, Descrição: Código da Fazenda;

Campo: NN3_TALHAO, Tipo: Caracter, Tamanho: 16, Descrição: Código do Talhão;

Campo: NN3_DESCRI, Tipo: Caracter, Tamanho: 40, Descrição: Descrição do Talhão;

Campo: NN3_HECTAR, Tipo: Numérico, Tamanho: 7 Inteiros e 2 Decimais, Descrição: Quantidade de Hectares;

Campo: NN3_PLANT, Tipo: Caracter, Tamanho: 1, Descrição: Sistema de Cultivo;

Campo: NN3_CODPRO, Tipo: Caracter, Tamanho: 15, Descrição: Código do Produto;

Campo: NN3_UM1PRO, Tipo: Caracter, Tamanho: 2, Descrição: Unidade de Medida;

Campo: NN3_FECHAD, Tipo: Caracter, Tamanho: 1, Descrição: Indica se está fechado (S=Sim;N=Não);

Campo: NN4_FILIAL, Tipo: Caracter, Tamanho: 2, Descrição: Filial do Sistema;

Campo: NN4_SAFRA, Tipo: Caracter, Tamanho: 15, Descrição: Código da Safra;

Campo: NN4_FAZ, Tipo: Caracter, Tamanho: 2, Descrição: Código da Fazenda;

Campo: NN4_TALHAO, Tipo: Caracter, Tamanho: 16, Descrição: Código do Talhão;

Campo: NN4_ITEM, Tipo: Caracter, Tamanho: 2, Descrição: Item da Variedade;

Campo: NN4_CODVAR, Tipo: Caracter, Tamanho: 6, Descrição: Código da Variedade;

Campo: NN4_DESVAR, Tipo: Caracter, Tamanho: 20, Descrição: Descrição da Variedade;

Campo: NN4_HECTAR, Tipo: Caracter, Tamanho: 11 Inteiros e 2 Decimais, Descrição: Quantidade de Hectares;