Partilhar via

Gerar e submeter faturas eletrónicas simplificadas para a Arábia Saudita

  • Artigo

Nota

A funcionalidade descrita neste artigo destina-se a suportar os requisitos da Fase 2 da implementação da Faturação Eletrónica no Reino da Arábia Saudita. Para obter informações sobre os recursos legados destinados a suportar os requisitos da Fase 1 da implementação de faturação eletrónica no Reino da Arábia Saudita, consulte Gerar códigos QR e imprimi-los em recibos para a Arábia Saudita.

Este artigo fornece uma descrição geral da funcionalidade para faturas eletrónicas simplificadas (faturas eletrónicas) disponíveis para a Arábia Saudita no Microsoft Dynamics 365 Commerce. Este artigo também fornece diretrizes para configurar a funcionalidade.

A funcionalidade faturação eletrónica disponível para a Arábia Saudita no Commerce fornece as seguintes capacidades:

  • Gere um ficheiro XML de uma fatura eletrónica simplificada quando uma transação de venda é concluída no ponto de venda (POS) do Commerce.
  • Gere um carimbo criptográfico, ou uma assinatura digital, para a fatura eletrónica simplificada.
  • Gere e imprima um código QR para a fatura eletrónica simplificada que inclui o carimbo criptográfico.
  • Envie a fatura eletrónica simplificada de Commerce headquarters às autoridades fiscais da Arábia Saudita (Zakat, Autoridade Tributária e Aduaneira [ZATCA]) para fins de relatório.

Para obter mais informações sobre os requisitos de faturação eletrónica para a Arábia Saudita, consulte o Portal de faturação eletrónica da ZATCA.

O fluxo de processo de alto nível, de ponto a ponto, no Commerce para a Arábia Saudita é o seguinte:

  1. Quando o processo de finalização da compra é concluído para uma transação de venda no POS, o POS usa Commerce Scale Unit (CSU) para enviar ao Commerce runtime (CRT) um pedido para gerar e assinar digitalmente uma fatura eletrónica simplificada. O quadro de registo fiscal e um conector interno são utilizados para implementar a geração e assinatura digital de faturas eletrónicas simplificadas.

    Nota

    Se o POS estiver no modo offline, a geração e a assinatura digital de uma fatura eletrónica ocorrem na cópia local do CRT na máquina POS.

  2. CRT gera uma fatura eletrónica simplificada num formato XML. Relatórios Eletrónicos (ER) é utilizado para implementar o formato XML de faturas eletrónicas para a Arábia Saudita. É utilizado um formato comum para faturas eletrónicas simplificadas no Commerce e faturas eletrónicas de impostos normais no Dynamics 365 Finance.

  3. CRT envia ao Commerce headquarters um pedido para fornecer um certificado digital.

  4. Commerce headquarters extrai o certificado digital do Azure Key Vault e envia-o de volta para CRT. Para obter mais informações sobre como o Commerce lida com certificados digitais, consulte a secção Configurar os parâmetros de assinatura digital deste artigo.

    Nota

    Se o POS estiver no modo offline, a cópia local do CRT usará um certificado digital instalado localmente na máquina POS.

  5. CRT calcula o hash da fatura, assina digitalmente os dados da fatura eletrónica e gera um código QR que inclui o hash da fatura e os dados da assinatura digital. CRT também atualiza a fatura XML com o hash da fatura e os dados da assinatura digital. A fatura eletrónica, o hash da fatura, o código QR e outras informações são guardadas na base de dados do canal numa transação fiscal ligada à transação de venda.

  6. O POS solicita um recibo venda do CRT. CRT compila o recibo, incluindo o código QR, e envia-o de volta para o POS. O POS envia o recibo para a impressora de recibos.

  7. Commerce headquarters usa Commerce Data Exchange (CDX) para transferir os dados da transação de vendas juntamente com as transações fiscais do CSU. Os dados são armazenados na base de dados da sede durante toda a vida útil do seu ambiente de produção.

  8. Commerce headquarters extrai a fatura eletrónica simplificada no formato XML da transação fiscal associada à transação de venda. Em seguida, submete a fatura eletrónica à ZATCA. A submissão é feita através da integração com o Serviço de faturação eletrónica. Para obter mais informações sobre os recursos de faturação eletrónica comuns disponíveis para a Arábia Saudita, consulte Faturas eletrónicas de clientes na Arábia Saudita.

