Editar em massa os preços de canal de vendas e alternar os tipos de preço em um design
Edite os valores de canal de vendas e de tipo de preço de muitos SKUs de uma só vez e recalcule o preço de um design existente alternando seu tipo de preço.
A edição em massa dos preços de canal de vendas de muitos SKUs de ferragens ou acessórios é feita selecionando os SKUs, abrindo a ação de edição em massa, editando os valores individuais de canal de vendas e de tipo de preço e confirmando as alterações.
Alternar o tipo de preço em um design existente recalcula seu preço no próprio local — o design não precisa ser copiado nem remodelado para ser orçado com outro conjunto de preços.
Um tipo de preço pode ser usado para alternar instantaneamente o orçamento de um design existente entre preços padrão e preços de franqueado, sem alterar o canal de vendas.
Um tipo de preço não pode ser definido como fator ou porcentagem de outro tipo de preço.
Cada tipo de preço deve receber seus próprios valores por SKU.
Um aumento de preço é aplicado editando os preços individuais dos itens, e não definindo um multiplicador único.
POST /price/update (também exposto em enterprise_api) atualiza o preço de um SKU. Regras aplicadas no código: sales_channel_id e price_type_id devem ser enviados juntos ou não ser enviados — omitir ambos atualiza o preço padrão da organização/BU, enviar ambos atualiza o preço daquele canal + lista de preços; enviar apenas um gera erro. price, tax, margin e display_unit são obrigatórios (zero é aceito; valores ausentes retornam 'price, tax, margin, display_unit must be specified'); os campos de desconto são opcionais. A chamada também aceita uma configuração opcional de atendimento ('serviceable' ou 'unserviceable') que se aplica ao mapeamento SKU + canal de vendas independentemente da lista de preços; ela só pode ser enviada junto com um canal de vendas, e enviá-la sem um é rejeitado. Pela API empresarial, use_referred_price é fixado em false, então toda atualização via API DESVINCULA o preço do canal de vendas do preço padrão — após uma gravação via API, alterações posteriores no preço padrão deixam de fluir para esse preço de canal até que alguém o vincule novamente em admin portal. Quando o canal + tipo de preço de destino ainda não tinha uma linha de preço explícita, a API cria uma, copiando as configurações de CBU/lista de exclusão/margem de substituição/preço de origem do preço padrão. Os preços de unidades de exibição dimensionais devem ser enviados na base por milímetro. As falhas aparecem como PRICE_UPDATE_FAILED, e uma requisição que nomeia um canal de vendas sem entrada de SKU correspondente é rejeitada como erro de parâmetros inválidos; a autorização exige direitos de gerente de catálogo para a organização ou para a BU proprietária do canal de vendas, e toda chamada é registrada no log de auditoria.
Excluir um tipo de preço (price_type/remove; gerente de catálogo no nível da organização ou da BU) é um fluxo protegido em duas etapas. O tipo de preço padrão nunca pode ser excluído (CANNOT_DELETE_DEFAULT_PRICE_TYPES). Uma primeira chamada sem force retorna successfully_removed:false e o que a bloqueia: sales_channel_map_req lista os canais de vendas em que este é o ÚNICO tipo de preço mapeado (cada um precisa de um substituto), e users_map_req lista os usuários cujo tipo de preço PREFERIDO é este (num_users conta todos os mapeados). O chamador deve reenviar com sales_channel_map e user_map fornecendo exatamente um substituto por entidade bloqueada — sem extras, sem faltas, todos os tipos de preço pertencentes à mesma organização — caso contrário, INVALID_PARAMS. Atenção: o tipo de preço preferido substituto de um usuário já deve estar mapeado para esse usuário no mesmo nível (organização ou BU); a API não cria o mapeamento e falha com INVALID_PARAMS. Em caso de sucesso, ela exclui o tipo de preço, seus mapeamentos de usuário e de canal de vendas e todos os mapeamentos de preço de SKU por canal de vendas sob ele — todo preço personalizado por SKU armazenado nessa lista de preços é descartado permanentemente (um comentário no código observa que as linhas de Price subjacentes ficam órfãs por motivos de referência). Oriente os clientes a tratar a exclusão de tipo de preço como destrutiva e irreversível para os preços dessa lista.