El servicio de fiscalización de RetailForce es un middleware de fiscalización basado en .NET para Alemania y el resto de países.

Instalación

Puede descargar una copia del servicio de fiscalización para Windows a través del siguiente enlace:

http://www.retailforce.cloud/downloads

Le rogamos que descargue la versión más reciente del software.

El instalador se ejecuta de forma sencilla y no requiere información adicional.

Una vez completada la instalación, el servicio se expondrá como un servicio web REST (JSON) en el puerto 7678 (HTTPS) sobre localhost.

Alternativas

Como alternativa a la instalación del servicio web REST, el RetailForce Fiskal middleware también está disponible como:

• Contenedor Docker: puede descargarse desde Docker Hub https://hub.docker.com/u/RetailForce, así como
• Nuget-packages: descargue los paquetes en https://www.nuget.org/profiles/RetailForceDevelopment

Puede encontrar información sobre estas variantes de instalación e integración en los siguientes artículos:

• Contenedor Docker: Linux — TrustedFiscalService como contenedor Docker
• nuget-packages: Primeros pasos en la implementación de nuget

Aplicación de ejemplo

También encontrará una aplicación de ejemplo en el directorio de descargas mencionado anteriormente, dentro de la subcarpeta «Samples» (Fiscal Service Client Sample). En esta aplicación de ejemplo se incluye todo el código fuente para realizar un registro y una firma sencillos en C#.

Para utilizar la aplicación de ejemplo, puede emplear el siguiente GUID de cliente:

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

Puede utilizar este GUID de cliente para sus primeras pruebas sin ningún problema. Para realizar pruebas adicionales, incluso con integración en la nube, deberá crear su propio cliente de prueba con RetailForce Cloud.

En caso de problemas con archivos DLL ausentes, consulte la carpeta «bin/debug» del proyecto en la aplicación de ejemplo.

Validación de documentos

Para facilitar la integración de su software, hemos implementado una función que valida el modelo de objetos del documento que enviará al módulo de fiscalización.

Al invocar el método ValidateDocument en un TrustedFiscalModule creado o en el servicio web de fiscalización (dependiendo de su integración), obtendrá todos los errores (y advertencias) del documento de una sola vez. De este modo, resulta mucho más sencillo adaptar el procedimiento de llamada para completar el proceso de integración.

Información adicional

La integración del middleware puede realizarse de las siguientes formas

• Integración mediante servicio web (Windows, REST)
• Integración a través de servicio web (con Fiskalclient en .NET Standard, NuGet)
• Integración a través de un servicio web (con Fiskalclient en .NET Framework 2.0, nuget)
• Integración mediante servicio web (como DLL COM/ActiveX, disponible previa solicitud)
• Integración como paquete AAR en dispositivos Android (para Java) (la disponibilidad dependerá de los planes de Microsoft)

Información adicional sobre aspectos técnicos

• Todo el desarrollo se realiza mediante metodología Test-Driven Development (TDD).
• Todas las pruebas se ejecutan durante el proceso de compilación al crear una nueva versión
• La implementación de la solución se realiza mediante paquetes NuGet o mediante la descarga del instalador de Windows.

Sistemas operativos

El RetailForce Middleware se ha probado hasta la fecha en los siguientes sistemas operativos:

• Windows 7
• Windows 10
• Android (a partir de la versión 8) (como integración de paquetes nuget)
• Linux (para el servicio)

Consulte también la documentación del sistema de seguridad para verificar si el sistema de seguridad elegido (TSE, HSM, etc.) en el país correspondiente es compatible con su sistema operativo.

Por el momento no se ha validado ni es compatible, pero debería funcionar:

• iOS (como integración de paquetes NuGet)

Gestión de clientes fiscales

Según nuestra experiencia, la gestión de clientes fiscales puede resultar en ocasiones laboriosa y compleja.

Por ello, hemos creado los siguientes servicios adicionales:

• Configuración automática de clientes mediante RetailForce Cloud, lo que elimina el mantenimiento del cliente fiscal instalado
• API de gestión de RetailForce Cloud para administrar empresas, tiendas y terminales adicionales, así como todos los demás datos maestros que se requieran.

Documentación adicional / documentación del servicio

Encontrará documentación adicional aquí:

Descripción completa del servicio web

• http://localhost:7678/swagger (tras instalar el servicio web)

Documentación completa (modelo de objetos) del servicio fiscal

Documentación en la subcarpeta «download» de los archivos de instalación (enlace del capítulo «Instalación»)

Esta documentación estará disponible próximamente en http://docs.RetailForce Cloud.

Características del país (fiscalCountryProperties)

Este artículo ha sido traducido automáticamente.