Marketplaces

Visão Geral

Um marketplace é um ecossistema digital que atua como mediador, permitindo que múltiplos vendedores (sellers) ofereçam seus produtos em uma única plataforma unificada. No contexto do e-commerce, este modelo funciona como uma poderosa vitrine de alto tráfego, onde a plataforma oferece a infraestrutura tecnológica e o público, enquanto os sellers provêm o catálogo de produtos.

Para o Seller, a integração com marketplaces é uma peça fundamental de escalabilidade, oferecendo benefícios diretos como:

• Alcance e Audiência: Exposição imediata para milhões de clientes sem a
necessidade de investimentos massivos em marketing para atrair tráfego próprio (redução do CAC - Custo de Aquisição de Cliente).
• Credibilidade e Confiança: O vendedor "pega carona" na autoridade de
grandes marcas já consolidadas no mercado, facilitando a decisão de compra do consumidor final.
• Infraestrutura Compartilhada: Acesso a ecossistemas prontos de pagamento,
segurança e soluções logísticas, permitindo que o seller foque na gestão de seu estoque e na qualidade de seus produtos.

Em suma, o marketplace permite que o seller transforme sua operação local em uma presença nacional, utilizando a plataforma como um acelerador de vendas e um canal estratégico de distribuição.

Entidades Envolvidas

A integração de marketplace da Uappi 3 orquestra o fluxo de dados entre diversas entidades do ecossistema da loja. Abaixo, detalhamos as principais entidades envolvidas e suas responsabilidades no processo:

1. Produtos

É a entidade central da integração. As informações de catálogo (nome, descrição, preços e estoque) e mídias (imagens e vídeos) são sincronizadas para garantir que a vitrine no marketplace esteja sempre atualizada.

2. Categorias

Responsáveis pela organização do catálogo. Na integração, é comum realizar o "de-para" (mapeamento) entre as categorias internas da loja e a árvore de categorias específica de cada marketplace, garantindo que o produto seja encontrado no local correto.

3. Marcas

Utilizadas para indexação e filtros nos marketplaces. A correta associação das marcas permite que os produtos participem de campanhas específicas e ganhem relevância nas buscas por fabricante.

4. Filtros e Atributos

• Atributos: Definem as variações do produto (como cor e tamanho) e
características técnicas.
• Filtros: Facilitam a navegação do usuário final no marketplace.
Ambos são essenciais para a montagem de anúncios ricos e técnicos, influenciando diretamente na conversão de vendas.

5. Logística (Transportadoras e Tabelas de Frete)

• Transportadoras: Identificam quem será responsável pela entrega.
• Tabelas de Frete: Contêm as regras de cálculo (prazo e preço).

6. Pedidos

Listagem de marketplace disponíveis

Descrição

Retorna a lista de todos os marketplaces disponíveis para uso.

Headers Obrigatórios

Campos de Condição Disponíveis

Campos de Solicitação Disponíveis

Exemplo de Requisição

1curl --request GET \
2  --url {{MAIN_URL}}/marketplaces \
3  --header 'Authorization: Bearer SEU_TOKEN_AQUI' \
4  --header 'Content-Type: application/json' \
5  --data '{
6	"fields": [
7		"marketplaceCredentialQuantity"
8	],
9	"order": [],
10	"condition": {
11		"type": "AND",
12		"conditions": [
13		]
14	}
15}'

✅ Resposta de Sucesso

1{
2  "status": true,
3  "data": {
4    "registers": [
5      {
6        "id": 1,
7        "name": "Uappi Hub",
8        "code": "uappi-hub",
9        "url": "https://uappi.com.br",
10        "marketplaceCredentialQuantity": 1
11      }
12    ],
13    "pagination": {
14      "limit": 10,
15      "offset": 0,
16      "pages": 1,
17      "registers": 1
18    }
19  }
20}