Skip to main content

sgrAdicionarPessoaFisicaRapidoV3

Method used to include the professional profile register when a search is not required.

SoapAction

PARAMETERS:

FieldTypeReq.Description
keyaccessstringYesKey returned by the sgrLogin method.
cdpasintegerYesPAS code, returned by the sgrListaPASUsuario method
cdclientintegerYesClient code, returned by the sgrListCompaniesPASUser method.
cdpaisorigemintegerYesEmployee's nationality code, returned by the sgrListPais method.
numDocOrgExpintegerYesID card issuing country. Code returned by the sgrListaOrgaoEmissorRG method, only when the country of origin is Brazil (cdpaisorigem=1), inform -1 in other cases.
numDocUFintegerNo*Code of the state where the CNH was issued. This code is returned by the sgrListaUF method. * Mandatory when the professional is a driver.
strDocVinculostringYesProfessional profile link code. This code is returned by the sgrListaTiposVinculoPF method.
dtDocEmissaostringYesDocument issue date (CPF). Format 'YYYY-MM-DD'.
dtDocEmissaoCNHstringNo*CNH issue date. Enter '1900-01-01' when it does not exist. * Mandatory when the professional is a driver.
dtDocVencCNHstringNo*CNH expiration date. Enter '1900-01-01' when it does not exist. * Mandatory when the professional is a driver.
dtDocVencMOOPstringNoMOPP expiration date. Enter '1900-01-01' when it does not exist.
strDocCPFstringYesDocument number (CPF). Enter only the digits.
strDocRGstringYesID number. Enter only the digits.
strDocNrCNHstringNo*CNH number. Send “” (blank) when it doesn't exist. * Mandatory when the professional is a driver.
strDocCategoriastringNo*Driver's license category. Send “” (blank) when it doesn't exist. * Mandatory when the professional is a driver.
strDocNrRegistrostringNo*CNH registration number. Send “” (blank) when it doesn't exist * Required when the professional is a driver.
dtDpBirthstringYesProfessional's date of birth. Format 'YYYY-MM-DD'.
numDpNationalityintegerYesNationality code. This code is returned by the sgrListNationality method.
strDpNamestringYesProfessional's name [50 characters]
numEndCityintegerYesCity of residence code. This code is returned by the sgrListCities method
strEndPhone1stringYesPhone number 1.
strEndPhone2stringNoPhone number 2. Send “” (blank) when it doesn't exist.
strEndFaxstringNoFax number. Send “” (blank) when it doesn't exist.
cdEntidadeMOPPintegerNoMOPP registration entity code. This code is returned by the sgrListMOPPEntities method. Send -1 when no MOPP exists.
nrMOPPstringNoProfessional's MOPP number. Send “” (blank) when it doesn't exist.
dtContratacaostringNoDate the professional was hired. Format 'YYYY-MM-DD'. Send “” (blank) when it doesn't exist.
nrMatriculastringNoEnrollment number (employee) at the client [30 characters]. Send “” (blank) when it doesn't exist.
DDD1stringYesDDD of phone 1
DDD2stringNo*DDD of phone 2 * Required if strEndFone2 is filled in
DDDFaxstringNo*Fax DDD * Required if strEndFax is filled

Observation: To make it easier to understand the secondary methods, which must be called to return the codes required in the parameters listed above, an analogy between the secondary methods and the registration screen in Clipas NET will be presented below.

Note that, as they are different systems, the Web Service and Clipas NET do not necessarily have to contain the same fields.

Figure 1: Quick FP registration screen in Clipas NET. In blue, the names of the parameters have been written. In red are the secondary methods.

METHOD RETURN:

ReturnDataset: If the parameters are correctly entered, the ReturnDataset property will contain:

FieldTypeDescription
CDPFJintegerCode of the professional profile registered in the execution of the method

ReturnDescription: If there is an error in the execution of the method, the object's property will display:

ErrorDescription
Could not register professional profileIn this case, the Web Service must return the dataset with the errors that made registration impossible. The list of errors can be seen in Table 2

If the customer HAS THE REGISTRATION SERVICE, the following method is used to add them: sgrGerarPessoaFisicaV4