Ajuda Infurnia

“Translated trade words” is not ready for these pages yet, so they are shown with “Common trade words in English”.

Pricing

Por que os tipos de preço mostram silenciosamente o preço padrão

Entenda por que todos os tipos de preço mostram o mesmo preço e como se comportam as linhas de preço vinculadas e personalizadas.

  1. 'all my price types show the same price' significa que nenhum preço específico de canal foi definido - tudo está recorrendo ao padrão.

  2. Toda linha de preço carrega use_referred_price e referred_price_id. Enquanto use_referred_price for true, o preço efetivo usado em leituras e cotações é o preço no FIM da cadeia de referência; os números armazenados na própria linha não são usados para o preço efetivo. Isso produz duas confusões clássicas. Primeiro, 'I changed the price and nothing happened': a linha em edição está no modo vinculado, então seus números são inúteis - a correção é mudar o preço para o modo personalizado (uma atualização com use_referred_price=false salva os números e desfaz o vínculo em uma única etapa). Segundo, 'I typed a price and it vanished': quando uma solicitação de atualização ativa o modo vinculado (use_referred_price=true), o backend salva o sinalizador e descarta silenciosamente qualquer preço/imposto/margem enviado na mesma solicitação - por design, já que um preço vinculado recebe valores da sua referência; também limpa qualquer precificação baseada em fórmula nessa linha. O outro lado é o recurso de poder pretendido: editar o preço padrão da organização/BU atualiza instantaneamente todos os preços de canal de vendas que ainda estão vinculados a ele. Observe que cada preço de canal de vendas é criado no modo personalizado, mas mantém um ponteiro para o preço padrão, para que possa ser revinculado depois sem perder a relação. Diagnostique perguntando qual linha foi editada e se ela está no modo vinculado ou personalizado.

  3. Editar um desses preços sintetizados pela primeira vez na verdade CRIA uma nova linha de preço de canal (nascida no modo personalizado, com um ponteiro de volta ao padrão mantido para que possa ser vinculada depois).

  4. Depois de criado, esse tipo de preço deixa de seguir o padrão, a menos que a opção de vinculação esteja ativada.

  5. Para fazer um tipo de preço acompanhar o padrão novamente, ative sua opção vinculada/referida em vez de redigitar os números.

  6. A sequência 'default price updated, most price types moved but one did not' significa que um tipo de preço foi definido explicitamente (ou atualizado via API) em algum momento.

  7. A rota pública /enterprise_api/price/update fixa use_referred_price como false para chamadores enterprise - o sinalizador não pode ser enviado pela API. Consequência: na primeira vez que um ERP/integração atualiza um preço de canal de vendas para um (SKU, canal de vendas, tipo de preço), esse preço é convertido para o modo personalizado e desvinculado do preço padrão da organização/BU. A partir daí, as edições no preço padrão não fluem mais para esse preço de canal. Isso aparece como: 'atualizamos o preço mestre/padrão, mas nosso canal de revendedores ainda mostra a taxa antiga' - a causa usual é uma sincronização anterior via API que tocou o preço de canal e quebrou o vínculo silenciosamente. Não há forma de revincular pela API; o cliente deve reativar a opção vinculada/referida nesse preço pela interface do catálogo, ou aceitar que sua integração deve enviar atualizações explicitamente para cada preço de canal. Ao integrar um cliente com sincronização de ERP, avise desde o início: sincronizar preços no nível de canal significa assumir TODOS os preços no nível de canal daí em diante, enquanto sincronizar apenas preços padrão mantém a herança interna funcionando. Observe também que as atualizações de preço são registradas no log de auditoria (price_update), o que ajuda a estabelecer quando um vínculo foi quebrado.