1. Pessoas/Limites de Crédito
Qgestora API
  • Qgestora API
    • Guia de Integração
      • Primeiros Passos & Autenticação
    • Operações
      • Validar Operação
      • Importar Operação
      • Imporar Documentação de Lastro
      • Cancelar Operação
    • Retorno de Status de Operação
      • Callback: Retorno de Status da Operação
    • Pessoas/Limites de Crédito
      • Importar Cedente/Limite de Crédito
        POST
      • Importar Pessoa/Limite de Crédito
        POST
    • Esquemas
      • ValidateImportCnabRequest
      • ImportCnabRequest
      • ImportReceivableDocumentationRequest
      • ReceivableDocumentationFile
      • ReturnCnabSituationRequest
      • CnabInformation
      • ExceptionResponse
      • ExceptionResponseError
      • TransferorData
      • TransferorCreditLimit
      • ImportTransferorLimitRequest
      • ImportTransferorLimitResponse
      • PersonData
      • PersonCreditLimit
      • ImportPersonLimitRequest
      • ImportPersonLimitResponse
      • ImportMessage
      • OperationCancellationRequest
      • CancellationExceptionResponse
      • CancellationExceptionResponseError
  1. Pessoas/Limites de Crédito

Importar Pessoa/Limite de Crédito

POST
/v1/import-person-limit
Importa o cadastro de uma ou mais pessoas e/ou seus limites de crédito para inclusão/atualização na base do Qgestora.
Atualmente a importação só está disponível para pessoas do tipo Cedente.

Tipo Entidade#

CódigoDescrição
CCedente
SSacado

Tipo Pessoa#

CódigoDescrição
FFísica
JJurídica

Estado Civil#

CódigoDescrição
1Casado (a)
2Separado (a)
3Solteiro (a)
4Viúvo (a)
5Divorciado (a)
6Desquitado (a)
7União Estável

Regime Casamento#

CódigoDescrição
1Comunhão Parcial de Bens
2Comunhão Universal de Bens
3Separação Total de Bens

Status Importação Pessoa#

CódigoDescrição
01Pessoa atualizada com sucesso.
02Pessoa atualizada com ressalvas.
03Pessoa não atualizada.
04Limite(s) de crédito atualizado(s) com sucesso.
05Limite(s) de crédito atualizado(s) com ressalvas.
06Limite(s) de crédito não atualizado(s).
07Pessoa e limite(s) de crédito atualizados com sucesso.
08Pessoa e limite(s) de crédito atualizados com ressalvas.
09Pessoa não atualizada. Limite(s) de crédito atualizado(s).
10Pessoa atualizada. Limite(s) de crédito não atualizado(s).
11Pessoa atualizada com ressalvas. Limite(s) de crédito não atualizado(s).
12Pessoa e limite(s) de crédito não atualizados.

Requisição

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200
application/json
Sucesso. Retorna validações ou mensagem de lista vazia.

Mensagens de Validação dos Limites

As mensagens de validação dos limites são retornadas no HTTP 200 dentro do array mensagens de cada pessoa, com tipo ERRO ou ALERTA.
TipoMensagem
ERRO[Limite]: Fundo com CNPJ: {cnpj} não foi encontrado.
ERRO[Limite]: CNPJ informado para o fundo: {cnpj}, é inválido.
ERRO[Limite]: Fundo CNPJ: {cnpj}. "{campo}" possui caracteres inválidos ou excede o tamanho máximo.
ERRO[Limite]: Limite de crédito não informado para o fundo CNPJ: {cnpj}.
ERRO[Limite]: ... Data Início Vigência é um campo obrigatório.
ERRO[Limite]: ... Data Início Vigência deve ser maior ou igual à Data Atual.
ERRO[Limite]: ... Data Fim Vigência deve ser maior que a Data Início Vigência.
ALERTA[Limite]: ... O limite importado irá sobrepor o(s) limite(s) ativo(s) existente(s).
Bodyapplication/json

🟠401
🔴500
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": []
    }
]
Modificado em 2026-07-07 19:14:04
Página anterior
Importar Cedente/Limite de Crédito
Próxima página
ValidateImportCnabRequest
Built with