Criar produtos em lote

Cadastra ou atualiza até 100 produtos de uma vez, pelo código (SKU). Item com problema não derruba os outros.

POST https://app.salos.com.br/api/products/batch products:write

Corpo de exemplo

{
  "items": [
    { "name": "Camiseta Básica", "sku": "CAM-1", "base_price": 49.9 },
    { "name": "Caneca", "sku": "CAN-1", "base_price": 19.9, "track_stock": false }
  ]
}

Cada item é o mesmo corpo de POST/api/products (sem custom_fields). Upsert por sku:

  • SKU que já existe na conta → atualiza o produto e a variação com os campos enviados (o que não veio não é mexido; initial_stock só vale na criação);
  • SKU novo (ou sem SKU) → cria o produto.

O mesmo SKU duas vezes no mesmo lote: só o 1º item vale, os repetidos viram erro no item. Campo desconhecido num item vira erro daquele item, não do lote. SKU de um produto excluído (arquivado) continua reservado: o item é recusado.

Resposta

{
  "data": {
    "resultados": [
      { "indice": 0, "ok": true, "id": "…", "acao": "criado" },
      { "indice": 1, "ok": true, "id": "…", "acao": "atualizado", "avisos": ["Custo e imposto ignorados: só administrador grava."] },
      { "indice": 2, "ok": false, "erro": "Esse código pertence a um produto excluído." }
    ]
  }
}

avisos aparece quando algo do item não entrou (custo de quem não é dono ou administrador, estoque inicial em produto sem controle de estoque…) — o item nunca volta ok calado sobre isso.

Idempotency-Key vale pro lote inteiro. ?dry_run=true valida os itens sem gravar nada — os que passariam voltam ok: true, sem id nem acao.