En este artículo, aprenderá qué pasos debe seguir tras volver a conectarse con el FiskalService.
Se deben seguir los mismos pasos con la integración .NET.
Requisitos previos
- El servicio fiscal está instalado y se conoce la URL, o bien la integración de la biblioteca .NET se ha completado hasta el momento
- Dispone de acceso a RetailForce Cloud mediante la ApiKey y el secreto API de la nube
- Utiliza la configuración descargándola de la Cloud
- Dispone del número UID o del número de identificación fiscal de la organización del sistema de punto de venta
- Conoce el número de tienda y de terminal.
Procedimiento
Para minimizar el almacenamiento de datos en el sistema de punto de venta, siga el procedimiento descrito a continuación. Puede persistir los estados en el sistema de caja registradora, pero deberá actualizarlos periódicamente.
Compruebe si la configuración del cliente ya existe
Una vez completado este paso, recibirá el «uniqueClientId» del módulo fiscal correspondiente a la caja registradora solicitada. (El «uniqueClientId» se corresponde con el «terminalId» en RetailForce Cloud).
Servicio fiscal
Para determinar si la configuración del cliente ya existe en el FiskalService, debe ejecutar dos métodos:
- GET management/clients/LicenseConsumerId
- GET management/clients/ID
Para obtener información detallada sobre las funcionalidades, consulte la documentación de Swagger del client de FiscalService.
Integración con .NET
Con la integración con .NET, puede utilizar la clase `FiscalModuleManagement` y el método `GetClients()` para consultar todos los clientes disponibles en la configuración.
Si el cliente aún no existe en la configuración
Si el cliente ya existe en la configuración y ha recibido un uniqueClientId, puede omitir este paso.
Descargue la configuración del terminal desde la Cloud; para obtener instrucciones, consulte el artículo:
Conexión a la Cloud
Servicio fiscal
El módulo fiscal no almacena las credenciales de acceso a la nube (ApiKey/apiSecret). Por lo tanto, dichas credenciales deben transferirse al servicio o al módulo fiscal cada vez que se establezca una nueva conexión.
Los datos pueden transmitirse mediante el siguiente método:
Nota: Si no se facilitan estos datos, se devuelve un error HTTP con el código HttpStatusCode 424 - FailedDependency. Si a continuación se invoca el método management/cloud/connect y se vuelve a intentar la solicitud fallida, debería funcionar.
Integración con .NET
En la integración con .NET, las credenciales de la Cloud deben pasarse al crear el módulo fiscal (parámetro del método CreateFiscalModuleForClient).
Se recomienda inicializar y cargar el módulo fiscal al inicio del software de punto de venta durante la integración con .NET, ya que en algunos países es necesario realizar pasos de inicialización que requieren algo más de tiempo.
Comprobar si el FiskalClient ya está inicializado
Para determinar si el FiskalClient ya se ha inicializado, puede consultar el estado del mismo:
- GET /api/v1/information/client/{clientId}/status
- Integración con .NET: Propiedad FiscalClientStatus en el módulo fiscal
La propiedad «State» puede adoptar los siguientes valores:
- NotInitialized
- Initialized
- Desactivado
Inicialización del client fiscal
Si el FiskalClient ya está inicializado, puede omitir este paso.
En el siguiente artículo encontrará una descripción detallada del proceso de inicialización:
Finalizar
Tras completar los pasos previos, el Fiscal Client quedará listo para recibir los primeros comprobantes.
Este artículo ha sido traducido automáticamente.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.