Informações gerais sobre a configuração

Este artigo contém informações gerais sobre como criar um objeto de configuração para o RetailForce Fiscal Middleware na nuvem. As configurações são descarregadas e aplicadas pelos clientes fiscais durante a inicialização, através do ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Para mais informações, consulte o artigo sobre a inicialização.

No RetailForce portal, a configuração pode ser herdada para os níveis inferiores da estrutura organizacional. Isto significa que uma configuração pode ser utilizada em vários terminais ao mesmo tempo, não sendo necessário criá-la para cada terminal. É também possível substituir algumas configurações no objeto herdado.

Exemplo:

No exemplo abaixo, o objeto de configuração A é atribuído à organização «XYZ Holding GmbH». A configuração é herdada por todas as unidades subordinadas na estrutura organizacional. A caixa registadora «099» (terminal) tem atribuído o objeto de configuração B, sobrepondo assim o objeto de configuração A herdado.

O objeto de configuração é sempre independente do objeto de dados mestre, como a organização, etc.

É possível transferir um objeto de configuração para qualquer nível de herança. Um objeto de configuração pode ser transferido em cada nível (organização, empresa, lojas e terminais).

Importante: Não é possível partilhar um objeto de configuração entre diferentes organizações. Deve ser criado um objeto de configuração distinto para cada organização. Exceção: Organização Principal

Estrutura de herança de dados na Cloud:

Organização
- Empresa — opcional
  - Loja
    - Terminal

Exemplo:

A sua organização é composta por 13 lojas na Alemanha e está agora a planear uma nova filial na Áustria. O hardware do sistema de PDV utilizado é o mesmo na Alemanha e na Áustria.

Irá necessitar de:

Uma organização sediada na Alemanha (fiscalCountry = Alemanha)
Uma empresa adicional opcional com sede na Áustria (fiscalCountry = Áustria)
13 lojas/filiais ligadas à organização
1 filial com ligação à organização E à empresa na Áustria

Terá de definir 2 objetos de configuração:

um objeto de configuração com todas as configurações necessárias para a Alemanha
- pode definir toda a configuração de hardware no objeto de configuração para a Alemanha
um objeto de configuração com todas as configurações necessárias para a Áustria
- não é necessário definir a configuração de hardware na configuração para a Áustria
- substitua o «fiscalCountry» e a configuração específica do país na configuração para a Áustria

Atribuição de configurações

A atribuição de um objeto de configuração é efetuada no RetailForce portal, através dos detalhes das respetivas entidades (objetos organizacionais: Organização, Empresa, Loja, Terminal).

Para tal, selecione a configuração relevante na área «Configuração» através do menu suspenso e clique em «Guardar».

Nota: Se nenhum objeto de configuração for apresentado na seleção, isso significa que ainda não foi criada nenhuma configuração ou que a configuração criada não corresponde ao país fiscal definido para a entidade. As configurações só podem ser atribuídas se o país fiscal da entidade (por exemplo, a empresa) corresponder ao da configuração.

O item de menu «Nova configuração» pode ser utilizado para especificar que uma nova configuração é válida a partir de uma determinada data («Nova válida a partir de»).

Atualizar configuração

Atenção: Se um objeto de configuração for alterado na Cloud, essa alteração NÃO é distribuída automaticamente aos clientes relevantes (mandatos de middleware)!

As configurações de cada client devem ser transmitidas através de:

PUT /api/v1/management/clients/byCloud/{clientId}

devem ser atualizadas.

Tratamento de erros

Erro: Licença

Se receber o seguinte erro ao aceder ao ponto de extremidade GetConfiguration, receberá a seguinte mensagem:

[error] (exception): License 'GetConfiguration' for client '<ClientID>' not found.

Falta a opção de licença que permite ao client recuperar dados de configuração da nuvem. Verifique no RetailForce Cloud Portal se a licença atribuída contém a opção «Aceder ao download da configuração».

Atribuição de configurações

Atualizar configuração

Tratamento de erros

Erro: Licença

Artigos relacionados

Comentários