Este punto final permite la recuperación de un cliente en el RetailForce Middleware, con datos (incluida la información de configuración) procedentes de RetailForce Cloud.
La recuperación de un cliente puede ser necesaria en caso de cambio en el hardware del punto de venta o de defectos en el mismo.
La función POST /api/v1/management/clients/recovery/restoreByCloud es esencialmente idéntica a PUT /api/v1/management/clients/byCloud, pero esta última solo puede realizarse una vez, durante la puesta en marcha inicial de un cliente.
Resultado
Una llamada correcta al punto final (200):
- Vuelve a descargar el objeto de configuración del cliente en cuestión desde el sistema Cloud y configura el cliente en consecuencia.
- Restaura un cliente que ya se ha puesto en funcionamiento en el middleware y le asigna el «uniqueClientId» correspondiente del terminal procedente de RetailForce Cloud.
Uso
Este punto final se utiliza cuando es necesario restaurar un client que ya se ha creado anteriormente y cuyo clientId se conoce (por ejemplo, en caso de cambio de hardware).
Requisitos previos
- El cliente debe haberse creado previamente y debe conocerse su ClientId.
- Se han creado la estructura organizativa y el objeto de configuración en RetailForce Cloud y se han asignado adecuadamente.
- Se conocen el «storeNumber» y el «terminalNumber».
- Se conoce el «LicenseConsumerId».
- Se ha instalado Fiscal Middleware.
- restoreByCloud solo se puede utilizar si:
- se utilice la licencia correspondiente (paquete de licencia que incluya «Cloud Archive Access»),
- la casilla «Cloud Archive» se encuentre marcada en la configuración (Cloud),
- el cliente haya transferido previamente datos al archivo en la nube (ANTES de la restauración).
- En Alemania, debe haberse registrado en el client al menos un cierre diario (en cualquier momento del pasado) y haberse transferido al archivo en la nube.
Nota: RestoreByCloud solo funcionará correctamente si
- se haya instalado recientemente el middleware en el sistema ANTES de ejecutar restoreByCloud,
- o, sin necesidad de reinstalación, se haya reiniciado el servicio de fiscalización (servicio RetailForce) antes de ejecutar RestoreByCloud.
Campos del formulario
Se debe facilitar la siguiente información:
| Nombre | Descripción | Ejemplos |
| LicenseConsumerId | El ID de la organización. | ID: d92254ca-d0fe-XXXX-bc3c-XXXXXX |
| storeNumber |
El número de la sucursal en la que se encuentra la caja registradora. Debe coincidir con la información introducida en RetailForce Cloud. Datos del país:
|
|
| terminalNumber | Número de caja registradora. Debe coincidir con la información introducida en RetailForce Cloud. | 0010 |
| cloudApiKey | Clave API para autenticar la comunicación con la nube | RFC_4a2abc... |
| cloudApiSecret | API Secret para autenticar la comunicación con la Cloud | ypts7u5OU... |
Respuesta
Posibles respuestas:
| Código | Descripción | Ejemplo |
| 200 | El cliente se ha restaurado y configurado correctamente. El objeto de respuesta devuelve el «uniqueClientId» del cliente restaurado. El «uniqueClientId» debe ser almacenado por el sistema de caja registradora y utilizado durante todo el proceso de comunicación posterior relativo al cliente. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
El tipo del identificador de empresa facilitado no es un tipo único. Gestión de errores: Utilice uno de los siguientes identificadores de empresa: [0] = VatNumber, |
- |
Este artículo ha sido traducido automáticamente.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.