Ir para o conteúdo

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

CampoObrigatórioDescrição
cnpjsimCNPJ do comprador, com ou sem pontuação. Validado pelos dígitos verificadores.
razao_socialsimRazão social do comprador.
sitenãoRede social ou site do comprador (endereço ou perfil, até 200 caracteres).
faturamento_mensalsimFaturamento médio mensal em reais (número, ponto decimal).
responsavel_nomesimRepresentante da empresa que autorizou a solicitação.
responsavel_emailsimE-mail do representante. Recebe o protocolo e os avisos de andamento.
responsavel_telefonesimTelefone ou WhatsApp.
empresa_ancoranãoFornecedor do pedido (empresa âncora).
numero_pedidonãoNúmero ou referência do pedido no ERP.
valorsimValor solicitado em reais. Mínimo 1000.
prazo_mesessimPrazo desejado, de 1 a 120 meses.
finalidadesimUm de: estoque, capital_giro, equipamentos, outro.
observacoesnãoTexto livre, até 2000 caracteres.
consentimentosimtrue. 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_bureaunãotrue se o representante autorizou a consulta do CNPJ em bureaus de crédito.
documentosnãoLista 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

  • 401 chave ausente ou inválida · 403 integração inativa · 429 limite de chamadas
  • 422 dados 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.