Documentação para Desenvolvedores

A API da Sellit permite que ERPs, marketplaces, automações e sistemas logísticos leiam e atualizem os dados de uma loja com autorização segura. É a mesma base usada por integrações de mercado como a do Bling, com a mesma robustez e sem complexidade desnecessária.

• Listar, criar, atualizar e excluir produtos e variações.
• Atualizar estoque do produto ou por SKU de forma dedicada.
• Consultar pedidos, atualizar status de envio e reembolsar.
• Ler categorias e clientes; enviar imagens de produtos.
• Calcular o frete dos seus produtos no checkout (CarrierService).
• Receber webhooks de product.*, stock.updated e order.* assinados com HMAC.

Escolha o modo conforme quem vai integrar. Os dois chamam os mesmos endpoints /api/v1/* com Authorization: Bearer.

• Token de API da loja — o próprio lojista gera um token no painel e conecta o ERP dele em minutos. Sem App, sem tela de consentimento, sem refresh. Ideal para integração privada de uma loja só.
• OAuth 2.0 — para quem publica um App que várias lojas instalam. O lojista autoriza seu App e você recebe um token por loja, com escopos e refresh.

Se o seu App cria produtos na loja via API, ele também pode calcular o frete desses produtos no checkout. Você registra uma URL de cotação e a Sellit a chama de forma síncrona durante o checkout — no mesmo estilo do CarrierService da Shopify. Vale apenas para itens cujo produto foi criado pelo seu App (campo sourceClientId); produtos do próprio lojista seguem usando o cálculo de frete normal da loja.

1. •

   1. Registre o provedor de frete

   Com escopo shipping:write, envie a URL que receberá as cotações. O secret (usado para assinar as chamadas) é retornado uma única vez — guarde-o com segurança.

   http

   POST /api/v1/shipping/providers
   Authorization: Bearer <access_token>
   Content-Type: application/json
   
   { "url": "https://seu-app.com/sellit/frete" }
   
   → 201 { "id": "...", "url": "...", "secret": "shpsec_..." }

   Cada App tem um provedor por loja. Para trocar a URL ou desativar, use PATCH /api/v1/shipping/providers/{id} com { url?, active? }; para remover, use DELETE. Liste os registros com GET /api/v1/shipping/providers (escopo shipping:read).

2. •

   2. Receba a cotação no checkout

   No checkout, a Sellit faz um POST na sua URL com o CEP de destino e os itens do App. O corpo é assinado em X-Sellit-Signature-256 (HMAC-SHA256 do corpo cru com o seu secret) — valide antes de responder.

   json

   POST https://seu-app.com/sellit/frete
   X-Sellit-Signature-256: sha256=<hmac>
   
   {
     "destination": { "cep": "01310100" },
     "items": [
       { "productId": "...", "sku": null, "quantity": 1, "price": 89.9, "weightKg": 0.3 }
     ]
   }

3. •

   3. Responda com as opções de frete

   Devolva as tarifas em rates. Só entram itens com id, name e price numérico; deliveryTime é opcional.

   json

   {
     "rates": [
       { "id": "expressa", "name": "Entrega expressa", "price": 24.9, "deliveryTime": "2 dias úteis" },
       { "id": "economica", "name": "Econômica", "price": 12.5 }
     ]
   }