Método gravarPtv
- Objetivo do Método:
Incluir informações de 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:
Responsável Técnico cadastrado.
Pessoa Física cadastra.
Pessoa Jurídica cadastrada.
- Campos de Entrada:
|
Atributo |
Tipo de Dados |
Chave |
Regras |
Valor Padrão |
Observação |
|
ID_PROTOCOLO_PTV |
NUMBER(10) |
PK |
|
Identificador único |
|
|
NR_PTV |
NUMBER(17) |
|
|
Número da PTV manual emitida |
|
|
ID_UF_ORIG |
NUMBER(2) |
|
|
Identificador da UF do CF (Item 3.2.2) |
|
|
DT_VALIDADE |
DATE(DDMMAAAA) |
|
|
Data prevista para a validade do certificado |
|
|
NR_CPF_ORIG |
VARCHAR(14) |
|
|
Identifica pessoa física de origem na emissão da PTV |
|
|
NR_CNPJ_ORIG |
VARCHAR(18) |
|
|
Identifica pessoa jurídica de origem na emissão da PTV |
|
|
NM_INTERESSADO_ORIG |
VARCHAR(150) |
|
|
Nome do interessado de origem da PTV. |
|
|
DS_ENDERECO_ORIG |
VARCHAR(150) |
|
|
Descrição do endereço de origem da PTV. |
|
|
ID_MUNICIPIO_ORIG |
NUMBER(7) |
|
|
Número IBGE do Município de origem da PTV |
|
|
NR_CPF_DEST |
NUMBER(11) |
|
|
Identifica pessoa física destinatária na emissão da PTV |
|
|
NR_CNPJ_DEST |
NUMBER(14) |
|
|
Identifica pessoa jurídica destinatária na emissão da PTV |
|
|
NM_INTERES_DESTINO |
VARCHAR(150) |
|
|
Nome do destinatário na emissão da PTV |
|
|
DS_ENDERECO_DEST |
VARCHAR(150) |
|
|
|
Descrição do Endereço do destinatário na emissão da PTV |
|
ID_UF_DEST |
NUMBER(2) |
|
|
Identificador da UF do CF (Item 3.2.2) |
|
|
ID_MUNICIPIO_DEST |
NUMBER(7) |
|
|
Número IBGE do Município de destino da PTV |
|
|
ID_RESPONSAVEL_TECNICO |
NUMBER(10) |
|
|
Identificação do Responsável Técnico |
|
|
ID_MEIO_TRANSPORTE |
VARCHAR (2) |
|
|
Identificar do Meio de Transporte (Item 3.2.30) |
|
|
DS_VEICULO |
VARCHAR(50) |
|
|
Identificação do Veículo |
|
|
ID_STATUS_PTV |
VARCHAR(2) |
|
|
Situação da PTV (Item 3.2.41) |
|
|
DT_CANCELAMENTO |
DATE(DDMMAAAA) |
|
|
|
Data do Cancelamento |
|
DS_MOTIVO_CANCELAMENTO |
VARCHAR(100) |
|
|
|
Motivo do Cancelamento |
|
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:gravarPtv>
<!--Optional:-->
<idProtocoloPtv>5300000001</idProtocoloPtv>
<!--Optional:-->
<nrPtv>123</nrPtv>
<!--Optional:-->
<idUfOrig>53</idUfOrig>
<!--Optional:-->
<nrCpfOrig>95439563083</nrCpfOrig>
<!--Optional:-->
<nmInteressadoOrig>Interessado Origem</nmInteressadoOrig>
<!--Optional:-->
<dsEnderecoOrig>Endereço Origem</dsEnderecoOrig>
<!--Optional:-->
<idMunicipioOrig>5300108</idMunicipioOrig>
<!--Optional:-->
<idUfDest>53</idUfDest>
<!--Optional:-->
<nrCnpjDest>96401289000120</nrCnpjDest>
<!--Optional:-->
<nmInteressadoDest>Interessado Destino</nmInteressadoDest>
<!--Optional:-->
<dsEnderecoDest>Endereço Destino</dsEnderecoDest>
<!--Optional:-->
<idMunicipioDest>5300108</idMunicipioDest>
<!--Optional:-->
<idResponsavelTecnico>5300000100</idResponsavelTecnico>
<!--Optional:-->
<idMeioTransporte>02</idMeioTransporte>
<!--Optional:-->
<dsVeiculo>Caminhão</dsVeiculo>
<!--Optional:-->
<idStatusPtv>01</idStatusPtv>
<!--Optional:-->
<dtValidade>31082020</dtValidade>
<!--Optional:-->
<dtCancelamento>01092020</dtCancelamento>
<!--Optional:-->
<dsMotivoCancelamento>S</dsMotivoCancelamento>
<!--Optional:-->
<sysKey>{Syskey do Estado}</sysKey>
</web:gravarPtv>
</soapenv:Body>
</soapenv:Envelope>
- Exemplo de XML de Saída:
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:gravarPtvResponse xmlns:ns2="http://webservice.ws.pga.id2.inf.br/">
<return><mensagem>MS0001</mensagem><status>SUCESSO</status></return>
</ns2:gravarPtvResponse>
</S:Body>
</S:Envelope>