Diretrizes de implantação para a impressão de faturas antecipadas para República Tcheca, Hungria e Polônia

Artigo
11/15/2023

Aviso

Você deverá implementar as etapas descritas neste artigo somente se estiver usando o Commerce versão 10.0.34 ou anterior. A partir da versão 10.0.35, todos os componentes necessários do canal do Commerce para a impressão de fatura antecipada estão habilitados e prontos para uso. Se você estiver usando o Commerce versão 10.0.34 ou anterior e estiver migrando para o Commerce versão 10.0.35 ou posterior, siga as etapas na seção Migrar para o Commerce versão 10.0.35 ou posterior.

Este artigo mostra como habilitar a localização do Dynamics 365 Commerce para a a República Tcheca, Hungria e Polônia. A localização consiste em várias extensões de componentes do Commerce. Essas extensões permitem que você imprima o relatório Fatura antecipada no Ponto de Venda (PDV). Para obter mais informações sobre a localização para a República Tcheca, Hungria e Polônia, consulte Faturas antecipadas para o Commerce para a Europa Oriental.

A localização faz parte do kit de desenvolvimento de software (SDK) do Retail. Para obter informações sobre o SDK, consulte Arquitetura do kit de desenvolvimento de software (SDK) do Retail.

A localização consiste em extensões para o Commerce Runtime (CRT) e o PDV. Para habilitar essa localização, você deve modificar o arquivo de configuração do CRT e criar projetos do PDV. É recomendável usar um SDK não modificado do Retail para fazer as alterações descritas neste artigo. Também é recomendável que você use um sistema de controle do código-fonte, como o Microsoft Visual Studio Team Services, em que nenhum arquivo tenha sido alterado ainda.

Ambiente de desenvolvimento

Conclua esses procedimentos para configurar um ambiente de desenvolvimento para que você possa testar a funcionalidade.

Componentes da extensão do CRT

Localize o arquivo de configuração das extensões do CRT.

O nome do arquivo é commerceruntime.ext.config e ele está na pasta bin\ext, no local do site do Commerce Scale Unit do IIS.
Registre a alteração do CRT no arquivo de configuração das extensões.
```
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.UseAdvanceInvoice" />
```
Aviso

Não edite o arquivo commerceruntime.config. Esse arquivo não é destinado a personalizações.

Componentes da extensão do Modern PDV

Abra a solução em RetailSdk\PDV\ModernPDV.sln e verifique se ela pode ser compilada sem erros. Além disso, verifique se você pode executar o Modern PDV do Microsoft 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 no extensions.json adicionando as linhas a seguir no local apropriado.
```
{
    "extensionPackages": [
        {
            "baseUrl": "Microsoft/AdvanceInvoice"
        }
    ]
}
```
Recrie a solução.
Execute o Modern POS no depurador e teste a funcionalidade.

Componentes da extensão do PDV em Nuvem

Abra a solução em RetailSdk\POS\CloudPOS.sln e verifique se ela pode ser compilada sem erros.
Habilite as extensões a serem carregadas no extensions.json adicionando as linhas a seguir no local apropriado.
```
{
    "extensionPackages": [
        {
            "baseUrl": "Microsoft/AdvanceInvoice"
        }
    ]
}
```
Recrie a solução.
Execute o PDV em Nuvem no depurador e teste a funcionalidade.

Configurar os parâmetros obrigatórios no headquarters

Para obter mais informações, consulte Faturas antecipadas para o Commerce para a Europa Oriental.

Ambiente de produção

Siga estas etapas para criar pacotes implantáveis que contenham componentes do Commerce e para aplicar esses pacotes em um ambiente de produção.

Conclua as etapas nas seções Componentes da extensão do PDV em Nuvem ou Componentes da extensão do Modern POS anteriormente neste artigo.
Faça a alteração a seguir nos arquivos de configuração do pacote na pasta RetailSdk\Assets.

Nos arquivos de configuração commerceruntime.ext.config, adicione as seguintes linhas à seção composição:
```
<add source="assembly" value="Microsoft.Dynamics.Commerce.Runtime.UseAdvanceInvoice" />
```
Execute msbuild para o SDK do Retail para criar pacotes implantáveis.
Aplique os pacotes via Microsoft Dynamics Lifecycle Services (LCS) ou manualmente. Para obter mais informações, consulte Criar pacotes implantáveis.

Migrar para o Commerce versão 10.0.35 ou posterior

As etapas descritas nesta seção são necessárias se você estiver usando o Commerce versão 10.0.34 ou anterior, e estiver migrando para a versão 10.0.35 ou posterior. Você deve seguir essas etapas para atualizar corretamente seu ambiente do Commerce.

Atualize o Commerce headquarters.
Habilite o recurso Impressão de faturas antecipadas no espaço de trabalho Gerenciamento de recursos e distribua as alterações para os canais.
Atualize o Commerce Runtime, o PDV em Nuvem e o Modern POS e exclua as seguintes extensões herdadas:
- Extensões do Commerce Runtime nos arquivos commerceruntime.ext.config e CommerceRuntime.MPOSOffline.Ext.config:
  - Microsoft.Dynamics.Commerce.Runtime.UseAdvanceInvoice
- Extensões do PDV no arquivo extensions.json:
  - Microsoft/AdvanceInvoice

Compartilhar via