Mudanças entre as edições de "API de importação de responsáveis"

(Criou página com 'A API de importação de responsáveis deve ser utilizada para cadastrar um ou mais responsáveis pelo devedor no Recuperador CRM. Endpoint: https://www.recuperador.com.br/a...')
 
 
Linha 2: Linha 2:
  
  
Endpoint: https://www.recuperador.com.br/api/v1ImportacaoResponsavel
+
Endpoint: https://app.recuperador.com.br/api/v1ImportacaoResponsavel
  
 
Ação: '''POST'''
 
Ação: '''POST'''

Edição atual tal como às 21h02min de 22 de junho de 2023

A API de importação de responsáveis deve ser utilizada para cadastrar um ou mais responsáveis pelo devedor no Recuperador CRM.


Endpoint: https://app.recuperador.com.br/api/v1ImportacaoResponsavel

Ação: POST

Formato: JSON

Autenticação: enviar o token da API no campo username da autenticação Basic Auth. Deixe o campo password em branco.


Objeto de entrada

{

   atualizar: string,
   email: string, 
   responsaveis: array de responsáveis

}

Seguem informações complementares sobre cada coluna do objeto:

  • Atualizar: deve ser preenchido com S para Sim e N para Não. Quando marcado como S, este campo faz o importador atualizar CPFs ou CNPJs existentes na base de dados com os novos dados.
  • E-mail: e-mail que receberá o resultado da importação. Este método é assíncrono, por isso deve-se informar um endereço de e-mail para recebimento do resultado do processamento.
  • Responsaveis: lista de responsáveis a serem importados. O array deve ser do tipo responsavel, que será descrito abaixo.

Classe responsavel

{

   id_credor: int
   cpf_cnpj_devedor: string,
   nome_devedor: string, 
   prioridade: int,
   titulo: string,
   nome: string, 
   apelido: string,
   datanasc: DateTime,
   email: string,
   email2: string, 
   email3: string, 
   email4: string, 
   telefone: string, 
   telefone2: string, 
   endereco: string, 
   numero: string, 
   complemento: string, 
   bairro: string, 
   cidade: string, 
   estado: string, 
   cep: string, 
   sexo: string, 
   rg: string, 
   tipo_pessoa: string, 
   cpf_cnpj: string, 
   whatsapp: string, 
   telegram: string, 
   profissao: string, 
   username_fb: string, 
   username_insta: string, 
   telefone3: string, 
   telefone4: string, 
   telefone5: string, 
   telefone6: string, 
   codigo: string, 
   obs: string

}

Seguem informações complementares sobre cada coluna do objeto:

  • *ID do credor: aceita apenas valores inteiros e é obrigatório somente na importação de múltiplos credores. Ele deve ser preenchido com o código do credor que aparece em Cadastros > Credores.
  • *CPF/CNPJ do devedor: aceita no máximo de 18 caracteres e é obrigatório. Somente números preferencialmente.
  • *Nome do devedor: aceita no máximo de 40 caracteres e é obrigatório.
  • *Prioridade do responsável: aceita apenas valores inteiros é obrigatório.
  • *Título do responsável: aceita no máximo de 40 caracteres e é obrigatório.
  • *Nome: aceita no máximo de 40 caracteres e é obrigatório.
  • Apelido: aceita no máximo de 40 caracteres e não é obrigatório.
  • Data nasc.: aceita no máximo 10 caracteres no formato DD/MM/AAAA e não é obrigatório.
  • *E-mail: aceita no máximo de 256 caracteres e é obrigatório.
  • E-mail 2: aceita no máximo de 256 caracteres e não é obrigatório.
  • E-mail 3: aceita no máximo de 256 caracteres e não é obrigatório.
  • E-mail 4: aceita no máximo de 256 caracteres e não é obrigatório.
  • *Telefone: aceita no máximo de 20 caracteres e é obrigatório.
  • Telefone2: aceita no máximo de 20 caracteres e não é obrigatório.
  • *Endereço: aceita no máximo de 256 caracteres e é obrigatório.
  • *Número: aceita no máximo de 5 caracteres e é obrigatório.
  • Complemento: aceita no máximo de 150 caracteres e não é obrigatório.
  • *Bairro: aceita no máximo de 60 caracteres e é obrigatório.
  • *Cidade: aceita no máximo de 60 caracteres e é obrigatório.
  • *Estado: aceita no máximo de 2 caracteres e é obrigatório.
  • *CEP: aceita no máximo de 9 caracteres e é obrigatório. Somente números preferencialmente.
  • Sexo: aceita no máximo de 1 caractere e não é obrigatório. Deve ser preenchido com M ou F. Se não houver sexo, informar N maiúsculo.
  • *Tipo: aceita no máximo de 1 caractere e é obrigatório. Informar F maiúsculo para pessoa física ou J maiúsculo para pessoa jurídica.
  • *CPF/CNPJ: aceita no máximo de 18 caracteres e é obrigatório. Somente números preferencialmente.
  • RG: aceita no máximo de 12 caracteres e não é obrigatório.
  • WhatsApp: aceita no máximo de 20 caracteres e não é obrigatório.
  • Telegram: aceita no máximo de 20 caracteres e não é obrigatório.
  • Profissão: aceita no máximo de 100 caracteres e não é obrigatório.
  • Facebook: aceita no máximo de 256 caracteres e não é obrigatório.
  • Instagram: aceita no máximo de 256 caracteres e não é obrigatório.
  • Telefone de recado 1: aceita no máximo de 20 caracteres e não é obrigatório.
  • Telefone de recado 2: aceita no máximo de 20 caracteres e não é obrigatório.
  • Telefone de recado 3: aceita no máximo de 20 caracteres e não é obrigatório.
  • Telefone de recado 4: aceita no máximo de 20 caracteres e não é obrigatório.
  • Código do cliente: aceita no máximo de 100 caracteres e não é obrigatório.
  • Observações: aceita no máximo de 400 caracteres e não é obrigatório.

Se o parâmetro Exigir dados completos do cliente estiver configurado como Não no cadastro do credor, então não será obrigatório informar o e-mail, telefone, data de nascimento e endereço completo do responsável.


Classe de retorno

{

   sucesso: bool,
   mensagem: string

}

Seguem informações complementares sobre cada coluna do objeto:

  • Sucesso: retornará true em caso de chamada realizada com sucesso e false em caso de erro na chamada.
  • Mensagem: exibirá a mensagem de sucesso ou de erro.