Feeds de produtos

Feeds de catálogo do seller para Google Shopping, Meta, Mercado Livre e formatos livres, com link público.

Um feed de produtos é um arquivo (XML, CSV ou JSON) com o catálogo do seller, em um formato que um serviço externo lê sozinho: Google Shopping, Meta (Facebook/Instagram), Mercado Livre ou um formato livre. Você cadastra o feed uma vez, a plataforma gera o arquivo (manualmente ou em horários fixos) e entrega um link público para colar no serviço de destino.

Como funciona

Cadastre o feed
Crie o feed com tipo, formato e filtros. A resposta traz public_url.
Gere o arquivo
Gere pela primeira vez. Antes disso o link público responde "Feed has not been generated yet".
Entregue o link
Cole public_url no Google Merchant Center, Meta Commerce Manager etc.
Mantenha atualizado
Defina schedule_interval (em segundos) para regenerar sozinho, por exemplo 86400 para uma vez por dia.

`feed_type`	Conteúdo gerado	Use `file_format`
`google_shopping`	XML no padrão do Google Shopping.	`xml`
`facebook`	CSV no padrão do catálogo da Meta.	`csv`
`mercado_livre`	CSV, ou JSON se `file_format` for `json`.	`csv` / `json`
`custom`	Colunas à sua escolha em `field_mapping`, no formato de `file_format`.	`xml` / `csv` / `json`

Conceitos importantes

Link público

O public_url tem a forma https://sualoja/api/v1/feeds/<token>.<xml|csv|json>. Ele só funciona se o módulo de feeds estiver ligado na loja; sem o módulo, o link responde 404 mesmo com o feed criado. Para invalidar um link vazado, peça ao administrador para regenerar o token.

Endpoints

Método	Caminho	Para que serve
GET	`/api/v1/vendor/data-feeds`	Lista os feeds do seller.
POST	`/api/v1/vendor/data-feeds`	Cria um feed.
GET	`/api/v1/vendor/data-feeds/{id}`	Lê um feed.
PUT	`/api/v1/vendor/data-feeds/{id}`	Altera um feed.
DELETE	`/api/v1/vendor/data-feeds/{id}`	Exclui um feed.
POST	`/api/v1/vendor/data-feeds/{id}/generate`	Gera o arquivo agora.

Erros comuns

Colar o link antes de gerar. O destino recebe "Feed has not been generated yet" (404).
Combinar tipo e formato incoerentes. google_shopping com file_format: "csv" gera XML dentro de um arquivo .csv. Use os pares da tabela.
Tentar exportar produtos de outro seller. vendor_ids é sobrescrito; o feed traz só os seus.
Mandar preço em reais nos filtros. min_price e max_price são centavos.
Esperar product_count atualizado ao criar. Ele só muda a cada geração.
Expor public_token. Ele dá acesso de leitura ao feed inteiro.

Próximos passos

Cadastro de feeds

Crie e ajuste os feeds.

Gerar o arquivo

Atualize o arquivo sob demanda.