Configurar Commerce para a Arábia Saudita

Esta secção descreve as definições do Commerce que são específicas e recomendadas para a Arábia Saudita. Para obter mais informações sobre recursos e definições comuns do Commerce, consulte a Home page do Commerce.

Como pré-requisito, deve concluir a configuração da funcionalidade de faturação eletrónica para a Arábia Saudita, incluindo a configuração do serviço faturação eletrónica. Para obter mais informações, consulte Faturas eletrónicas de clientes na Arábia Saudita.

Para utilizar a funcionalidade Commerce específica da Arábia Saudita, tem de concluir as seguintes tarefas:

  • Defina o campo País/região como SAU (Arábia Saudita) no endereço principal da entidade legal.
  • Defina o campo de código ISO como SA (Arábia Saudita) no perfil de funcionalidade de POS de cada loja localizada na Arábia Saudita.

Também deve especificar as seguintes definições para a Arábia Saudita. Tenha em atenção que deve executar as tarefas de distribuição apropriados depois de concluir a configuração.

  1. Ative os recursos do Commerce para a Arábia Saudita na área de trabalho Gestão de funcionalidades.
  2. Configure o imposto sobre o valor acrescentado (IVA) de acordo com os regulamentos de IVA da Arábia Saudita.
  3. Configure campos personalizados e formatos de recibo para imprimir códigos QR em recibos e cumprir os requisitos regulamentares locais.
  4. Configure a funcionalidade de registo fiscal para a Arábia Saudita para permitir a geração e assinatura digital de faturas eletrónicas simplificadas.
  5. Configure certificados digitais e outros parâmetros de assinatura digital para o lado do canal do Commerce.
  6. Especifique as configurações de ER que devem ser utilizadas para gerar faturas eletrónicas simplificadas no POS e envie-as a partir de Commerce headquarters.
  7. Configure o envio de faturas eletrónicas para faturas eletrónicas simplificadas que são geradas no POS.
  8. Ative a assinatura digital no modo offline.

Ativar funcionalidades para a Arábia Saudita

Ative as seguintes funcionalidades na área de trabalho Gestão de funcionalidades:

  • Capacidade de Faturação Eletrónica do Reino da Arábia Saudita para a estrutura de integração fiscal
  • Integração da faturação eletrónica (Arábia Saudita)

Configurar o IVA de acordo com os requisitos da Arábia Saudita

Deve criar códigos de imposto sobre vendas, grupos de impostos sobre vendas e grupos de impostos sobre vendas de itens. Também deve configurar informações de imposto sobre vendas para produtos e serviços. Para obter mais informações sobre como configurar e usar o imposto sobre vendas, consulte Descrição geral do imposto sobre vendas e Configurar códigos de imposto.

Também deve especificar grupos de impostos sobre vendas e ativar a opção Preços incluem imposto sobre vendas para lojas localizadas na Arábia Saudita.

Configurar campos personalizados para utilizar em formatos de recibo para recibos de venda

Pode configurar o texto de idioma e os campos personalizados utilizados nos formatos de recibo do POS. A empresa predefinida do utilizador que cria a configuração de recibo deve ser a mesma entidade legal onde a configuração de texto de idioma é criada. Como alternativa, os mesmos textos de idioma devem ser criados na empresa predefinida do utilizador e na entidade legal da loja para a qual a configuração foi criada.

Na página de Texto do idioma, no separador POS, adicione os seguintes registos para as etiquetas dos campos personalizados para esquemas de recibo. Observe que os valores ID de idioma, ID de texto e Texto mostrados na tabela são apenas exemplos. Pode alterá-los para atender às suas necessidades. No entanto, os valores de ID de texto que usa devem ser exclusivos e devem ser iguais ou superiores a 900001.

