Configurar e implantar a localização do Dynamics 365 Commerce para o Brasil

Artigo
11/14/2023

Este artigo aborda como configurar e implantar a localização do Microsoft Dynamics 365 Commerce para o Brasil.

A localização do Dynamics 365 Commerce para o Brasil inclui várias extensões dos seguintes componentes do Commerce: Commerce Runtime (CRT), Retail Server e ponto de venda (PDV). Essas extensões permitem calcular impostos específicos do Brasil, gerar notas fiscais eletrônicas para vendas no varejo, imprimir recibos fiscais DANFE (Documento Auxiliar de Nota Fiscal Eletrônica) e CF-e-SAT (Cupom Fiscal Eletrônico - Sistema Autenticador e Transmissor de Cupons Fiscais Eletrônicos) que possuam campos personalizados, gerenciem informações de clientes específicos do Brasil e emitam vendas no modo de contingência offline em que o registro de notas fiscais eletrônicas é postergado. Para obter mais informações sobre a localização do Commerce para o Brasil, consulte Escopo da localização brasileira e Localização do Commerce para o Brasil.

As extensões descritas neste artigo foram desenvolvidas com base na estrutura de integração fiscal. Para obter informações sobre a funcionalidade de integração fiscal, consulte Visão geral da integração fiscal dos canais do Commerce. O Relatório eletrônico (ER) é usado para implementar formatos de notas fiscais eletrônicas brasileiras.

Habilitar a funcionalidade do Commerce específica do Brasil

Esta seção descreve como definir as configurações do Commerce headquarters específicas e recomendadas para o Brasil. Para obter mais informações, consulte a Home page do Commerce.

Para habilitar e usar a funcionalidade específica do Brasil, você deve definir as seguintes configurações no Commerce headquarters.

No endereço principal da entidade legal, defina o campo País/região como BRA (Brasil).
No perfil da funcionalidade de PDV de todas as lojas localizadas no Brasil, defina o campo Código ISO como BR (Brasil).
Acesse Administrador do sistema > Espaços de trabalho > Gerenciamento de recursos e, na guia Tudo, habilite as seguintes teclas do recurso:
- (Brasil) Funcionalidade do Commerce específica para o Brasil
- (Brasil) NFC-e processamento síncrono
- Registro adiado de documentos

Configurar relatório eletrônico

Você pode baixar as configurações de ER para as notas fiscais eletrônicas do Microsoft Dynamics Lifecycle Services (LCS). Para obter mais informações, consulte Importar configurações do ER (Relatório eletrônico). Você deve baixar as versões mais recentes das configurações listadas no procedimento a seguir.

Para configurar relatórios eletrônicos no Commerce headquarters, siga estas etapas:

Vá para Administração da organização > Espaços de trabalho > Relatórios eletrônicos.
No bloco do provedor de configuração da Microsoft, selecione as reticências (...) e escolha Definir como ativo.
No bloco, selecione Repositórios.
Selecione o repositório de configuração Global e, no Painel de Ação, escolha Abrir.
Na caixa de diálogo Conectar ao Regulatory Configuration Service, selecione Clique aqui para se conectar ao Regulatory Configuration Service, retorne à caixa de diálogo e escolha OK.
Importe as versões compartilhadas mais recentes do modelo de dados, mapeamento do modelo de dados e configurações de formato a seguir:
- Mapeamento de notas fiscais
- Formato de exportação de envio da NF-e (BR)
- Formato de exportação de solicitação de status da NF-e (BR)
- Formato de exportação de cancelamento da NF-e (BR)
- Formato de exportação de envio da NFC-e (BR)
- Formato de exportação de contingência da NFC-e (BR)
- Mapeamento de notas fiscais da NFC-e
- Formato de validação de notas fiscais da NFC-e (BR)
- Formato de exportação de envio da CF-e (BR)
- Formato de exportação de cancelamento da CF-e (BR)
Acesse Administração da organização > Espaços de trabalho > Relatório eletrônico e selecione Configurações de relatórios.
Selecione Mapeamento de notas fiscais e defina a opção Mapeamento de modelo padrão como Não.
Selecione Mapeamento de notas fiscais da NFC-e e defina a opção Mapeamento de modelo padrão como Sim.
Acesse Administração da organização > Configuração > Parâmetros brasileiros.
Na guia Varejo, no campo Mapeamento de formato, selecione Formato de validação de notas fiscais da NFC-e (BR).

