Como segmentar produtos por canais de venda

Neste post iremos abordar sobre como segmentar produtos por canais de venda (marketplaces e ecommerces).

O processo é bastante parecido com o cadastro de produto, porém para ocorrer, é necessário informar a propriedade salesChannels no corpo da requisição, conforme exemplo abaixo:

Cadastrando um Produto

URL:

POST https://api.sandbox.flipmarket.com.br/products

Body:

{
 "productId": "534332",
 "productName": "Camiseta Básica",
 "sku": "534333",
 "name": "Camiseta Básica Branca",
 "size": "GG",
 "categoryId": "5d420c71e2f97a00163a2d7e",
 "brand": "Nike",
 "description": "Descrição da camisa básica",
 "width": 20,
 "height": 20,
 "length": 20,
 "weight": 200,
 "stock": 10,
 "price": 79,
 "model": "Básica",
 "salesChannels": [
  {
   "id": 1
  },
 {
  "id": 2
 },
 {
  "id": 6
 },
 {
  "id": 7,
  "sellerId": "<id da conta do mercado livre>",
  "listingType": "<tipo do anúncio ('CLASSICO', 'PREMIUM')>"
  }
 ]

Atualizando um Produto

A atualização de produto segue a mesma lógica do cadastro, porém, se você deixar de informar algum dos canais anteriormente informados, ele será removido deste. A mesma lógica serve para adicionar novos canais de venda, basta incluir no array.

URL:

PUT https://api.sandbox.flipmarket.com.br/products/{sku}

Body:

{
 "productId": "534332",
 "productName": "Camiseta Básica",
 "sku": "534333",
 "name": "Camiseta Básica Branca",
 "size": "GG",
 "categoryId": "5d420c71e2f97a00163a2d7e",
 "brand": "Nike",
 "description": "Descrição da camisa básica",
 "width": 20,
 "height": 20,
 "length": 20,
 "weight": 200,
 "stock": 10,
 "price": 79,
 "model": "Básica",
 "salesChannels": [
  {
   "id": 1
  },
 {
  "id": 2
 },
 {
  "id": 6
 },
 {
  "id": 7,
  "sellerId": "<id da conta do mercado livre>",
  "listingType": "<tipo do anúncio ('CLASSICO', 'PREMIUM')>"
  }
 ]
}

Atualização de Preço

Os campos Price, SalePrice, SaleDateStart, SaleDateEnd enviados na raiz do JSON, atualizará apenas o preço PADRÃO.

Os campos Price, SalePrice, SaleDateStart, SaleDateEnd enviados dentro do array MARKETPLACES, atualizará o preço exclusivamente para o canal de venda mencionado.
Se não for enviado o preço de algum canal de venda no Array (marketplaces) o padrão é manter o preço que está no banco de dados, portanto não assumirá o preço padrão enviado na requisição.

URL:

PUT https://api.sandbox.flipmarket.com.br/products/{sku}

{
  "productId": "123",
  "productName": "Teste Produto ",
  "sku": "SPEEDLAB",
  "name": "Teste Produto Flip Market",
  "categoryId": "5D420CB3E2F97A00163D6985",
  "brand": "Sistema",
  "description": "Olá, SH !!\r\n\r\n Esse produto é de teste.",
  "width": 10,
  "height": 18,
  "length": 28,
  "weight": 840,
  "price": 100,
  "stock": 1,
  "model": "Teste",
  "origin": "nacional",
  "gender": "masculino",
  "active": true,
  "color": "5d950b9b0168c6000117ec99",
  "size": "5dfbe7aeea047f0001d34a12",
  "warranty": 1,
  "salesChannels": [
    {
      "id": 7,
      "sellerId": "123",
      "listingType": "CLASSICO",
      "price": 36.9,
      "forSale": {
        "salePrice": 33.94,
        "saleDateStart": "2022-06-29T10:09",
        "saleDateEnd": "2022-10-23T23:59"
      }
    },
    {
      "id": 7,
      "sellerId": "123",
      "listingType": "PREMIUM",
      "price": 38.9,
      "forSale": {
        "salePrice": 30.94,
        "saleDateStart": "2022-06-22T10:09",
        "saleDateEnd": "2022-06-23T23:59"
      }
    },
    {
      "id": 26,
      "price": 36.9,
      "forSale": {
        "salePrice": 33.94,
        "saleDateStart": "2022-06-22T10:09",
        "saleDateEnd": "2022-06-23T23:59"
      }
    }
  ]
}

Surgiu alguma dúvida referente algum campo? Confira nossa documentação técnica clicando aqui.