Compartilhar 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 faturamento eletrônico no Reino da Arábia Saudita, consulte Gerar códigos QR e imprimi-los em recibos para a Arábia Saudita.

Isto artigo fornece uma visão geral da funcionalidade de faturas eletrónicas simplificadas (faturas eletrónicas) disponíveis para a Arábia Saudita Microsoft Dynamics 365 Commerce. Isto 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 selo 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 ponta a ponta, no Comércio para a Arábia Saudita é o seguinte:

  1. Quando o processo de checkout é concluído para uma transação de venda no PDV, o POS usa Commerce Scale Unit (CSU) para enviar ao tempo de execução do Commerce (CRT) uma solicitação 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 em Dynamics 365 Finance.

  3. CRT Envia Commerce headquarters uma solicitação 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 de CRT venda. CRT constrói 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 baixar os dados da transação de vendas juntamente com as transações fiscais da CSU. Os dados são armazenados no banco 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 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 o Commerce para a Arábia Saudita

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

Como pré-requisito, você 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.

Você também deve especificar as seguintes configurações para a Arábia Saudita. Observe que você deve executar os trabalhos de sindicação apropriados depois de concluir a instalação.

  1. Habilite os recursos do Commerce para a Arábia Saudita no espaço de trabalho Gerenciamento de recursos.
  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. Habilite a assinatura digital no modo offline.

Ativar funcionalidades para a Arábia Saudita

Habilite os seguintes recursos no espaço de trabalho Gerenciamento de recursos:

  • Capacidade de faturação eletrónica do KSA para o quadro 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

Você deve criar códigos de imposto sobre vendas, grupos de impostos sobre vendas e grupos de impostos sobre vendas de itens. Você 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 Visão geral do imposto sobre vendas e Configurar códigos de imposto.

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

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

Pode configurar o idioma, o texto e os campos personalizados utilizados nos formatos de recibo do POS. A empresa padrão do utente que cria a configuração de recebimento 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 padrão do utente e na entidade legal da loja para a qual a configuração foi criada.

Na página de texto Idioma , no separador POS , adicione os seguintes registos para as etiquetas dos campos personalizados para esquemas de recibo. Observe que os valores ID deidioma, ID de texto e Texto mostrados na tabela são apenas exemplos. Você pode alterá-los para atender às suas necessidades. No entanto, os valores de ID de texto que você 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 Idioma .

Nome Tipo ID de texto de legenda
INVOICEQRCODE_SA Receção 900001

Na página Parâmetros do Commerce, na guia Parâmetros de configuração, adicione os seguintes registros.

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 Sempre imprimir. Também tem de configurar perfis de hardware para suportar impressoras de recibos e para activar a Estação de hardware. Para obter mais informações sobre como trabalhar com periféricos POS, consulte Periféricos.

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

  • Rodapé: Adicione o seguinte campo:

    • QR Code – Isto campo imprime o código QR para o recibo.

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

Configurar o registo fiscal

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

  1. Configure um processo de registo fiscal. Certifique-se de observar as configurações do processo de registro fiscal que são específicas da Arábia Saudita.
  2. Defina as configurações de tratamento de erros.
  3. Habilite a execução manual do registro 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 Soluções Dynamics 365 Commerce .
    2. Abra a última ramificação de versão disponível.
    3. Abra src>FiscalIntegration>ElectronicInvoiceSaudiArabia.
    4. Baixe o ficheiro de configuração do conector fiscal,ConnectorSample.xml .
    5. Baixe o ficheiro de configuração para o provedor de documentos fiscais,DocumentProviderSample.xml .

  2. Vá para Configuração da sede>do Retail and Commerce>Parâmetros Parâmetros>partilhados. Na guia Geral , defina a opção Habilitar integração fiscal como Sim.

  3. Vá para Configuração>de canais de retalho e comércio>Integração>fiscal Conectores fiscais e carregue o ficheiro de configuração do conector fiscal que você baixou anteriormente.

  4. Vá para Configuração>de canais de retalho e comércio>Integração>fiscal Fornecedores de documentação fiscal e carregue o ficheiro de configuração do fornecedor de notas fiscais que transferiu anteriormente.

  5. Vá para Configuração>de canais de retalho e comércio>Integração>fiscal Perfis funcionais do conector. Crie um novo perfil funcional do conector e selecione o provedor de documentos e o conector que você carregou anteriormente. Em seguida, atualize as configurações de mapeamento de dados conforme necessário.

  6. Vá para Configuração>de canais de retalho e comércio>Integração>fiscal Perfis técnicos do conector. Crie um novo perfil técnico do conector e selecione o conector que você carregou anteriormente. Defina o tipo de conector como Interno e atualize as outras configurações de conexão conforme necessário.

  7. Vá para Configuração>de canais de retalho e comércio>Integração>fiscal Grupos de conectores fiscais e crie um novo grupo de conectores fiscais para o perfil funcional do conector que você criou anteriormente.

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

  9. Vá para Configuração de canais de retalho e comércio>Configuração>de PDV, Perfis>>de PDV, Perfis de funcionalidade e selecione um perfil de funcionalidade vinculado à loja onde o processo de registro deve ser ativado. Na Guia Rápida Processo de registro fiscal, selecione o processo de registro fiscal que você criou anteriormente. Na Guia Rápida Serviços fiscais, selecione o perfil técnico do conector que você criou anteriormente.

  10. Vá para Retail and Commerce>Retail e Commerce IT>Distribution schedule. Abra o cronograma de sindicação e selecione os trabalhos 1070 e 1090 para transferir dados para o banco de dados de canais.

