RetailForce desarrolla software para cumplir con la normativa relativa a la fiscalización de los sistemas de registro electrónico en distintos países. Este software se denomina «Fiscal Middleware».
El presente documento ofrece una visión general de cómo integrar el RetailForce Middleware. La arquitectura del sistema de origen que envía y recibe datos del RetailForce Middleware, así como los requisitos y funciones específicos de dicho sistema, pueden hacer necesario apartarse de esta descripción.
1. Conceptos básicos
A continuación se enumeran los pasos individuales que deben llevarse a cabo antes de iniciar la integración. Estos pasos también se tratan en detalle durante la sesión de incorporación.
1.1 Resumen de las variantes de integración
Antes de iniciar la integración, obtenga una visión general de las distintas variantes de integración disponibles. Estas variantes se describen en el siguiente artículo: Visión general de la fiscalización con RetailForce – RetailForce Software GmbH (=artículo de visión general).
En el artículo enlazado también encontrará las fuentes desde las que puede descargar el RetailForce Middleware en las diferentes variantes.
Una vez descargado el Fiscal Middleware, proceda a su instalación. En el artículo de resumen encontrará una descripción detallada de cómo instalar las diferentes variantes.
1.1.1 En línea frente a fuera de línea
El RetailForce Fiscal Middleware es, básicamente, un sistema de software autónomo. Sin embargo, diversas funciones solo están disponibles cuando el middleware está conectado a la RetailForce Cloud.
RetailForce Cloud ofrece diversas funciones de gestión, como la configuración remota automática del middleware —incluida la asignación de licencias— y funciones de archivo seguro a largo plazo.
Para poder utilizar las funciones de RetailForce Cloud, el middleware fiscal o el cliente específico de la instalación (cliente = instancia única del sistema de registro electrónico) debe estar conectado a un terminal en RetailForce Cloud.
Si se va a utilizar el middleware sin establecer una conexión a la Cloud (sistema sin conexión), se pueden omitir los siguientes pasos. Continúe con el punto 1.5.
1.2 Acceder al RetailForce Portal
Todas las funciones de RetailForce Cloud se ofrecen a través de
- el RetailForce Cloud Portal (https://portal.retailforce.cloud), así como a través de
- la Cloud API (https://api.retailforce.cloud/swagger)
Por motivos de seguridad, no es posible registrarse de forma autónoma en el RetailForce Portal. Para acceder al portal, deberá recibir un enlace de invitación de un usuario ya autorizado. El proceso de registro posterior se describe en el siguiente artículo: Registro en el RetailForce Portal – RetailForce Software GmbH.
1.3 Estructura organizativa
En primer lugar, debe definirse una estructura organizativa en el portal. El artículo «Creación de una estructura organizativa en RetailForce Cloud – RetailForce Software GmbH» ofrece una visión general de las funciones disponibles para este fin.
1.4 Configuración
Una vez creada la estructura organizativa, así como al menos una organización (=cliente), una tienda (=sucursal) y un terminal (=caja), debe prepararse un objeto de configuración en la Cloud y asignarse a una entidad (organización, empresa, tienda o terminal). Encontrará una descripción de este proceso en: Información general sobre la configuración – RetailForce Software GmbH.
1.5 Inicialización
Si los pasos anteriores se han completado con éxito, puede ponerse en servicio el Fiscal Middleware. Los pasos necesarios para la puesta en servicio (con y sin establecer la conexión a la Cloud) se explican con más detalle en el artículo «Inicialización (general) – RetailForce Software GmbH».
Como resultado del proceso de puesta en marcha/inicialización, el «Fiscal Client» debería
- estar completamente configurado,
- ya sea mediante un objeto de configuración preparado en la Cloud, o
- «manualmente» por el sistema de registro electrónico,
- y disponer de un ID de cliente único.
2. Integración
Una vez completada con éxito la puesta en servicio de un cliente («caja registradora»), se puede iniciar la integración.
En esta sección se ofrece orientación sobre el proceso de transferencia de documentos entre la caja registradora (sistema de registro electrónico) y el cliente concreto.
2.1 Servicio web REST
El siguiente artículo le ayudará a dar los primeros pasos en la integración de la interfaz del servicio web REST, que se utiliza tanto para
- el servicio de Windows y
- el contenedor Docker.
Primeros pasos con el servicio fiscal – RetailForce Software GmbH
2.2 Implementación de NuGet
En el siguiente artículo se ofrece ayuda para la implementación de nuget (DLL) del middleware: Primeros pasos en la implementación de nuget – RetailForce Software GmbH.
2.3 Interfaz del sistema de archivos
Además de las dos variantes de implementación mencionadas anteriormente, el servicio web REST y NuGet, también es posible acceder al middleware mediante una interfaz de sistema de archivos. Encontrará más información al respecto en el artículo: Interfaz del sistema de archivos – RetailForce Software GmbH.
2.4 Proceso de transmisión de documentos
Una vez instalado el middleware fiscal —que adopta una forma similar a la de un servicio de Windows— en un ordenador, se puede acceder a la descripción de la API a través de http://localhost:7678/swagger/index.html.
En caso de instalación en un nodo remoto (p. ej., LAN), utilice la dirección IP del sistema en el que se haya instalado el middleware en lugar de «localhost».
Todos los puntos finales del middleware se describen en Swagger. Para la transmisión de documentos (por ejemplo, comprobantes de caja), son relevantes los puntos finales de la sección «Transacciones».
La transmisión de documentos es siempre un proceso de dos pasos, que se inicia con
- «createDocument» y finaliza con
- «storeDocument» o con «cancelDocument», en caso de cancelación del documento.
El proceso de transmisión de documentos se explica detalladamente aquí: Proceso básico de transferencia de documentos – RetailForce Software GmbH.
2.5 Fiscal Service Client Sample
RetailForce proporciona un programa de ejemplo, el «Fiscal Service Client Sample». Este ofrece orientación sobre cómo crear la estructura JSON en la que se envían los documentos al Servicio Fiscal.
El Fiscal Service Client Sample puede emplearse para generar ejemplos de distintos tipos de documentos y casos de uso.
Puede encontrar una descripción del programa en: Fiscal Service Client Sample – RetailForce Software GmbH.
También puede encontrar ejemplos de distintos documentos y casos de negocio en el Centro de Soluciones en: Transacciones comerciales – RetailForce Software GmbH.
2.6 Lista de puntos finales
A continuación, se describen los puntos finales (endpoints) que deben implementarse en cualquier caso.
| Punto final | Descripción |
| PUT /api/va/management/clients | solo es necesario si la configuración del cliente se va a realizar desde el software del punto de venta y no desde el sistema en la nube. Alternativa: PUT /api/v1/management/clients/byCloud |
| PUT /api/v1/management/clients/byCloud | Es necesario si la configuración del cliente se va a realizar desde el sistema en la nube. Alternativa: PUT /api/va/management/clients |
| POST /api/v1/management/cloud/connect | establece la conexión a la nube de un cliente. Debe ejecutarse tras cada reinicio del sistema. Los datos necesarios para establecer dicha conexión (API Key y API Secret) deben almacenarse en el sistema de registro electrónico. |
| POST /api/v1/management/clients/initialize | Inicializa el cliente o cualquier hardware fiscal necesario (dispositivo técnico de seguridad, unidad de creación de firma, impresora, etc.). Para la inicialización se requiere un documento de inicio. Este puede generarse bien mediante el sistema de registro electrónico, bien automáticamente a través del middleware con el punto final GET /api/v1/transactions/document/{clientId}/start. |
| GET /api/v1/transactions/document/{clientId}/start | Recomendado. Crea el denominado documento de inicio para el cliente específico, con fines de inicialización. |
| PUT /api/v1/transactions/createDocument | Este método no genera un documento per se, sino que inicia el proceso, por ejemplo, en el TSE (Dispositivo Técnico de Seguridad) en Alemania. (¡Obligatorio en todos los países!) |
| POST /api/v1/transactions/storeDocument | Guarda el documento correspondiente |
| POST /api/v1/transactions/cancelDocument | Anula un documento en la unidad de fiscalización. |
Este artículo ha sido traducido automáticamente.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.