Integrações suportadas¶

A Gubee integra com 19+ marketplaces, ERPs, plataformas de e-commerce e transportadoras. Esta página lista as integrações ativas e seus metadados.

Como ler esta página¶

Cada integração tem um nome interno canônico (ex.: MERCADOLIVRE) usado em paths de API como {platform}. O nome de exibição é o que aparece no painel Gubee. Os demais metadados — categoria, popularidade, dificuldade de setup — são informativos e podem ser obtidos dinamicamente via API.

Use a API como fonte de verdade

A tabela abaixo reflete o estado atual do catálogo, mas a lista canônica é sempre a retornada por GET /integration/platforms/configuration. Não hardcode esta lista em código de produção — consulte a API em runtime.

Endpoints canônicos¶

Lista de plataformas configuradas¶

curl -X GET "$GUBEE_API/integration/platforms/configuration" \
  -H "Authorization: Bearer $JWT"

Retorna List<PlatformConfigurationApiDTO> com code, label, type, publishType e orderStatus por plataforma. Veja Plataformas suportadas para o schema completo.

Blacklist de criação de pedido¶

Algumas plataformas (notadamente Shein e TikTok Shop) não suportam criação de pedido pela API — apenas recebem a notificação do marketplace. Para verificar dinamicamente:

curl -X GET "$GUBEE_API/integration/platforms/blacklist/created" \
  -H "Authorization: Bearer $JWT"

[
  { "name": "SHEIN", "status": "CREATED" },
  { "name": "TIKTOKSHOP", "status": "CREATED" }
]

Não tente criar pedido em plataforma blacklistada

Para essas plataformas, POST /integration/orders/create retorna 422. O pedido é criado diretamente no marketplace e a Gubee apenas recebe o webhook. Seu ERP precisa ouvir o evento order.created para essas plataformas em vez de tentar push.

Marketplaces¶

Mercado Livre¶

Campo	Valor
Nome interno	`MERCADOLIVRE`
Categoria	`MARKETPLACE`
Popularidade	98
Setup	EASY
Multi-conta	sim
Notas	Líder na América Latina. Setup via OAuth simples.

Amazon¶

Campo	Valor
Nome interno	`AMAZONV2`
Categoria	`MARKETPLACE`
Popularidade	95
Setup	MEDIUM
Multi-conta	sim
Notas	Conector v2 (SP-API). Substituiu o `AMAZON` legado.

Shopee¶

Campo	Valor
Nome interno	`SHOPEE`
Categoria	`MARKETPLACE`
Popularidade	85
Setup	EASY
Multi-conta	sim
Notas	Mobile-first, crescimento rápido no Brasil. Sem criação de pedido via API.

Magalu¶

Campo	Valor
Nome interno	`MAGALU`
Categoria	`MARKETPLACE`
Popularidade	88
Setup	MEDIUM
Multi-conta	não
Notas	Varejo tradicional em transição digital. Categoria sugerida via IA.

Shein¶

Campo	Valor
Nome interno	`SHEIN`
Categoria	`MARKETPLACE`
Popularidade	78
Setup	MEDIUM
Multi-conta	não
Notas	Foco em moda / fast fashion. Sem criação de pedido — ouça webhooks.

Aliexpress¶

Campo	Valor
Nome interno	`ALIEXPRESS`
Categoria	`MARKETPLACE`
Popularidade	72
Setup	ADVANCED
Multi-conta	não
Notas	Internacional / importação. Fluxo de OAuth complexo.

Kabum¶

Campo	Valor
Nome interno	`KABUM`
Categoria	`MARKETPLACE`
Popularidade	75
Setup	MEDIUM
Multi-conta	não
Notas	Foco em eletrônicos. Categoria sugerida via IA.

Casas Bahia (Via Varejo)¶

Campo	Valor
Nome interno	`VIAVAREJO`
Categoria	`MARKETPLACE`
Popularidade	68
Setup	MEDIUM
Multi-conta	não
Notas	Grupo Via. Categoria sugerida via IA.