ID do idioma ID de texto Texto
pt-PT 900001 Código QR

Na página Campos personalizados, adicione os seguintes registos para os campos personalizados para esquemas de recibo. Observe que os valores de ID de texto de legenda devem corresponder aos valores de ID de texto especificados na página de Texto de idioma .

Nome Tipo ID de texto de legenda
INVOICEQRCODE_SA Recebimento 900001

Na página Parâmetros de Commerce, no separador Parâmetros de configuração, adicione os seguintes registos.

Nome Valor
RetailEInvoiceFeature_SA.QrCodeHeight 200
RetailEInvoiceFeature_SA.QrCodeWidth 200

Configurar formatos de recibo

Para cada formato de recibo necessário, altere o valor do campo Comportamento de impressão para Imprimir sempre. Também tem de configurar perfis de hardware para suportar impressoras de recibos e para ativar a Estação de hardware. Para obter mais informações sobre como trabalhar com periféricos do POS, consulte Periféricos.

No Estruturador de formato de recibo, adicione os seguintes campos personalizados às secções de recibo apropriadas. Os nomes dos campos correspondem aos textos de idioma definidos na secção anterior.

  • Rodapé: Adicione o seguinte campo:

    • Código QR – Este campo imprime o código QR para o recibo.

Para obter mais informações sobre como trabalhar com formatos de recibo, consulte Configurar e conceber formatos de recibo.

Configurar registo fiscal

Conclua as etapas de configuração do registo fiscal descritas em Configurar a integração fiscal para canais do Commerce:

  1. Configurar um processo de registo fiscal. Certifique-se de que observa as definições do processo de registo fiscal que são específicas da Arábia Saudita.
  2. Definir definições de processamento de erros.
  3. Ativar a execução manual do registo fiscal diferido.

Configurar o processo de registo fiscal

Para ativar o processo de registo fiscal da Arábia Saudita em Commerce headquarters, siga estes passos.

  1. Transfira ficheiros de configuração para o fornecedor de documentação fiscal e o conector fiscal a partir do SDK (Software Development Kit) do Commerce:

    1. Abra o repositório de Soluções do Dynamics 365 Commerce.
    2. Abra o último ramo de versão disponível.
    3. Abra src>FiscalIntegration>ElectronicInvoiceSaudiArabia.
    4. Transfira o ficheiro de configuração do conector fiscal, ConnectorSample.xml.
    5. Transfira o ficheiro de configuração do fornecedor de documentos fiscais, DocumentProviderSample.xml.

  2. Vá para Retalho e Comércio>Configuração da sede>Parâmetros>Parâmetros partilhados. No separador Geral, defina a opção Ativar integração fiscal como Sim.

  3. Vá para Retalho e Comércio>Configuração do canal>Integração fiscal>Conectores fiscais e carregue o ficheiro de configuração do conector fiscal que transferiu anteriormente.

  4. Vá para Retalho e Comércio>Configuração do canal>Integração fiscal>Fornecedores de documentos fiscais e carregue o ficheiro de configuração do fornecedor de documentos que transferiu anteriormente.

  5. Vá para Retalho e Comércio>Configuração do canal>Integração fiscal>Perfis funcionais do conector. Crie um novo perfil funcional do conector e selecione o fornecedor de documentos e o conector que carregou anteriormente. Em seguida, atualize as definições de mapeamento de dados conforme necessário.

  6. Vá para Retalho e Comércio>Configuração do canal>Integração fiscal>Perfis técnicos do conector. Crie um novo perfil técnico do conector e selecione o conector que carregou anteriormente. Defina o tipo de conector como Interno e atualize as outras definições de ligação conforme necessário.

  7. Vá para Retalho e Comércio>Configuração do canal>Integração fiscal>Grupos de conectores fiscais e crie um novo grupo de conectores fiscais para o perfil funcional do conector que criou anteriormente.

  8. Vá para Retalho e Comércio>Configuração do canal>Integração fiscal>Processos de registo fiscal. Crie um novo processo de registo fiscal, crie um passo de processo de registo fiscal e, em seguida, selecione o grupo de conectores fiscais que criou anteriormente.

  9. Vá para Retalho e Comércio>Configuração do canal>Configuração POS>Perfis POS>Perfis de funcionalidade e selecione um perfil de funcionalidade vinculado à loja onde o processo de registo deve ser ativado. No Separador Rápido Processo de registo fiscal, selecione o processo de registo fiscal que criou anteriormente. No Separador Rápido Serviços fiscais, selecione o perfil técnico do conector que criou anteriormente.

  10. Aceda a Retalho e Comércio>TI de Retalho e Comércio>Agenda de distribuição. Abra a agenda de distribuição e selecione as tarefas 1070 e 1090 para transferir dados para a base de dados de canais.

