Compartilhar via

Definir configurações de recursos

  • Artigo

Configurar a geração de arquivos eletrônicos e outras etapas de processamento (por exemplo, assinar arquivos digitalmente, enviá-los ao serviço Web do governo e receber uma resposta ou armazená-los), configurar o pipeline de processamento, as regras de aplicabilidade e variáveis para os recursos de faturamento eletrônico.

As informações de configuração são combinadas no conceito de configuração do recurso e podem ser criadas, excluídas e ajustadas. Para as versões concluídas dos recursos de faturamento eletrônico, as informações também podem ser exibidas.

É possível criar o número de itens de configuração de recursos necessários para definir diferentes cenários de geração, processamento e recebimento de arquivos eletrônicos. Embora esses itens de configuração de recursos tenham ações e condições de processamento independentes para execução, eles são criados como parte de um único recurso de Faturamento eletrônico e herdam seu ciclo de vida e processo de implantação.

Adicionar uma configuração de recurso

  1. No espaço de trabalho Globalization Studio, selecione o bloco Faturamento eletrônico.

  2. Na página Recursos de Faturamento eletrônico, selecione uma versão de recurso de Faturamento eletrônico que tenha um status de Rascunho.

  3. Na guia Configurações, selecione Adicionar.

  4. Na caixa de diálogo suspensa Criar configuração do recurso, no grupo de campos Novo, selecione uma das seguintes opções:

    • Configuração personalizada – Crie uma nova configuração de recurso que tenha canais vazios, uma lista de pipeline de processamento vazia, uma seção vazia das regras de aplicabilidade e um conjunto de variáveis padrão, dependendo do tipo de configuração.
    • Configuração a partir do recurso – Crie uma cópia de outra configuração de recurso no escopo do recurso de Faturamento eletrônico atual.

  5. Se você selecionou a opção Configuração personalizada na última etapa, digite um nome e uma descrição do item de configuração do recurso e, em seguida, no grupo de campos Tipo de configuração, selecione uma das seguintes opções:

    • Pipeline de processamento – Selecione esta opção para gerar e processar documentos eletrônicos de saída. Para esse tipo de configuração, o sistema cria uma lista de pipeline de processamento vazia, uma seção vazia para regras de aplicabilidade e um conjunto de variáveis padrão. Não será possível trabalhar com os canais para documentos eletrônicos de entrada.
    • Canal de importação – selecione esta opção para configurar o processo de recebimento de documentos eletrônicos de entrada de um dos canais definidos e a transferência deles diretamente para o Microsoft Dynamics 365 Finance ou o Dynamics 365 Supply Chain Management sem ações adicionais. Para esse tipo de configuração, o sistema cria uma lista predefinida de parâmetros para os canais de dados, uma seção vazia para regras de aplicabilidade e um conjunto de variáveis padrão. Não será possível adicionar ações ao pipeline de processamento.
    • Canal de importação e pipeline de processamento – esse tipo de configuração é semelhante ao tipo Canal de importação. No entanto, antes que um documento eletrônico de entrada seja passado para o Finance ou Supply Chain Management, você pode configurar ações adicionais no pipeline de processamento.
    • Canal de exportação e pipeline de processamento – você pode configurar ações adicionais no pipeline de processamento para documentos eletrônicos de saída enviados do Finance ou do Supply Chain Management.

  6. Se você selecionou a opção Canal de importação, Canal de importação e pipeline de processamento ou Canal de exportação e pipeline de processamento na última etapa, no campo Selecionar canal de dados, você deve selecionar o canal com o qual ocorrerá a integração.

  7. Selecione Criar.

Depois que uma configuração do recurso for criada, você poderá selecionar Editar para configurá-la.

Editar uma configuração de recurso

Dependendo do tipo de configuração do recurso, você pode configurar o processo de geração de arquivos eletrônicos de saída e de seu envio a canais externos, ou o o processo de recebimento de documentos de entrada e a transferência deles para o seu aplicativo Finance ou Supply Chain Management.

Canal de importação

Um Canal de importação processa o arquivo eletrônico ou o transmite diretamente para o Finance ou Supply Chain Management. Esta opção não está disponível para configurações de recurso do tipo Pipeline de processamento.

Para configurar um canal de importação, insira o nome do canal. Em seguida, defina os parâmetros, com base no tipo de canal selecionado. O identificador do canal de importação deve se referir à variável criada especificamente para identificar o canal de importação. Ele será usado como referência no Finance ou Supply Chain Management.

