WS_GUARDIAN Web Service

WS_GUARDIAN

Click here for a complete list of operations.

AlteraVeiculo

[INTERFACE]
Este método é responsável por:

Alterar o cadastro de um veículo no banco.

A pré-condição para a execução deste web método é que veículo esteja cadastrado no banco.

Para alterar o veículo é necessário preencher alguns campos da estrutura VODadosCadastraAlteraVeiculo.

As descrições dos campos podem ser conferidas nos VOs: VODadosCadastraAlteraVeiculo, VORetornoCadastraAlteraVeiculo.

O web método verifica as seguintes configurações gerais na validação:
- Configurações para Cadastro de Veículos nas Configurações do Sistema: Obrigar associação de identificador e Obrigar associação de fluxo;
- Considerar Placa da carreta sempre igual a placa do veículo, nas Configurações do Sistema (se ativada, não altera a Placa da Carreta);

O web método verifica as seguintes configurações de operação na validação:
- Formato e Tipo de Placas(Tipo de Balança e Máscara), marcados na configuração da operação de Pré-cadastro (que a integração utilizará);
- Campos Obrigatórios, marcados na configuração de campos da operação de Pré-Cadastro (que a integração utilizará).

Obs.1: Também é verificado se as placas e o identificador (tag) já existem ou estão associados.

Obs.2: Assim como pela tela, não é possível alterar Código e Placa do Veículo.

Obs.3: Para os dados que não possuem uma opção em (VOConfiguracaoAlteraVeiculo), preencher conforme a documentação da sua respectiva tabela.