Configurar os parâmetros de assinatura digital

Para assinar digitalmente e enviar faturas eletrónicas simplificadas, deve obter os chamados Identificadores de Carimbo Criptográfico (CSIDs) da ZATCA. Os CSIDs são na forma de certificados digitais. Para mais informações sobre como obter CSIDs, consulte Inclusão de faturação eletrónica na Arábia Saudita. Tem de obter um CSID para cada registo de POS que irá utilizar, uma vez que a numeração sequencial e a assinatura digital de faturas eletrónicas simplificadas são feitas por registo POS.

Os certificados digitais que serão utilizados para assinar digitalmente faturas eletrónicas simplificadas são armazenados no Key Vault. Para o modo offline da aplicação Store Commerce, a assinatura também pode ser feita usando um certificado digital armazenado no armazenamento local da máquina na qual a aplicação Store Commerce está instalada. A funcionalidade Perfis de certificado definido pelo utilizador para lojas de retalho permite a configuração de certificados armazenados no Key Vault. Também suporta ativação pós-falha para o modo offline quando o Key Vault ou Commerce headquarters não está disponível. Esta funcionalidade expande a funcionalidade Gerir segredos para canais de revenda.

Para configurar certificados e perfis de certificado que podem ser utilizados para assinatura digital, siga os passos em Configurar perfis de certificado. Deve configurar um perfil de certificado separado para cada CSID obtido do ZATCA.

Depois de configurar os perfis de certificado, siga estes passos.

  1. Vá para Retalho e Comércio>Configuração do canal>Integração fiscal>Perfis técnicos do conector e selecione o perfil técnico do conector que criou anteriormente.
  2. Para configurar perfis de certificado por registo de POS, selecione Substituir e crie registos para todos os registos para os quais deve especificar CSIDs.
  3. Em cada registo, no Separador Rápido Dispositivo, no campo Perfil de certificado, especifique um perfil de certificado correspondente. Para obter mais informações sobre como substituir as definições do perfil técnico do conector, consulte Criar perfis técnicos do conector.

Especificar configurações de ER

Deve transferir as versões mais recentes das seguintes configurações do repositório do Dataverse. Para obter mais informações, consulte Importar configurações de Relatórios Eletrónicos (ER) do Dataverse.

  • Configurações de geração de faturas eletrónicas:

    • Modelo de dados do modelo de fatura
    • Mapeamento de modelo de dados do Mapeamento do modelo de faturas para comércio (SA)
    • Formato de Fatura eletrónica de venda (SA)

  • Configurações de submissão de faturas eletrónicas:

    • Modelo de dados de Modelo de contexto da fatura do cliente
    • Modelo de dados de Dados do canal de retalho
    • Mapeamento do modelo de dados do Mapeamento do documento fiscal de retalho
    • Formato do Formato de documentos fiscais de retalho

