Ir para o conteúdo

Cadastrar/Alterar Dados do Condutor V2

Cadastrar/Alterar Dados do Condutor (Set_AlteraCondutorV2)

O método funciona para cadastro e alteração de dados do condutor pode ser utilizado para ajustar informações de um único campo ou vários campos da tabela de condutores nos cadastros do cliente na gerenciadora.

O método também pode ser utilizado para:

  • Alterar perfil securitário do condutor;
  • Tornar o condutor Ativo ou Inativo;
  • Alterar vínculo do condutor (autônomo para agregado, agregado para clt, etc);
  • Alterar contatos do condutor;
  • Simples alteração de dados do condutor ou
  • Inclusão do condutor caso o mesmo não exista na base.

Para que esse método seja aceito, todos os dados de inclusão de condutor que são obrigatórios devem ser enviados (note que alguns campos são obrigatórios para inclusão porém não necessariamente precisam ser enviados na integração pois possuem valores “default”) bem como deve haver a informação solicitando a inclusão em caso de inexistência do cadastro (iId_AutoInclusao = “S”).

Caso esteja utilizando esse método na função “alteração” (com sId_AutoInclusao = “N” ou se sId_AutoInclusao não for informado na integração), observar os campos que permitem alteração (ver coluna “permite alteração” na tabela de detalhamento de campos/grupos).

Campos obrigatórios para alteração/inclusão (chaves de acesso): iCd_CnpjUnidNeg e iNo_CpfCondutor. Se esses atributos não forem enviados ou seu conteúdo for nulo, não haverá processamento da requisição.

Toda informação enviada irá sobreescrever a informação da cadastrada, por favor se atente ao enviar os dados do condutor.

Atualização V2

Para funcionamento do método de Solicitação de Perfil securitário é necessário realizar a atualização para este método atual do Cadastro/Altera Condutor.

Foram adicionados as tags do conjunto ListaDocumentos para envio de documentos a serem utilizados pela solicitação de Perfil Securitário

Tabela de detalhamento de campos/grupos para alteração/inclusão de condutores

