1. Objetivo do Método:


Incluir o Proprietário da Unidade de Produção. Para realizar uma alteração em um registro, basta que o método de inserção seja usado. O WS ao localizar um registro já existente irá realizar o merge (mescla) das informações, atualizando os dados.


  1. Pré-condição:


Propriedade Rural cadastrada

Produto cadastrado


  1. Campos de Entrada:


Atributo

Tipo de Dados

Chave

Regras

Valor Padrão

Observação

ID_UNIDADE_PRODUCAO

NUMBER(17)

PK

RN02, RN05, RN10


Identificador único

ID_PROPRIEDADE

NUMBER(11)


RN02


Identificação da propriedade 

CS_PERENIDADE

CHAR(1)


RN02


Atributo que indica o status do tipo de cultivo quanto a perenidade, sendo: S – Sim N – Não 

DS_LOCAL_LIVRO

VARCHAR(100)




Indica o local físico onde se encontra o livro de registro da unidade 

ID_TIPO_PRODUCAO

NUMBER(1)


RN02


Contém o domínio possível para os tipos de produção de uma unidade de produção, sendo: 1 – Padrão 2 – Agroextrativismo 3 – Plantas ornamentais, oleícolas e medicinais 

DT_PLANTIO

DATE(DDMMAAAA)




Data do plantio 

ID_PRODUTO

VARCHAR(10)


RN02


Identificação do produto 

NR_AREA

NUMBER(12,2)


RN02


Contém a área da unidade de produção em hectares (hc) 

DS_SITUACAO

VARCHAR(7)




Especificar se o registro está ativo ou inativo.

SYS_KEY

VARCHAR(39)


RN02, RN06


Chave de sistema do estado correspondente ao ambiente


  1. Campos de Saída:


Nome do Campo

Tipo de Dados

Observação

Mensagem

Mensagem de Retorno

Ver Item 3.1

Status

Status do Retorno

ERRO: Quando há alguma falha no resultado, ou o resultado esperado não é alcançado

SUCESS: Quando o resultado esperado é alcançado


  1. Exemplo de XML de Entrada:


O XML do método, gerado pelo WSDL, apresentará o sinal “?” para as tags. O “?” deverá ser substituído pelo valor do campo correspondente. 

IMPORTANTE: Caso o campo não tenha valor, o mesmo não deverá ser enviado, sob pena de geração de erro na tentativa de consumo do método.


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.ws.pga.id2.inf.br/">

   <soapenv:Header/>

   <soapenv:Body>

      <web:gravarUnidadeProducao>

         <!--Optional:-->

         <idUnidadeProducao>53000000000000001</idUnidadeProducao>

         <!--Optional:-->

         <propriedadeRural>53000000001</propriedadeRural>

         <!--Optional:-->

         <csPeneridade>S</csPeneridade>

         <!--Optional:-->

         <dsLocalLivro>Local do Livro</dsLocalLivro>

         <!--Optional:-->

         <tipoProducao>1</tipoProducao>

         <!--Optional:-->

         <dtPlantio>20072020</dtPlantio>

         <!--Optional:-->

         <idProduto>5300000002</idProduto>

         <!--Optional:-->

         <nrArea>100</nrArea>

         <!--Optional:-->

         <dsSituacao>Ativo</dsSituacao>

         <!--Optional:-->

         <sysKey>{Syskey do Estado}</sysKey>

      </web:gravarUnidadeProducao>

   </soapenv:Body>

</soapenv:Envelope>


  1. Exemplo de XML de Saída:


<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">

   <S:Body>

      <ns2:gravarUnidadeProducaoResponse xmlns:ns2="http://webservice.ws.pga.id2.inf.br/">

         <return><mensagem>MS0001</mensagem><status>SUCESSO</status></return>

      </ns2:gravarUnidadeProducaoResponse>

   </S:Body>

</S:Envelope>