Fast Shop - API Seller
Swagger API
  • Sobre a API
  • Guias da API
    • Primeiros passos
    • Autenticação e formato dos dados
    • Códigos de retorno (HTTP status)
    • Limite de requisições
    • Melhores práticas
  • Integração
    • Fluxo de integração
    • Ambientes de integração
    • Definição da URL e Siglas
    • Recursos (endpoint)
      • Catálogo de Produto
        • Notificação de catálogo
        • Registro de catálogo
        • Atualização de catálogo
        • Atualização de preço/estoque
      • Criação de Pedido
        • Cálculo de frete
        • Criação de pedido
      • Processar Pagamento
        • Bandeiras de cartão
        • Parcelamento no cartão
        • Processar transação de pagamento
          • Como criptografar as informações do pagamento
      • Gerenciamento do Pedido
        • Pedido Aprovado/Confirmado pelo Marketplace
        • Pedido Confirmado pelo Seller
        • Pedido Faturado ou Despachado
        • Pedido Entregue
        • Pedido Cancelado pelo Marketplace
        • Pedido Cancelado pelo Seller
        • Consultar Pedido
    • Status de Pedidos no Seller
Powered by GitBook
On this page
  • Endpoint
  • Change Notification

Was this helpful?

  1. Integração
  2. Recursos (endpoint)
  3. Catálogo de Produto

Notificação de catálogo

Nesta seção explicamos um pouco sobre os recursos relacionados a notificação de produtos de criação, alteração de cadastro, preço e estoque.

O Seller é responsável por sugerir novos SKUs a serem vendidos no Marketplace e por informar ao Marketplace sobre as mudanças em seus SKUs que já foram integrados como alterações de cadastro, estoque e preço. Ambas as ações começam com uma notificação de catálogo.

Para que essa notificação aconteça, o Seller irá chamar o endpoint fornecido pelo Marketplace.

Se a conexão está autenticada e a solicitação for feita corretamente, há duas respostas possíveis:

Status 404: O SKU não foi encontrado no Marketplace. O corpo da resposta, neste caso, deve seguir este formato: "Seller StockKeepingUnit {sellerSkuId} not found for this seller id {sellerId}". Isso significa que a Fast Shop agora pode prosseguir com o envio de uma oferta ao Marketplace para sugerir que esse SKU seja vendido lá, ou seja, chamar o “Registro de Catálogo (Send SKU Suggestion)”.

Status 200: O SKU cujo ID foi informado na URL já existe no Marketplace e foi localizado. O Marketplace agora pode prosseguir com uma “Atualização de Preço/Estoque (Update Stock Price)” para obter informações atualizadas sobre o estoque e preço deste SKU.

Ao receber esse request o Marketplace irá "Simular as condições comerciais" chamando um endpoint implementado pelo Seller.

Endpoint

Change Notification

POST https://{environmentMarketplace}/api/catalog_system/pvt/skuseller/changenotification/{sellerId}/{sellerSkuId}

Path Parameters

Name
Type
Description

{environmentMarketplace}*

string

URL da API do Marketpalce

{sellerId}*

string

ID da conta do Seller

{sellerSkuId}*

string

ID da SKU no Seller

Headers

Name
Type
Description

X-VTEX-API-AppKey*

string

{{appKey}}

X-VTEX-API-AppToken*

string

{{appToken}}

Accept*

string

application/json

Content-Type*

string

application/json

{
  "errorCode": "string",
  "message": "string"
}
{
  "errorCode": "string",
  "message": "string"
}

Será enviado no Header as chaves de autenticação que poderão ser utilizadas pelo Marketplace para validação caso seja conveniente

PreviousCatálogo de ProdutoNextRegistro de catálogo

Last updated 1 year ago

Was this helpful?