Configurar um estabelecimento fiscal e parâmetros federais da NF-e

Para configurar um estabelecimento fiscal e os parâmetros federais da NF-e (Nota Fiscal Eletrônica) no Commerce headquarters, siga estas etapas:

Acesse Administração da organização > Organizações > Estabelecimentos fiscais > Estabelecimento fiscal.
No campo Números de registro de imposto – CNPJ, IE e CCM, insira os números de registro de imposto. (CNPJ significa Cadastro Nacional da Pessoa Jurídica, IE significa Inscrição Estadual e CCM significa Cadastro de Contribuinte Mobiliário.)
No campo Endereço do estabelecimento, insira um endereço.
Configure a criptografia do CSC (Código de Segurança do Contribuinte) inserindo o token do CSC e o código alfanumérico do CSC.
Selecione o certificado digital apropriado para autenticação com o serviço de autoridade fiscal e assinatura digital de notas fiscais.

Observação

O certificado que está configurado na página Estabelecimento fiscal é utilizado para notas fiscais NFC-e (Nota Fiscal de Consumidor Eletrônica) que são emitidas no PDV em modo de contingência offline e posteriormente encaminhadas para autorização no Commerce headquarters. Para permitir que as notas fiscais sejam assinadas no modo de contingência offline, você deve instalar um certificado no armazenamento de certificados offline do PDV. Para obter mais informações, consulte Fazer uma venda de mercadorias por cash-and-carry no modo de contingência offline e Registro adiado da NFC-e emitida no moto de contingência.
Em SERVIÇO Web DE NF-E, no campo Ambiente, selecione Teste ou Produção.
Em SERVIÇO Web DE NFC-E, no campo Ambiente, selecione Teste ou Produção.
Especifique as versões dos recursos NF-e e NFC-e.
Em SERVIÇO Web DE NF-E, no campo Autoridade, insira o valor usado em Parâmetros federais de NF-e > Serviços Web > Autoridade.
Em SERVIÇO Web DE NFC-E, no campo Autoridade, insira o valor usado em Parâmetros federais de NF-e > Serviços Web > Autoridade.
Acesse Administração da organização > Organizações > Estabelecimentos fiscais > Notas fiscais eletrônicas > Parâmetros federais da NF-e.
Crie autoridades para os estados necessários ou use autoridades existentes.
Para cada estado, ative o sinalizador Processamento síncrono da NFC-e.
Para cada estado, no campo Endereço na Internet para consulta de NFC-e, insira as URLs do código QR.
Para cada estado, especifique os pontos de extremidade para todos os serviços da Web dos ambientes apropriados.

Configurar catálogos de endereços

Para adicionar o mesmo catálogo de endereços para clientes, lojas e funcionários brasileiros no Commerce headquarters, siga estas etapas:

Acesse Retail e Commerce > Clientes > Todos os clientes.
Na guia Geral, no campo Catálogos de endereços, adicione catálogos de endereços de varejo para clientes conforme necessário.
Acesse Varejo e Comércio > Canais > Lojas > Todas as lojas.
Na guia Geral, nos campos Catálogo de endereços do cliente e Catálogo de endereços do funcionário, adicione os catálogos de endereços para as lojas.
Acesse Varejo e Comércio > Funcionários > Trabalhadores.
Na guia Resumo do trabalhador, no campo Catálogos de endereços, adicione os catálogos de endereços para os trabalhadores.

Configurar imposto sobre vendas para PDV

Para configurar o imposto sobre vendas para PDV no Commerce headquarters, siga estas etapas:

Acesse Imposto > Impostos indiretos > Impostos > Códigos de imposto.
Crie os códigos de imposto sobre vendas necessários para diferentes tipos de imposto e códigos de tributação. Inclua códigos de imposto sobre vendas para devoluções.
Acesse Imposto > Impostos indiretos > Imposto > Grupo de impostos.
Crie grupos de impostos sobre vendas para vendas no varejo e devoluções e adicione os códigos de impostos que você acabou de criar.
Acesse Varejo e Comércio > Canais > Lojas > Todas as lojas.
Nos campos Grupo de impostos e Grupo de impostos sobre vendas para devoluções, selecione os grupos de impostos sobre vendas que você acabou de criar.
Acesse Imposto > Impostos indiretos > Impostos > Grupos de impostos.
Crie grupos de impostos sobre vendas de itens para varejo e adicione os códigos de impostos sobre vendas que você criou anteriormente.
Acesse Administração da organização > Configuração > Textos de origem da nota fiscal.
Crie um texto de origem da nota fiscal para carga tributária de varejo. Defina o campo Restrição como Externo e a opção Informações fiscais como Não.
Acesse Administração da organização > Configuração > Parâmetros brasileiros.
Na guia Varejo, no campo ID de texto, especifique o texto de origem para a carga tributária de varejo.
Acesse Retail e Commerce > Produtos e categorias > Produtos lançados por categoria.
Selecione os produtos desejados e defina os seguintes campos:
- Na guia Vender:
  - Grupo de impostos do item
