PUT /api/v1/management/clients/ byCloud – RetailForce

Este punto final crea un nuevo client en el RetailForce Middleware y lo vincula a un terminal en RetailForce Cloud. Constituye el primer paso en la puesta en servicio de una nueva caja registradora.

Resultados

Una llamada correcta al punto final (200)

crea un nuevo cliente en el middleware, le asigna el «uniqueClientId» del terminal (Cloud) y
descarga el objeto de configuración del sistema Cloud y configura el client en consecuencia.

Uso

Debe ejecutarse una única vez, al poner en funcionamiento una nueva caja registradora. Llamar de nuevo al punto final con el mismo cliente (clientId) provocará un error.

IMPORTANTE : si un cliente concreto ya se ha conectado una vez al terminal creado en la Cloud (asignación de uniqueClientId), volver a llamar al punto final dará lugar a un mensaje de error: «409 - El cliente ya existe». Si es necesario volver a crear un cliente (por ejemplo, en caso de fallo del disco duro, etc.), deberá utilizarse el punto final /api/v1/management/clients/recovery/restoreByCloud.

Requisitos previos

Se han creado la estructura organizativa y el objeto de configuración en RetailForce Cloud y se han asignado correctamente
Se ha instalado el middleware fiscal

Campos del formulario

Se debe facilitar la siguiente información:

Cargo	Descripción	Ejemplo
Tipo	Tipo de identificación de la empresa. El tipo también debe haberse introducido y figurar en RetailForce Cloud. Están disponibles los siguientes tipos: [0] = VatNumber, [1] = taxNumber, [2] = GLNNumber, [3] = BusinessIdentificationNumber, [4] = Clasificación estadística, [5] = Número de registro mercantil, [6] = Oficina de registro mercantil, [7] = Número de registro comercial Véase también: Identificación de la empresa Se recomienda utilizar el tipo [0] = VatNumber como identificador principal en todos los países de la Unión Europea, incluso en aquellos en los que no se emplee como identificador obligatorio de la empresa.	[0] = VatNumber
Identificación	La propia identificación de la empresa. Debe coincidir con la información introducida en RetailForce Cloud.	ATU57780814
storeNumber	El número de sucursal o tienda donde se halla la caja registradora. Debe coincidir con los datos introducidos en RetailForce Cloud. ATENCIÓN: en Francia, debe indicarse aquí el SIRET (ampliación del SIREN con el número de sucursal).	S001, 12345 etc.
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 la autenticación de la comunicación en la nube	ypts7u5OU...

Respuesta

Posibles respuestas:

Código	Descripción	Ejemplo
200	El cliente se ha creado y configurado correctamente. El «uniqueClientId» se devuelve como objeto de respuesta. El «uniqueClientId» debe ser almacenado por el sistema TPV y utilizado por este durante todo el proceso de comunicación posterior (en lo que respecta al client).	3fa85f64-5717-4562-b3fc-2c963f66afa6
404	No se ha encontrado ninguna organización en RetailForce Cloud para el ID de empresa especificado. Solución de problemas: Verifique el ID de empresa tanto en RetailForce Cloud como en el punto de venta. Cree una empresa (organización o sociedad) en RetailForce Cloud.	-
406	Debido al tipo especificado (código de empresa), no es posible realizar una asignación unívoca (por ejemplo, al utilizar [6] = Oficina del Registro Mercantil). Solución de problemas: Utilice un tipo de ID diferente (p. ej., [0] = VatNumber)	-
409	Ya existe un cliente con el «uniqueClientId» correspondiente en el Servicio Fiscal (Fiscal Middleware). Solución: Utilice el client existente.	-

Este artículo ha sido traducido automáticamente.

Resultados

Uso

Requisitos previos

Campos del formulario

Respuesta

Artículos relacionados