Neste artigo, irá aprender quais os passos que deve seguir após restabelecer a ligação ao FiskalService.

Os mesmos passos devem ser seguidos na integração .NET.;

Pré-requisitos

• O serviço fiscal está instalado e o URL é conhecido / a integração da biblioteca .NET está concluída até ao momento
• Tem acesso ao RetailForce Cloud utilizando a ApiKey/apiSecret da nuvem
• Utiliza a configuração descarregada da Cloud
• Conhece o número UID / número fiscal da organização do sistema de ponto de venda
• Conhece o número da loja e do terminal

Abordagem

Para armazenar o mínimo de dados possível no sistema de PDV, pode proceder da seguinte forma. Fica ao seu critério armazenar os estados no sistema de caixa, mas terá de os atualizar repetidamente.

Verifique se a configuração do client já existe

Após concluir este passo, receberá o uniqueClientId do módulo fiscal para a caixa registadora solicitada. (O uniqueClientId corresponde ao terminalId na RetailForce Cloud).

Serviço fiscal

Para determinar se a configuração do client já existe no FiskalService, terá de executar dois métodos:

• GET management/clients/LicenseConsumerId
• GET management/clients/ID

Para obter informações detalhadas sobre as funcionalidades, consulte a documentação swagger do Client do FiscalService.

Integração .NET

Com a integração .NET, pode utilizar a classe `FiscalModuleManagement` e o método `GetClients()` para consultar todos os clientes disponíveis na configuração.

O client ainda não existe na configuração

Se o client já existir na configuração e tiver recebido um uniqueClientId, pode ignorar este passo.

Descarregue a configuração do terminal a partir da Cloud; para obter instruções, consulte o artigo:

Inicialização (geral)

Ligar-se à Cloud

Serviço fiscal

O módulo fiscal não armazena os dados de acesso à Cloud (ApiKey/apiSecret). Por conseguinte, estes dados de acesso devem ser transferidos para o serviço/módulo fiscal sempre que for estabelecida uma nova ligação.

Os dados podem ser transmitidos utilizando o seguinte método:

• POST management/Cloud/connect

Integração .NET

Na integração .NET, as credenciais para a Cloud devem ser transmitidas aquando da criação do módulo fiscal (parâmetro do método CreateFiscalModuleForClient).

Recomenda-se inicializar e carregar o módulo fiscal no arranque do software POS durante a integração .NET, uma vez que, em alguns países, é necessário realizar etapas de inicialização que demoram um pouco mais.

Verifique se o FiskalClient já está inicializado

Para determinar se o FiskalClient já foi inicializado, pode consultar o estado do FiskalClient:

• GET /api/v1/information/client/{clientId}/status
• Integração .NET: Propriedade FiscalClientStatus no Fiscalmodule

A propriedade «State» pode assumir os seguintes valores:

• NotInitialized
• Initialized
• Desativado

Inicialização do client fiscal

Se o FiskalClient já estiver inicializado, pode saltar este passo.

Encontrará uma descrição de como proceder à inicialização no artigo seguinte:

Inicialização (geral)

Concluir

Após realizar os passos anteriores, o Fiscal Client está pronto para receber os registos iniciais.

Este artigo foi traduzido automaticamente.