Na guia Filtro de anexos, você deve definir um conjunto de filtros para obter arquivos específicos do canal. Você pode criar várias linhas pretende que os arquivos tenham extensões de nome de arquivo diferentes ou se os arquivos tiverem de ser processados de forma diferente dependendo do nome do arquivo. Estes são os principais parâmetros:

  • Nome – Insira o nome do arquivo ao qual o sistema fará referência durante o processamento. Nos aplicativos Finance e Supply Chain Management, os arquivos são exibidos no log de envio.
  • Filtro – Defina o filtro para selecionar arquivos.
  • Opcional – Se esta caixa de seleção estiver desmarcada, o arquivo será obrigatório. Nesse caso, o sistema exibirá uma mensagem de erro se os canais não contiverem arquivos que correspondam ao filtro. Esse parâmetro é aplicável a emails.

Se o canal for uma caixa de correio e um email de entrada contiver vários anexos, você poderá configurar regras para definir como o serviço deve tratar os anexos. O serviço pode considerar cada anexo em uma fatura eletrônica separada ou pode tratar um anexo como uma fatura principal e todos os outros anexos como adições.

Pipeline de processamento

Um pipeline de processamento é um conjunto de ações que são executadas sequencialmente até serem concluídas com êxito. Você pode usar um pipeline de processamento para configurar o processo de geração de arquivos eletrônicos e a execução de outras etapas (por exemplo, assinatura digital de arquivos, o envio deles aos serviços Web externos e a análise da resposta e o recebimento e o processamento de documentos de entrada).

A lista de ações é predefinida. Você pode usar os botões Novo e Excluir para especificar a combinação de ações que define logicamente o processo necessário para enviar ou receber documentos.

A ordem das ações é importante. Você pode ajustar a ordem usando os botões Para cima e Para baixo.

Cada ação tem um conjunto de parâmetros que você pode definir ou ajustar. O conjunto específico de parâmetros depende do tipo de ação.

  • Ação - Selecione o tipo de ação.

  • Nome – insira o nome da ação da diretiva de localização. Esse nome aparecerá nos logs de envio e em mensagens nos aplicativos Finance e Supply Chain Management.

  • Descrição – Fornece mais detalhes sobre a finalidade da ação no processo.

  • Habilitar nova tentativa – Se você marcar esta caixa de seleção, poderá selecionar uma ação no campo Ação de nova tentativa e configurar parâmetros adicionais na guia Parâmetros de nova tentativa.

    A funcionalidade de repetição permite configurar o comportamento do serviço se uma ação específica não puder ser executada. Por exemplo, se o serviço Web externo ao qual você está tentando se conectar não responder, você poderá especificar quantas vezes o sistema deve tentar novamente a conexão, com que intervalo e em que ação no pipeline de processamento.

  • Exportar resultados – Você pode marcar essa caixa de seleção para uma ação no pipeline de processamento. O arquivo eletrônico que a ação produz no aplicativo Finance ou Supply Chain Management pode ser exportado da página Log de envio de documentos eletrônicos.

Regras de aplicabilidade

As regras de aplicabilidade são cláusulas configuráveis para fornecer um contexto para recursos de Faturamento eletrônico por meio do conjunto de recursos de faturamento eletrônico. Os documentos de negócios enviados do Finance ou Supply Chain Management para o Faturamento eletrônico não possuem uma referência explícita que permita que o recurso de faturamento eletrônico chame uma versão específica de um recurso de faturamento eletrônico e um item de configuração de recurso específico para processar o envio. No entanto, quando configurado corretamente, o documento comercial contém os elementos necessários que permitem ao Faturamento determinar qual versão do recurso de Faturamento eletrônico e pipeline de processamento deve ser selecionada e executada.

As regras de aplicabilidade permitem que o serviço de Faturamento Eletrônico encontre os recursos de Faturamento eletrônico exatos a serem usados para processar o envio. Para encontrar os recursos corretos, o serviço faz a correspondência dos campos Contexto do documento comercial enviado com as cláusulas das regras de aplicabilidade.