- Na guia Informações fiscais:
  - Origem da tributação
  - Tipo de produto
  - Código de classificação fiscal
  - Percentual aproximado de imposto federal
  - Percentual aproximado de imposto estadual
  - Percentual aproximado de imposto Municipal
Vá para Imposto > Configuração > Imposto > Códigos CFOP.
Defina a opção Referência fiscal obrigatória como Não para códigos CFOP (Código Fiscal de Operações e de Prestações) que são usados para devoluções de varejo.

Configurar uma loja de varejo

Para configurar uma loja de varejo no Commerce headquarters, siga estas etapas:

Vá para Gerenciamento de estoque > Configuração > Detalhamento do estoque > Depósitos.
Crie depósitos para as lojas e especifique os endereços.
Acesse Varejo e Comércio > Canais > Lojas > Todas as lojas.
Crie as lojas e defina os seguintes campos:
- Preços incluem imposto
- Grupo de impostos sobre vendas
- Grupo de impostos sobre vendas para devoluções
- Cliente padrão
  
  Observação
  
  O cliente padrão deve ser incluído no mesmo catálogo de endereços da loja.
Configure os métodos de pagamento para as lojas que você criou na etapa anterior.
Vá para Varejo e comércio > Configuração do headquarters > Agendador do Commerce.
Adicione as lojas que você criou anteriormente ao banco de dados do canal que é usado.
Acesse Varejo e comércio > Configuração de canal > Configuração do PDV > Caixas registradoras.
Crie caixas registradoras de PDV e defina os seguintes campos específicos do Brasil, dependendo do modo de operação fiscal:
- Modo de operação fiscal – Selecione NFC-e ou CF-e.
- Série da NFC-e – Se você selecionou NFC-e no campo Modo de operação fiscal, insira a série da NFC-e.
- Série de contingência da NFC-e – Se você selecionou NFC-e no campo Modo de operação fiscal, insira a série da NFC-e para o modo de contingência offline.
- Série da NF-e – Insira a série da NF-e a ser usada quando notas NF-e forem emitidas para devoluções.
- Número da caixa registradora para CF-e – Insira o número da caixa registradora de PDV que está conectado ao SAT. Este número de caixa registradora existe para atender à marca numeroCaixa no XML de CF-e. Duas ou mais caixas registradoras de PDV não podem ter o mesmo número de caixa registradora para CF-e.
Acesse Varejo e comércio > Configuração de canal > Configuração do PDV > Dispositivos.
Crie e configure dispositivos para as caixas registradoras de PDV que você acabou de criar.
Vá para Administração da organização > Organizações > Hierarquias da organização.
Selecione a hierarquia organizacional Lojas de varejo por unidade de negócios, selecione Exibir, selecione Editar > Inserir canal de varejo e adicione as lojas que você criou anteriormente para as unidades de negócios apropriadas na hierarquia. Depois, publique as alterações.
Atribua a finalidade Lançamento do Retail POS à hierarquia da organização Lojas de varejo por unidade de negócios.
Acesse Varejo e Comércio > Configuração de canal > Categorias do canal e atributos de produto.
Publique as atualizações do canal.
Acesse Varejo e Comércio > Configuração do canal > Perfis do PDV > Perfis de recibo.
Crie layouts de recebimento para DANFE e adicione os layouts aos perfis de recebimento.
Crie layouts de recebimento para cancelamento de CF-e-SAT e CF-e-SAT e adicione os layouts aos perfis de recebimento.

Observação

A empresa padrão do usuário que cria a configuração de recibo deve ser a mesma entidade legal na qual a configuração de texto do idioma foi criada. Como alternativa, a configuração de texto no mesmo idioma deve ser criada na empresa padrão do usuário e na entidade legal da loja para a qual a configuração de recebimento foi criada.