Carrefour¶

Campo	Valor
Nome interno	`CARREFOURV2`
Categoria	`MARKETPLACE`
Popularidade	70
Setup	MEDIUM
Multi-conta	não
Notas	Conector v2. Foco em alimentos e varejo.

TikTok Shop¶

Campo	Valor
Nome interno	`TIKTOKSHOP`
Categoria	`MARKETPLACE`
Popularidade	80
Setup	MEDIUM
Multi-conta	não
Notas	Social commerce / vídeo. Sem criação de pedido — ouça webhooks.

Temu¶

Campo	Valor
Nome interno	`TEMU`
Categoria	`MARKETPLACE`
Popularidade	—
Setup	MEDIUM
Multi-conta	não
Notas	Cross-border em expansão no Brasil.

Leroy Merlin¶

Campo	Valor
Nome interno	`LEROYMERLINV2`
Categoria	`MARKETPLACE`
Popularidade	—
Setup	MEDIUM
Multi-conta	não
Notas	Casa e construção. Conector v2. Categoria sugerida via IA.

Madeira Madeira¶

Campo	Valor
Nome interno	`MADEIRAMADEIRAV2`
Categoria	`MARKETPLACE`
Popularidade	—
Setup	MEDIUM
Multi-conta	não
Notas	Móveis e decoração. Conector v2. Categoria sugerida via IA.

ERPs¶

Bling¶

Campo	Valor
Nome interno	`BLING`
Categoria	`ERP`
Popularidade	90
Setup	EASY
Multi-conta	não
Notas	ERP mais popular entre sellers Gubee. Integração nativa com nota fiscal e estoque.

Conta Azul¶

Campo	Valor
Nome interno	`CONTAAZUL`
Categoria	`ERP`
Popularidade	85
Setup	EASY
Multi-conta	não
Notas	Foco em financeiro e contabilidade.

E-commerce¶

Magento¶

Campo	Valor
Nome interno	`MAGENTO`
Categoria	`ECOMMERCE`
Popularidade	—
Setup	ADVANCED
Multi-conta	não
Notas	Plataforma de e-commerce self-hosted. Requer configuração de webhook no lado do cliente.

Bis2Bis¶

Campo	Valor
Nome interno	`BIS2BIS`
Categoria	`ECOMMERCE`
Popularidade	—
Setup	ADVANCED
Multi-conta	não
Notas	Plataforma brasileira baseada em Magento.

Logística¶

Correios¶

Campo	Valor
Nome interno	`CORREIOSLOGISTICS`
Categoria	`LOGISTICS`
Popularidade	92
Setup	EASY
Multi-conta	não
Notas	Transportadora essencial para o varejo brasileiro. Etiquetas em PDF e ZPL.

Intelipost¶

Campo	Valor
Nome interno	`INTELIPOSTLOGISTICS`
Categoria	`LOGISTICS`
Popularidade	88
Setup	MEDIUM
Multi-conta	não
Notas	Multi-carrier aggregator. WMS e cotação de frete.

Inteligência Artificial¶

Gubee IA¶

Campo	Valor
Nome interno	`GUBEEAI` (virtual)
Categoria	`IA`
Popularidade	—
Setup	transparente
Multi-conta	n/a
Notas	Não é uma plataforma de venda — é o motor de IA interno. Usado para sugestão de categoria em marketplaces sem preditor nativo (`MAGALU`, `VIAVAREJO`, `MADEIRAMADEIRAV2`, `KABUM`, `LEROYMERLINV2`).

Uso em paths de API¶

O nome interno aparece em paths como {platform}. Exemplo — leitura de preço efetivo de um item no Mercado Livre:

curl -X GET "$GUBEE_API/integration/prices/MERCADOLIVRE/ITEM123" \
  -H "Authorization: Bearer $JWT"

Resposta (PriceApiDTO):