Você pode trabalhar com as regras de aplicabilidade da seguinte maneira:

  • Selecione Novo para adicionar uma nova cláusula a um conjunto de regras de aplicabilidade.

  • Selecione Excluir para excluir a cláusula.

  • Selecione vários registros e use o botão Agrupar ou Desagrupar para criar uma combinação de itens ou instruções lógicas. Por exemplo, selecione as linhas que deseja agrupar e selecione Agrupar cláusula. Quando as cláusulas são agrupadas, uma nova coluna é adicionada à grade. Esta coluna especifica o operador lógico para a cláusula agrupada. Há suporte aos seguintes operadores:

    • Igual
    • Diferente
    • Maior que
    • Menor que
    • Maior que ou igual a
    • Menor que ou igual a
    • Contém
    • Começa com

    Observação

    Ao desagrupar uma cláusula, sempre inicie do nível de agrupamento mais interno.

Variáveis

As Variáveis dão mais flexibilidade ao configurar um pipeline de processamento e o fluxo de dados entre as ações. Você pode fazer referência a uma variável em alguns parâmetros de ação para armazenar temporariamente dados ou arquivos eletrônicos. Algumas variáveis são usadas para passar dados entre o aplicativo Finance ou Supply Chain Management e o serviço de Faturamento eletrônico.

O sistema cria algumas variáveis por padrão. Por exemplo, a variável BusinessDocumentDataModel contém dados corporativos em uma estrutura JSON (JavaScript Object Notation). Esses dados aparecem na chamada do aplicativo Finance durante o processo de envio.

Estão disponíveis os seguintes tipos de variável:

  • Constante – a variável é um contêiner para armazenar dados temporários usados em ações do pipeline de processamento.
  • Do cliente – O conteúdo da variável é adquirido do cliente do Dynamics 365 durante a execução do processo de envio.
  • Para o cliente – O conteúdo da variável é disponibilizado para importação pelo cliente do Dynamics 365 durante a execução do processo de envio.
  • Tipo de dados – selecione o tipo de dados das informações armazenadas na variável.

Parâmetros

A opção Desabilitar redução de dados de negócios é usada para otimizar a estrutura da payload de dados de negócios que vem do aplicativo Finance ou Supply Chain Management durante o envio de documentos eletrônicos. A otimização ajuda a reduzir os dados que entram no serviço de Faturamento eletrônico para uma transformação adicional no arquivo eletrônico necessário. O valor padrão é Não.

  • Sim – o Finance ou Supply Chain Management envia um arquivo JSON da estrutura do Modelo de fatura ou, para o Brasil, Modelo fiscal definido no módulo de Relatório eletrônico. Todos os elementos do modelo são preenchidos com dados corporativos no lado do aplicativo, independentemente da estrutura do arquivo eletrônico final. Os modelos normalmente contêm mais dados de negócios do que a estrutura de arquivo de destino requer, e mais tempo pode ser necessário para gerar esses dados no aplicativo. O valor Sim é necessário para essa opção no evento raro de você querer gerar arquivos de saída diferentes em um recurso de Faturamento eletrônico e na configuração de recursos. O valor Sim é útil quando ao solucionar os problemas de seus cenários, a estrutura dos arquivos eletrônicos e a integridade dos dados de negócios.
  • Não – o Finance ou Supply Chain Management faz a primeira chamada ao serviço sem qualquer dado de negócios. A finalidade dessa chamada é obter informações sobre a configuração de relatório eletrônico (ER) que será usada para a transformação eletrônica de arquivos no pipeline de processamento. Essas informações são retornadas ao aplicativo, que as usa para determinar o subconjunto de dados de negócios que devem ser incluídos no arquivo JSON da estrutura Modelo de fatura ou, para o Brasil, Modelo fiscal. O valor Não para essa opção ajuda a reduzir o volume de dados de negócios que o aplicativo envia ao serviço, pois o aplicativo pode enviar somente os dados corporativos necessários para gerar com êxito um arquivo eletrônico.

Validar uma configuração de recurso

Você pode executar uma validação para verificar a consistência de toda a configuração. Por exemplo, se um parâmetro obrigatório de uma ação for deixado em branco, a validação detectará essa inconsistência e você receberá uma mensagem de aviso.

  • Na página Configuração de versão do recurso, no Painel de Ações, selecione Validar.

Excluir uma configuração de recurso

  1. Na página Recursos de Faturamento eletrônico, selecione uma versão de recurso de Faturamento eletrônico que tenha um status de Rascunho.
  2. Na guia Configurações, selecione Excluir.
  3. Na caixa de mensagem exibida, selecione Sim para confirmar que você deseja excluir a configuração de recurso.