Grupo/Campo Tipo Descrição Observação Obrig Permite Alteração Pai Ocor
DadosAC Grupo geral da alteração Necesssário apresentar ao menos uma TAG relacionada nesse grupo 1-1
sCd_CnpjUnidNeg Num(14) CNPJ da unidade de negócios a qual o veiculo está vinculado Preencher com zeros a esquerda Sim-chave Não 1-1
sNo_CpfCondutor String(11) CPF do condutor padrão do veiculo Preencher com zeros a esquerda Sim-chave Não 1-1
sId_AutoInclusao string(1) Autorização de inclusão S = inclusão automática caso o condutor não exista / N = não permite inclusão caso o condutor não exista, porém caso exista, irá realizar a atualização Não Não 0-1
DadosCondutor Grupo informações do Condutor Necessário apresentar ao menos uma TAG relacionada nesse grupo, caso contrario, apresentar erro Sim DadosAC 1-1
sNm_Condutor string(60) Nome do Condutor Sim(***) Não 0-1
sAb_Condutor string(30) Nome Abreviado do Condutor Sim(***) Não 0-1
sNo_CNH string(11) Numero da CNH Completar com zeros a esquerda Sim(***) Sim 0-1
dDt_ValidadeCNH date Data de Validade da CNH Formato "AAAA-MM-DD" Sim(***) Sim 0-1
sId_CategoriaCNH string(3) Categoria da CNH Validar pela Tabela de Categorias CNH Sim(***) Sim 0-1
sTp_Identidade string(3) Tipo do documento de Identidade RG = Registro Geral / RIC = Registro de Identificação Civil / CIE = Cedula Identidade de Estrangeiro Sim(***) Sim 0-1
sNo_Identidade string(15) Numero do documento de identidade Sim(***) Sim 0-1
sSg_OrgaoExpedIdentidade string(10) Órgão expedidor do documento de identidade Não Sim 0-1
dDt_EmissaoIdentidade date Data de emissão da Identidade Formato "AAAA-MM-DD" Não Sim 0-1
sId_VinculoEmpreg string(1) Vinculo do condutor Validar pela Tabela de Vínculo do Condutor Sim(***) Sim 0-1
iCd_CEP num(8) CEP da Residencia do Condutor Sim(***) Sim 0-1
sNm_Logradouro string(64) Nome do logradouro da residencia do Condutor Sim(***) Sim 0-1
sNo_Logradouro string(15) Número do logradouro da residencia do Condutor Sim(***) Sim 0-1
sCp_Logradouro string(35) Complemento do logradouro da residencia do Condutor Não Sim 0-1
sNm_Bairro string(40) Bairro da residencia do Condutor Não Sim 0-1
sCd_Municipio string(15) Município da residencia do condutor Utilizar padrão IBGE. Se não for informado na inclusão utilizará padrão "indefinido". Se não utilizar código do integrador, o campo utilizará o tipo num(8) Sim(***) Sim 0-1
sCd_Latitude num(15v18) Latitude da Residencia do condutor Não Sim 0-1
sCd_Longitude num(15v18) Longitude da Residencia do condutor Não Sim 0-1
sDc_Obs string(50) Observações Gerais sobre o condutor Não Sim 0-1
dDt_InterrupAtivid date Data de Interrupção de Atividades Formato "AAAA-MM-DD" Não Sim 0-1
sCd_SegCentralMonit string(8) Senha de segurança Não Sim
sNm_Mae string(60) Nome da mãe Sim Sim
sNm_Pai string(60) Nome do pai Sim Sim
dDt_Nascimento date Data de Nascimento formato "AAAA-MM-DD" Sim Sim
sCd_MunNatural num(10) Código do Municipio de nascimento Sim Sim
sId_EstadoCivil string(1) Estado Civil
sId_Sexo num(1) Sexo Sim Sim
sCd_SegurancaCNH string(20) Senha de segurança CNH
DadosCondutorCnt Grupo informações de contato com o Condutor Sim DadosAC 1-n
iCd_DDD num(3) DDD do telefone contato Completar com zeros a esquerda Não Não 1-1
sNo_TelContato string(10) Telefone contato Somente números podendo ter um traço (-) Não Não 1-1
sId_TipoTelefone string(3) Tipo de telefone de contato Fix = Fixo / Cel = Celular / Rad = Radio Não Não 1-1
sId_Propriedade string(1) Telefone pessoal ou recados P = Pessoal / R = Recados Não Sim 1-1
iCd_OperTelefonia num(4) Operadora do Telefone de contato Validar pela Tabela de Operadoras de Telefonia Não Sim 1-1
sNm_PessoaCnt string(20) Nome da pessoa de contato Obrigatório caso sId_Propriedade = "R" Não Sim 0-1
DadosPerfSecCondutor Grupo de informações do perfil securitário do condutor padrão Se informado o grupo, deve haver informação nos campos abaixo Não DadosAC 0-1
iCd_FornecPerfSec num(4) Código do Fornecedor do Perfil Securitário Validar pela Tabela de Empresas Perfil Securitário Não Sim 1-1
sId_VincCondutorPS string(1) Identifica o Vinculo do Condutor Validar pela Tabela de Vínculos do Condutor Não Sim 1-1
sCd_PesquisaPS string(20) Código da pesquisa no fornecedor Não pode existir código duplicado para um mesmo fornecedor de perfil securitário Não Sim 1-1
dDt_PesquisaPS date Data da Pesquisa Formato "AAAA-MM-DD". Não Sim 1-1
dDt_ValidadePS date Data de Validade Formato "AAAA-MM-DD". Data de validade não pode ser superior a 365 dias da data da pesquisa para "CLT" ou 180 dias para "Agregados" ou 30 dias para "Terceiros-Autonomos) Não Sim 1-1
ListaDocumentos Conjunto de envio de documentos Não Sim
stDocumento Conjunto de documentos Não Sim
sTipo string Tipo de documento enviado Enviar parametros: CNH, MOPP, FOTO ou OUTROS Não Sim
sLink string Envio do link de upload do documento Link do Upload da imagem, é necessário ser de acesso livre para que o sistema possa baixa-la

(***) Obrigatório somente para inclusão

Exemplo do Envio/Retorno para alteração de dados do condutor

