Método gravarContato
- 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.
- Pré-condição:
Aglomeração cadastrada
Propriedade cadastrada
Estabelecimento cadastrado
OESA cadastrada
- Campos de Entrada:
Atributo |
Tipo de Dados |
Chave |
Regras |
Valor Padrão |
Observação |
ID_CONTATO |
NUMBER(10) |
PK |
|
Identificador único |
|
ID_AGLOMERACAO |
NUMBER(10) |
|
|
Identificador de Aglomeração |
|
ID_PROPRIEDADE |
VARCHAR(11) |
|
|
Identificador de Propriedade (Estabelecimento) Rural |
|
NR_CPF |
VARCHAR(14) |
|
|
Identificador de Pessoa Física |
|
NR_CPNJ |
VARCHAR(18) |
|
|
Identificador de Pessoa Jurídica |
|
ID_TIPO_CONTATO |
NUMBER(1) |
|
|
Tipo de Contato (Item 3.2.8) |
|
ID_ESTABELECIMENTO_POA |
NUMBER(10) |
|
|
Identificador de Estabelecimento de POA |
|
NR_CONTATO |
VARCHAR(9) |
|
|
Número de telefone de contato |
|
NR_DDD |
VARCHAR(2) |
|
|
Código DDD |
|
NR_DDI |
VARCHAR(2) |
|
|
|
Código DDI |
ID_OESA |
NUMBER(10) |
|
|
Identificador de OESA |
|
SYS_KEY |
VARCHAR(39) |
|
|
Chave de sistema do estado correspondente ao ambiente |
- Campos de Saída:
Nome do Campo |
Tipo de Dados |
Observação |
Mensagem |
Mensagem de Retorno |
|
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 |
- 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>
- 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>