Cadastro de Agentes
Recebe dados para realizar um cadastro de agentes do tipo Cedente, Cotista, Empresa Conveniada (quando o fundo é parametrizado a este tipo) e Sacado.
No caso de vínculo entre Empresa Conveniada e Sacado, faça o vínculo entre as entidades (Empresa Conveniada e Sacado) utilizando o método Vínculo de Sacados após realizar o cadastro dos agentes.
Hosts
Produção: https://api.hmra.com.br
Homologação: https://hom.api.hmra.com.br
POST http://host/api/agente/fundo/cnpj
Parameters
cnpj | CNPJ do fundo | String
REQUEST
Attributes
tipoAgente | required | enum | Preencher com o código do agente
2 = Cedente
9 = Cotista
12 = Empresa Conveniada
13 = Sacado/Emitente
14 = Originador
cpfCnpj | required | string | Informar o número do documento do Agente.: CPF = "99999999999" CNPJ = "99999999999999"
operacaoUR | boolean | Obrigatório para operação de UR
coobrigacao | boolean | Obrigatório para cadastro de Cedentes (tipoAgente = 2)
dadosBancarios | array
tipo | required | enum | Preencher com o código do tipo da conta
1 = Conta corrente individual
2 = Conta corrente conjunta
3 = Conta poupança individual
5 = Conta poupança conjunta
contaPrincipal | required | enum
S = Sim
N = Não
codigoBanco | required | number | Informar o código do banco 3 dígitos "999"
agencia | required | number | Informar o código da agência 4 dígitos "9999"
dvAgencia | required | number | Informar o dígito verificador da agência 1 dígito "9"
conta | required | number | Informar o número da conta 7 dígitos "9999999"
dvConta | required | number | Informar o dígito verificador da conta 1 dígito "9"
representantes | array | Obrigatório para Cedente - Não informar para Sacado
participacao | required | enum
1 = Representante Legal
2 = Convidado
3 = Sócio
4 = Procurador
5 = Testemunha
6 = Responsável Solidário
7 = Gestor Representante
8 = Endossante
9 = Avalista
10 = Emitente
cpfCnpj | required | string | Informar o cpf do representante, em casos de ser participacao Representante Solidário, poderá informar o CNPJ
tipoDocumento | enum | Informar o tipo de documento - não obrigatório para operação UR ou Representante Solidário
1 = RG
2 = CPF/CNH
3 = Passaporte
numeroDocumento | string | Informar o número do documento referente ao tipo documento - não obrigatório para operação UR ou Representante Solidário
telefone | required | string | Informar o telefone do representante - não obrigatório para operação UR ou Representante Solidário
email | required | string | Informar o email do representante
tipoAssinaturaTermo | enum | Informar o tipo de assinatura para termos se não for um representante solidário pessoa jurídica
1 = Não Assina
2 = Assina Individualmente
3 = Assina em conjunto
tipoAssinaturaDuplicata | enum | Informar o tipo de assinatura para duplicatas se não for um representante solidário pessoa jurídica
1 = Não Assina
2 = Assina Individualmente
3 = Assina em conjunto
possuiAlcadaFinanceira | required | boolean | Informar se possui ou não alçada financeira
alcadaFinanceira | required | number | Informar o valor da alçada se possuir "0.00"
assinaturaEletronica | required | boolean | Informar se assina eletronicamente
representantes | array | Informar os representantes vinculados ao solidário PJ
cpf | required | string | Informar o representante vinculado ao solidário PJ
tipoDocumento | required | enum | Informar o tipo do documento
1 = RG
2 = CPF/CNH
3 = Passaporte
numeroDocumento | required | string | Informar o número do documento conforme o tipo
telefone | required | string | Informar o telefone
email | required | string | Informar o email
regrasAssinaturas | array | Obrigatório para Cedente - Não informar para Sacado
participacao | required | boolean | Informar se possui ou não alçada financeira
alcadaFinanceira | required | number | Informar o valor da alçada se possuir "0.00"
assinaturaEletronica | required | enum
1 = Representante Legal
2 = Convidado
3 = Sócio
4 = Procurador
5 = Testemunha
6 = Responsável Solidário
7 = Gestor Representante
8 = Endossante
9 = Avalista
10 = Emitente
quantidadeMinimaTermo | required | number | Informar a quantidade mínima de assinaturas para termos
quantidadeMinimaDuplicata | required | number | Informar a quantidade mínima de assinaturas para duplicatas
HEADERS
Accept:application/json
Content-Type:application/json
Authorization:Bearer fsdfsdfsaf.fsadfsafsafsa.fsdafsadfsa
RequestToken:hua12DuadlAKsjioqj
BODY
[
{
"tipoAgente": 0,
"cpfCnpj": "string",
"operacaoUR": true,
"coobrigacao": true,
"dadosBancarios": [
{
"tipo": 0,
"contaPrincipal": "string",
"codigoBanco": "string",
"agencia": "string",
"dvAgencia": "string",
"conta": "string",
"dvConta": "string"
}
],
"representantes": [
{
"participacao": 0,
"cpfCnpj": "string",
"tipoDocumento": 0,
"numeroDocumento": "string",
"telefone": "string",
"email": "string",
"tipoAssinaturaDuplicata": 0,
"tipoAssinaturaTermo": 0,
"possuiAlcadaFinanceira": true,
"alcadaFinanceira": 0,
"assinaturaEletronica": true,
"representantes": [
{
"cpf": "string",
"tipoDocumento": 0,
"numeroDocumento": "string",
"telefone": "string",
"email": "string"
}
]
}
],
"regrasAssinaturas": [
{
"participacao": 0,
"quantidadeMinimaTermo": 0,
"quantidadeMinimaDuplicata": 0
}
]
}
]
RESPONSE
Attributes
codigo | number
descricao | string | Mensagem do erro
cpfCnpj | string | CPF ou CNPJ do agente que apresentou o erro
BODY
[
{
"codigo": 0,
"descricao": "string",
"cpfCnpj": "string"
}
]
CODIGOS RESPONSE
Códigos Sucesso
0 - Cadastro Pendente. Favor complementar o cadastro através da opção de menu CADASTRO.
100 - Há um pré-cadastro deste CPF/ CNPJ em andamento para este fundo.
200 - Este CNPJ/CPF encontra-se cadastrado para este fundo!
201 - Este CNPJ/CPF encontra-se cadastrado para este fundo e para esta empresa conveniada!
Códigos Falha
300 - Não foi possível realizar o pré-cadastro.
301 - Pré-cadastro aprovado. Houve falha em registrar o Endereço de Correspondência. Favor complementar o cadastro através da opção de menu CADASTRO.
302 - Problemas ao processar arquivo. Verifique o arquivo enviado. É obrigatório o envio do arquivo em formato '.zip'.
400 - Não foi possível realizar o pré-cadastro. O fundo informado não está cadastrado.
402 - CPF protegido pela LGPD na Receita Federal.
403 - Erro ao buscar CNPJ/CPF na Receita Federal - Requisição Inválida
404 - Erro ao buscar CNPJ/CPF na Receita Federal - Não Autorizado
405 - Erro ao buscar CNPJ/CPF na Receita Federal - Proibido
406 - CNPJ/CPF não encontrado na Receita Federal.
407 - Erro ao buscar CNPJ/CPF na Receita Federal - Erro no Servidor
408 - Erro ao buscar CNPJ/CPF na Receita Federal - Tempo Esgotado do Gateway
500 - Não foi possível realizar o pré-cadastro. Este fundo não está vinculado ao perfil utilizado.
501 - Não foi encontrado Empresa Conveniada para esse fundo com o CNPJ informado no campo CNPJEmpresaConveniada.
502 - O campo CNPJEmpresaConveniada é obrigatório para cadastrar um sacado.
503 - Fundo não configurado para cadastro de Empresa Conveniada/Sacado.
504 - Empresa Conveniada não está vinculada ao Fundo.
505 - Empresa Conveniada precisa ser do Tipo 'Empresa Conveniada'.
506 - O código informado no 'Tipo Agente' não é válido.
507 - Perfil utilizado não tem permissão para acessar o fundo informado.
600 - Este CNPJ/CPF já existe como FUNDO, permitido somente novo cadastro como Cotista.
999 - Não foi possível realizar o pré-cadastro.