Método gravarPropriedadeRural
- Objetivo do Método:
Inscrever uma Propriedade Rural. 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:
OESA cadastrada
- Campos de Entrada:
|
Atributo |
Tipo de Dados |
Chave |
Regras |
Valor Padrão |
Observação |
|
ID_PROPRIEDADE |
VARCHAR(11) |
PK |
|
Identificador único |
|
|
ID_UF |
NUMBER(2) |
|
|
Número IBGE da UF (Item 3.2.2) |
|
|
ID_MUNICIPIO_IBGE |
NUMBER(7) |
|
|
Número IBGE do Município |
|
|
ID_OESA |
NUMBER(10) |
|
|
Número do OESA responsável pela Propriedade (Estabelecimento Rural) |
|
|
ID_IDENT_RISCO |
NUMBER(1) |
|
|
Estabelecimento Rural de Risco (Item 3.2.16) |
|
|
NM_PROPRIEDADE |
VARCHAR(100) |
|
0 |
Nome do Estabelecimento Rural |
|
|
NR_SISBOV |
VARCHAR(1) |
|
0 |
Identificador de Estabeleciemento Rural SISBOV |
|
|
NR_ERAS |
VARCHAR(1) |
|
|
|
Identificador de Estabeleciemnto Rural ERAS |
|
NR_NIRF |
VARCHAR(8) |
|
|
|
Número do Imóvel na Receita Federal |
|
NR_INCRA |
VARCHAR(13) |
|
|
|
Instituto Nacional de Colonização e Reforma Agrária |
|
NR_ORGEM_PROGRESSO |
VARCHAR(11) |
|
|
|
Número de Ordem e Progresso |
|
NR_AREA_TOTAL |
NUMBER(20,4) |
|
|
|
Área Total do Estabelecimento Rural, numérica, do tipo decimal, utilizando (.) como separador |
|
DS_ENDERECO |
VARCHAR(60) |
|
|
|
Descrição do endereço |
|
DS_VIA_ACESSO |
VARCHAR(200) |
|
|
|
Via de acesso ao Estabelecimento Rural |
|
NR_DIST_SEDE |
NUMBER(9,2) |
|
|
Distância da Sede em KM |
|
|
IN_CONDICAO_BLOQ |
VARCHAR(1) |
|
0 |
Condição de Bloqueio quanto a receber ou emitir GTA (Item 3.2.26) |
|
|
NM_CONTATO |
VARCHAR(150) |
|
|
|
Nome de Pessoa de Contato |
|
NM_EMAIL |
VARCHAR(250) |
|
|
|
E-mail para contato |
|
DS_SITUACAO |
VARCHAR(7) |
|
|
Especifica se o registro está ativo ou inativo (Item 3.2.38) |
|
|
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:gravarPropriedadeRural>
<!--Optional:-->
<idPropriedade>53000000001</idPropriedade>
<!--Optional:-->
<idUf>53</idUf>
<!--Optional:-->
<idIdentRisco>2</idIdentRisco>
<!--Optional:-->
<idMunicipioIbge>5300108</idMunicipioIbge>
<!--Optional:-->
<idOesa>5300000001</idOesa>
<!--Optional:-->
<nmPropriedade>Fezenda de Teste 1</nmPropriedade>
<!--Optional:-->
<nrSisbov>0</nrSisbov>
<!--Optional:-->
<nrEras>0</nrEras>
<!--Optional:-->
<nrNirf>12345678</nrNirf>
<!--Optional:-->
<nrIncra>1234567891011</nrIncra>
<!--Optional:-->
<nrOrdemProgresso>12345678910</nrOrdemProgresso>
<!--Optional:-->
<nrAreaTotal>171.171</nrAreaTotal>
<!--Optional:-->
<dsEndereco>Endereço de Teste</dsEndereco>
<!--Optional:-->
<dsViaAcesso>Via de Teste</dsViaAcesso>
<!--Optional:-->
<nrDistSede>1,71</nrDistSede>
<!--Optional:-->
<inCondicaoBloq>0</inCondicaoBloq>
<!--Optional:-->
<nmContato>999999999</nmContato>
<!--Optional:-->
<nmEmail>testeER1@teste.com</nmEmail>
<!--Optional:-->
<dsSituacao>ATIVO</dsSituacao>
<!--Optional:-->
<sysKey>{Syskey do Estado}</sysKey>
</web:gravarPropriedadeRural>
</soapenv:Body>
</soapenv:Envelope>
- Exemplo de XML de Saída
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:gravarPropriedadeRuralResponse xmlns:ns2="http://webservice.ws.pga.id2.inf.br/">
<return><mensagem>MS0001</mensagem><status>SUCESSO</status></return>
</ns2:gravarPropriedadeRuralResponse>
</S:Body>
</S:Envelope>