{
  "itemId": "ITEM123",
  "platform": "MERCADOLIVRE",
  "defaultPrice": { "value": 219.90, "priceType": "DEFAULT" },
  "promotions": []
}

Caso especial: plataformas multi-conta¶

Para MERCADOLIVRE, AMAZONV2 e SHOPEE, um seller pode ter múltiplas contas cadastradas. Em endpoints que aceitam {platform} apenas, a operação considera a conta principal (default). Para contas específicas, use os endpoints com accountId:

curl -X GET "$GUBEE_API/integration/prices/MERCADOLIVRE/ITEM123?accountId=ACC-987" \
  -H "Authorization: Bearer $JWT"

Descubra os accountIds de um seller via GET /integration/accounts.

Resumo em tabela¶

Nome interno	Exibição	Categoria	Pop	Multi-conta	Cria pedido
`MERCADOLIVRE`	Mercado Livre	MARKETPLACE	98	sim	sim
`AMAZONV2`	Amazon	MARKETPLACE	95	sim	sim
`SHOPEE`	Shopee	MARKETPLACE	85	sim	não
`MAGALU`	Magalu	MARKETPLACE	88	não	sim
`SHEIN`	Shein	MARKETPLACE	78	não	não
`ALIEXPRESS`	Aliexpress	MARKETPLACE	72	não	sim
`KABUM`	Kabum	MARKETPLACE	75	não	sim
`VIAVAREJO`	Casas Bahia	MARKETPLACE	68	não	sim
`CARREFOURV2`	Carrefour	MARKETPLACE	70	não	sim
`TIKTOKSHOP`	TikTok Shop	MARKETPLACE	80	não	não
`TEMU`	Temu	MARKETPLACE	—	não	sim
`LEROYMERLINV2`	Leroy Merlin	MARKETPLACE	—	não	sim
`MADEIRAMADEIRAV2`	Madeira Madeira	MARKETPLACE	—	não	sim
`CORREIOSLOGISTICS`	Correios	LOGISTICS	92	n/a	n/a
`INTELIPOSTLOGISTICS`	Intelipost	LOGISTICS	88	n/a	n/a
`BLING`	Bling	ERP	90	não	n/a
`CONTAAZUL`	Conta Azul	ERP	85	não	n/a
`MAGENTO`	Magento	ECOMMERCE	—	não	n/a
`BIS2BIS`	Bis2Bis	ECOMMERCE	—	não	n/a

Convenções de nomenclatura¶

Maiúsculas: nomes internos são sempre UPPER_SNAKE_CASE (MERCADOLIVRE, TIKTOKSHOP).
Sufixo V2: indica conector de segunda geração coexistente com o original (AMAZONV2 vs AMAZON, CARREFOURV2 vs CARREFOUR, LEROYMERLINV2 vs LEROYMERLIN, MADEIRAMADEIRAV2 vs MADEIRAMADEIRA). Sempre prefira a V2 — a versão sem sufixo pode ser descontinuada.
Sufixo LOGISTICS: separa transportadoras de marketplaces com mesmo nome (CORREIOSLOGISTICS, INTELIPOSTLOGISTICS).
Case-insensitive em path: MERCADOLIVRE, mercadolivre e MercadoLivre são equivalentes. Use o code retornado pela API para consistência.

Descoberta dinâmica em produção

Antes de chamar qualquer endpoint com {platform}, faça cache (5–15 min) de GET /integration/platforms/configuration e valide se o nome interno está presente. Isso evita 404 quando uma plataforma é descontinuada ou renomeada.

Próximos passos¶

Plataformas suportadas: schema completo do endpoint de configuração e roteamento dinâmico downstream.
Ad vs Produto: como cada plataforma cria múltiplos anúncios por produto.
Glossário PT-BR ↔ API: tradução termo-a-termo da UI para o JSON.
Receber Pedidos: como ouvir webhooks de plataformas que não suportam criação de pedido.