Importar Pessoa/Limite de Crédito
POST
/v1/import-person-limit
Parâmetros
| Atributo | Tipo | Obrig | Tam | Ocorr | Descrição |
|---|---|---|---|---|---|
| token | Alfa | Sim | 64 | 1:1 | Token gerado no Qgestora |
| pessoas | 1:N | Estrutura do cadastro de pessoas | |||
| tipoEntidade | Alfa | Sim | 1 | 1:1 | Tipo de entidade (ver tabela Tipo Entidade) |
| tipoPessoa | Alfa | Não | 1 | 0:1 | Tipo de pessoa (ver tabela Tipo Pessoa) |
| cnpjCpf | Alfa | Sim | 18 | 1:1 | CPF ou CNPJ da pessoa, com ou sem máscara |
| nome | Alfa | Sim | 255 | 1:1 | Nome (se PF) ou Razão social (se PJ) |
| nomeFantasia | Alfa | Não | 60 | 0:1 | Nome fantasia (se PJ) ou Apelido (se PF). Se não for informado, será preenchido com o Nome. |
| inscricaoEstadual | Alfa | Não | 25 | 0:1 | Inscrição Estadual (se PJ) |
| isentoIE | Alfa | Não | 1 | 0:1 | Isento de Inscrição Estadual (S/N) |
| inscricaoMunicipal | Alfa | Não | 25 | 0:1 | Inscrição Municipal (se PJ) |
| cnae | Alfa | Não | 10 | 0:1 | Código da atividade econômica principal, com ou sem máscara (se PJ) |
| site | Alfa | Não | 255 | 0:1 | Website da empresa (se PJ) |
| numFuncionarios | Num | Não | 10 | 0:1 | Número de funcionários (se PJ) |
| recuperacaoJudicial | Alfa | Não | 1 | 0:1 | Recuperação judicial (S/N) (se PJ) |
| processoFalencia | Alfa | Não | 1 | 0:1 | Processo de falência (S/N) (se PJ) |
| instituicaoFinanceira | Alfa | Não | 1 | 0:1 | Instituição Financeira (S/N) (se PJ) |
| docIdentidade | Alfa | Não | 25 | 0:1 | Número do RG (se PF) |
| orgaoExpedidor | Alfa | Não | 10 | 0:1 | Órgão emissor do RG (se PF) |
| dataExpedicao | Data | Não | 0:1 | Data de emissão do RG (se PF) | |
| estadoCivil | Num | Não | 2 | 0:1 | Estado civil (ver tabela Estado Civil) (se PF) |
| regimeCasamento | Num | Não | 2 | 0:1 | Regime de casamento (ver tabela Regime Casamento) (se PF) |
| Alfa | Não | 255 | 0:1 | ||
| dddTelefone1 | Num | Não | 3 | 0:1 | DDD do telefone 1 |
| numTelefone1 | Num | Não | 9 | 0:1 | Número do telefone 1 |
| dddTelefone2 | Num | Não | 3 | 0:1 | DDD do telefone 2 |
| numTelefone2 | Num | Não | 9 | 0:1 | Número do telefone 2 |
| cep | Alfa | Não | 9 | 0:1 | Código de endereçamento postal, com ou sem máscara |
| endereco | Alfa | Não | 255 | 0:1 | Descrição do logradouro |
| numEndereco | Num | Não | 6 | 0:1 | Número do endereço |
| compEndereco | Alfa | Não | 75 | 0:1 | Complemento do endereço |
| bairro | Alfa | Não | 75 | 0:1 | Bairro |
| cidade | Alfa | Não | 50 | 0:1 | Cidade |
| uf | Alfa | Não | 2 | 0:1 | Estado (UF) |
| limites | Não | 0:N | Estrutura do limite de crédito da pessoa | ||
| cnpjFundo | Alfa | Sim | 18 | 1:1 | CNPJ do Fundo (FIDC), com ou sem máscara. Retorna erro se o CNPJ for inválido ou o fundo não for encontrado. |
| valorLimiteCredito | Num | Cond. | 17,2 | 0:1 | Valor do limite de crédito. Pelo menos um entre valorLimiteCredito e percLimiteCredito deve ser informado e maior que zero. Retorna erro se o formato for inválido. |
| percLimiteCredito | Num | Cond. | 5,2 | 0:1 | Percentual do limite de crédito (máx. 100). Pelo menos um entre valorLimiteCredito e percLimiteCredito deve ser informado e maior que zero. Retorna erro se o formato for inválido. |
| dataInicioVigencia | Data | Sim | 1:1 | Data de início da vigência do limite de crédito. Deve ser maior ou igual à data atual. | |
| dataFimVigencia | Data | Não | 0:1 | Data do fim da vigência do limite de crédito. Se informada, deve ser maior que dataInicioVigencia. |
Tipo Entidade
| Código | Descrição |
|---|---|
| C | Cedente |
| S | Sacado |
Tipo Pessoa
| Código | Descrição |
|---|---|
| F | Física |
| J | Jurídica |
Estado Civil
| Código | Descrição |
|---|---|
| 1 | Casado (a) |
| 2 | Separado (a) |
| 3 | Solteiro (a) |
| 4 | Viúvo (a) |
| 5 | Divorciado (a) |
| 6 | Desquitado (a) |
| 7 | União Estável |
Regime Casamento
| Código | Descrição |
|---|---|
| 1 | Comunhão Parcial de Bens |
| 2 | Comunhão Universal de Bens |
| 3 | Separação Total de Bens |
Status Importação Pessoa
| Código | Descrição |
|---|---|
| 01 | Pessoa atualizada com sucesso. |
| 02 | Pessoa atualizada com ressalvas. |
| 03 | Pessoa não atualizada. |
| 04 | Limite(s) de crédito atualizado(s) com sucesso. |
| 05 | Limite(s) de crédito atualizado(s) com ressalvas. |
| 06 | Limite(s) de crédito não atualizado(s). |
| 07 | Pessoa e limite(s) de crédito atualizados com sucesso. |
| 08 | Pessoa e limite(s) de crédito atualizados com ressalvas. |
| 09 | Pessoa não atualizada. Limite(s) de crédito atualizado(s). |
| 10 | Pessoa atualizada. Limite(s) de crédito não atualizado(s). |
| 11 | Pessoa atualizada com ressalvas. Limite(s) de crédito não atualizado(s). |
| 12 | Pessoa e limite(s) de crédito não atualizados. |
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/import-person-limit' \
--header 'Content-Type: application/json' \
--data-raw '{
"token": "###############################################",
"pessoas": [
{
"tipoEntidade": "C",
"tipoPessoa": "J",
"cnpjCpf": "99999999999999",
"nome": "NOME/RAZAO SOCIAL",
"nomeFantasia": "NOME FANTASIA",
"inscricaoEstadual": "",
"isentoIE": "S",
"inscricaoMunicipal": "",
"cnae": "9999-9/99",
"site": "",
"numFuncionarios": 999999,
"recuperacaoJudicial": "N",
"processoFalencia": "N",
"docIdentidade": "",
"orgaoExpedidor": "",
"dataExpedicao": "01/01/1900",
"estadoCivil": 0,
"regimeCasamento": 0,
"email": "pessoa@email.com.br",
"dddTelefone1": 99,
"numTelefone1": 999999999,
"dddTelefone2": 99,
"numTelefone2": 999999999,
"cep": "99999-999",
"endereco": "DESCRICAO LOGRADOURO",
"numEndereco": 0,
"compEndereco": "",
"bairro": "NOME BAIRRO",
"cidade": "NOME CIDADE",
"uf": "SP",
"limites": [
{
"cnpjFundo": "99999999999999",
"valorLimiteCredito": 999999999.99,
"percLimiteCredito": 0,
"dataInicioVigencia": "01/01/2024",
"dataFimVigencia": "31/12/2024"
}
]
}
]
}'Response Response Example
200 - response
[
{
"tipoPessoa": "J",
"cnpjCpf": "99999999999999",
"status": 1,
"descricao": "Pessoa atualizada com sucesso.",
"mensagens": []
}
]Modified at 2026-06-08 21:30:31