Também deve configurar parâmetros específicos da entidade legal do formato de fatura eletrónica.

  1. Na área de trabalho Relatórios eletrónicos, selecione Configurações de relatórios.

  2. Na página Configurações, selecione o formato de Fatura eletrónica de vendas (SA) que importou anteriormente e, em seguida, selecione Configurações>Parâmetros específicos da aplicação>Configuração.

  3. Na página Parâmetros específicos da aplicação, selecione a versão da configuração de formato para a qual deseja configurar os parâmetros.

  4. No Separador Rápido Procuras, selecione o registo para a procura PaymentMethodSubstitutionLookup.

  5. No Separador Rápido Condições, crie regitros para vincular métodos de pagamento configurados para clientes no módulo Contas a receber aos meios de pagamento que a ZATCA define para faturas eletrónicas.

  6. No campo Resultado da procura, selecione um código de meio de pagamento.

  7. No campo Nome, selecione um método de pagamento do cliente que deve corresponder ao código do meio de pagamento. Se quiser que o código dos meios de pagamento seja selecionado quando o método de pagamento do cliente não for especificado, pode selecionar *Em branco*. Se quiser que o código dos meios de pagamento seja selecionado para qualquer método de pagamento do cliente, pode selecionar *Não está em branco*.

    O campo Linha é automaticamente definido. Define a ordem em que os códigos dos meios de pagamento são pesquisados para um método de pagamento do cliente. Pode alterar a ordem utilizando os botões Mover para cima e Mover para baixo.

  8. Conclua a configuração definindo o campo Estado como Concluído.

Configurar a submissão de faturas eletrónicas

Antes de configurar os parâmetros de envio de faturas eletrónicas para o Commerce, configure o serviço faturação eletrónica para que possa ser utilizado na Arábia Saudita. Para mais informações, consulte Introdução à Faturação eletrónica para a Arábia Saudita. Para suportar a configuração de CSIDs por registo POS, siga estes passos para cada registo de POS no seu ambiente de faturação eletrónica.

  1. Adicione um certificado CSID correspondente aos parâmetros do Key Vault do ambiente.

  2. Crie uma configuração de funcionalidade do tipo Pipeline de processamento para a funcionalidade de faturação eletrónica. Para concluir esse passo, configure a primeira configuração de funcionalidade e, em seguida, crie novas definições de recursos copiando-as da primeira e modificando os parâmetros.

  3. Na configuração da funcionalidade, siga estes passos:

    1. Na ação de integração do pipeline de processamento, especifique o nome do certificado CSID que adicionou anteriormente.
    2. Na regra de aplicabilidade, especifique os valores Store e RegisterNumber correspondentes.

Em Commerce headquarters, siga estes passos para configurar parâmetros de envio de faturas eletrónicas específicos do Commerce para a Arábia Saudita.

  1. Na página Parâmetros do documento eletrónico, no separador Documento eletrónico, crie um novo registo e especifique os seguintes parâmetros:

    1. No campo Nome da tabela, selecione Documento de transação fiscal.
    2. No campo Contexto de documento, selecione Contexto do documento fiscal de retalho.
    3. No campo Mapeamento de modelos de documento eletrónico, selecione Mapeamento do documento fiscal de retalho.
    4. Selecione sequências de números para nomes de ficheiros enviados e IDs de envio de lote.

  2. No separador Funcionalidades, marque a funcionalidade Fatura eletrónica da Arábia Saudita como Ativada.

Ative a assinatura digital no modo offline

Para ativar a assinatura digital no modo offline, tem de seguir estes passos depois de ativar o POS num novo dispositivo.

  1. Inicie sessão no POS.
  2. Na página Estado de ligação da base de dados, verifique se a base de dados offline está totalmente sincronizada. Quando o valor do campo Transferências pendentes é 0 (zero), a base de dados é totalmente sincronizada.
  3. Terminar sessão no POS.
  4. Aguarde até que a base de dados offline esteja totalmente sincronizada.
  5. Inicie sessão no POS.
  6. Na página Estado de ligação da base de dados, verifique se a base de dados offline está totalmente sincronizada. Quando o valor do campo Transações pendentes na base de dados offline é 0 (zero), a base de dados é totalmente sincronizada.
  7. Reiniciar POS.

Submissão de faturas eletrónicas

Para iniciar o envio de faturas eletrónicas simplificadas para a ZATCA, execute a operação periódica Submeter documentos eletrónicos em Commerce headquarters.

Pode rever o registo de submissão na página Registo de submissão de documentos eletrónicos.