Da sandbox para a empresa real
Como o que você construiu na sua empresa de teste passa a falar com uma empresa que já usa a Kernos.
/guias/da-sandbox-para-a-empresa-real.mdÍndice das páginas: /llms.txtO vínculo é a chave
A sua conta no portal enxerga a sandbox, que é sua. Uma empresa que já usa a Kernos é de quem a gere, e há dois vínculos entre vocês, que se somam: a chave ksk_live_, que a dona cria e entrega a você para escrever na empresa, e o convite, com o qual a dona deixa o seu e-mail ler o que a integração faz.
Com o convite, a empresa aparece em Console › Suas empresas: números das últimas 24 horas, o servidor do webhook, as entregas, os eventos (só o tipo e o horário, a menos que a dona libere o conteúdo) e os pedidos à API sem o corpo da resposta. É só leitura. Para entrar no portal por convite não precisa estar na lista de testes.
O que a dona da empresa faz
- Abre o app em Menu › Integrações › API da Kernos e escolhe Criar chave de produção.
- Marca só as ações de que a integração precisa (a chave nunca pode mais do que quem a cria), escolhe os CDs, se quiser limitar, e dá uma validade.
- Copia a chave na hora, porque ela aparece uma vez, e entrega por um canal seguro. Quem perder a chave pede uma nova; a antiga se revoga.
O que a dona faz para convidar
No mesmo lugar, em Menu › Integrações › API da Kernos, a seção Programadores tem o botão Convidar programador: o e-mail da pessoa, a validade (7, 30 ou 90 dias) e, se quiser, o conteúdo dos eventos. A Kernos não manda e-mail: ela passa a você o endereço do portal. Revogar o convite não cancela a chave que ela já entregou; a tela pergunta se quer revogá-la junto.
O que você muda no seu código
Só a chave. O prefixo escolhe o ambiente: com SDK ou CLI nada mais muda; com curl, o endereço passa de https://stag.kernos.com.br para https://api.kernos.com.br. O contrato, os campos, os erros e a versão (2026-10-03) são os mesmos.
O que é diferente em produção
| Sandbox (`ksk_test_`) | Empresa real (`ksk_live_`) | |
|---|---|---|
| Dados | De exemplo, só seus | Reais: um erro vira estoque ou pedido de verdade |
| Registro de pedidos | Guarda o corpo da resposta | Guarda só rota, status, código e duração |
| Limite | 10 pedidos por segundo | 25 pedidos por segundo |
| Console do portal | Mostra tudo | Não mostra; use kernos logs e kernos events com a chave de produção |
| Posições e produtos | Os de exemplo (TREINO-01, 12 produtos) | Os da empresa: leia antes de escrever |
Antes de ligar
- Comece por uma rota de leitura (
GET /v1/objects/product) para conferir a chave e o alcance. - Mande
Idempotency-Keyem toda escrita: uma nova tentativa não duplica o pedido. - Confira cada
error_codeque a sua integração pode receber, na página de erros. Recusa de produção é dado real do cliente: trate, não ignore. - Se a chave vazar, a dona revoga na mesma tela e cria outra.