Método gravarUnidadeProducao
- 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.
- Pré-condição:
Propriedade Rural cadastrada
Produto cadastrado
- Campos de Entrada:
Atributo |
Tipo de Dados |
Chave |
Regras |
Valor Padrão |
Observação |
ID_UNIDADE_PRODUCAO |
NUMBER(17) |
PK |
|
Identificador único |
|
ID_PROPRIEDADE |
NUMBER(11) |
|
|
Identificação da propriedade |
|
CS_PERENIDADE |
CHAR(1) |
|
|
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) |
|
|
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) |
|
|
Identificação do produto |
|
NR_AREA |
NUMBER(12,2) |
|
|
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) |
|
|
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: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>
- 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>