O programa «Fiscal Service Client Sample» serve de auxílio para a implementação de vários casos de negócio. O «Sample Client» gera a estrutura JSON a transmitir ao Fiscal Client, em condições normais, para determinados casos de negócio.

A aplicação é fornecida com todas as versões do Cliente Fiscal e está disponível para transferência no diretório .../Samples/. Após descompactar o ficheiro .zip, recomenda-se copiá-lo para o diretório RetailForce (no Windows: C:\ProgramData\RetailForce\>).

O próprio client de exemplo encontra-se então em: \FiscalServiceClientSample\bin\Debug>FiscalServiceClientSample.exe 

Cliente de Teste

O programa disponibiliza vários clientes de teste. Para poder utilizar a aplicação, é necessário selecionar um cliente de teste após iniciar o programa. Nos exemplos seguintes, o cliente de teste c1062c55-57c4-4ed2-9c53-aff1762326a4: (001-01 Filial de teste 001 (Alemanha, {c1062c55-57c4-4ed2-9c53-aff1762326a4})).

Posteriormente, é possível criar vários cenários de negócio utilizando as funções disponibilizadas.

Exemplo — documento de venda simples (recibo)

Neste exemplo, é mapeada a venda de um artigo quando o cliente paga em dinheiro e é gerada a estrutura JSON.

1. Selecione o tipo de documento — neste caso, «Recibo» para um documento de venda normal.
2. Selecione um artigo no menu suspenso — no exemplo, é vendido um pão.
3. Clique no botão «Adicionar» para adicionar o artigo selecionado.
4. Selecione o tipo de pagamento — no exemplo, «Dinheiro» para um pagamento em dinheiro.

A estrutura JSON do caso de negócio pode então ser gerada.

1. Clique no botão «Mostrar JSON do documento».
2. Clique no botão «Copiar JSON» para copiar todo o documento JSON para a área de transferência.

Elementos operacionais

• Cliente - Seleção do client a utilizar
• DocType - Seleção do tipo de documento (documentType); estão disponíveis os tipos de documento descritos no artigo «Tipos de documento e utilização nos países específicos ».
  • Utilizador (ID/Caption) – Opção de introdução de dados do utilizador (ID e designação/nome).
  • Formação - Checkbox para ativar o modo de formação para o documento (documento = documento de formação).
  • Seleção de tabela - Menu suspenso para selecionar a atribuição da tabela.
  • Anular com referência - Anular o documento com referência a um recibo emitido anteriormente.
• Artigo/Quantidade - Seleção do artigo e quantidade (campo numérico mais à direita).
  • Inhouse - assinalar um consumo inhouse (restauração).
  • Campo numérico - definir a quantidade do artigo.
  • Adicionar - adicionar o item e a quantidade selecionada ao documento.
• Registo - defina o caso de negócio (podem ser definidos vários casos de negócio por documento); os casos de negócio descritos no artigo «Casos de Negócio - BusinessTransactionTypes» estão disponíveis para seleção.
  • Menu suspenso Vat - selecione o Vat.
  • Campo numérico - defina o valor na moeda selecionada (EUR).
  • Adicionar — adiciona o item e a quantidade selecionada ao documento.
• Controlo do cliente
  • Obter estado - Consultar o estado do client
  • Adicionar cliente - Adicione as informações do cliente (introduza no campo à esquerda)
  • Recuperar cliente - 
  • Eliminar posição - eliminar o item
  • Desconto de 10% - Adicionar desconto de 10%
  • Abono - Adicionar um abono de X (valor em EUR)
  • Subtotal - adicionar subtotal
  • Cancelar posição - cancelar a posição
• Seleção de PaymentTypes
  • Dinheiro - pagamento em dinheiro
  • Pagamento EC - cartão bancário como meio de pagamento
  • CreditCard - CreditCard
  • Voucher multifuncional - meio de pagamento: voucher multifuncional
  • Resgate de depósito - meio de pagamento: resgate de depósito
  • Voucher de finalidade única - meio de pagamento: voucher de finalidade única
• Enviar documento JSON - enviar documento JSON
• Mostrar documento JSON - mostrar o documento JSON
• Limpar documento - limpar documento - para iniciar um novo caso de negócio
• Validar — função validateDocument
• Armazenar - função storeDocument
• Obter EndOfDay - gerar documento de fim de dia
• Código QR - Apresentar o código QR

Este artigo foi traduzido automaticamente.