# Vender na Worten, na Fnac, no KuantoKusta e na Amazon

Liga os marketplaces à Feitora para publicares o mesmo catálogo lá, com stock e preços sincronizados, e receberes as encomendas no painel como as outras. A Amazon funciona por ficheiro.

Um marketplace é uma loja online de outra empresa onde também podes vender os teus produtos: a Worten, a Fnac e o KuantoKusta em Portugal, a Amazon em Espanha. Com a Feitora ligada, escolhes os produtos a publicar, o **stock e os preços seguem sozinhos** e cada venda entra em **Encomendas** como uma encomenda normal, já paga, com a morada do cliente e o número do marketplace. Tu só preparas o envio e emites a fatura.

> **Em testes — Ligações por validar com conta real**
> A ligação à Worten e à Fnac segue a documentação pública da plataforma Mirakl (a que ambas usam); a do KuantoKusta segue os endpoints assumidos, porque não há documentação pública completa. **Nenhuma foi ainda validada com uma conta real de vendedor.** Sem credenciais, tudo funciona em **modo de testes**: as publicações ficam ativas na simulação e cada sincronização traz uma encomenda falsa para veres o circuito completo. Antes de desligar o modo de testes, confirma com o marketplace as credenciais e faz uma primeira publicação com poucos produtos.

## Antes de começar

- **Conta de vendedor aprovada** em cada marketplace. A Worten e a Fnac avaliam a candidatura (empresa, NIF, catálogo, prazos de envio); o KuantoKusta tem adesão própria; a Amazon pede o registo no Seller Central. As comissões por venda são cobradas pelo marketplace, não pela Feitora.
- **Produtos completos:** cada variante precisa de **código de barras (EAN)** — é assim que o marketplace reconhece o produto —, de **fotografias** (fundo branco na Amazon), de título, descrição e marca. Sem EAN, a oferta fica com erro «Sem código de barras (EAN)».
- **Dados da loja preenchidos:** o NIF, a morada e os contactos de **Definições → Loja** aparecem nas faturas e nas comunicações.
- **Prazo de expedição real:** o que anuncias (2 dias por omissão) conta para a tua avaliação de vendedor.
- Só o proprietário altera as definições dos marketplaces.

## Ligar a Worten ou a Fnac

1. Abre **Definições → Marketplaces**.
2. Liga o interruptor da **Worten Marketplace** ou da **Fnac Marketplace**.
3. Deixa o **Modo de testes** ligado por agora.
4. Em **Credenciais da API** cola a **Chave de API** e o **Shop ID** que encontras no back office do marketplace (o teu utilizador → API key). Se o marketplace te der um endereço de testes, muda o **Endereço da API**.
5. Indica a **Zona de envio** do teu contrato (normalmente PT) e, se quiseres, a **Categoria por omissão** para os produtos novos.
6. Carrega em **Guardar** e depois em **Testar ligação**: deve aparecer o nome da tua loja no marketplace.
7. Quando os testes correrem bem, desliga o **Modo de testes** e guarda.

## Ligar o KuantoKusta

O KuantoKusta tem duas partes: o **comparador de preços** (lê um ficheiro XML com o teu catálogo) e o **marketplace** (as encomendas entram na Feitora). Liga o interruptor, cola a **Chave de vendedor** e o **ID da loja**, e copia o **Feed do comparador (XML)** para a tua conta do KuantoKusta. O feed funciona mesmo que a API ainda não esteja validada.

## Amazon: por ficheiro

Nesta fase a Amazon não tem ligação automática (a API exige aprovação à parte). Liga o interruptor da **Amazon (amazon.es)** e:

- **Exportar flat file** — descarrega o ficheiro TSV com os produtos publicados para a Amazon (SKU, EAN, preço, stock, prazo) e carrega-o no **Seller Central → Inventário → Adicionar produtos por ficheiro**.
- **Importar CSV** — descarrega o **Order Report** do Seller Central e carrega-o aqui: as encomendas entram em **Marketplaces → Encomendas** e, ao aceitar, nas tuas encomendas, já pagas.

Repete os dois passos sempre que mudares preços ou stock e quando houver vendas novas.

## Regras para todos os marketplaces

Na mesma página, em **Regras para todos os marketplaces**:

- **Sincronizar a cada** — de quanto em quanto tempo a Feitora vai buscar encomendas e envia stock e preços alterados (15 minutos por omissão).
- **Reserva de stock** — unidades que ficam só para a tua loja. O stock enviado é o stock da loja menos a reserva.
- **Prazo de expedição** — o que anuncias ao marketplace.
- **Preço no marketplace** — um **acréscimo** sobre o preço da loja para cobrir a comissão e o arredondamento a **,99** ou **,90**. O exemplo por baixo mostra o resultado (por exemplo, 12,50 € na loja → 13,99 € no marketplace).
- **Aceitar as encomendas automaticamente** — quando há stock. Os marketplaces dão poucas horas para aceitar; sem isto, cada encomenda espera por ti.
- **Enviar também os emails da loja ao cliente** — desligado por omissão: é o marketplace que informa o cliente da confirmação, do envio e da entrega.

## Publicar produtos

1. Abre **Marketplaces** no menu lateral e escolhe o marketplace nas pastilhas do topo.
2. Carrega em **Adicionar produtos**: pesquisa e escolhe produtos ou variantes, ou escolhe **Uma coleção inteira**.
3. Se quiseres, indica a **Categoria no marketplace** (pesquisa pelo nome; a Worten e a Fnac exigem categoria).
4. Deixa **Publicar já** ligado e confirma. As ofertas seguem na próxima sincronização ou quando carregas em **Sincronizar agora**.

Na lista vês, para cada oferta, o preço **na loja** e **no marketplace**, o stock enviado, o estado (**Rascunho**, **A publicar**, **Publicado**, **Em pausa**, **Erro**, **Retirado**) e a mensagem de erro do marketplace, quando houver. Em **⋯** podes **Pausar**, **Retomar**, editar a **Categoria e atributos** (marca, cor e outros exigidos pela categoria, ou um preço fixo só para este marketplace) e **Retirar do marketplace**. Na ficha de cada produto, o cartão **Marketplaces** mostra o estado em cada marketplace ligado.

## Encomendas dos marketplaces

Em **Marketplaces → Encomendas** vês as encomendas que vieram de cada marketplace com o estado **Por aceitar**, **Aceite**, **Recusada**, **Enviada**, **Entregue** ou **Cancelada**. Com a aceitação automática ligada, as que têm stock são aceites e importadas sozinhas; as outras esperam por **Aceitar** ou **Recusar**. Ao aceitar, a encomenda entra em **Encomendas** como **paga** (o marketplace cobrou), com a pastilha do marketplace e o número dele; o Início mostra «Encomendas de marketplaces por aceitar» quando há alguma à espera.

Depois é como qualquer outra encomenda: preparas, crias o envio (CTT, DPD ou outra) e **marcas como enviada**. O tracking segue para o marketplace, que avisa o cliente. Se o marketplace cancelar a encomenda, ela fica cancelada na Feitora e o stock volta.

> **Dica — Faturas**
> A fatura é emitida por ti, como nas outras encomendas (Definições → Faturação), em nome do cliente final. A comissão do marketplace vem na fatura que o marketplace te envia a ti.

## Sincronizações

**Marketplaces → Sincronizações** regista cada envio de ofertas, cada ida buscar encomendas e cada envio de tracking, com a hora, o marketplace e o resultado. Se houver erros repetidos, recebes uma notificação no sino.

## Problemas frequentes

| Problema | O que fazer |
|---|---|
| A oferta ficou com «Sem código de barras (EAN)» | Preenche o código de barras da variante na ficha do produto e sincroniza de novo. |
| «Testar ligação» está cinzento | Guarda primeiro as alterações. |
| O teste dá erro de autenticação | Confirma a chave de API e o Shop ID no back office do marketplace, e se o endereço da API corresponde ao ambiente (produção ou testes). |
| A oferta ficou em **Erro** com uma mensagem do marketplace | Abre **Categoria e atributos** e preenche o que falta (categoria, marca, atributos obrigatórios). |
| A encomenda ficou em **Erro** «SKU desconhecido» | O SKU vendido no marketplace não existe na loja. Cria ou corrige a variante com esse SKU e carrega em **Importar**. |
| O cliente não recebeu o email da loja | É normal: é o marketplace que comunica com o cliente. Liga «Enviar também os emails da loja ao cliente» só se quiseres duplicar. |