Em poucas palavras
A API da Sellit deixa outro sistema ler e escrever na sua loja: produtos, estoque, pedidos, clientes, frete e imagens. Você gera um Token de API em Configurações › Integrações, marca só os escopos necessários e usa ele como Bearer nas chamadas. Está em todos os planos, e a documentação técnica fica em docs.sellit-br.com.
Pra que serve
Você já tem um ERP, um sistema de estoque ou uma planilha que manda na operação — e digitar o mesmo produto duas vezes é trabalho jogado fora. A API resolve isso: o seu sistema conversa direto com a loja, cria produto, atualiza estoque e lê pedido, sem ninguém copiar e colar.
Ela serve quando não existe integração pronta para o seu caso. Se o seu sistema é Bling, Mercado Livre, Shopee ou Olist, o caminho mais curto é a integração nativa, na mesma tela — a API é para o que sobra.
Para quem isto é
Lojista que tem um ERP ou sistema próprio e quer sincronizar catálogo e estoque sem digitação dupla.
Quem contratou um desenvolvedor para automatizar algo específico da operação.
Quem quer ser avisado quando um pedido é pago ou o estoque muda, sem ficar consultando o painel.
Se você não programa e não tem quem programe, esta página provavelmente não é para você. Não há nada aqui que se resolva só clicando.
Como fazer
Abra as integrações da loja
No menu da esquerda, clique em Configurações e depois na aba Integrações. Role até o cartão 06, Tokens de API da loja.
Clique em Gerar token
O cartão mostra quantos tokens você tem ativos. O botão fica no canto de cima, à direita dele.
Dê um nome que você reconheça depois
Escreva no campo Nome algo como "Integração com o ERP". É por esse nome que você vai saber qual revogar daqui a seis meses.
Marque só os escopos necessários
Cada escopo libera uma coisa. Um sistema que só lê catálogo não precisa de products:write nem de orders:write.
Escolha a validade
Em Validade, clique em Nunca, 90 dias ou 1 ano. Para integração que vai rodar sozinha, 1 ano é o equilíbrio entre segurança e não esquecer de renovar.
Copie o token na hora
Ao clicar em Gerar token, o valor aparece uma vez só. Copie e guarde no cofre de senhas do seu sistema — ele não é mostrado de novo.
Confira o token na lista
De volta ao cartão, o token aparece com o nome, os últimos caracteres, quantos escopos tem, a data de criação e o último uso. O botão Revogar apaga ele na hora.
Os onze escopos, em português
Escopo | O que libera |
|---|---|
products:read | Ver seus produtos |
products:write | Criar e editar produtos |
stock:write | Atualizar o estoque dos produtos |
categories:read | Ver as categorias da loja |
customers:read | Ver seus clientes |
orders:read | Ver seus pedidos |
orders:write | Atualizar status e reembolsar pedidos |
shipping:read | Consultar fretes e rastreamento |
shipping:write | Gerar etiquetas e atualizar envios |
media:write | Enviar imagens de produtos |
webhooks:manage | Gerenciar webhooks |
Marque o mínimo que resolve. Um token roubado só faz o que os escopos dele permitem — e é essa a diferença entre um susto e um problema.
Ser avisado em vez de ficar perguntando
Com o escopo `webhooks:manage` o seu sistema se inscreve para receber um aviso quando algo acontece na loja, em vez de consultar a API de minuto em minuto. Os eventos que existem hoje são: produto criado, produto atualizado, produto apagado, estoque atualizado, pedido criado, pedido pago, pedido enviado e pedido estornado.
Como o token é usado
O token vai no cabeçalho `Authorization`, no formato `Bearer <seu-token>`. A primeira chamada que vale fazer é a de conferência: ela devolve a qual loja o token pertence e quais escopos ele tem — se o retorno não for a sua loja, pare e confira o token antes de seguir.
A documentação técnica, com os endereços de cada rota e os exemplos prontos, fica em docs.sellit-br.com. O cartão no painel tem o link direto para o guia de integração em 15 minutos.
O que você ganha
O catálogo para de ser cadastrado duas vezes.
O estoque do ERP e o da loja andam juntos, então some a venda de produto que já acabou.
O pedido novo chega no seu sistema sem ninguém copiar.
Você escolhe o que cada integração pode fazer, e revoga em um clique quando o contrato acaba.
Dicas para não errar
O token aparece uma vez só. Fechou a janela sem copiar? Revogue e gere outro — não há como ver de novo.
Nunca ponha o token no navegador, em aplicativo de celular ou em código que o cliente consegue ler. Ele vale no servidor do seu sistema, e só lá.
Um token por integração, com nome. Dois sistemas no mesmo token viram um problema quando você precisa cortar o acesso de um deles.
Marcar todos os escopos por preguiça é o erro mais comum. Se o sistema só lê, marque só os `:read`.
Antes de escrever código, veja se já existe integração pronta: Bling, Mercado Livre, Shopee e Olist estão na mesma tela.
A coluna "Último uso" do cartão diz se a integração está viva. Token com "nunca" há meses é token para revogar.
Quando não vale a pena usar
- Não serve para quem não programa. Não existe tela de configuração visual aqui: o token é matéria-prima para código, e sem um desenvolvedor ele não faz nada sozinho.
- Não substitui as integrações prontas. Para Bling, Mercado Livre, Shopee e Olist, a integração nativa da mesma tela é mais rápida e não exige manutenção.
- Não exporta sua base de clientes em planilha. O escopo customers:read serve para o seu sistema ler os dados, não para você baixar um arquivo.
- O token não pode ser visto de novo depois de criado. Se você perder, o único caminho é revogar e gerar outro, atualizando o seu sistema.
Perguntas frequentes
- Perdi o token que copiei. Onde eu vejo de novo?
- Em lugar nenhum. Por segurança, o valor é mostrado uma única vez, no momento da criação. Revogue o token antigo no cartão de Tokens de API e gere um novo.
- A API está em qual plano?
- Em todos. Gerar token de API não exige plano PRO nem FULL — o que muda por plano são outros recursos da loja, não o acesso à API.
- Qual a diferença entre a API e a integração com o Bling?
- A integração com o Bling já está pronta e é ligada clicando na própria tela. A API é para quando não existe integração pronta para o seu sistema e alguém vai escrever o código da conexão.
- Onde fica a documentação técnica com as rotas?
- Em docs.sellit-br.com, que é o endereço da documentação para desenvolvedores. O cartão de Tokens de API no painel tem um link direto para o guia de integração em 15 minutos.