Parâmetros de entrada:
- VOConfiguracaoAlteraVeiculo (VOConfiguracaoAlteraVeiculo ) = Obrigatório - Configuração para a tomada de decisão se necessário.
- VODadosCadastraAlteraVeiculo (VODadosCadastraAlteraVeiculo ) = Obrigatório - Conforme a definição da estrutura VODadosCadastraAlteraVeiculo.
Retornos:
-
- VORetornoCadastraAlteraVeiculo (VORetornoCadastraAlteraVeiculo ) = Retorno do resultado da execução do web método. Erro = 0, indicação de sucesso. Qualquer valor diferente disto indica falha na execução.

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /WS_GUARDIAN_625/WS_GUARDIAN_PLUS.asmx HTTP/1.1
Host: services.toledobrasil.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://toledobrasil.com.br/WS_Guardian/AlteraVeiculo"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AlteraVeiculo xmlns="http://toledobrasil.com.br/WS_Guardian">
      <VOConfiguracaoAlteraVeiculo>
        <ConfiguracaoOpcoesVeiculo>
          <OpcaoIdentificador>int</OpcaoIdentificador>
          <OpcaoIdentificadores>int</OpcaoIdentificadores>
          <OpcaoItens>int</OpcaoItens>
          <OpcaoCamposAdicionais>int</OpcaoCamposAdicionais>
          <OpcaoCarretasSecundarias>int</OpcaoCarretasSecundarias>
          <OpcaoTipoVeiculo>int</OpcaoTipoVeiculo>
          <OpcaoFluxo>int</OpcaoFluxo>
          <OpcaoEmissor>int</OpcaoEmissor>
          <OpcaoMotorista>int</OpcaoMotorista>
          <OpcaoTransportadora>int</OpcaoTransportadora>
          <OpcaoFatorCorrecao>int</OpcaoFatorCorrecao>
        </ConfiguracaoOpcoesVeiculo>
      </VOConfiguracaoAlteraVeiculo>
      <VODadosCadastraAlteraVeiculo>
        <Veiculo>
          <FluxoAtualizacaoTara>
            <Codigo>string</Codigo>
          </FluxoAtualizacaoTara>
          <Transportadora>
            <Codigo>string</Codigo>
            <Descricao>string</Descricao>
            <RazaoSocial>string</RazaoSocial>
            <Cnpj>string</Cnpj>
            <InscricaoEstadual>string</InscricaoEstadual>
            <Endereco>string</Endereco>
            <Complemento>string</Complemento>
            <Municipio>string</Municipio>
            <UF>string</UF>
            <Cep>string</Cep>
            <Telefone>string</Telefone>
            <Email>string</Email>
            <Observacao>string</Observacao>
            <Estado>int</Estado>
            <TipoDocumento>int</TipoDocumento>
          </Transportadora>
          <Emissor>
            <Codigo>string</Codigo>
            <TipoEmissor>int</TipoEmissor>
            <RazaoSocial>string</RazaoSocial>
            <Descricao>string</Descricao>
            <Cnpj>string</Cnpj>
            <InscricaoEstadual>string</InscricaoEstadual>
            <Endereco>string</Endereco>
            <Complemento>string</Complemento>
            <Municipio>string</Municipio>
            <UF>string</UF>
            <Cep>string</Cep>
            <Telefone>string</Telefone>
            <Email>string</Email>
            <Observacao>string</Observacao>
            <Estado>int</Estado>
            <TipoDocumento>int</TipoDocumento>
          </Emissor>
          <Motorista>
            <PaisOrigem xsi:nil="true" />
            <Arquivos xsi:nil="true" />
            <Emissor xsi:nil="true" />
          </Motorista>
          <TipoVeiculo>
            <Codigo>string</Codigo>
          </TipoVeiculo>
          <Fluxo>
            <Codigo>string</Codigo>
          </Fluxo>
          <ListaItens>
            <VOItemIntegracao xsi:nil="true" />
            <VOItemIntegracao xsi:nil="true" />
          </ListaItens>
          <ListaIdentificadoresVeiculo>
            <VOIdentificadorVeiculoIntegracao xsi:nil="true" />
            <VOIdentificadorVeiculoIntegracao xsi:nil="true" />
          </ListaIdentificadoresVeiculo>
          <ListaAtualizacaoTara>
            <VOAtualizacaoTaraIntegracao xsi:nil="true" />
            <VOAtualizacaoTaraIntegracao xsi:nil="true" />
          </ListaAtualizacaoTara>
          <ListaCamposAdicionais>
            <VOValorCampoAdicionalIntegracao xsi:nil="true" />
            <VOValorCampoAdicionalIntegracao xsi:nil="true" />
          </ListaCamposAdicionais>
          <ListaCarretasSecundarias>
            <VOPlacaSecundaria xsi:nil="true" />
            <VOPlacaSecundaria xsi:nil="true" />
          </ListaCarretasSecundarias>
          <FatorCorrecao>
            <TipoFatorCorrecao>int</TipoFatorCorrecao>
            <CodigoTabela>string</CodigoTabela>
            <ListaFatorCorrecao xsi:nil="true" />
          </FatorCorrecao>
          <FatorConversao>decimal</FatorConversao>
          <UnidadeAposConversao>string</UnidadeAposConversao>
        </Veiculo>
      </VODadosCadastraAlteraVeiculo>
    </AlteraVeiculo>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AlteraVeiculoResponse xmlns="http://toledobrasil.com.br/WS_Guardian">
      <VORetornoCadastraAlteraVeiculo>
        <VORetornoCadastraAlteraVeiculo>
          <Veiculo>
            <Sequencial>int</Sequencial>
            <Data>dateTime</Data>
            <FluxoAtualizacaoTara xsi:nil="true" />
            <Transportadora xsi:nil="true" />
            <Emissor xsi:nil="true" />
            <Motorista xsi:nil="true" />
            <TipoVeiculo xsi:nil="true" />
            <Fluxo xsi:nil="true" />
            <ListaItens xsi:nil="true" />
            <ListaIdentificadoresVeiculo xsi:nil="true" />
            <ListaAtualizacaoTara xsi:nil="true" />
            <ListaCamposAdicionais xsi:nil="true" />
            <ListaCarretasSecundarias xsi:nil="true" />
            <FatorCorrecao xsi:nil="true" />
            <FatorConversao>decimal</FatorConversao>
            <UnidadeAposConversao>string</UnidadeAposConversao>
          </Veiculo>
        </VORetornoCadastraAlteraVeiculo>
        <VORetornoCadastraAlteraVeiculo>
          <Veiculo>
            <Sequencial>int</Sequencial>
            <Data>dateTime</Data>
            <FluxoAtualizacaoTara xsi:nil="true" />
            <Transportadora xsi:nil="true" />
            <Emissor xsi:nil="true" />
            <Motorista xsi:nil="true" />
            <TipoVeiculo xsi:nil="true" />
            <Fluxo xsi:nil="true" />
            <ListaItens xsi:nil="true" />
            <ListaIdentificadoresVeiculo xsi:nil="true" />
            <ListaAtualizacaoTara xsi:nil="true" />
            <ListaCamposAdicionais xsi:nil="true" />
            <ListaCarretasSecundarias xsi:nil="true" />
            <FatorCorrecao xsi:nil="true" />
            <FatorConversao>decimal</FatorConversao>
            <UnidadeAposConversao>string</UnidadeAposConversao>
          </Veiculo>
        </VORetornoCadastraAlteraVeiculo>
      </VORetornoCadastraAlteraVeiculo>
    </AlteraVeiculoResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /WS_GUARDIAN_625/WS_GUARDIAN_PLUS.asmx HTTP/1.1
