A transferência de recibos digitais pode ser efetuada através dos métodos do módulo cliente fiscal (dll/serviço) ou diretamente através da RetailForce Cloud.
Pré-requisitos
Deverá dispor dos seguintes pré-requisitos e conhecimentos para utilizar a comunicação direta com a RetailForce Cloud.
- Deve dispor de uma conta de distribuidor e da respetiva chave API e API Secret de distribuidor
- Deve possuir conhecimentos sobre chamadas de serviços Web JSON/REST (HTTP)
- Deve possuir conhecimentos sobre a autenticação JWT Bearer (utilizada)
- Deve criar um terminal na Retail Force Cloud e atribuir a licença adequada (DigitalReceipt/DigitalReceiptLight)
Pode encontrar informações sobre a autenticação JWT Bearer aqui:
Transferência do recibo digital
Para transferir um recibo digital, deve chamar os seguintes métodos, pela ordem indicada:

Métodos:
-
https://api.retailforce.cloud/api/v1.0/authenticate/logon
(POST)
key: parâmetro
FORM secret: parâmetro FORM -
https://api.retailforce.cloud/api/v1.0/licensing/token
(GET)
uniqueClientId: parâmetro
QUERY accessLicenseId: parâmetro QUERY -
https://functions.retailforce.cloud/api/digitalReceipt
(POST)
uniqueClientId: parâmetro QUERY/FORM (ambos possíveis)
licenseToken: parâmetro QUERY/FORM (ambos possíveis)
file: parâmetro FORM (conteúdo)
Nota: Pode enviar o mesmo nome de ficheiro mais do que uma vez para o mesmo sistema POS (uniqueClientId).
Para obter informações detalhadas sobre as funções em https://api.retailforce.cloud, utilize a seguinte ligação: https://api.retailforce.cloud/swagger.
Importante: Não é necessário utilizar todo o processo constantemente. O token de licença que obterá através de licensing/token (GET) é válido por 30 dias. Pode utilizar jwt/decode no lado do client para verificar se o token de licença é válido.
NOTA: Se chamar a função licensing/token com demasiada frequência, esta será bloqueada. Por conseguinte, utilize-a apenas da forma adequada, tal como descrito acima.
NOTA: Se chamar a função licensing/token com demasiada frequência, esta será bloqueada. Por conseguinte, utilize-a apenas da forma adequada, tal como descrito acima.
Este artigo foi traduzido automaticamente.
Comentários
0 comentários
iniciar sessão para comentar.