Pular para o conteúdo
Criar minha loja
Menu ativo: início

Para desenvolvedores

A operação da loja, programável.

Feeds de catálogo, webhooks assinados, pedidos por API e um servidor MCP para agentes de IA — no mesmo sistema que já cuida da venda.

Feeds de catálogo

Os produtos publicados saem em feeds abertos — JSON paginado, XML para Google Merchant e TSV para catálogos de IA.

GET /feeds/{slug-da-loja}/products.json?page=1&limit=100

Pedidos e eventos de entrada

Integrações criam pedidos por endpoint assinado com credenciais Connect da loja, com chave de idempotência para tentativas repetidas.

POST /api/public/orders
POST /api/public/webhooks/in/{token}

Servidor MCP para agentes de IA

Clientes MCP leem o catálogo pelas ferramentas do servidor — produtos, clientes e vendas com isolamento por empresa.

POST /api/integrations/mcp
Authorization: Bearer <access_token>
X-Girabem-Tenant: <uuid_empresa>

Webhooks que avisam quando algo acontece.

Cada entrega vai assinada: valide a assinatura do corpo bruto, confira o timestamp e deduplique pelo identificador de entrega antes de processar. Estes são os eventos disponíveis hoje:

Vendas

  • sale.created

    Disparado quando uma nova venda/pedido é registrada (PDV, loja ou importação).

  • sale.paid

    Disparado quando uma venda é aprovada/paga.

  • sale.cancelled

    Disparado quando uma venda é cancelada.

  • sale.fulfilled

    Disparado quando um pedido é marcado como enviado/expedido (com rastreio).

Estoque

  • stock.updated

    Disparado a cada movimentação de estoque (entrada, saída, ajuste).

Fiscal

  • fiscal.note.issued

    Disparado quando uma nota fiscal (NF-e/NFC-e/NFS-e) é autorizada.

  • fiscal.note.cancelled

    Disparado quando uma nota fiscal é cancelada.

  • fiscal.note.error

    Disparado quando uma emissão fiscal é rejeitada ou retorna erro.

  1. Abra a empresa

    A documentação completa — contratos, credenciais e ferramentas — fica em Integrações e API dentro do painel, para empresas assinantes.

  2. Escolha o contrato

    Feeds públicos não pedem login. Pedidos e webhooks usam credenciais Connect assinadas; o MCP usa a sessão da sua empresa.

  3. Sem API genérica

    Não existe API REST geral nem chave permanente nesta versão: cada fluxo tem um contrato próprio, com assinatura e limites declarados.

Gira Bem

Abra a loja e conecte sua operação.

Criar minha loja