Avançar para o conteúdo principal

Processo básico de transferência de documentos

Harald Krondorfer
  • Atualizado

Criação do módulo fiscal

Para transferir documentos fiscais (dados fiscais), deve primeiro criar um módulo fiscal. Isto pode ser feito de várias formas:

  • Se utilizar o serviço fiscal de confiança (serviço Windows ou Linux), o módulo fiscal será criado automaticamente pelo serviço fiscal.
  • Se pretender realizar a integração do módulo fiscal através da integração direta com a DLL .NET, terá de instanciar o módulo fiscal por conta própria. Encontrará uma descrição detalhada abaixo:
    Criar/instanciar o módulo fiscal
Atenção: O módulo fiscal inicializa alguns submódulos e não deve ser recriado para cada recibo (por exemplo, o autoteste do hardware TSS (Alemanha) demora, pelo menos, 30 segundos). Além disso, deve-se chamar o CloudConnect antes de transferir os documentos; caso contrário, o arquivo na nuvem falhará (apenas necessário se o arquivo na nuvem estiver ativado).

Transferência de documentos

Para transferir documentos fiscais para o módulo fiscal, são necessárias, pelo menos, duas etapas:

  • createDocument
  • storeDocument

Independentemente do país, recomendamos que o método createDocument seja chamado em todos os casos.

Atenção: O método createDocument deve ser chamado no início de um documento (quando regista um artigo). Isto é absolutamente necessário para implementar a fiscalização de forma legal (por exemplo: na Alemanha). Deve definir o fiscalResponse do documento a guardar com o fiscalResponse que obteve ao chamar o método createDocument.

Exemplo de documento de recibo em formato JSON:

{
"UniqueClientId": "c1062c55-57c4-4ed2-9c53-aff1762326a4",
"DocumentGuid": "5efa5306-fe53-452d-9c81-68329475eee0",
"DocumentId": "2021-02-02T05:31:08.9450964+01:00",
"CreateDate": "2021-02-02T05:31:08.9450964+01:00",
"BookDate": "2021-02-02T05:31:08.9450964+01:00",
"DocumentNumber": null,
"CancellationDocument": false,
"DocumentReference": null,
"IsTraining": false,
"DocumentType": 0,
"DocumentTypeCaption": null,
"User": {
   "Id": "1234",
   "Caption": "Testuser"
},
"AllocationGroups": [],
"Partner": null,
"FiscalResponse": null, 
"FiscalDocumentNumber": 0, // set fiscaldocument of create document here
"FiscalDocumentRevision": 0, // set fisacldocument revision of create document here
"Positions": [
   {
      "ItemCaption": "Blume grün", // the caption of the item
      "ItemShortCaption": null,
      "Discounts": [],
      "Type": 0,
      "UseSubItemVatCalculation": true,
      "SubItems": null,
      "Quantity": 1.0,
      "QuantityUnit": null,
      "ItemId": "000714", // the item id
      "BaseNetValue": 3.61, // base value (without discounts)
      "BaseGrossValue": 4.3,
      "BaseTaxValue": 0.69,
      "GTIN": null,
      "BusinessTransactionType": 0,
      "VatIdentification": 1, 
      "VatPercent": 19.0, 
      "NetValue": 3.61, // net value (quantity * price)
      "GrossValue": 4.3, // gross value of the position
      "TaxValue": 0.69,
      "AccountingIdentifier": null,
      "PositionNumber": 0,
      "PositionReference": null,
      "CancellationPosition": false
   }
],
"Payments": [
   {
      "Amount": 5.0, // payment with over payment
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   },
   {
      "Amount": -0.7, // cash return (second payment)
      "IsCash": false,
      "CurrencyIsoCode": "EUR",
      "Caption": null,
      "UniqueReadablePaymentIdentifier": null,
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
   }
]
}

