sgrAdicionarPessoaFisicaRapidoV3
Método utilizado para incluir o cadastro do perfil profissional quando não for necessária a pesquisa.
PARÂMETROS:
Campo | Tipo | Req.? | Descrição |
---|---|---|---|
chaveacesso | string | Sim | Chave retornada pelo método sgrLogin. |
cdpas | inteiro | Sim | Código do PAS, retornado pelo método sgrListaPASUsuario |
cdcliente | inteiro | Sim | Código do cliente, retornado pelo método sgrListaEmpresasPASUsuario. |
cdpaisorigem | inteiro | Sim | Código de nacionalidade do funcionário, retornado pelo método sgrListaPais. |
numDocOrgExp | inteiro | Sim | Órgão expedidor do RG. Código retornado pelo método sgrListaOrgaoEmissorRG, somente quando país de origem for Brasil (cdpaisorigem=1), informar -1 nos demais casos. |
numDocUF | inteiro | Não* | Código do estado de emissão da CNH. Este código é retornado pelo método sgrListaUF. * Obrigatório quando o profissional for motorista. |
strDocVinculo | string | Sim | Código do vínculo do perfil profissional. Este código é retornado pelo método sgrListaTiposVinculoPF. |
dtDocEmissao | string | Sim | Data de emissão do documento (CPF). Formato 'AAAA-MM-DD'. |
dtDocEmissaoCNH | string | Não* | Data de emissão da CNH. Informar '1900-01-01' quando não existir. * Obrigatório quando o profissional for motorista. |
dtDocVencCNH | string | Não* | Data de vencimento da CNH. Informar '1900-01-01' quando não existir. * Obrigatório quando o profissional for motorista. |
dtDocVencMOOP | string | Não | Data de vencimento do MOPP. Informar '1900-01-01' quando não existir. |
strDocCPF | string | Sim | Número do documento (CPF). Informar somente os dígitos. |
strDocRG | string | Sim | Número do RG. Informar somente os dígitos. |
strDocNrCNH | string | Não* | Número da CNH. Enviar "" (branco) quando não existir. * Obrigatório quando o profissional for motorista. |
strDocCategoria | string | Não* | Categoria da CNH. Enviar "" (branco) quando não existir. * Obrigatório quando o profissional for motorista. |
strDocNrRegistro | string | Não* | Número do registro da CNH. Enviar "" (branco) quando não existir * Obrigatório quando o profissional for motorista. |
dtDpNascimento | string | Sim | Data de nascimento do profissional. Formato ‘AAAA-MM-DD’. |
numDpNacionalidade | inteiro | Sim | Código da nacionalidade. Este código é retornado pelo método sgrListaNacionalidade. |
strDpNome | string | Sim | Nome do profissional [50 caracteres] |
numEndCidade | inteiro | Sim | Código da cidade de residência. Este código é retornado pelo método sgrListaCidades |
strEndFone1 | string | Sim | Número do telefone 1. |
strEndFone2 | string | Não | Número do telefone 2. Enviar "" (branco) quando não existir. |
strEndFax | string | Não | Número do fax. Enviar "" (branco) quando não existir. |
cdEntidadeMOPP | inteiro | Não | Código da entidade de registro do MOPP. Este código é retornado pelo método sgrListaEntidadesMOPP. Enviar -1 quando não existir MOPP. |
nrMOPP | string | Não | Número do MOPP do profissional. Enviar "" (branco) quando não existir. |
dtContratacao | string | Não | Data da contratação do profissional. Formato ‘AAAA-MM-DD’. Enviar "" (branco) quando não existir. |
nrMatricula | string | Não | Número da matrícula (funcionário) no cliente [30 caracteres]. Enviar "" (branco) quando não existir. |
DDD1 | string | Sim | DDD do telefone 1 |
DDD2 | string | Não* | DDD do telefone 2 * Obrigatório se strEndFone2 for preenchido |
DDDFax | string | Não* | DDD do Fax * Obrigatório se strEndFax for preenchido |
Observação: Para facilitar a compreensão dos métodos secundários, que devem ser chamados para retornarem os códigos exigidos nos parâmetros listados acima, será apresentada a seguir uma analogia entre os métodos secundários e a tela de cadastro no Clipas NET.
Ressaltando que, por se tratar de sistemas diferentes, o Web Service e o Clipas NET não precisam necessariamente conter os mesmos campos.
Figura 1: Tela de cadastro rápido de PF no Clipas NET. Em azul, foram escritos os nomes dos parâmetros. Em vermelho estão os métodos secundários.
RETORNO DO MÉTODO:
ReturnDataset: Se os parâmetros forem corretamente informados, a propriedade ReturnDataset irá conter:
Campo | Tipo | Descrição |
---|---|---|
CDPFJ | inteiro | Código do perfil profissional cadastrado na execução do método |
ReturnDescription: Se houver erro na execução do método, a propriedade do objeto irá apresentar:
Erro | Descrição |
---|---|
Não foi possível cadastrar o perfil profissional | Nesse caso, o Web Service deve retornar o dataset com os erros que impossibilitaram o cadastro. A relação de erros pode ser vista no Quadro 2. |
Se o cliente POSSUI O SERVIÇO DE CADASTRO, para fazer a inclusão utiliza-se o método a seguir: sgrGerarPessoaFisicaV4