No designer de formato de recibo, adicione campos personalizados brasileiros à seção de recibo apropriada para cada formato de recibo necessário. Para obter mais informações sobre como trabalhar com formatos de recibo, consulte Modelos de recibo e impressão.

Configurar o processo de registro fiscal

Para configurar o processo de registo fiscal no Commerce headquarters, siga estas etapas: Para obter mais informações, consulte Configurar a integração fiscal dos canais do Commerce.

Baixe arquivos de configuração para o provedor de documentos fiscais e o conector fiscal do SDK do Commerce:
1. Abra o repositório Soluções do Dynamics 365 Commerce.
2. Abra a última ramificação de versão disponível (por exemplo, versão/9.31).
3. Abra src > FiscalIntegration > ElectronicFiscalDocumentsBrazil.
4. Baixe os arquivos de configuração do conector fiscal em Configurações > Conectores (por exemplo, o arquivo para a versão/9.31):
  - SubmitConnector.xml
  - SatConnector.xml
  - ContingencyConnector.xml
5. Baixe os arquivos de configuração do provedor de notas fiscais em Configurações > DocumentProviders (por exemplo, o arquivo para a versão/9.31):
  - SubmitProvider.xml
  - SatProvider.xml
  - ContingencyProvider.xml
Vá para Varejo e Comércio > Configuração do headquarters > Parâmetros > Parâmetros compartilhados com o comércio.
Na guia Geral, defina a opção Habilitar integração fiscal como Sim.
Acesse Retail e Commerce > Configuração de canal > Integração fiscal > Conectores fiscais e carregue os arquivos de configuração do conector fiscal baixado anteriormente.
Acesse Retail e Commerce > Configuração de canal > Integração fiscal > Provedores de documentos fiscais e carregue os arquivos do provedor de documentos fiscais baixados anteriormente.
Acesse Varejo e Comércio > Configuração de canal > Integração fiscal > Perfis funcionais do conector.
Para cada provedor de notas para o qual você acabou de carregar a configuração, crie perfis funcionais do conector e selecione os conectores fiscais para os quais você carregou a configuração anteriormente. Atualize as configurações de mapeamento de dados conforme necessário. Se forem necessárias configurações para SAT, defina os campos Nome secreto do código de ativação do Key Vault e Assinatura POS para SAT.
Acesse Varejo e Comércio > Configuração de canal > Integração fiscal > Perfis técnicos do conector.
Crie perfis técnicos do conector e selecione os conectores fiscais para os quais você carregou a configuração anteriormente. Atualize as configurações de conexão conforme necessário (para NFC-e, defina o campo Tipo de conector como Interno). Se forem necessárias configurações para SAT, defina o campo Nome do conector para o dispositivo SAT (Tipo de conector = Local) e especifique a cadeia de caracteres Caminho da biblioteca de SAT. Inclua o nome do arquivo de biblioteca de vínculo dinâmico (DLL).
Acesse Varejo e Comércio > Configuração de canal > Integração fiscal > Grupo de conectores fiscais.
Crie grupos de conectores fiscais, um para cada perfil funcional de conector que você criou anteriormente (incluindo SAT).
Acesse Varejo e Comércio > Configuração de canal > Integração fiscal > Processo de Registro.
Crie um processo de registro. Como etapas de registro, selecione os grupos de conectores fiscais que você acabou de criar.
Crie um processo de registro separado para o dispositivo SAT.
Acesse Retail e Commerce > Configuração de canal > Configuração do PDV > Perfis de PDV > Perfis de funcionalidade.
Selecione o perfil de funcionalidade que está vinculado à loja onde o processo de registro deve ser ativado e, na Guia Rápida Processo de registro fiscal, selecione o número do processo de registro que você acabou de criar.
Crie um perfil de funcionalidade separado para o dispositivo SAT.
Acesse Varejo e Comércio > Configuração de canal > Configuração do PDV > Perfis de PDV > Perfis de hardware.
Selecione um perfil de hardware vinculado à estação de hardware à qual a impressora fiscal será conectada.
Crie um perfil de hardware separado para o dispositivo SAT.
Na Guia Rápida Periféricos fiscais, selecione o perfil técnico do conector para cada perfil de hardware.
Acesse Varejo e Comércio > Configuração de canal > Configuração do PDV > Perfis de PDV > Perfis de hardware.
Configure perfis de hardware para impressoras.
Na página Lojas, na Guia Rápida Estações de Hardware, adicione uma configuração para a estação de hardware. Conforme necessário, configure endereços IP para a impressora de rede que você configurou anteriormente.

