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 parámetros adicionales.
Una vez instalado, el servicio estará disponible como un servicio web REST (JSON) en el puerto 7678 (HTTP). El servicio escucha en todas las interfaces de red del equipo, no solo en localhost. Para la comunicación cifrada (HTTPS en el puerto 7677), consulte «Activación de HTTPS para una comunicación API más segura».
Alternativas
Como alternativa a la instalación del servicio web REST, el RetailForce Fiskal middleware también está disponible como:
- Contenedor Docker: se puede descargar en Docker Hub https://hub.docker.com/u/RetailForce, así como
- paquetes NuGet: descargue los paquetes en: https://www.nuget.org/profiles/RetailForceDevelopment
La información detallada sobre estas variantes de instalación e integración se encuentra 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 errores por falta de archivos DLL, consulte la carpeta «bin/debug» del proyecto en la aplicación de ejemplo.
Validación de documentos
Para facilitarle la integración de su software, hemos desarrollado 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 a través de servicio web (Windows, REST)
- Integración a través de un 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 de desarrollo guiado por pruebas
- 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
Hasta la fecha, el RetailForce Middleware fiscal se ha probado 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 comprobar 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 probado ni es compatible, pero debería funcionar:
- iOS (como integración de paquete nuget)
Gestión de clientes fiscales
Según nuestra experiencia, la gestión de clientes fiscales puede resultar a veces laboriosa y compleja.
Por ello, hemos creado los siguientes servicios adicionales:
- Configuración automática de clientes mediante la RetailForce Cloud, lo que elimina la necesidad de 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 necesite.
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 disponible 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.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.