Este recibo contém:

  • uma posição de artigo com o artigo «000714», «Blume grün», com um preço bruto de 4,3 EUR (1 unidade).
  • 2 pagamentos: uma posição com 5 EUR em dinheiro e o troco de 0,7 EUR
Nota: Para ver como um documento deve ser montado, pode consultar o exemplo do Fiscal Service Client Sample (C#), que se encontra na secção de downloads (http://www.retailforce.cloud/downloads ). Este exemplo também mostra o JSON resultante quando inicia a aplicação de exemplo. Certifique-se de que o serviço fiscal está instalado e em execução na mesma máquina.

Para cancelar um documento criado anteriormente, pode chamar o método:

  • cancelDocument
Atenção: Cada documento criado (com createDocument) tem de ser encerrado com storeDocument ou cancelado com cancelDocument.

Para validar um documento antes de o transferir para o módulo fiscal, pode chamar

  • ValidateDocument
Informação: O próprio documento será sempre validado antes de ser armazenado (mesmo que seja cancelado). Se ocorrer um erro de validação, o método storeDocument falhará, gerando uma exceção.

Processos em pormenor

Processo de vendas no retalho

A venda de mercadorias, por exemplo no retalho, decorre da seguinte forma:

Operador Sistema de caixa registadora Serviço de Fiscalização RetailForce
1. O operador (utilizador da caixa registadora) introduz o primeiro artigo que o cliente pretende adquirir.    
  2. O sistema de caixa envia um pedido ao serviço fiscal (createDocument) para registar o início da transação correspondente.  
    3. O Serviço Fiscal recebe o pedido do sistema a montante e processa-o de acordo com os requisitos específicos do país (por exemplo, assinatura, etc.).
    4. O Serviço Fiscal envia uma resposta (fiscalResponse) ao sistema a montante.
  5. O sistema de caixa registadora (sistema a montante) recebe a resposta e armazena partes da mesma (ou todo o objeto de resposta) para utilização posterior (referência) quando a transação estiver concluída.  
6. O operador digitaliza todos os artigos do cliente e inicia o processo de pagamento.    
 

7. Assim que todos os dados da transação tiverem sido determinados (artigos, método de pagamento, etc.), o sistema de PDV gera o payload da transação (JSON) e envia outro pedido ao serviço fiscal (storeDocument), o qual conclui (guarda) a transação.

Certas informações da «fiscalResponse» recebida durante o «createDocument» devem ser incluídas na payload («fiscalDocumentNumber», «fiscalDocumentStartTime» e, se aplicável, elementos específicos do país, tais como «fiscalDocumentRevision» na Alemanha).

Atenção: apenas os elementos acima referidos podem ser incluídos na payload e NÃO o objeto fiscalResp inteiro!
  
    8. O Serviço Fiscal recebe os pedidos do sistema a montante e processa-os de acordo com os requisitos específicos de cada país (por exemplo, assinatura, etc.).
    9. O Serviço Fiscal envia uma resposta (fiscalResponse) ao sistema a montante.
  10. O sistema de caixa registadora recebe a «fiscalResponse», extrai as informações necessárias para a criação do documento (por exemplo, assinatura do documento, código QR, etc.) e imprime o documento.  
11. O operador entrega o recibo impresso ao cliente    

Processo de venda no retalho com cancelamento de transação

Se, tal como descrito acima, durante o passo 6, ou seja, APÓS o envio de createDocument (passo 2) e ANTES do envio de storeDocument (passo 7), o sistema de caixa enviar um cancelDocument EM VEZ de um storeDocument.

Atenção: o cancelDocument é utilizado para cancelar (abandonar) uma transação incompleta e NÃO (!) para refletir devoluções.

As devoluções são processadas da mesma forma que as transações de venda normais, utilizando os comandos createDocument e storeDocument.

 

Este artigo foi traduzido automaticamente.

Artigos relacionados

Comentários

0 comentários

iniciar sessão para comentar.

Powered by Zendesk