XML de Envio

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Set_AlteraCondutorV2 xmlns="http://tempuri.org/">
      <Login>
        <sUserName>string</sUserName>
        <sPassWord>string</sPassWord>
        <sToken>string</sToken>
      </Login>
      <DadosAC>
        <sCd_CnpjUnidNeg>string</sCd_CnpjUnidNeg>
        <sNo_CpfCondutor>string</sNo_CpfCondutor>
        <sId_AutoInclusao>string</sId_AutoInclusao>
        <DadosCondutor>
          <sNm_Condutor>string</sNm_Condutor>
          <sAb_Condutor>string</sAb_Condutor>
          <sNo_CNH>string</sNo_CNH>
          <dDt_ValidadeCNH>date</dDt_ValidadeCNH>
          <sId_CategoriaCNH>string</sId_CategoriaCNH>
          <sTp_Identidade>string</sTp_Identidade>
          <sNo_Identidade>string</sNo_Identidade>
          <sSg_OrgaoExpedIdentidade>string</sSg_OrgaoExpedIdentidade>
          <dDt_EmissaoIdentidade>date</dDt_EmissaoIdentidade>
          <sId_VinculoEmpreg>string</sId_VinculoEmpreg>
          <iCd_CEP>int</iCd_CEP>
          <sNm_Logradouro>string</sNm_Logradouro>
          <sNo_Logradouro>string</sNo_Logradouro>
          <sCp_Logradouro>string</sCp_Logradouro>
          <sNm_Bairro>string</sNm_Bairro>
          <sCd_Municipio>string</sCd_Municipio>
          <sCd_Latitude>string</sCd_Latitude>
          <sCd_Longitude>string</sCd_Longitude>
          <sDc_Obs>string</sDc_Obs>
          <dDt_InterrupAtivid>date</dDt_InterrupAtivid>
          <sCd_SegCentralMonit>string</sCd_SegCentralMonit>
          <sNm_Mae>string</sNm_Mae>
          <sNm_Pai>string</sNm_Pai>
          <dDt_Nascimento>date</dDt_Nascimento>
          <sCd_MunNatural>string</sCd_MunNatural>
          <sId_EstadoCivil>string</sId_EstadoCivil>
          <sId_Sexo>string</sId_Sexo>
          <sCd_SegurancaCNH>string</sCd_SegurancaCNH>
          <sUF_SegurancaCNH>string</sUF_SegurancaCNH>
          <sCd_MOP>string</sCd_MOP>
          <dDt_ValidadeMOP>date</dDt_ValidadeMOP>
        </DadosCondutor>
        <DadosCondutorCnt>
          <stDadosCondutorCnt>
            <iCd_DDD>int</iCd_DDD>
            <sNo_TelContato>string</sNo_TelContato>
            <sId_TipoTelefone>string</sId_TipoTelefone>
            <sId_Propriedade>string</sId_Propriedade>
            <iCd_OperTelefonia>int</iCd_OperTelefonia>
            <sNm_PessoaCnt>string</sNm_PessoaCnt>
          </stDadosCondutorCnt>
          <stDadosCondutorCnt>
            <iCd_DDD>int</iCd_DDD>
            <sNo_TelContato>string</sNo_TelContato>
            <sId_TipoTelefone>string</sId_TipoTelefone>
            <sId_Propriedade>string</sId_Propriedade>
            <iCd_OperTelefonia>int</iCd_OperTelefonia>
            <sNm_PessoaCnt>string</sNm_PessoaCnt>
          </stDadosCondutorCnt>
        </DadosCondutorCnt>
        <DadosPerfSecCondutor>
          <iCd_FornecPerfSec>int</iCd_FornecPerfSec>
          <sId_VincCondutorPS>string</sId_VincCondutorPS>
          <sCd_PesquisaPS>string</sCd_PesquisaPS>
          <dDt_PesquisaPS>date</dDt_PesquisaPS>
          <dDt_ValidadePS>date</dDt_ValidadePS>
        </DadosPerfSecCondutor>
        <ListaDocumentos>
          <stDocumento>
            <sTipo>string</sTipo>
            <sLink>string</sLink>
          </stDocumento>
          <stDocumento>
            <sTipo>string</sTipo>
            <sLink>string</sLink>
          </stDocumento>
        </ListaDocumentos>
      </DadosAC>
    </Set_AlteraCondutorV2>
  </soap:Body>
</soap:Envelope>

XML de Retorno

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Set_AlteraCondutorV2Response xmlns="http://tempuri.org/">
      <Set_AlteraCondutorV2Result>
        <Retorno>
          <stResult>
            <sCode>string</sCode>
            <sResult>string</sResult>
          </stResult>
          <stResult>
            <sCode>string</sCode>
            <sResult>string</sResult>
          </stResult>
        </Retorno>
      </Set_AlteraCondutorV2Result>
    </Set_AlteraCondutorV2Response>
  </soap:Body>
</soap:Envelope>