Obrei for Developers
Integre o ERP do seu cliente à plataforma Obrei em minutos. Sincronize catálogo e estoque via API REST — sem SDK proprietário, sem overhead.
https://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-syncÚnico endpoint necessário — POST com seu tokenCapacidades da integração
Token por loja
Cada lojista tem seu próprio token isolado. Revogue individualmente sem afetar outros.
Upsert inteligente
Cria ou atualiza produtos por nome. Envie o catálogo completo ou só o que mudou.
Zero exposição
A service_role_key nunca sai do servidor. O dev só vê o token da loja dele.
Importação CSV
Para lojistas sem ERP: upload manual de planilha direto no painel.
Sem SDK obrigatório
Um POST com JSON. Funciona em qualquer linguagem — cURL, Python, PHP, Java.
Rastreamento de uso
O campo ultimo_uso registra a última sincronização de cada token.
Autenticação
Toda requisição usa um token exclusivo da loja, fornecido pelo suporte Obrei. Apenas um header é necessário — nenhuma chave interna do banco é exposta.
✓ Sem chaves internas: seu token identifica apenas a loja vinculada. A service_role_key fica exclusivamente no servidor Obrei e nunca é transmitida.
Modelo de dados
A tabela produtos armazena o catálogo de cada loja. A combinação loja_id + nome é a chave de upsert.
| CAMPO | TIPO | OBRIG. | DESCRIÇÃO |
|---|---|---|---|
nome | text | sim | Nome do produto. Usado como chave de upsert. |
preco | decimal | sim | Preço de venda (ponto como separador decimal). |
estoque | integer | sim | Quantidade disponível em estoque. |
descricao | text | não | Descrição livre do produto. |
categoria | text | não | Categoria livre — ex: "Cimentos", "Tintas". |
tipo | text | não | Tipo ou subcategoria do produto. |
preco_comparacao | decimal | não | Preço "de" exibido riscado no app. |
custo | decimal | não | Custo interno — não visível ao cliente final. |
ativo | boolean | não | Visibilidade na loja. Padrão: true. |
imagem_url | text | não | URL pública da imagem do produto. |
Sincronizar produtos
POSTCria ou atualiza produtos em lote. Se o produto já existir (mesmo loja_id + nome), os campos são atualizados. Caso contrário, é inserido.
https://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-syncAtualizar estoque
PATCHAtualiza somente o estoque de um produto existente. Ideal para triggers de baixa no ERP sem precisar reenviar todo o cadastro.
https://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-sync— mesmo endpoint, basta enviar o estoque atualizadoImportação CSV
Para ERPs sem API disponível, o lojista pode exportar um .csv e importar manualmente pelo painel. O parser aceita colunas com nomes alternativos, com ou sem acentuação.
Exemplo
Sincronização automática
Configure o seu sistema para chamar o endpoint automaticamente sempre que o estoque ou o catálogo mudar. Nenhuma configuração adicional no Obrei é necessária — basta usar o mesmo token.
https://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-syncCódigos de erro
A API retorna erros em JSON com o campo error descrevendo o problema — ex: { "error": "Token inválido" }.
Pronto para integrar?
Solicite seu token de integração para começar.
Obrei Developer API — v1.0 · 2026
