curl -X POST https://{loja}.com.br/api/hunter/v1/produtos \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hk_..." \
  -d '{
    "produtos": [
      {
        "hunter_id": "PROD-001",
        "nome": "Produto Exemplo A",
        "descricao": "Descrição textual.",
        "categoria_hunter_id": "CAT-01",
        "sku_base": "SKU-001",
        "marca": "Marca Exemplo",
        "peso_kg": 0.15
      }
    ]
  }'

const res = await fetch(`${BASE_URL}/produtos`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.API_KEY,
  },
  body: JSON.stringify({
    produtos: [
      {
        hunter_id: "PROD-001",
        nome: "Produto Exemplo A",
        descricao: "Descrição textual.",
        categoria_hunter_id: "CAT-01",
        sku_base: "SKU-001",
        marca: "Marca Exemplo",
        peso_kg: 0.15,
      },
    ],
  }),
});

import requests

res = requests.post(
    f"{BASE_URL}/produtos",
    headers={"X-API-Key": API_KEY},
    json={
        "produtos": [
            {
                "hunter_id": "PROD-001",
                "nome": "Produto Exemplo A",
                "descricao": "Descrição textual.",
                "categoria_hunter_id": "CAT-01",
                "sku_base": "SKU-001",
                "marca": "Marca Exemplo",
                "peso_kg": 0.15,
            }
        ]
    },
)

{
  "success": true,
  "data": {
    "processados": 2,
    "criados": 1,
    "atualizados": 1,
    "erros": 0,
    "resultados": [
      { "hunter_id": "PROD-001", "id_loja": "uuid-1", "acao": "criado" },
      { "hunter_id": "PROD-002", "id_loja": "uuid-2", "acao": "atualizado" }
    ],
    "parcial": false,
    "totalmente_falho": false
  }
}

{
  "success": true,
  "data": {
    "processados": 3,
    "criados": 2,
    "atualizados": 0,
    "erros": 1,
    "resultados": [
      { "hunter_id": "PROD-001", "id_loja": "uuid-1", "acao": "criado" },
      { "hunter_id": "PROD-002", "id_loja": "uuid-2", "acao": "criado" },
      {
        "hunter_id": "PROD-003",
        "id_loja": null,
        "acao": "erro",
        "erro": "categoria_hunter_id 'CAT-INEXISTENTE' não encontrada."
      }
    ],
    "parcial": true,
    "totalmente_falho": false
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION",
    "message": "Payload inválido — veja details pra campos com erro.",
    "details": [
      {
        "path": "produtos.0.ativo",
        "message": "Campo 'ativo' é gerenciado pela loja, não deve ser enviado.",
        "code": "custom"
      }
    ]
  }
}