Envio de Produtos

A Fast Shop trabalha com um conceito chamado sugestão de sku, ou seja a integração envia os produtos para o HUB da Fast Shop, que por sua vez, gera uma sugestão de SKU para o Marketplace, essa sugestão de SKU, pode ou não ser aprovado pelo Marketplace, a partir do momento em que essa sugestão de SKU é aprovado, é gerado um SKU Fast Shop, associado ao SKU do Seller, o SKU a ser exibido no site www.fastshop.com.br é o SKU Fast Shop.

Como enviar produtos para a Fast Shop:

Envio de SKU para Seller VTEX:

Endpoint Produção​: ​https://fsh-hub.kaive.com.br/api/notification Endpoint Homologação: https://hml-fsh-hub.kaive.com.br/api/notification

Envio de SKU para Seller não VTEX:

Endpoint Produção​: https://fsh-hub.kaive.com.br​/api/catalog_system/pvt/sku/SuggestionInsertUpdatev2

Endpoint Homologação: https://hml-fsh-hub.kaive.com.br/api/catalog_system/pvt/sku/SuggestionInsertUpdatev2

Método: POST

Body Request Para Sugerir a Venda de um Sku

{ 
  "sellerId": "string", 
  "id": "string", 
  "productDescription": "string", 
  "productId": 0, 
  "productName": "string", 
  "skuId": "string", 
  "skuName": "string", 
  "brandId": "string", 
  "brandName": "string", 
  "categoryFullPath": "string", 
  "categoryId": "string", 
  "ean": [ 
    "string" 
  ], 
  "refId": "string", 
  "height": 0, 
  "length": 0, 
  "weightKg": 0, 
  "width": 0, 
  "images": [ 
    { 
      "imageUrl": "string", 
      "imageName": "string", 
      "fileId": "string" 
    } 
  ], 
  "productSpecifications": [ 
    { 
      "fieldId": "string", 
      "fieldName": "string", 
      "fieldValueIds": [ 
        0 
      ], 
      "fieldValues": [ 
        "string" 
      ] 
    } 
  ], 
  "skuSpecifications": [ 
    { 
      "fieldId": "string", 
      "fieldName": "string", 
      "fieldValueIds": [ 
        0 
      ], 
      "fieldValues": [ 
        "string" 
      ] 
    } 
  ], 
  "listPrice": 0, 
  "price": 0, 
  "sellerStockKeepingUnitId": "string", 
  "isAssociation": true, 
  "isKit": true, 
  "isProductSuggestion": true, 
  "modalId": { 
  
  }, 
  "productSupplementaryFields": { 
  
  }, 
  "sellerModifiedDate": { 
  
  }, 
  "skuSupplementaryFields": { 
  
  }, 
  "synonymousPropertyNames": { 
  
  } 
} 

Campos que são obrigatórios enviar na sugestão de Sku para a nossa integração:

SellerId​ => obrigatório, O Marketplace informará o seu código no momento de configuração da loja. BrandId​ => obrigatório, de 1 a 50 caracteres BrandName​ => obrigatório, de 1 a 100 caracteres CategoryId​ => obrigatório, de 1 a 50 caracteres CategoryFullPath​ => obrigatório, de 1 a 100 caracteres SellerStockKeepingUnitId​ => obrigatório, de 1 a 50 caracteres (skuId do seller) SkuName​ => obrigatório, de 1 a 255 caracteres Width​ => Valor não pode ser negativo (campo decimal) Height​ => Valor não pode ser negativo (campo decimal) WeightKg​ => Valor não pode ser negativo (campo decimal) Length​ => Valor não pode ser negativo (campo decimal) ImageUrl​ => obrigatório, de 1 a 255 caracteres ProductDescription => Obrigatório, de 1 a 4.000 caracteres FieldValues => obrigatório, de 1 a 100 caracteres Images​ => É necessário conter no mínimo 1 e no máximo 9, as imagens antes de serem enviadas para o MarketPlace, precisam ter seu formato quadrado e de forma sequencia ao qual serão exibidas no site Formato da imagem: JPEG/JPG. Qualidade da imagem: Mínimo 600x600 pixels no máximo 2000x2000 pixels

Campos não obrigatórios:

Dentro do array de skuSpecifications, existe o campo fieldId => Valor não pode ser negativo, limitado a 8 posições (campo decimal) fieldIdValuesIds => Valor não pode ser negativo, limitado a 8 posições (campo decimal)

O Array de productSpefications é utilizado para descrever os atributos comuns de um produtos.

O Array de skuSpefications é utilizado para descrever os atributos de definição do SKU, por exemplo: Cor, Tamanho, ML, Voltagem, Sabor e entre outros.

Conceito de Produto com Variação:

Produto é o nível da organização do catálogo que se localiza abaixo das Categorias e acima dos SKUs.

Como o produto está acima do SKU na hierarquia do catálogo, podemos entendê-lo como uma definição mais genérica dos itens que são vendidos em sua loja.

Como os SKUs são o último nível na organização de um catálogo, eles são os itens que os consumidores realmente compram.

Os SKUs são as variações do Produto. Assim, o Produto é um nível mais abstrato daquilo que é vendido na sua loja.

O que a integração não disponibiliza:

Endpoint para consulta de produtos na FastShop

Endpoint para remoção de produtos na FastShop

Atenção:

O HUB recebe até 5 produtos por segundo, caso ultrapasse esse limite será retornado http: 429 too many request.