Para o parceiro: criar uma integração
Você não precisa programar. Em poucos minutos você cria a integração no painel e entrega ao seu programador só o que ele precisa.
Esta página é para você, parceiro. O resto da documentação é para quem programa.
O que é isso, em uma frase
Uma integração é uma chave que você cria para um sistema seu (um ERP, uma automação) conversar com a OTL no seu lugar: consultar o catálogo, o preço de atacado e o estoque.
Essa chave se chama token. Você nunca entrega a sua senha a ninguém — só o token.
Antes de começar
Você precisa que a OTL tenha liberado a API para a sua conta. Se a opção Integrações não aparece no seu menu:
- Entre em Minha conta e clique em Integrações e API.
- Clique em Solicitar acesso à API, conte o que quer integrar e quem vai programar.
- Aguarde o retorno da equipe OTL.
Criando a integração
- No menu, abra Integrações.
- Clique em Nova integração.
- Na primeira vez, leia e aceite os Termos de Uso da API.
- Dê um nome que diga o sistema e quem programou. Exemplo: Bling – João Dev. É por esse nome que você vai saber, depois, qual chave desligar.
- Marque as permissões. Peça ao programador a lista do que ele precisa, e marque só isso.
- Escolha a validade. Para começar, 30 dias é uma boa escolha: você renova quando vencer.
- Clique em Criar e gerar token.
O token aparece uma única vez
Ao criar, a tela mostra o token e um texto pronto para enviar ao programador, com tudo o que ele precisa.
Depois de fechar, ninguém consegue ver o token de novo — nem você, nem a OTL. Se perder, não é problema: clique em Novo token na integração e envie o novo ao programador.
Envie o token por um canal privado: mensagem direta, nunca em grupo.
Testando antes de valer
Se a OTL liberou o Ambiente de testes para você, ele aparece na mesma tela, num bloco azul. Ali
você cria um token de teste (começa com otl_sbx_) e entrega ao programador para ele desenvolver
sem risco: nada do que é feito lá vale de verdade.
Quando a integração estiver funcionando no teste, você cria o token de produção.
Cuidando das integrações
Na lista de integrações você vê, para cada uma, quando foi usada pela última vez e até quando vale.
| Situação | O que fazer |
|---|---|
| O token vai vencer | Clique em Novo token e envie o novo ao programador |
| Trocou de programador ou de sistema | Clique em Revogar na integração antiga e crie outra |
| Acha que o token vazou | Revogue na hora e avise a OTL |
| Aviso “sem uso há mais de 90 dias” | Se ninguém usa mais, revogue |
| Quer dar ou tirar uma permissão | Clique em Editar — o token continua o mesmo |
Revogar faz o token parar de funcionar imediatamente, e não dá para desfazer.
Sua responsabilidade
O que for feito com o token é feito em seu nome. Entregue-o só a quem você confia, com as permissões mínimas, e revogue quando a pessoa ou o sistema deixar de atender você.