Método gravarPtvDocumentos
- Objetivo do Método:
Incluir informações de Documentos da Ptv. 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:
Ptv Produto cadastrado
Unidade Produção cadastrada
Unidade Consolidação cadastrada
- Campos de Entrada:
|
Atributo |
Tipo de Dados |
Chave |
Regras |
Valor Padrão |
Observação |
|
ID_PTV_DOCUMENTOS |
NUMBER(10) |
PK |
|
Identificador único do Registro |
|
|
ID_PTV_PRODUTO |
NUMBER(10) |
|
|
Identificação do produto da PTV. |
|
|
NR_CFO |
NUMBER(10) |
|
|
|
Número do CFO associado ao produto da PTV |
|
ID_UF_CFO |
NUMBER(2) |
|
|
Identificador da UF do CFO (Item 3.2.2) |
|
|
ID_UNIDADE_PRODUCAO_CFO |
NUMBER(17) |
|
|
|
Identificação da unidade de produção associada a uma CFO |
|
NR_CFOC |
NUMBER(10) |
|
|
|
Número do CFOC associado ao produto da PTV |
|
ID_UF_CFOC |
NUMBER(2) |
|
|
Identificador da UF de Outros Documentos (Item 3.2.2) |
|
|
ID_UNIDADE_CONSOLIDACAO_CFOC |
NUMBER(12) |
|
|
|
Identificação da unidade de consolidação da CFOC |
|
NR_PTV |
NUMBER(10) |
|
|
|
Número da PTV. |
|
ID_UF_PTV |
NUMBER(2) |
|
|
Identificador da UF da PTV (Item 3.2.2) |
|
|
ID_UNIDADE_PRODUCAO_PTV |
NUMBER(17) |
|
|
|
Identificação da unidade de produção da PTV |
|
NR_CF |
NUMBER(10) |
|
|
|
Número de CF associado ao produto da PTV |
|
ID_UF_CF |
NUMBER(2) |
|
|
Identificador da UF do CF associado ao produto da PTV (Item 3.2.2) |
|
|
NR_CFR |
NUMBER(10) |
|
|
|
Número de CFR associado ao produto da PTV |
|
ID_UF_CFR |
NUMBER(2) |
|
|
Identificador da UF do CFR ao produto da PTV (Item 3.2.2) |
|
|
NR_OUTROS |
NUMBER(10) |
|
|
|
Número do documento de origem associado ao produto da PTV |
|
ID_UF_OUTROS |
NUMBER(2) |
|
|
Identificador da UF de Outros Documentos (Item 3.2.2) |
|
|
DS_TIPO_OUTROS |
VARCHAR(20) |
|
|
|
Descrição do tipo de documento associado ao produto da PTV |
|
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:gravarPtvDocumentos>
<!--Optional:-->
<idPtvDocumentos>5300000001</idPtvDocumentos>
<!--Optional:-->
<idPtvProduto>5300000001</idPtvProduto>
<!--Optional:-->
<nrCf>123</nrCf>
<!--Optional:-->
<idUfCf>53</idUfCf>
<!--Optional:-->
<nrCfr>123</nrCfr>
<!--Optional:-->
<idUfCfr>53</idUfCfr>
<!--Optional:-->
<nrCfo>123</nrCfo>
<!--Optional:-->
<idUfCfo>53</idUfCfo>
<!--Optional:-->
<idUnidadeProducaoCfo>53000000000000001</idUnidadeProducaoCfo>
<!--Optional:-->
<nrCfoc>123</nrCfoc>
<!--Optional:-->
<idUfCfoc>53</idUfCfoc>
<!--Optional:-->
<idUnidadeConsolidacaoCfoc>530000000001</idUnidadeConsolidacaoCfoc>
<!--Optional:-->
<nrPtv>123</nrPtv>
<!--Optional:-->
<idUfPtv>53</idUfPtv>
<!--Optional:-->
<idUnidadeProducaoPtv>53000000000000001</idUnidadeProducaoPtv>
<!--Optional:-->
<nrOutros>123</nrOutros>
<!--Optional:-->
<idUfOutros>53</idUfOutros>
<!--Optional:-->
<dsTipoOutros>Outros</dsTipoOutros>
<!--Optional:-->
<sysKey>{Syskey do Estado}</sysKey>
</web:gravarPtvDocumentos>
</soapenv:Body>
</soapenv:Envelope>
- Exemplo de XML de Saída:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:gravarPtvDocumentosResponse xmlns:ns2="http://webservice.ws.pga.id2.inf.br/">
<return><mensagem>MS0001</mensagem><status>SUCESSO</status></return>
</ns2:gravarPtvDocumentosResponse>
</S:Body>
</S:Envelope>