Atualização de Preço e Estoque

A Fast Shop deve ser comunicada sobre as alterações de preço e estoque através de notificação.

Como enviar uma notificação de preço e estoque:

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

Metodo: POST

Body Request:

Notification

{
  "IdSku": "Sku_do_Produto",      // SKU
  "An": "sellerId",              // ID do Seller
  "idAffiliate": "FSH",         // Afiliado criado para FastShop (FSH)
  "StockModified": true,       // Se houver alteração de estoque
  "PriceModified": true       // Se houver alteração de preço
}

Os valores aceitos para os campos:

• StockModified

• PriceModified

São:

• TRUE

• FALSE

Retorne true para o dado que foi alterado e false para o campo que não foi alterado.

Atenção: Todas as vezes em que sua integração enviar uma notificação e esse produto existir no Marketplace o HUB fará um consulta no endpoint de simulation da seguinte forma:

Endpoint de Calculo de Frete:

https://{prefixoDaIntegracao}/api/fulfillment/pvt/orderForms/simulation?sc=1&affiliateId=FSH Body Request:

{
  "items": [
            {
    			"id": "XXXX",
    			"quantity": 1,
    			"seller": "sellerName"
    }
  ],
  "postalCode": "",
  "country": "BRA"
}

Obs: Considere que para atualização de preço e estoque o Markteplace não informará postalCode (CEP).

Body Response:

{
    "items": [
        {
            "id": "XXXX",
            "requestIndex": 0,
            "quantity": 1,
            "seller": "1",
            "merchantName": null,
            "parentItemIndex": null,
            "parentAssemblyBinding": null,
            "priceValidUntil": "2050-12-31T23:59:59Z",
            "price": 41999,
            "listPrice": 41999,
            "offerings": [],
            "priceTags": [],
            "measurementUnit": "un",
            "unitMultiplier": 1.0000,
            "attachmentOfferings": []
        }
    ],
    "postalCode": "",
    "geoCoordinates": [],
    "country": "BRA",
    "logisticsInfo": [
        {
            "itemIndex": 0,
            "addressId": null,
            "selectedSla": null,
            "selectedDeliveryChannel": null,
            "stockBalance": 2,
            "quantity": 1,
            "shipsTo": [
                "BRA"
            ],
            "slas": [],
            "deliveryChannels": [
                {
                    "id": "delivery",
                    "stockBalance": 2
                }
            ]
        }
    ],
    "pickupPoints": [],
    "messages": [],
    "itemMetadata": null
}

Dentro do array de logisticsInfo o campo stockBalance deve conter a quantidade de estoque do SKU, o Markteplace usa esse campo para atualizar o estoque.

Os campos price e listPrice são utilizados para atualizar o preço do produto no Marketplace, o price representa o Preço POR e o listPrice representa o Preço DE.

Quando eu devo enviar atualização de preço e estoque para a Fast Shop?

Após o envio de produtos e com a confirmação de que a nossa API retornou HTTP 200 para a sua integração, com isso a sua integração pode enviar a notificação de atualização de preço e estoque.

Limite de Requisições

Este endpoint conta com um limite de 5 requisições por segundo, caso você envie mais que 5 requisições por segundo, você receberá o retorno HTTP: 429 - TOO MANY REQUEST. Faça o consumo consciente e inteligente no momento das alterações de preço e estoque para não haver problemas, segui as boas praticas recomendadas pela FastShop, Guia de Boas Práticas.

Obs: Sempre que você enviar um novo produto para a Fast Shop você precisa enviar uma notificação de alteração de preço e estoque para o produto ter essas informações.