VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa/Feeds de produtos

Gerar o arquivo do feed

Gera na hora o arquivo de um feed do seller, salva-o para o link público e devolve o conteúdo.

Use depois de criar o feed, depois de mudar produtos em massa ou quando o destino exigir dados frescos. Com schedule_interval maior que zero, a plataforma faz isso sozinha.

Gerar

Monta o arquivo agora com os produtos que atendem aos filtros, salva-o para o link público e devolve o próprio conteúdo na resposta. Atualiza last_generated_at, file_url e product_count do feed.

POST/api/v1/vendor/data-feeds/{id}/generateSeller

Gerar o arquivo do feed

Cabeçalhos

Authorizationstringobrigatório
Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

idstring (uuid)obrigatório
Id do feed.

Exemplo de requisição

bash
curl -X POST "$BASE_URL/api/v1/vendor/data-feeds/$FEED_ID/generate" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Conteúdo do feed
xml
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>Loja Seller Teste</title>
    <item>
      <g:id>7bc1d5e9-a9a4-457b-866f-bbb3879d258d</g:id>
      <g:title>Camiseta Básica Algodão Preta</g:title>
      <g:price>49.90 BRL</g:price>
    </item>
  </channel>
</rss>

Campos da resposta

(corpo)xml | csv | json
O arquivo gerado, não um objeto JSON. O Content-Type é application/xml, text/csv ou application/json conforme o tipo do feed.

Erros

StatusQuandoCorpo
401Token ausente, inválido ou expirado.{"error":"missing authorization header"}
403Token que não é de seller, ou usuário sem o privilégio exigido pela rota.{"error":"insufficient vendor privileges","privilege_required_any":["vendor_settings"]}
404O feed não existe ou não é seu.{"error":"data feed not found"}
500Falha ao consultar os produtos ou montar o arquivo.{"error":"failed to generate feed","detail":"..."}
Resposta pesada

A resposta traz o arquivo inteiro, que em catálogos grandes pode ter megabytes. Se você só quer atualizar o arquivo do link público, descarte o corpo.

Produtos incluídos

Entram os produtos do seu seller que passam nos filtros; por padrão, apenas os ativos. Produto pendente, rejeitado ou desativado fica de fora.

Veja também

  • Feeds de produtos: visão geral
Anterior
Cadastro de feeds
Próxima
Assistente de importação
Nesta página
  • Gerar
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também