Gerenciamento de informações do cliente

A operação Adicionar informações do cliente pode ser usada para adicionar números de CNPJ ou CPF (Cadastro de Pessoas Físicas) específicos do Brasil e endereços às transações de vendas. As informações do cliente podem ser extraídas do registro do cliente especificado para a transação ou podem ser inseridas manualmente. As informações do cliente podem então ser impressas nos recibos fiscais DANFE e CF-e-SAT e utilizadas para fins de faturamento.

Para configurar a operação Adicionar informações do cliente no Commerce headquarters, siga estas etapas:

Acesse Varejo e Comércio > Configuração de canal > Configuração do PDV > PDV > Grades de botões.
Selecione a grade de botões onde a operação deve aparecer e abra Designer da grade de botões.
Adicione um botão e, no campo Ação, selecione Adicionar informações do cliente.

Para obter mais informações sobre como trabalhar com layouts de tela e grades de botões, consulte Layouts de tela para o ponto de venda (PDV).

Habilitar pesquisas de clientes com base em números de registro fiscal no PDV

Para habilitar a busca de clientes por CNPJ/CPF e CCM no PDV, siga as etapas abaixo:

No Commerce headquarters, na página Parâmetros do Commerce, na guia Critérios de pesquisa de PDV, na Guia Rápida Critérios de pesquisa do cliente, adicione um registro.
No novo registro, no campo Critérios de pesquisa do cliente, selecione Número de registro de imposto.
Marque a caixa de seleção Exibir como atalho, mas deixe a caixa de seleção Pode ser refinado desmarcada.
Na página Agendas de distribuição, execute o trabalho 1110.

Configurar parâmetros para demonstrativos

Vá para Administração da organização > Sequências numéricas.
Crie e configure sequências numéricas para extratos de varejo para cada loja (unidade operacional).
Na Guia Rápida Referências, adicione duas referências para a área Loja de varejo: uma onde o valor Referência é definido como Número do extrato e outra onde é definido como Comprovante.
Acesse Varejo e comércio > Catálogos e sortimentos.
Crie uma variedade que inclua produtos apropriados.
Na guia Canais de comércio, adicione as lojas que você criou anteriormente. Depois, selecione Publicar.
Acesse Varejo e Comércio > Configuração de canal > Categorias do canal e atributos de produto e publique atualizações do canal.
Acesse Vendas e marketing > Configuração > Devoluções > Códigos de disposição e adicione um código de disposição.
Acesse Varejo e comércio > Produtos e categorias > Produtos lançados por categoria.
Selecione um produto para o vale-presente e marque a caixa de seleção Bloqueado na caixa registradora.
Acesse Retail e Commerce > Configuração da sede > Parâmetros > Parâmetros do Commerce.
Na guia Ordens de cliente, insira o código de disposição que você adicionou anteriormente.
Na guia Lançamento, defina os parâmetros do vale-presente. Esses parâmetros incluem os campos Empresa do cartão-presente e Produto para o cartão-presente.

Configurar um ambiente de produção

Esta seção fornece diretrizes de implantação que ajudarão você a habilitar os componentes do Commerce da localização do Commerce para o Brasil.

Observação

Algumas etapas desses procedimentos variam, dependendo da versão do produto que você está usando. Para obter mais informações, consulte Novidades ou alterações do Dynamics 365 for Retail.

Use certificados para autenticação com o serviço de autoridade fiscal e assinatura digital de notas fiscais

Um certificado digital para AOS (Application Object Server) deve ser armazenado no Azure Key Vault.

Os certificados digitais para Retail Server devem ser instalados localmente ou armazenados no Key Vault. Ambos os tipos de localização para Retail Server também podem ser configurados simultaneamente e usados de acordo com suas prioridades.

Para obter mais informações sobre como trabalhar com o armazenamento do Key Vault, consulte Introdução ao Azure Key Vault e Configurar o cliente do Azure Key Vault.

