API Docs v1 api.hubiss.com.br

Bem-vindo

Comece aqui: o que a API faz, como autenticar e o caminho mais rápido para a primeira requisição.

A API da Hubiss conecta o seu sistema (ERP, planilha ou plataforma própria) à plataforma: você cadastra lojas, categorias, marcas, produtos e fotos, e recebe pedidos dos marketplaces sem digitar nada duas vezes.

Em resumo
Base URL https://api.hubiss.com.br/v1 · autenticação por Authorization: Bearer SEU_TOKEN · respostas em JSON · 20 registros por página (máximo 20) · sem limite de requisições por token.

O que você consegue fazer

Recurso Para quê serve
Lojas Criar a estrutura que agrupa categorias e produtos
Categorias Montar a árvore de categorias de cada loja
Marcas Vincular produtos a fabricantes
Produtos Cadastrar e atualizar itens, incluindo variações e fotos
Pedidos Ler pedidos do marketplace, faturar, enviar e concluir
Webhooks Ser avisado em tempo real quando algo muda

Sua primeira requisição em 3 passos

  1. Gere o token no painel da Hubiss (ícone do usuário → Token API → Gerar Token). Veja Autenticação.
  2. Envie a requisição abaixo, trocando SEU_TOKEN pelo valor gerado.
  3. Confira a resposta: 200 com uma lista paginada significa que está tudo certo.
Exemplo em linha de comandobash
curl --request GET \
     --url 'https://api.hubiss.com.br/v1/stores' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer SEU_TOKEN'

Resposta esperada (resumida):

JSONjson
{
    "data": [
        {
            "id": "1",
            "name": "Minha loja",
            "status": "active"
        }
    ],
    "links": { "next": null },
    "meta": { "current_page": 1, "total": 1 }
}
Recebeu 401?
O token está ausente, inválido ou foi substituído por um novo. Ao gerar um token, o anterior deixa de funcionar imediatamente. Veja Erros.

Ordem que funciona

O cadastro tem dependência real entre recursos. Siga a sequência:

1 · Token painel 2 · Loja POST /stores 3 · Categorias .../categories 4 · Produtos .../products 5 · Fotos .../pictures 6 · Webhooks pedidos

Cada etapa depende da anterior: não existe produto sem loja e categoria.

Próximo passo
Leia o Fluxo completo de integração para ver cada etapa com payload, resposta e erros comuns.

Versão da API

Existe uma única versão pública, v1, e o compromisso é não quebrar integrações existentes. Mudanças incompatíveis só aconteceriam em uma versão nova.