Información general sobre la configuración

Este artículo contiene información general sobre cómo crear un objeto de configuración para RetailForce Fiscal Middleware en la nube. Las configuraciones son descargadas y aplicadas por los clientes fiscales durante la inicialización, a través de ConfigClient byCloud (PUT /api/v1/management/clients/byCloud). Para obtener más información, consulte el artículo sobre la inicialización.

En el RetailForce Portal, la configuración puede heredarse hacia abajo dentro de la estructura organizativa. Esto significa que una configuración puede utilizarse para varios terminales al mismo tiempo y no es necesario crearla para cada terminal. También es posible sobrescribir algunas configuraciones en el objeto heredado.

Ejemplo:

En el ejemplo siguiente, el objeto de configuración A se asigna a la organización «XYZ Holding GmbH». La configuración es heredada por todas las unidades subordinadas de la estructura organizativa. A la caja registradora «099» (terminal) se le asigna el objeto de configuración B, con lo que se sobrescribe el objeto de configuración A heredado.

El objeto de configuración es siempre independiente del objeto de datos maestros, como la organización, etc.

Es posible transferir un objeto de configuración a cualquier nivel de herencia. Un objeto de configuración puede transferirse en cada nivel (organización, empresa, tiendas y terminales).

Importante: No es posible compartir un objeto de configuración entre diferentes organizaciones. Se debe crear un objeto de configuración independiente para cada organización. Excepción: Organización principal

Estructura de herencia de datos en la Cloud:

Organización
- Empresa —opcional—
  - Tienda
    - Terminal

Ejemplo:

Su organización cuenta con 13 tiendas en Alemania y ahora tiene previsto abrir una nueva sucursal en Austria. El hardware del sistema de punto de venta (POS) utilizado es el mismo tanto en Alemania como en Austria.

Necesitará:

Una organización con sede en Alemania (FiscalCountry = Alemania)
Una empresa adicional opcional con sede en Austria (FiscalCountry = Austria)
13 tiendas/sucursales vinculadas a la organización
1 sucursal vinculada a la organización y a la empresa de Austria

Debe definir dos objetos de configuración:

un objeto de configuración con todas las configuraciones necesarias para Alemania
- puede definir toda la configuración de hardware en el objeto de configuración para Alemania
un objeto de configuración con todas las configuraciones necesarias para Austria
- No es necesario definir la configuración de hardware en la configuración de Austria
- sobrescriba el campo «fiscalCountry» y la configuración específica del país en la configuración de Austria

Asignación de configuraciones

La asignación de un objeto de configuración se realiza en el RetailForce Portal, a través de los detalles de las entidades correspondientes (objetos de organización: Organización, Empresa, Tienda, Terminal).

Para ello, seleccione la configuración correspondiente en el área «Configuración» mediante el menú desplegable y haga clic en «Guardar».

Nota: Si no aparece ningún objeto de configuración en la selección, significa que aún no se ha creado ninguna configuración o que la configuración creada no coincide con el país fiscal establecido para la entidad. Las configuraciones solo pueden asignarse si el país fiscal de la entidad (por ejemplo, la empresa) coincide con el de la configuración.

La opción de menú «Nueva configuración» permite especificar que una nueva configuración sea válida a partir de una fecha determinada («Nueva válida a partir de»).

Actualizar configuración

Importante: Si se modifica un objeto de configuración en la nube, este cambio NO se distribuye automáticamente a los clientes correspondientes (mandatos de middleware).

Las configuraciones de cada uno de los clientes deben transmitirse a través de:

PUT /api/v1/management/clients/byCloud/{clientId}

deben actualizarse.

Gestión de errores

Error: Licencia

Si al invocar el punto final GetConfiguration se produce el siguiente error, se mostrará el siguiente mensaje:

[error] (exception): License 'GetConfiguration' for client '<ClientID>' not found.

Falta la opción de licencia que permite al cliente recuperar datos de configuración de la nube. Compruebe en el RetailForce Cloud Portal si la licencia asignada incluye la opción «Acceder a la descarga de la configuración».

Asignación de configuraciones

Actualizar configuración

Gestión de errores

Error: Licencia

Artículos relacionados

Comentarios