Este ponto de extremidade liga um cliente específico (tenant) à RetailForce Cloud e armazena em cache o módulo fiscal. O CloudConnect deve ser chamado antes de as transações serem enviadas para o serviço fiscal.
A função deve ser executada, pelo menos, após o reinício da caixa registadora ou após o reinício do sistema no qual o Fiscal Middleware está instalado. No entanto, recomendamos a utilização regular do ponto de extremidade para garantir uma ligação constante ao sistema da Cloud.
Resultado
Uma chamada bem-sucedida do endpoint (200)
- estabelece a ligação entre o Fiscal Client e o RetailForce Cloud e
- carrega o módulo Fiscal na cache.
Utilização
- durante a colocação em funcionamento, após PUT /api/v1/management/clients/byCloud ou PUT /api/v1/management/clients;
- regularmente, pelo menos após cada reinício do sistema anfitrião.
A chamada POST /api/v1/management/cloud/connect, por exemplo, pode ser executada antes de cada transmissão de transação.
Pré-requisitos
- O Fiskal Middleware deve estar instalado e, pelo menos, a operação PUT /api/v1/management/clients/byCloud ou PUT /api/v1/management/clients deve ter sido executada com sucesso.
Campos do formulário
Devem ser fornecidas as seguintes informações:
| Designação | Descrição | Exemplo |
| clientId |
The uniqueClientId of the cash register (from the RetailForce system). |
c1062c55-57c4-4ed2-9c53-aff1762326a4 |
| cloudApiKey |
Chave API para autenticar a comunicação na Cloud |
RFC_4a2abc... |
| cloudApiSecret |
API Secret para autenticação da comunicação na Cloud
Atenção:
o API Secret deve estar sempre entre aspas simples, por exemplo, 'ypmqt7s5UVZOyY9mDFzOeVgdpRnJ8GrOsQ'
|
ypts7u5OU... |
Resposta
Respostas possíveis:
| Código | Descrição | Exemplo |
| 200 |
A ligação à Cloud foi estabelecida com sucesso |
- |
| 403 |
Os dados de acesso (credenciais = cloudApiKey e API Secret) estão incorretos. Resolução de problemas:
|
- |
| 422 |
Não foi possível encontrar o clientId especificado no sistema local ou os dados de acesso não foram especificados. Resolução de problemas:
|
- |
| 424 |
Se pretender utilizar o arquivo na Cloud, deve chamar a função «cloud connect» antes de utilizar o módulo fiscal de confiança. Resolução de problemas:
|
- |
Este artigo foi traduzido automaticamente.
Comentários
0 comentários
iniciar sessão para comentar.