DOCUMENTAÇÃO

Cadastro de relacionamentos e representantes

Chamada: AutoCadastroRelacionamentos

Esta função tem por OBJETIVO realizar o cadastramento de um relacionamento e seus representantes.

  • Como uma Pessoa física se auto representa no Portal QualiSign é importante que neste caso, sejam preenchidas as informações da Tag representante, com as informações da Pessoa física.

Formato de entrada: 

<?xml version="1.0" encoding="ISO-8859-1" ?>
<documentoeletronico>
        <sessao>XXXX</sessao> 
        <relacionamento rel_cnpjcpf="" razao="" nomefantasia="" gtdeass="" PerfilDefault="" rel_Ativo="" />
                <representantes>
                    <representante repr_cont_cpf="" nome="" idlogon="" email="" perfil="" DataVencMandato="" DataVencInd="" reprAtivo="" />
                    <representante repr_cont_cpf="" nome="" idlogon="" email="" perfil="" DataVencMandato="" DataVencInd="" reprAtivo="" />
                    <representante repr_cont_cpf="" nome="" idlogon="" email="" perfil="" DataVencMandato="" DataVencInd="" reprAtivo="" />
                </representantes>
        <relacionamento>
</documentoeletronico>
Parâmetro Formato Obrigatório Descrição
sessao Texto S Chave de acesso cadastrada para sua empresa
relacionamento Texto S TAG para definir o relacionamento a ser incluído /alterado
rel_cnpjcpf Texto S CNPJ da empresa ou CPF da Pessoa Física que será cadastrado / alterado no Portal QualiSign. Preencher com CNPJ/CPF sem formatação enviando inclusive ZEROS a esquerda para completar a estrutura de 11 posições para CPF ou 14 posições para CNPJ.
razao Texto S Razão Social (PJ) ou nome (PF) do relacionamento
nomefantasia Texto S Nome Fantasia (PJ) ou o nome (PF) do relacionamento
qtdeass Numérico S Quantidade de assinaturas mínima necessárias para considerar que as assinaturas da parte foram completadas
PerfilDefault String S Nome do Perfil ou Código do Perfil que deve ser utilizado como padrão para o cadastro de um representante.

(vide capítulo “Perfis de acesso”)
rel_ativo Texto N Define o status do representante.

Valores possíveis: S – Ativo, N- não ativo
representantes Texto N Node para definir os representantes dos relacionamentos que serão associados ao relacionamento em questão. Caso este node não exista nenhum representante será associado
representante Texto N TAG para definir o representante que será incluído / alterado no relacionamento em questão.
repr_cont_cpf Texto S CPF do representante.

Preencher sem formatação obedecendo as 11 posições para este número (preencher inclusive com ZEROS a esquerda quando necessário).
nome Texto S Nome do representante
idlogon Texto S Identificação do usuário para efetuar login no portal
email Texto S Email do representante
perfil String N Nome do Perfil ou Código do Perfil a ser associado

(vide capítulo “Perfis de acesso”)
DataVencMandato Texto N Data de vencimento do mandato do representante, no formato DD/MM/AAAA
DataVencInd Texto N Define se o mandato do representante é INDETERMINADO. Os valores possíveis são S (para definir mandato indeterminado) ou N (para definir mandato com validade determinada, expressa pelo argumento DataVencMandato
repr_Ativo Texto N Define se o representante está Ativo ou Não. Os valores possíveis são S para deixar o representante Ativo para este relacionamento e N para torná-lo Inativo neste relacionamento.

 
AssinaIsoladamente Texto N Indica se assina isoladamente (S-Sim, N-Não). Essa informação é relevante somente se a configuração “A quantidade de assinaturas necessárias para encerrar a coleta de uma Parte é definida em cada Relacionamento” estiver habilitada para o relacionamento.
LimiteIsoladamente Texto N Informar valor do limite em REAIS.  Caso AssinaIsoladamente seja igual a S e o limite deste representante seja INDETERMINADO, informar 0 (zero) para LimiteIsoladamente. Caso AssinaIsoladamente seja igual a N, informar na TAG LimiteIsoladamente o valor 0 (zero) ou não informar o TAG. Vale lembrar que a obrigatoriedade em definir limites de um representante na moeda REAL, ocorre devido ao Portal QualiSign não realizar conversão de moedas no momento de conferir alçadas em relação ao valor de um documento. Sendo assim, o valor do documento cadastrado também deve estar sempre em REAIS para utilizar a validação automática de poderes pelo portal.

 
Assinaconjuntamente Texto N Indica se assina conjuntamente (S-Sim, N-Não). Essa informação é relevante somente se a configuração “A quantidade de assinaturas necessárias para encerrar a coleta de uma Parte é definida em cada Relacionamento” estiver habilitada para o relacionamento.
Limiteconjuntamente Texto N Informar valor do limite em REAIS.  Caso Assinaconjuntamente seja igual a S e o limite deste representante seja INDETERMINADO, informar 0 (zero) para Limiteconjuntamente. Caso Assinaconjuntamente seja igual a N, informar na TAG Limiteconjuntamente o valor 0 (zero) ou não informar o TAG. Vale lembrar que a obrigatoriedade em definir limites de um representante na moeda REAL, ocorre devido ao Portal QualiSign não realizar conversão de moedas no momento de conferir alçadas em relação ao valor de um documento. Sendo assim, o valor do documento cadastrado também deve estar sempre em REAIS para utilizar a validação automática de poderes pelo portal.

 

Formato de saída: 

                                    <?xml version="1.0" encoding="ISO-8859-1" ?>
<documentoeletronico>
        <CodErro />
        <MsgErro />
</documentoeletronico>
Parâmetro Formato Descrição
CodErro Numérico Código de erro (ver Códigos de Erros).
MsgErro Texto Mensagem de Erro
Voltar para Consulta status de workflow do documento Consulta ID do representante