O serviço de fiscalização da RetailForce é um middleware de fiscalização baseado em .NET para a Alemanha e todos os outros países.

Instalação

Pode descarregar uma cópia do serviço de fiscalização para Windows através da seguinte ligação:

http://www.retailforce.cloud/downloads

Por favor, descarregue a versão mais recente do software.

A instalação é simples, não sendo necessárias mais informações.

Após a instalação, o serviço fica disponível como um serviço Web REST (JSON) na porta 7678 (HTTPS) no localhost.

Alternativas

Como alternativa à instalação do serviço Web REST, o RetailForce Fiskal middleware também está disponível como:

• Contentor Docker — disponível para download no Docker Hub https://hub.docker.com/u/RetailForce, bem como
• nuget-packages — descarregue os pacotes em: https://www.nuget.org/profiles/RetailForceDevelopment

Pode encontrar informações sobre estas variantes de instalação/integração nos seguintes artigos:

• Contentor Docker: Linux — TrustedFiscalService como contentor Docker
• nuget-packages: Primeiros passos na implementação do nuget

Aplicação de exemplo

Encontrará também uma aplicação de exemplo no diretório de download acima, na subpasta «Samples» (Fiscal Service Client Sample). Nesta aplicação de exemplo, está incluído todo o código-fonte para o registo e assinatura simples em C#.

Para utilizar a aplicação de exemplo, pode utilizar o seguinte GUID do client:

{c1062c55-57c4-4ed2-9c53-aff1762326a4}

Pode utilizar este GUID de cliente para os seus primeiros testes sem qualquer problema. Para testes adicionais, incluindo a integração na nuvem, terá de criar o seu próprio cliente de teste com o RetailForce Cloud.

Caso encontre problemas com DLLs em falta, consulte a pasta «bin/debug» do projeto na aplicação de exemplo.

Validação de documentos

Para o ajudar a integrar o seu software, criámos uma função para validar o modelo de objeto do documento que irá enviar para o módulo de fiscalização.

Ao chamar o método ValidateDocument num TrustedFiscalModule criado ou no serviço web de fiscalização (dependendo da sua integração), obterá todos os erros (e avisos) do documento de uma só vez. Assim, é muito mais fácil adaptar o procedimento de chamada para concluir o processo de integração.

Informações adicionais

A integração do middleware pode ser efetuada das seguintes formas

• Integração através de serviço web (Windows, REST)
• Integração através de serviço web (com o Fiskalclient no .NET Standard, nuget)
• Integração através de serviço web (com o Fiskalclient no .NET Framework 2.0, nuget)
• Integração através de serviço web (como COM-DLL/ActiveX, disponível mediante pedido)
• Integração como pacote AAR em dispositivos Android (para Java) (disponibilidade dependente dos planos da Microsoft)

Algumas informações adicionais sobre aspetos técnicos

• Todo o desenvolvimento é realizado segundo o método de desenvolvimento orientado por testes
• Todos os testes são executados durante o processo de compilação, aquando da criação de uma nova versão
• Implementação da solução através de pacotes nuget-packages ou também através do download do programa de instalação do Windows.

Sistemas operativos

O RetailForce Middleware Fiscal foi testado, até ao momento, nos seguintes sistemas operativos:

• Windows 7
• Windows 10
• Android (a partir da versão 8) (como integração de pacote nuget)
• Linux (para o serviço)

Consulte também a documentação do sistema de segurança para verificar se o sistema de segurança escolhido (TSE, HSM, etc.) no país em questão é compatível com o seu sistema operativo.

De momento, não foi testado nem é suportado, mas deverá funcionar:

• iOS (como integração de pacote nuget)

Gestão de clientes fiscais

Pela nossa experiência, a gestão de clientes fiscais pode, por vezes, ser demorada e complicada.

Por isso, criámos os seguintes serviços adicionais:

• Configuração automática de clientes através da RetailForce Cloud, dispensando a manutenção do cliente fiscal instalado
• API de gestão da nuvem RetailForce para a gestão de empresas, lojas e terminais adicionais, bem como de todos os outros dados mestre de que necessitará.

Documentação adicional / documentação do serviço

Encontrará documentação adicional aqui:

Descrição completa do serviço para o serviço web

• http://localhost:7678/swagger (após a instalação do serviço web)

Documentação completa (modelo de objetos) do serviço fiscal

Documentação na pasta de downloads dos ficheiros de instalação (ligação no capítulo «Instalação»)

Esta documentação estará disponível em breve em http://docs.RetailForce Cloud.

Características do país (fiscalCountryProperties)

Este artigo foi traduzido automaticamente.