Configurar os parâmetros de assinatura digital

Para assinar digitalmente e enviar faturas eletrônicas simplificadas, você deve obter os chamados Identificadores de Selo Criptográfico (CSIDs) da ZATCA. Os CSIDs são na forma de certificados digitais. Para obter mais informações sobre como obter CSIDs, consulte faturação eletrónica integração 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 Cofre da Chave. Para o modo offline do aplicativo Store Commerce, a assinatura também pode ser feita usando um certificado digital armazenado no armazenamento local da máquina na qual o aplicativo Store Commerce está instalado. O recurso Perfis de certificado definidos pelo utente para lojas de retalho permite a configuração de certificados armazenados no Cofre de Chaves. Também suporta failover para o modo offline quando o Cofre da Chave ou Commerce headquarters não está disponível. Esse recurso amplia o recurso Gerenciar segredos para canais de retalho.

Para configurar certificados e perfis de certificado que podem ser utilizados para assinatura digital, siga as etapas em Configurar perfis de certificado. Você deve configurar um perfil de certificado separado para cada CSID obtido do ZATCA.

Depois de configurar os perfis de certificado, siga estas etapas.

  1. Vá para Configuração>de canais de retalho e comércio>Integração fiscal>Perfis técnicos do conector e selecione o perfil técnico do conector que você criou anteriormente.
  2. Para configurar perfis de certificado por registro de POS, selecione Substituir e crie registros para todos os registros para os quais você deve especificar CSIDs.
  3. Em cada registro, na Guia Rápida Dispositivo , no campo Perfil de certificado , especifique um perfil de certificado correspondente. Para obter mais informações sobre como substituir as configurações do perfil técnico do conector, consulte Criar perfis técnicos do conector.

Especificar configurações ER

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

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

    • Modelo de dados do modelo de fatura
    • Modelo de fatura mapeamento para comércio (SA) mapeamento de modelo de dados
    • Formato de fatura eletrónica (SA) de vendas

  • Configurações de envio de faturas eletrónicas:

    • Modelo de dados do modelo de contexto de faturas de clientes
    • Modelo de dados do canal de revenda
    • Documento fiscal de retalho mapeamento modelo de dados mapeamento
    • Formato de documento fiscal de retalho

Você também deve configurar parâmetros específicos da entidade legal do formato de fatura eletrônica.

  1. No espaço Relatórios Eletrónicos trabalho, selecione Configurações de relatórios.

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

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

  4. Na Guia Rápida Pesquisas , selecione o registro para a pesquisa PaymentMethodSubstitutionLookup .

  5. Na Guia Rápida Condições , crie registros 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 pesquisa, 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 do meio de pagamento seja selecionado para qualquer método de pagamento do cliente, pode selecionar *Não em branco*.

    O campo Linha é definido automaticamente. Define a ordem em que os códigos dos meios de pagamento são pesquisados para um método de pagamento do cliente. Você pode alterar a ordem usando 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 obter mais informações, consulte Introdução ao 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 faturação eletrónica.

  1. Adicione um certificado CSID correspondente aos parâmetros do Cofre de Chaves do ambiente.

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

  3. Na configuração do recurso, siga estas etapas:

    1. Na ação de integração do pipeline de processamento, especifique o nome do certificado CSID que você 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, na guia Documento eletrônico, crie um novo registro e especifique os seguintes parâmetros:

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

  2. Na guia Recursos , marque o recurso de fatura eletrônica da Arábia Saudita como Habilitado.

Ativar 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 Status da conexão do banco de dados, verifique se o banco de dados offline está totalmente sincronizado. Quando o valor do campo Downloads pendentes é 0 (zero), o banco de dados é totalmente sincronizado.
  3. Saia do PDV.
  4. Aguarde até que o banco de dados offline esteja totalmente sincronizado.
  5. Inicie sessão no POS.
  6. Na página Status da conexão do banco de dados, verifique se o banco de dados offline está totalmente sincronizado. Quando o valor do campo Transações pendentes no banco de dados offline é 0 (zero), o banco de dados é totalmente sincronizado.
  7. Reinicie o 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.