Método gravarCfoc
- Objetivo do Método:
Incluir informações de um Cfoc. 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:
Unidade Consolidação cadastrada
Responsável Técnico cadastrado
Produtor Up cadastrado
Carga Uc cadastrada
- Campos de Entrada:
Atributo |
Tipo de Dados |
Chave |
Regras |
Valor Padrão |
Observação |
ID_PROTOCOLO_CFOC |
NUMBER(10) |
PK |
|
Identificador único |
|
NR_CFOC |
NUMBER(10) |
|
|
Número do CFOC |
|
ID_UF |
NUMBER(2) |
|
|
Identificador da UF do CFOC (Item 3.2.2) |
|
ID_UNIDADE_CONSOLIDACAO |
UMBER(12) |
|
|
Número identificador da unidade de consolidação agrupadora do lote a ser consolidado |
|
ID_RESPONSAVEL_TECNICO |
NUMBER(10) |
|
|
Identifica os responsáveis técnicos habilitados a atuar junto a uma unidade de produção e/ou consolidação |
|
CS_PARTIDA_LACRADA |
CHAR(1) |
|
|
Indica que o contêiner ou outro modo de acondicionamento do produto recebeu um lacre no momento da partida, assumindo os domínios: S - Sim N – Não |
|
DS_CONTEINER |
VARCHAR(15) |
|
|
|
Código do equipamento utilizado para transportar a carga. Trata-se de um recipiente de metal ou madeira, geralmente de grandes dimensões, destinado ao acondicionamento e transporte de carga em navios, trens, etc. |
DS_PORAO |
VARCHAR(15) |
|
|
|
Código que identifica o porão utilizado para o transporte de carga do produto referenciada no certificado. Porão pode ser um pequeno espaço situado abaixo do primeiro pavimento de uma embarcação, onde são acondicionadas as cargas |
DS_LACRE |
VARCHAR(30) |
|
|
|
Código que identifica uma espécie de dispositivo ou fecho segurança de uma embalagem, contêiner, etc. Este campo será obrigatório caso o indicador de transporte com partida lacrada seja igual a “S” |
DT_VALIDADE |
DATE(DDMMAAAA) |
|
|
Data de Validade |
|
DT_CANCELAMENTO |
DATE(DDMMAAAA) |
|
|
|
Data do Cancelamento |
DS_MOTIVO_CANCELAMENTO |
VARCHAR(100) |
|
|
|
Motivo do Cancelamento |
ID_PRODUTOR_UP |
NUMBER(10) |
|
|
|
Identifica o produtor que cultivou/produziu o produto referenciado no certificado fitossanitário de origem |
ID_CARGA_UC |
NUMBER(10) |
|
|
|
Identificador da carga associada a unidade de consolidação. |
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:gravarCfoc>
<!--Optional:-->
<idProtocoloCfoc>5300000002</idProtocoloCfoc>
<!--Optional:-->
<nrCfoc>002</nrCfoc>
<!--Optional:-->
<idUf>53</idUf>
<!--Optional:-->
<idResponsavelTecnico>5300000100</idResponsavelTecnico>
<!--Optional:-->
<idUnidadeConsolidacao>530000000001</idUnidadeConsolidacao>
<!--Optional:-->
<idProdutorUp>5300000001</idProdutorUp>
<!--Optional:-->
<idCargaUc>5300000001</idCargaUc>
<!--Optional:-->
<csPartidaLacrada>S</csPartidaLacrada>
<!--Optional:-->
<dsConteiner>S</dsConteiner>
<!--Optional:-->
<dsPorao>S</dsPorao>
<!--Optional:-->
<dsLacre>S</dsLacre>
<!--Optional:-->
<dtValidade>01012021</dtValidade>
<!--Optional:-->
<dtCancelamento>01022021</dtCancelamento>
<!--Optional:-->
<dsMotivoCancelamento>S</dsMotivoCancelamento>
<!--Optional:-->
<sysKey>{Syskey do Estado}</sysKey>
</web:gravarCfoc>
</soapenv:Body>
</soapenv:Envelope>
- Exemplo de XML de Saída:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:gravarCfocResponse xmlns:ns2="http://webservice.ws.pga.id2.inf.br/">
<return><mensagem>MS0001</mensagem><status>SUCESSO</status></return>
</ns2:gravarCfocResponse>
</S:Body>
</S:Envelope>