Changelog
Mudanças na API e nos webhooks. Mudanças compatíveis entram sem nova versão; incompatíveis só numa nova versão, com 12 meses de aviso.
v1.4.0
Atacado e embalagens de venda no catálogo
- Produtos agora trazem
wholesale(faixas por quantidade até 5, pedido mínimo, múltiplos e grades fechadas) epackagings(dúzia, caixa, fardo…: peças, preço por peça na embalagem, faixas por quantidade de embalagens, mistura por opção, só atacado) maispackaging_only.POST/PATCH /productsaceitam os mesmos campos: cada grupo é substituído por inteiro quando enviado (null/[]remove) e mantido quando omitido. - Pedidos:
sale_type(varejo / atacado) e, em cada linha,price_type(varejo / membro / atacado) epackaging(a embalagem comprada: nome, peças, quantidade de embalagens; a quantidade da linha continua em peças). - MCP:
create_producteupdate_productaceitamwholesale,packagingsepackaging_only;get_productdevolve tudo.
v1.3.0
Montagem da loja pela API e pelos assistentes de IA
- Novo escopo
store:writee tag Design:GET/PATCH /theme, seções da página inicial (POST /theme/sections,PATCH/DELETE /theme/sections/{section_id}), versões do tema (GET /theme/versions,POST /theme/versions/{version_id}/restore), menus (GET/PUT /menus) e páginas institucionais (GET/POST /pages,PATCH /pages/{page_id}). Documentos em snake_case; categorias, coleções e páginas referenciadas são validadas. - Toda gravação do tema guarda a versão anterior (até 10), inclusive as feitas pelo editor do painel:
restore_theme_versiondesfaz uma reforma com uma chamada. - MCP: 12 ferramentas de design (
get_theme,update_theme,add_section,set_menus,create_page…), o recursotfshop://design-guidee os promptsredesign_home,seasonal_campaignewrite_store_page.
v1.2.0
Catálogo para ERPs: categorias, variantes e imagens
- Novo
GET /categories: lista as categorias da loja com o caminho completo, para escolher ocategory_idao cadastrar produtos a partir do ERP. PATCH /products/{product_id}aceitavariants: o conjunto é casado por SKU (variantes existentes mantêm id e unidades reservadas, SKUs novos são criados, SKUs ausentes são removidos);on_handaltera o estoque só quando enviado.image_urldefine a foto da variante.- Imagens enviadas por URL (galeria e
image_url) são copiadas para a biblioteca de mídia da loja logo após a gravação; a API passa a devolver URLs absolutas das imagens, inclusive das enviadas pelo painel. descriptioné texto puro: tags HTML enviadas por apps são removidas, mantendo as quebras de linha.
v1.1.0
Conector MCP e OAuth 2.1
- Servidor MCP do lojista em
https://tfshopcloud.com.br/mcp: 35 ferramentas, 6 recursos e 7 prompts que empacotam a API/v1(mesmos escopos, limites, idempotência e auditoria). Guia em Assistentes de IA (MCP). - Servidor de autorização OAuth 2.1 no mesmo host:
/oauth/authorize,/oauth/token,/oauth/register(DCR),/oauth/revokee os metadados/.well-known/oauth-protected-resourcee/.well-known/oauth-authorization-server. PKCES256, CIMD,issnas respostas, refresh token com rotação. Apps parceiros usam o mesmo fluxo. - Novo endpoint
GET /storee escopostore:read: perfil da loja (CNPJ, domínio, emissor da NF-e, limites do plano, moeda e fuso). - MCP anônimo por loja em
/s/{slug}/mcp(e no domínio próprio da loja): 13 ferramentas de descoberta, carrinho e encaminhamento ao checkout. Pedido e pagamento continuam na página da loja. - Painel: aba Assistentes de IA em Aplicativos e API, para ver e desconectar assistentes.
v1.0.0
Primeira versão pública
- 36 endpoints REST em
/v1: produtos e variantes, preços e estoque por SKU, pedidos, NF-e emitida pelo ERP, envios, webhooks e eventos. - 14 tipos de evento por webhook, assinados no padrão Standard Webhooks, com novas tentativas, reenvio e 30 dias de histórico em
/events. - Tokens da loja (
tfs_live_etfs_test_) e apps parceiros com OAuth 2.0 + PKCE, analisados pela TF. - 12 escopos, com os dados pessoais isolados em
orders.pii:read. - Erros RFC 9457,
Idempotency-Key, paginação por cursor e limite de 5 requisições por segundo por token (picos de 50). - Documento OpenAPI 3.1 em /developers/openapi.json.