Você também pode usar o recurso Perfis de certificado definidos pelo usuário para lojas de varejo, que oferece suporte a failover para offline quando o Key Vault ou o Commerce headquarters não estiverem disponíveis. Este recurso estende a funcionalidade Gerenciar segredos para canais de varejo.

Observação

Para permitir que as notas NFC-e sejam assinadas no modo de contingência offline, você deve instalar um certificado no armazenamento de certificados offline do PDV. Para obter mais informações, consulte Fazer uma venda de mercadorias por cash-and-carry no modo de contingência offline e Registro adiado da NFC-e emitida no moto de contingência.

Configurar certificados para que possam ser usados no Retail Server

A extensão do serviço fiscal brasileiro do Retail Server usa um certificado para autenticação com o serviço de autoridade fiscal e assinatura digital de notas fiscais. As configurações dos certificados do Retail Server são controladas por perfis de certificado.

Para configurar certificados para que possam ser usados no Retail Server, siga estas etapas:

Acesse Administração do sistema > Configurar > Perfis de certificado.
Crie um perfil de certificado para as entidades legais apropriadas.
Para cada entidade legal, selecione Configurações e siga estas etapas:
- Para o certificado local, crie um registro em que o campo Tipo de local seja definido como Certificado local. Depois, no campo Impressão digital, insira um valor.
- Para o certificado do Key Vault, crie um registro em que o campo Tipo de local esteja definido como Key Vault e selecione certificado do Key Vault.

Os certificados podem ser instalados no armazenamento local de certificados da máquina onde o Retail Server está implantado ou no Key Vault. Se desejar, eles podem ser instalados em ambos os tipos de local e configurados simultaneamente para que sejam usados de acordo com suas prioridades.

Configurar um certificado no AOS

Um certificado para autenticação com o serviço da autoridade fiscal é armazenado no Key Vault. Este certificado é utilizado no AOS para envio, por meio do Commerce headquarters, das notas NFC-e que foram emitidas no POS em modo de contingência offline. O certificado também é necessário para assinatura digital de pedidos de "descarte" e "cancelamento por substituição". Os parâmetros do certificado devem ser especificados nas configurações do estabelecimento fiscal.

Para configurar um certificado no AOS, siga estas etapas:

Acesse Administração da organização > Organizações > Estabelecimentos fiscais > Estabelecimentos fiscais.
Selecione o certificado digital apropriado para autenticação com o serviço de autoridade fiscal e assinatura digital de notas fiscais.

Observação

Após a conclusão da configuração, os trabalhos de distribuição apropriados devem ser executados no Commerce headquarters.

Configurar o código de ativação SAT

O código de ativação SAT permite a comunicação entre a caixa registradora de PDV e o dispositivo SAT. O atributo de hardware SAT contém o código de ativação para o número de série SAT que foi inserido durante a ativação do dispositivo SAT. Esse atributo de hardware SAT deve estar associado à caixa registradora de PDV.

Para criar o atributo de hardware SAT, siga estas etapas:

Vá para Administração do sistema > Configuração > Parâmetros do Key Vault.
Crie um registro para o código de ativação do SAT.
Adicione um segredo com o nome ActivationCode.
No campo Segredo, insira o valor.
No campo Tipo de segredo, selecione Manual.

Configurar componentes de extensão do CRT

Aviso

Devido às limitações do novo empacotamento independente e modelo de extensão, ele não pode ser usado no momento para essa funcionalidade de localização. Você deve usar a versão anterior do kit de desenvolvimento de software (SDK) do Retail em uma máquina virtual (VM) de desenvolvedor no LCS. (A Microsoft planeja adicionar suporte para a funcionalidade de localização ao novo pacote independente e modelo de extensão em versões posteriores.)

Para configurar os componentes de extensão do CRT, siga estas etapas:

Localize o arquivo de configuração da extensão do CRT.
- Commerce Scale Unit: o arquivo é denominado Commerceruntime.ext.config e está localizado na pasta bin\ext no local do site da Commerce Scale Unit dos Serviços de Informações da Internet (IIS).

Registre a alteração do CRT no arquivo de configuração da extensão.

<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.ElectronicReporting" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.ElectronicFiscalServiceBrazil" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.ElectronicFiscalDocumentBrazil" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.TaxRegistrationIdBrazil" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.TaxServiceBrazil" />

Encontre o arquivo Web.config para o CRT.
- Commerce Scale Unit: o arquivo é denominado Web.config e está localizado na pasta \RetailServer\webroot.

