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_stocksó 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.