Host: services.toledobrasil.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <AlteraVeiculo xmlns="http://toledobrasil.com.br/WS_Guardian">
      <VOConfiguracaoAlteraVeiculo>
        <ConfiguracaoOpcoesVeiculo>
          <OpcaoIdentificador>int</OpcaoIdentificador>
          <OpcaoIdentificadores>int</OpcaoIdentificadores>
          <OpcaoItens>int</OpcaoItens>
          <OpcaoCamposAdicionais>int</OpcaoCamposAdicionais>
          <OpcaoCarretasSecundarias>int</OpcaoCarretasSecundarias>
          <OpcaoTipoVeiculo>int</OpcaoTipoVeiculo>
          <OpcaoFluxo>int</OpcaoFluxo>
          <OpcaoEmissor>int</OpcaoEmissor>
          <OpcaoMotorista>int</OpcaoMotorista>
          <OpcaoTransportadora>int</OpcaoTransportadora>
          <OpcaoFatorCorrecao>int</OpcaoFatorCorrecao>
        </ConfiguracaoOpcoesVeiculo>
      </VOConfiguracaoAlteraVeiculo>
      <VODadosCadastraAlteraVeiculo>
        <Veiculo>
          <FluxoAtualizacaoTara>
            <Codigo>string</Codigo>
          </FluxoAtualizacaoTara>
          <Transportadora>
            <Codigo>string</Codigo>
            <Descricao>string</Descricao>
            <RazaoSocial>string</RazaoSocial>
            <Cnpj>string</Cnpj>
            <InscricaoEstadual>string</InscricaoEstadual>
            <Endereco>string</Endereco>
            <Complemento>string</Complemento>
            <Municipio>string</Municipio>
            <UF>string</UF>
            <Cep>string</Cep>
            <Telefone>string</Telefone>
            <Email>string</Email>
            <Observacao>string</Observacao>
            <Estado>int</Estado>
            <TipoDocumento>int</TipoDocumento>
          </Transportadora>
          <Emissor>
            <Codigo>string</Codigo>
            <TipoEmissor>int</TipoEmissor>
            <RazaoSocial>string</RazaoSocial>
            <Descricao>string</Descricao>
            <Cnpj>string</Cnpj>
            <InscricaoEstadual>string</InscricaoEstadual>
            <Endereco>string</Endereco>
            <Complemento>string</Complemento>
            <Municipio>string</Municipio>
            <UF>string</UF>
            <Cep>string</Cep>
            <Telefone>string</Telefone>
            <Email>string</Email>
            <Observacao>string</Observacao>
            <Estado>int</Estado>
            <TipoDocumento>int</TipoDocumento>
          </Emissor>
          <Motorista>
            <PaisOrigem xsi:nil="true" />
            <Arquivos xsi:nil="true" />
            <Emissor xsi:nil="true" />
          </Motorista>
          <TipoVeiculo>
            <Codigo>string</Codigo>
          </TipoVeiculo>
          <Fluxo>
            <Codigo>string</Codigo>
          </Fluxo>
          <ListaItens>
            <VOItemIntegracao xsi:nil="true" />
            <VOItemIntegracao xsi:nil="true" />
          </ListaItens>
          <ListaIdentificadoresVeiculo>
            <VOIdentificadorVeiculoIntegracao xsi:nil="true" />
            <VOIdentificadorVeiculoIntegracao xsi:nil="true" />
          </ListaIdentificadoresVeiculo>
          <ListaAtualizacaoTara>
            <VOAtualizacaoTaraIntegracao xsi:nil="true" />
            <VOAtualizacaoTaraIntegracao xsi:nil="true" />
          </ListaAtualizacaoTara>
          <ListaCamposAdicionais>
            <VOValorCampoAdicionalIntegracao xsi:nil="true" />
            <VOValorCampoAdicionalIntegracao xsi:nil="true" />
          </ListaCamposAdicionais>
          <ListaCarretasSecundarias>
            <VOPlacaSecundaria xsi:nil="true" />
            <VOPlacaSecundaria xsi:nil="true" />
          </ListaCarretasSecundarias>
          <FatorCorrecao>
            <TipoFatorCorrecao>int</TipoFatorCorrecao>
            <CodigoTabela>string</CodigoTabela>
            <ListaFatorCorrecao xsi:nil="true" />
          </FatorCorrecao>
          <FatorConversao>decimal</FatorConversao>
          <UnidadeAposConversao>string</UnidadeAposConversao>
        </Veiculo>
      </VODadosCadastraAlteraVeiculo>
    </AlteraVeiculo>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <AlteraVeiculoResponse xmlns="http://toledobrasil.com.br/WS_Guardian">
      <VORetornoCadastraAlteraVeiculo>
        <VORetornoCadastraAlteraVeiculo>
          <Veiculo>
            <Sequencial>int</Sequencial>
            <Data>dateTime</Data>
            <FluxoAtualizacaoTara xsi:nil="true" />
            <Transportadora xsi:nil="true" />
            <Emissor xsi:nil="true" />
            <Motorista xsi:nil="true" />
            <TipoVeiculo xsi:nil="true" />
            <Fluxo xsi:nil="true" />
            <ListaItens xsi:nil="true" />
            <ListaIdentificadoresVeiculo xsi:nil="true" />
            <ListaAtualizacaoTara xsi:nil="true" />
            <ListaCamposAdicionais xsi:nil="true" />
            <ListaCarretasSecundarias xsi:nil="true" />
            <FatorCorrecao xsi:nil="true" />
            <FatorConversao>decimal</FatorConversao>
            <UnidadeAposConversao>string</UnidadeAposConversao>
          </Veiculo>
        </VORetornoCadastraAlteraVeiculo>
        <VORetornoCadastraAlteraVeiculo>
          <Veiculo>
            <Sequencial>int</Sequencial>
            <Data>dateTime</Data>
            <FluxoAtualizacaoTara xsi:nil="true" />
            <Transportadora xsi:nil="true" />
            <Emissor xsi:nil="true" />
            <Motorista xsi:nil="true" />
            <TipoVeiculo xsi:nil="true" />
            <Fluxo xsi:nil="true" />
            <ListaItens xsi:nil="true" />
            <ListaIdentificadoresVeiculo xsi:nil="true" />
            <ListaAtualizacaoTara xsi:nil="true" />
            <ListaCamposAdicionais xsi:nil="true" />
            <ListaCarretasSecundarias xsi:nil="true" />
            <FatorCorrecao xsi:nil="true" />
            <FatorConversao>decimal</FatorConversao>
            <UnidadeAposConversao>string</UnidadeAposConversao>
          </Veiculo>
        </VORetornoCadastraAlteraVeiculo>
      </VORetornoCadastraAlteraVeiculo>
    </AlteraVeiculoResponse>
  </soap12:Body>
</soap12:Envelope>