Todos os cursos

Conciliação por fonte

Quando seu ERP, seu PLM ou sua ficha técnica dizem coisas diferentes sobre o mesmo dado: o que cada sistema reportou, onde não coincidem e como decidir qual manda.

O que é

Além do valor de cada atributo de um produto (o mestre, o que sai nos seus downloads e canais), a Bruxel guarda o que diz cada um dos seus sistemas conectados. Assim você vê onde não coincidem e decide qual manda, sem que um sistema sobrescreva o outro.

  • O que um sistema reporta não muda o mestre, nem o histórico, nem a completude.
  • A comparação é exata, depois de converter as unidades: 285 e 285,4 não coincidem.
  • Vale para atributos de texto, número, medida, data, sim/não e seleção; não para os de seleção múltipla.

Como um sistema reporta

Pela API pública, com `PUT /v1/products/:id/attributes/:code/source` e uma chave com a permissão `attributes:write`. Cada sistema usa a própria chave: a fonte é o sistema ao qual a chave está ligada em «Sistemas conectados» ou, se não tiver um, o nome da chave.

O valor é validado como o do mestre (uma medida é convertida para a unidade do atributo), e enviá-lo vazio apaga o que esse sistema dizia. Os detalhes estão no portal para desenvolvedores.

Na ficha

Abaixo de cada atributo que algum sistema reportou, a ficha diz quantas fontes há e se coincidem com o mestre («2 fontes · não coincidem»), com o valor de cada sistema e quando ele o viu. «Usar este» passa esse valor para o mestre e fica no histórico como «Conciliação».

Usá-lo exige o papel de Editor ou superior e respeita as mesmas travas de editar à mão: atributos protegidos, o acesso limitado por grupo e o que uma regra define.

A fila de divergências

Em Catálogo → «Conciliação por fonte» estão todos os produtos cujos sistemas não coincidem, com filtros por família, atributo e fonte. Para resolver em lote, marque as linhas («Selecionar todas» marca as da página), escolha «Usar o valor de» um sistema e clique em «Enviar ao mestre». O que não foi possível diz por quê: essa fonte não reportou o atributo, o atributo é protegido, está fora do seu acesso ou uma regra o define.

A fila é vista por quem não tem acesso limitado a uma parte do catálogo; resolver exige o papel de Editor ou superior.

Fazer um sistema mandar

Com as regras de prioridade ativas, ao escolher um atributo no filtro aparece «Prioridade das fontes»: os sistemas, do que mais manda ao que menos manda. Depois de salvar com «Salvar ordem», cada vez que um sistema reporta, o mais alto da lista que tiver reportado escreve o mestre sozinho (no histórico: «Regra de prioridade»). «Aplicar ao existente» faz o mesmo com o que já estava reportado.

  • Salvar a ordem não muda nada por si só.
  • Nunca escreve um atributo protegido nem um que outra regra define.
  • Sem ordem, tudo fica como divergência.
Quem muda a ordem é um administrador.

Nos relatórios

Em Relatórios, «Divergências entre fontes» baixa a lista completa, e o relatório de qualidade em PDF diz quantas faltam resolver.