Integração com ERPs
Documentação da API.
Referência para o desenvolvedor do sistema integrado: autenticação, campos, exemplos e códigos de erro. O acesso exige uma chave, fornecida pela Kesher Capital ao integrador cadastrado.
Autenticação
Toda chamada leva a chave da integração no cabeçalho Authorization. A chave é gerada no cadastro da integração e pode ser renovada a qualquer momento; a anterior deixa de valer na hora. Integração inativa recebe 403.
Authorization: Bearer kc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Content-Type: application/json Accept: application/json
Limite: 60 chamadas por minuto por integração. Endereço base: https://keshercapital.com.br/api/v1
POST https://keshercapital.com.br/api/v1/solicitacoes
Envia uma solicitação de crédito em nome do comprador PJ. Equivale ao formulário público do site. Resposta 201 com o protocolo.
Campos
| Campo | Obrigatório | Descrição |
|---|---|---|
| cnpj | sim | CNPJ do comprador, com ou sem pontuação. Validado pelos dígitos verificadores. |
| razao_social | sim | Razão social do comprador. |
| site | não | Rede social ou site do comprador (endereço ou perfil, até 200 caracteres). |
| faturamento_mensal | sim | Faturamento médio mensal em reais (número, ponto decimal). |
| responsavel_nome | sim | Representante da empresa que autorizou a solicitação. |
| responsavel_email | sim | E-mail do representante. Recebe o protocolo e os avisos de andamento. |
| responsavel_telefone | sim | Telefone ou WhatsApp. |
| empresa_ancora | não | Fornecedor do pedido (empresa âncora). |
| numero_pedido | não | Número ou referência do pedido no ERP. |
| valor | sim | Valor solicitado em reais. Mínimo 1000. |
| prazo_meses | sim | Prazo desejado, de 1 a 120 meses. |
| finalidade | sim | Um de: estoque, capital_giro, equipamentos, outro. |
| observacoes | não | Texto livre, até 2000 caracteres. |
| consentimento | sim | true. Declara que o representante autorizou o tratamento dos dados nos termos da Política de Privacidade (termo 2026-09.v1). O ERP é responsável por colher e guardar essa autorização. |
| consentimento_bureau | não | true se o representante autorizou a consulta do CNPJ em bureaus de crédito. |
| documentos | não | Lista de até 20 arquivos: tipo (contrato_social, extratos, faturamento, documentos_socios, balanco, comprovante_endereco, outros), nome_arquivo e conteudo_base64. Formatos: pdf,jpg,jpeg,png,xls,xlsx,csv,doc,docx. Até 20 MB cada. |
Exemplo de envio
{
"cnpj": "11.222.333/0001-81",
"razao_social": "Mar Azul Equipamentos Ltda",
"site": "instagram.com/marazulequipamentos",
"faturamento_mensal": 185000,
"responsavel_nome": "Ana Reis",
"responsavel_email": "[email protected]",
"responsavel_telefone": "(44) 99999-0000",
"empresa_ancora": "Ozoxx",
"numero_pedido": "PED-2048",
"valor": 48000,
"prazo_meses": 24,
"finalidade": "capital_giro",
"observacoes": "Compra de equipamentos para a nova unidade.",
"consentimento": true,
"consentimento_bureau": true,
"documentos": [
{
"tipo": "contrato_social",
"nome_arquivo": "contrato-social.pdf",
"conteudo_base64": "JVBERi0xLjQK..."
}
]
}
Resposta 201
{
"protocolo": "KC-2609-A1B2C3",
"etapa": "Solicitação recebida",
"mensagem": "Recebemos seus dados. Nossa equipe entrará em contato para validar as informações e solicitar os documentos.",
"encerrada": false,
"enviada_em": "2026-09-22T10:15:00-03:00",
"atualizada_em": "2026-09-22T10:15:00-03:00",
"acompanhar_url": "https://keshercapital.com.br/acompanhar?protocolo=KC-2609-A1B2C3"
}
Erros
401chave ausente ou inválida ·403integração inativa ·429limite de chamadas422dados inválidos. O corpo traz{"erro": "...", "campos": {"campo": ["mensagem"]}}. Nada é registrado.
GET https://keshercapital.com.br/api/v1/solicitacoes/{protocolo}
Andamento de uma solicitação enviada pela própria integração, no mesmo formato da resposta acima. Solicitações de outras origens retornam 404.
Exemplo com curl
curl -X POST https://keshercapital.com.br/api/v1/solicitacoes \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"cnpj":"11.222.333/0001-81","razao_social":"Mar Azul Equipamentos Ltda","faturamento_mensal":185000,"responsavel_nome":"Ana Reis","responsavel_email":"[email protected]","responsavel_telefone":"(44) 99999-0000","valor":48000,"prazo_meses":24,"finalidade":"capital_giro","consentimento":true}'
Depois do envio, o fluxo é o mesmo do site: o representante recebe o protocolo por e-mail, a análise de pré-elegibilidade roda automaticamente e cada mudança de etapa gera um novo aviso. A plataforma não é banco e a solicitação não representa aprovação de crédito.