Conectar o Kamino
A Kamino não usa OAuth: você gera as chaves da API na Kamino e cola os cinco valores (App, CN, IDUsr, Usr, Hash) e a URL base da empresa.
A Kamino não usa OAuth: você gera as chaves da API na Kamino e cola os cinco valores (App, CN, IDUsr, Usr, Hash) e a URL base da empresa.
Antes de começar
Você precisa ser administrador no Prodio e ter acesso de administrador no Kamino. O Prodio guarda as chaves cifradas no servidor: ninguém consegue lê-las depois de salvas, nem pela tela.
Passo a passo
No Prodio, abra Configurações › Conectores e clique em Conectar no cartão do Kamino. A janela que abre mostra estes mesmos passos ao lado dos campos.
- Crie um usuário para a API. Na Kamino, crie (ou escolha) um usuário só para o Prodio, com permissão de ler NF-e de entrada. Criar o aplicativo exige a permissão Sistema/Parametrizador. Documentação da API Kamino.
- Gere as chaves da API. Na Kamino, abra Configurações › Sistema › Aplicativo e Usuários › Chaves da API e gere as chaves desse usuário para o aplicativo.
- Copie os cinco valores e a URL. Copie App, CN, IDUsr, Usr e Hash, e o "Link para API" (https://suaempresa.kamino.tech). Para testar, peça ao atendimento da Kamino as credenciais do sandbox (https://sandbox.kamino.tech).
- Salve e teste. Cole tudo nos campos abaixo e clique em "Salvar e testar conexão". As notas entram no Recebimento a cada ciclo.
Erros comuns
- HTTP 401 (sem permissão). O usuário da API não tem permissão na NF-e de entrada ou uma das chaves está errada. Confira as permissões e gere as chaves de novo.
- HTTP 429 (limite de requisições). A Kamino aceita 20 requisições por minuto por empresa. O Prodio espera e tenta de novo; evite outros sistemas usando o mesmo CN.
- Nota chega sem XML. A nota ainda não foi manifestada na Kamino. Manifeste lá; o Prodio relê a nota e completa o XML.