Atualize este arquivo Web.config incluindo o novo nome da biblioteca de extensão na seção extensionComposition.

<extensionComposition>
    <add source="assembly" value="Microsoft.Dynamics.Retail.RetailServer.ElectronicFiscalDocumentBrazil" />
</extensionComposition>

Encontre o arquivo de configuração de extensão para o CRT local no Modern POS:
- CRT local no Modern POS: o nome do arquivo é CommerceRuntime.MPOSOffline.Ext.config, e ele está no local do agente do cliente CRT local.

Registre a alteração do CRT local no Modern POS no arquivo de configuração da extensão.

<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.ElectronicReporting" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.ElectronicFiscalDocumentBrazil.Offline" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.ElectronicFiscalDocumentBrazil" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.TaxRegistrationIdBrazil" />
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.TaxServiceBrazil" />

Aviso

Edite os arquivos Commerceruntime.config e CommerceRuntime.MPOSOffline.config. Esses arquivos não são destinados a personalizações.

Encontre o arquivo de configuração de extensão para o proxy do Retail no Modern POS:
- Proxy do Retail no Modern POS: o arquivo é denominado RetailProxy.MPOSOffline.Ext.config e está localizado no local do agente cliente CRT local.

Registre a alteração do proxy do Retail no Modern POS no arquivo de configuração da extensão.

<retailProxyExtensions>
    <composition>
        <add source="assembly" value="Microsoft.Dynamics.Commerce.RetailProxy.ElectronicFiscalDocumentBrazil" />
    </composition>
</retailProxyExtensions>

Habilitar componentes de extensão da estação de hardware

Observação

Para obter mais informações, consulte Configurar e instalar a estação de hardware do Retail.

Componente SatBrasil

Para ajudar a garantir que a estação de hardware carregue o componente de extensão SAT, você deve definir a referência de montagem correspondente no arquivo HardwareStation.Extension.config localizado na pasta Ativos no SDK do Retail.

<hardwareStationExtension>
    <composition>
        <add source="assembly" value="Microsoft.Dynamics.Commerce.HardwareStation.FiscalPeripherals.SatBrazil" />
    </composition>
</hardwareStationExtension>

Payments.Connector.Adyen.Device.Brazil component

Para ajudar a garantir que a estação de hardware carregue o componente de extensão para o conector de pagamento para Adyen na PDV do Brasil, você deve definir a referência de montagem correspondente no arquivo HardwareStation.Extension.config localizado na pasta Ativos no SDK do Retail.

<hardwareStationExtension>
    <composition>
        <add source="assembly" value="Microsoft.Dynamics.Commerce.Payments.Connector.Adyen.Device.Brazil" />
    </composition>
</hardwareStationExtension>

Habilitar os componentes da extensão do PDV Moderno

Para habilitar os componentes de extensão do Modern POS, siga estas etapas:

Abra a solução em RetailSdk\PDV\ModernPDV.sln e verifique se ela pode ser compilada sem erros. Além disso, confirme se você pode executar o Modern PDV do Visual Studio usando o comando Run.

Observação

O PDV Moderno não deve ser personalizado. Você deve habilitar o UAC (Controle de Conta de Usuário) e desinstalar instâncias instaladas anteriormente do PDV Moderno, conforme necessário.
Habilite as extensões a serem carregadas adicionando as seguintes linhas no arquivo extensions.json.
```
{
    "extensionPackages": [
        {
            "baseUrl": "Microsoft/ElectronicFiscalDocument.BR"
        },
        {
            "baseUrl": "Microsoft/TaxRegistrationId.BR"
        }
    ]
}
```
Observação

Para obter mais informações e para exemplos que mostram como incluir pastas de código-fonte e permitir que as extensões sejam carregadas, consulte as instruções no arquivo readme.md no projeto Pos.Extensions.
Recrie a solução.
Execute o PDV Moderno no depurador e teste a funcionalidade.

Habilitar componentes da extensão do PDV em Nuvem

Para permitir que os componentes da extensão do PDV em Nuvem sejam carregados no arquivo extensions.json, adicione as seguintes linhas na parte apropriada do arquivo:

{
    "extensionPackages": [
        {
            "baseUrl": "Microsoft/ElectronicFiscalDocument.BR"
        },
        {
            "baseUrl": "Microsoft/TaxRegistrationId.BR"
        }
    ]
}