Sua loja, ligada ao que você já usa.

1. 1

   Abra Desenvolvedores

   No painel, em Ajustes → Configurações → Desenvolvedores.

2. 2

   Gere um token

   Escolha, por área, o que ele pode ler e o que pode alterar.

3. 3

   Faça a primeira chamada

   Envie o token no cabeçalho, ou conecte um assistente pelo MCP.

curl "https://app.simplese.com.br/api/v1/pedidos?status=confirmado" \
  -H "Authorization: Bearer smp_int_SEU_TOKEN"

Prefere importar tudo de uma vez? O arquivo OpenAPI abre no Postman, no Insomnia e em geradores de cliente.

Toda chamada leva Authorization: Bearer <token>. O token começa com smp_int_, aparece uma única vez ao ser criado e vale por 30 dias, 90 dias ou 1 ano.

• Nunca pode mais que quem o criou

  Se o acesso da pessoa diminuir, o do token diminui junto, na hora.

• Não move dinheiro

  A Conta Digital é só leitura para qualquer token: saldo e extrato.

• Revogar é imediato

  Na mesma tela em que o token foi criado, com a data do último uso.

• O plano da loja vale para o token

  Um recurso que o plano não inclui responde 403 também pela API.

A Simplese tem um servidor MCP: o padrão que o Claude, o ChatGPT e outros assistentes usam para agir em sistemas de fora. Conectado, o assistente consulta e altera a loja a pedido seu, dentro do que você liberar.

https://app.simplese.com.br/api/mcp

O que pedir depois de conectar

• “Quais pedidos estão aguardando pagamento?”
• “Liste os produtos com estoque abaixo de 5 unidades.”
• “Cadastre a camiseta básica preta por R$ 59,90, com 20 em estoque.”
• “Quanto tenho a receber nos próximos 15 dias?”
• “Quem são meus cinco melhores clientes do mês?”

As 32 ferramentas

O assistente só enxerga as que a permissão concedida alcança. As que alteram dados vêm marcadas, para o assistente pedir a sua confirmação antes de usar.

Endereço base: https://app.simplese.com.br/api/v1. Envie e receba JSON. A resposta traz o resultado em data; listas trazem também meta com page, perPage, total e totalPages. Valores em dinheiro são números em reais.

* obrigatório.

A loja avisa o seu sistema quando algo acontece, com um POST em JSON para um endereço HTTPS público. Cadastre o endereço em Desenvolvedores, no painel, nos planos que incluem webhooks.

{
  "id": "evt_01J8ZQ...",
  "type": "order.paid",
  "createdAt": "2026-10-06T14:32:10.000Z",
  "data": {
    // os dados do pedido, produto ou cliente
  }
}

Cada entrega leva três cabeçalhos: X-Simplese-Event, X-Simplese-Delivery e X-Simplese-Signature, no formato t=<unix>,v1=<hmac>. Confira a assinatura antes de confiar no corpo:

import { createHmac, timingSafeEqual } from "node:crypto";

// v1 = HMAC-SHA256 de "<t>.<corpo>" com o segredo do endereço, em hexadecimal
const [t, v1] = cabecalho.split(",").map((parte) => parte.split("=")[1]);
const esperado = createHmac("sha256", SEGREDO).update(`${t}.${corpoCru}`).digest("hex");

const confere =
  v1.length === esperado.length && timingSafeEqual(Buffer.from(v1), Buffer.from(esperado));

• Responda com status 2xx em até 10 segundos.
• Entrega que falha é tentada de novo, até 6 vezes.
• O endereço é pausado depois de 20 falhas seguidas, e você reativa no painel.
• Use X-Simplese-Delivery para ignorar repetições.

600 requisições por minuto por loja, somando API e MCP. Acima disso a resposta é 429, com Retry-After dizendo em quantos segundos tentar de novo.

{
  "error": {
    "code": "FORBIDDEN",
    "message": "Você não tem permissão para esta ação.",
    "correlationId": "req_..."
  }
}

Informe o correlationId ao falar com o suporte: é por ele que achamos a sua chamada.