1. Objetivo do Método:


Inscrever informações de um Contato. 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:


Aglomeração cadastrada

Propriedade cadastrada

Estabelecimento cadastrado

OESA cadastrada


  1. Campos de Entrada:


Atributo

Tipo de Dados

Chave

Regras

Valor Padrão

Observação

ID_CONTATO

NUMBER(10)

PK

RN02, RN05, RN09


Identificador único

ID_AGLOMERACAO

NUMBER(10)


RN11, RN09


Identificador de Aglomeração

ID_PROPRIEDADE

VARCHAR(11)


RN11, RN10


Identificador de Propriedade (Estabelecimento) Rural

NR_CPF

VARCHAR(14)


RN11, RN07


Identificador de Pessoa Física

NR_CPNJ

VARCHAR(18)


RN11, RN08


Identificador de Pessoa Jurídica

ID_TIPO_CONTATO

NUMBER(1)


RN02, RN04


Tipo de Contato (Item 3.2.8)

ID_ESTABELECIMENTO_POA

NUMBER(10)


RN11, RN09


Identificador de Estabelecimento de POA

NR_CONTATO

VARCHAR(9)


RN02


Número de telefone de contato

NR_DDD

VARCHAR(2)


RN02


Código DDD

NR_DDI

VARCHAR(2)




Código DDI

ID_OESA

NUMBER(10)


RN09


Identificador de OESA

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:gravarContato>

         <!--Optional:-->

         <idContato>5300000001</idContato>

         <!--Optional:-->

         <idAglomeracao>?</idAglomeracao>

         <!--Optional:-->

         <idPropriedade>53000000001</idPropriedade>

         <!--Optional:-->

         <idOesa>5300000002</idOesa>

         <!--Optional:-->

         <nrCpf>33456871198</nrCpf>

         <!--Optional:-->

         <nrCnpj>47868328000198</nrCnpj>

         <!--Optional:-->

         <idTipoContato>01</idTipoContato>

         <!--Optional:-->

         <idEstabelecimentoPoa>?</idEstabelecimentoPoa>

         <!--Optional:-->

         <nrContato>999999999</nrContato>

         <!--Optional:-->

         <nrDdd>61</nrDdd>

         <!--Optional:-->

         <nrDdi>55</nrDdi>

         <!--Optional:-->

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

      </web:gravarContato>

   </soapenv:Body>

</soapenv:Envelope>


  1. Exemplo de XML de Saída:


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

   <S:Body>

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

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

      </ns2:gravarContatoResponse>

   </S:Body>

</S:Envelope>