Developers

Preço e saldo

Envie o preço e o saldo de cada produto em cada loja. É o que a contagem compara, a ruptura usa e a rebaixa precifica.

O preço e saldo por loja é o dado que mais muda. O BIX usa:

  • na Contagem: o saldo esperado, para a divergência;
  • na Ruptura: o saldo, para saber se o produto devia estar na gôndola;
  • na Validade: o preço, para calcular a rebaixa.

Enviar

POST/stock-prices

{
  "items": [
    {"store_code": "0012", "internal_code": "1001", "warehouse": "01",
     "balance": 48, "price": 27.9, "price_regular": 29.9}
  ]
}
Regra Detalhe
Chave (loja, produto, depósito). warehouse vazio quando o ERP não separa por depósito
Loja store_code (código de integração) ou store_id
Produto ean ou internal_code. Um internal_code com vários EANs atualiza todos eles
Parcial Campo ausente não é alterado: a carga de preço e a de saldo podem ser separadas sem uma apagar a outra
Oferta price_offer com valor abre a oferta; price_offer: null encerra
Curva curve vazio limpa a curva
Custos costs (opcional): médio contábil, médio com e sem impostos, última compra bruto e líquido

Só atualizar: update_only

Uma carga que não traz preço nem saldo (só a curva, por exemplo) não deve criar a linha da loja, senão o produto aparece com preço e saldo zerados. Use update_only: true: se não houver registro daquele produto na loja, o item volta skipped.

{"items": [{"store_code": "0012", "internal_code": "1001", "warehouse": "01",
            "curve": "A", "update_only": true}]}

Qual preço o BIX usa na rebaixa

price_regular, se vier; senão price; senão o preço do cadastro do produto. Mande o price_regular (sem oferta) sempre que tiver: é ele que dá o "de" da rebaixa.

Ler

GET/stock-prices

A leitura é por loja (store_code), sem filtro por data de alteração: a carga em lote não marca a hora em toda linha, e um filtro por data perderia mudanças.