ObreiDevelopers
Solicitar acesso
v1.0

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.

⚡

Quickstart

Faça seu primeiro upsert de produto em menos de 5 minutos. Você vai precisar apenas do token de integração fornecido pelo suporte Obrei.

Solicitar acesso
javascript
const res = await fetch('https://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-sync', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SEU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    produtos: [{
      nome: 'Cimento CP-II 50kg',
      preco: 42.90,
      estoque: 200,
    }],
  }),
})

const data = await res.json()
// { ok: true, sincronizados: 1 }
Endpoint
https://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-syncÚnico endpoint necessário — POST com seu token

Capacidades 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.

HEADERVALOROBRIG.
AuthorizationBearer SEU_TOKENsim
Content-Typeapplication/jsonsim

✓ 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.

CAMPOTIPOOBRIG.DESCRIÇÃO
nometextsimNome do produto. Usado como chave de upsert.
precodecimalsimPreço de venda (ponto como separador decimal).
estoqueintegersimQuantidade disponível em estoque.
descricaotextnãoDescrição livre do produto.
categoriatextnãoCategoria livre — ex: "Cimentos", "Tintas".
tipotextnãoTipo ou subcategoria do produto.
preco_comparacaodecimalnãoPreço "de" exibido riscado no app.
custodecimalnãoCusto interno — não visível ao cliente final.
ativobooleannãoVisibilidade na loja. Padrão: true.
imagem_urltextnãoURL pública da imagem do produto.

Sincronizar produtos

POST

Cria ou atualiza produtos em lote. Se o produto já existir (mesmo loja_id + nome), os campos são atualizados. Caso contrário, é inserido.

POSThttps://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-sync
curl -X POST 'https://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-sync' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "produtos": [
      {
        "nome": "Cimento CP-II 50kg",
        "categoria": "Cimentos",
        "preco": 42.90,
        "estoque": 200,
        "ativo": true
      }
    ]
  }'

Atualizar estoque

PATCH

Atualiza somente o estoque de um produto existente. Ideal para triggers de baixa no ERP sem precisar reenviar todo o cadastro.

POSThttps://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-sync— mesmo endpoint, basta enviar o estoque atualizado
curl -X POST 'https://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-sync' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "produtos": [
      { "nome": "Cimento CP-II 50kg", "preco": 42.90, "estoque": 185 }
    ]
  }'

Importaçã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.

Coluna

nome
name, produto, product
preco
price, preço, valor
estoque
stock, qty, quantidade
categoria
category, cat
descricao
description, desc
custo
cost, cogs
ativo
active, disponivel

Exemplo

csv
nome,categoria,preco,custo,estoque,ativo
Cimento CP-II 50kg,Cimentos,42.90,31.00,200,true
Tinta Látex 18L Branco,Tintas,189.90,120.00,45,true
Rejunte Cinza 1kg,Acabamento,12.50,7.80,300,true

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.

POSThttps://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-sync
bash
# Configure no seu sistema para chamar automaticamente
# sempre que o estoque ou catálogo mudar.

curl -X POST 'https://njzthxxlnttlcsdapvtq.supabase.co/functions/v1/erp-sync' \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "produtos": [
      { "nome": "Cimento CP-II 50kg", "preco": 42.90, "estoque": 185 },
      { "nome": "Tinta Látex 18L Branco", "preco": 189.90, "estoque": 40 }
    ]
  }'

Códigos de erro

A API retorna erros em JSON com o campo error descrevendo o problema — ex: { "error": "Token inválido" }.

401

Unauthorized

Token ausente, inválido ou não encontrado no sistema.

403

Forbidden

Token revogado. Entre em contato com o suporte do Obrei.

422

Unprocessable

Body inválido — esperado array de produtos. Produto sem "nome", "preco" ou "estoque".

500

Internal Error

Erro interno ao salvar no banco. Verifique os tipos dos campos e tente novamente.

Pronto para integrar?

Solicite seu token de integração para começar.

Solicitar acesso →

Obrei Developer API — v1.0 · 2026