Visão geral sobre anúncios

No Marketplace Beleza na Web os nossos anúncios são criados após o envio do catálogo através das integradoras. Existem algumas regras de negócios para que o anúncio fique disponível na loja do marketplace, sendo a principal delas o envio dos produtos com as seguintes informações:

EAN
Título
Descrição
Marca
Medidas
Árvore de Categorias
Preço
Estoque
SKU Seller

A transmissão do produto não será permitida se uma dessas informações não estiverem preenchidas. A seleção da marca é restrita à lista disponibilizada no endpoint.

O canal está apto a receber apenas as dimensões (peso) no formato de gramas. Caso o envio não seja realizado dessa forma, o cadastro do produto não estará com a informação correta podendo ocasionar erros no processo de cotação do frete. Já para a medida (tamanho), o formato que deverá ser utilizado é em metros.

Uma das principais chaves para a criação dos anúncios é o EAN do produto que é utilizado para definir se será um novo anúncio ou entrará no buybox através do match de EAN. Quando já existe um produto cadastrado em nossa plataforma com o mesmo EAN de um produto, realizamos o match e descartamos todas as informações sobre o produto enviado, armazenando apenas as informações de preço e estoque.

Para os novos produtos, os anúncios podem ser criados com 2 status:

Aprovado com Pendência: onde os 10 campos obrigatórios listados acima foram enviados através da integração e caso tenha preço e estoque cadastrados o anúncio fica disponível para venda no marketplace, porém o cadastro ainda precisa passar por um processo de curadoria interno.

Cadastro Incompleto: onde um dos 10 campos obrigatórios listados acima não foi reconhecido através da integração, desta forma o produto foi criado porém não liberando o anúncio para visualização no marketplace. Esse status precisa de uma atuação direta do seller para completar o cadastro diretamente no Portal do Seller. Após a ação, o produto ainda passa pelo processo de curadoria interno.

Após a integração em dos status acima, o seller poderá realizar através do Portal do Seller, a atualização das informações enviadas na integração e completar o cadastro dos campos adicionais e que fazem parte do processo de catalogação do produto. A edição poderá ocorrer a qualquer momento e quantas vezes for necessário, até a curadoria final ter sido realizada pelo time de curadoria interno e produto atualizado como status Aprovado

Regras de Negócios

O canal também recusa alguns produtos de forma automática por regras de negócio. As regras são:

Título do Produto Duplicado: Quando o Seller tentar enviar mais de um produto com mesmo nome.

EAN ou Sku Duplicado: Quando o Seller tentar enviar mais de um produto com mesmo EAN ou SKU.

Match de EAN por range de preço: Quando o Seller enviar um produto com preço promocional abaixo da média dos demais produtos de mesmo EAN dos demais Sellers.

Regras para Preços e Estoque:

Preços personalizados por canal de venda: O vendedor pode definir preços distintos para cada marketplace onde o produto é anunciado. Isso permite que o vendedor utilize estratégias de preços diferenciadas para cada plataforma.

Estoque único: O estoque do produto é compartilhado entre todos os marketplaces onde ele está anunciado.

Status de Produtos

Após a integração dos produtos eles podem estar em duas situações:

Ativo: para produtos integrados e estão visíveis no site

Inativo: para produtos integrados e foi inativado por alguma ação pontual

Verifique abaixo a lista de métodos necessários para realizar as integrações de anúncios

Um ponto importante nesses endpoints(6, 7) o processo acontece de forma assíncrona, ou seja, é recebido a requisição e imediatamente é iniciado o processo de assíncrono, então toda a confirmação da transação deverá ser por meio do GET(4) de produto.

Somente no cadastro de produto(2) é realizado uma validação preditiva de forma síncrona para verificar se determinado produto pode ser cadastrado e anunciado na loja, essa validação leva em consideração campos obrigatórios e regras de negócios, uma vez validado, é retornado um sucesso 2XX, e o processo de criação é iniciado assincronamente.

A chave primária que permite gerenciar sistemicamente um produto é o announcementId, esse id é gerado no processo assíncrono, o ideal é que após o recebimento do status 2XX o cliente busque o produto através do seller sku (4) e assim obtenha o announcementId para que seja possível a manipulação do mesmo. O announcementId não pode ser alterado, então o ideal é que o parceiro possa persistir esse dado para uso futuro.

Os endpoints de ativação e desativação de produtos e anuncios(8 e 9) são sincronos, porém contém a seguinte regra:
Em um cenário de desabilitação de um produto, só poderá ativar quem realizou a desativação.

EX:
O Seller realiza a desativação através da Integradora, somente o Seller via Integradora poderá realizar a ativação novamente.

O analista de Backoffice realiza a desativação do anuncio, o Seller via Integradora não conseguirá realizar a ativação novamente, somente a analista de Backoffice poderá realizar tal ativação.

2. POST /products

Criar anúncios de um produto.

3. GET /products?announcementId={announcementId}

Obter anúncio por announcementId.

4. GET /products?sellerSku={sellerSku}

Obter anúncio por sellerSku.

5. GET /products/{sellerId}

Obter todos os produtos de um seller.

6. PATCH /products/{announcementId}/price

Atualizar o preço do anuncio.

7. PATCH /products/{announcementId}/stock

Atualizar o estoque.

8. PATCH /products/{announcementId}/status/enable

Ativar anúncio.

9. PATCH /products/{announcementId}/status/disable

Desativar anúncio.

10. POST /kits

Criar anuncio de kits.

Carregando...