CloudSync: reenvío de datos

Esta documentación describe cómo verificar y transferir documentos de fin de día. Actualmente, esta función solo está disponible para Alemania.

Resumen

El proceso de sincronización en la nube almacena de forma segura sus documentos de fin de día en la nube y realiza las siguientes tareas:

1. comprueba si todos los archivos de fin de día necesarios (el documento genérico de fin de día y el archivo TAR específico de Alemania) se encuentran en el almacenamiento en la nube
2. transfiere a la nube cualquier archivo que falte desde el cliente local.

Requisitos previos

• Permiso de la organización: debe estar habilitado para reenviar datos. La activación debe realizarse a través del servicio de asistencia.
• País fiscal: Actualmente solo disponible para Alemania.
• Configuración: Las rutas de almacenamiento de archivos locales y en la nube deben configurarse en el RetailForce portal

Configuración del portal

1. Inicie sesión en el RetailForce portal.
2. Vaya a Configuración → Configuración relevante
3. Almacenamiento de archivos
   1. Haga clic en + Storage path.
   2. El campo «Storage path» permanece vacío y no es necesario introducir ningún dato.
4. Almacenamiento en la nube
   1. Haga clic en «+ Storage path».
   2. El campo «Storage path» también está vacío inicialmente.
5. Guarde los cambios.

Flujo de trabajo del cliente

Tras generar y contabilizar un cierre diario (EOD) basado en transacciones en el client, deben realizarse las siguientes llamadas a la API en el orden indicado:

• POST de actualización de la configuración
  /api/v1/management/clients/byCloud/{clientId}
  Actualiza la configuración y garantiza que el middleware utilice las rutas actuales de almacenamiento en archivo y en Cloud.
• POST de CloudConnect
  /api/v1/management/cloud/connect
  Establece una conexión con la nube.
• Crear cierre
  diario ( GET) /api/v1/closing/{clientId}/endofdayDocument
  Genera el documento local de cierre diario.
• POST de registro de fin
  de día /api/v1/transactions/storeDocument
  Contabiliza el documento de fin de día creado.

• Comprobar requisitos
  de sincronización (GET) /api/v1/cloudsync/{clientId}/isSyncRequired
  Determina si aún quedan archivos de fin de jornada en la cola de mensajes local.

  Posibles errores

  • EndOfDay required – No se ha encontrado ningún documento de fin de día; ¡generar uno!
  • CloudConnect required – Se requiere una llamada a CloudConnect.
  • Files are in Message Queue (cloudTemp folder) – Se deben cargar los archivos pendientes.
  • Terminal is not allowed to sync with cloud – El cliente no dispone de permisos.
  • Not implemented for country – Solo compatible con Alemania.

  Respuesta

  • false – Todos los archivos ya se encuentran en la Cloud; no es necesario realizar ninguna acción adicional.
  • true – Es necesario enviar uno o más archivos; continúe con el siguiente paso.

• Iniciar transferencia a la Cloud
  POST /api/v1/cloudsync/{clientId}/startSendingToCloud
  Inicia la carga asíncrona de archivos.

  Posibles errores

  • Todos los errores de isSyncRequired.
  • Insufficient rights – El cliente no dispone de permisos de escritura en el almacenamiento en la nube.
  Nota: El código de respuesta «Éxito» indica únicamente que el proceso de carga se ha iniciado; no garantiza la finalización inmediata de la transferencia.
• Verifique el estado de finalización
  Repita la llamada a isSyncRequired .
  • Si false: Carga completada.
  • Si aún true: Espere unos instantes y repita la operación hasta que todos los archivos hayan abandonado la cola.

Condiciones de activación

Esta rutina de sincronización debe ejecutarse cuando:

• Se haya procesado una transacción y
• el almacenamiento en archivo o en la Cloud no se haya habilitado previamente (es decir, en la configuración inicial) o
• Un intento de sincronización previo haya fracasado y dejado archivos en la cola local.

Este artículo ha sido traducido automáticamente.