...
| Produto: |
| Solucoes_totvs_cross |
|---|
| SolucaoCross | TOTVS Backoffice |
|---|
|
| Solucoes_totvs_parceirosexptotvs |
|---|
|
|
|---|
| Linha de Produto: | |
|---|
| Segmento: | |
|---|
| Módulo: | | Modulos_cross_segmentos |
|---|
| ModulosCrossSegmentos | TOTVS Backoffice (Linha Datasul) - Obrigações Fiscais (MOF) |
|---|
|
|
|---|
| Função: | html.taxAssessmentAPBIntegrationParameters - Parâmetros Integração Apuração x APB html.taxAssessmentAPBGenerator - Geração Integração Apuração x Contas a Pagar |
|---|
| País: | Brasil |
|---|
| Ticket: |
|
|---|
| Requisito/Story/Issue (informe o requisito relacionado) : | DBACKFISINOV-638, DBACKFISINOV-639, DBACKFISINOV-655, DBACKFISINOV-657, DBACKFISINOV-673, DBACKFISINOV-695, DBACKFISINOV-703 |
|---|
02. SITUAÇÃO/REQUISITO
Realizar a automatização da rotina de lançamento de títulos no módulo de Contas a Pagar. Atualmente, esse processo é realizado de forma manual pelo usuário, dessa forma, ele mais suscetível a erros na integração e, além disso, é uma rotina repetitiva e que demanda tempo. A partir disso, será desenvolvida uma aplicação HTML para realizar a integração da apuração de impostos com o módulo de Contas a Pagar, afim de garantir maior segurança, eficiência e rapidez nos processos do usuário.
...
A rotina de Lançamento Automático no Contas a Pagar (html.taxAssessmentAPBIntegrationParameters) foi desenvolvida como parte da revitalização do produto Datasul, agregando uma novas funcionalidades nova funcionalidade para usuário, que agora pode realizar a integração automática entre a apuração de impostos e os lançamentos no módulo de Contas a Pagar. Para isto, este novo programa é dividido em duas partes, : parâmetros e a geração:.
Parâmetros:
Na seção de Parâmetros, o usuário pode visualizar uma listagem com todos os parâmetros para a integração, bem como criar, visualizar, editar e remover estes.
Geração (AINDA NÃO IMPLEMENTADO)
Para acessar a nova rotina, no menu do sistema produto Datasul pesquise por html.taxAssessmentAPBIntegrationParameters ou pelo nome Parâmetros Integração Apuração X Contas a Pagar para acessar o programa.
Ainda, é possível acessar pelo menu lateral a partir do Cockpit Fiscal, basta expandir o menu, clicar no ícone de moeda e selecionar a opção Parâmetros.
Geração:
Na tela de Geração, o usuário pode realizar as configurações de parâmetros necessárias para realizar a geração do título no módulo de Contas a Pagar e atualizar ou cancelar a integração.
Para acessar essa nova aplicação, no menu do produto Datasul pesquise html.taxAssessmentAPBGenerator ou pelo nome Geração de Títulos Integração Apuração x Contas a Pagar para acessar o programa.
Ainda, é possível acessar pelo menu lateral a partir do Cockpit Fiscal, basta expandir o menu, clicar no ícone de moeda e selecionar a opção Geração de Títulos.
04. EXEMPLO DE UTILIZAÇÃO
| Totvs custom tabs box |
|---|
| tabs | Parâmetros,Geração |
|---|
| ids | Parametros,Geracao |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | Parametros |
|---|
| Listagem de Parâmetros: A tela de listagem de parâmetros permite que o usuário visualize as configurações de parâmetros cadastros para integração da apuração com o módulo de Contas a Pagar. Esta tela permite também a busca de registros com base no código do estabelecimento.  Image Modified
Novo Parâmetro: Logo acima da tabela de listagem de parâmetros está o botão Novo Parâmetro que redireciona o usuário para uma nova tela com um formulário para inclusão de novos parâmetros de integração. O formulário disponibiliza dois botões para realizar a inclusão do parâmetro: o botão Salvar e Novo permite que o usuário salve um parâmetro e continue na mesma tela para salvar outros parâmetros. Ao selecionar esta opção, o formulário é limpo automaticamente para facilitar a inclusão de novos registros. O botão Salvar, por sua vez, faz com que o usuário salve o registro e seja redirecionado para a tela de listagem.  Image Added
Regras do formulário de Parâmetros: Para inclusão ou edição correta do registro de parâmetro de integração, existem duas principais regras: - Todos os campos são obrigatórios;
- O campo Centro de Custo só será disponibilizado caso seja inserido uma Conta Contábil e Estabelecimento que façam uso de centro de custo.
Editar Parâmetro: A função de Editar Parâmetro redireciona o usuário para o mesmo formulário de criação de um novo parâmetro. No entanto, os campos Estabelecimento e Tipo de Imposto são desabilitados e não podem ser alterados. Esta função pode ser acessada a partir de um registro na tela de listagem, clicando no ícone de reticências e selecionando a opção Editar.
Visualizar Parâmetro: A função de Visualizar Parâmetro redireciona o usuário para o mesmo formulário de criação de um novo parâmetro. No entanto, todos os campossão desabilitados e não podem ser alterados, dado que esta função é apenas para fins de consulta do registro. Esta função pode ser acessada a partir de um registro na tela de listagem, clicando no ícone de reticências e selecionando a opção Visualizar.
Remover Parâmetro: A função de Remover Parâmetro permite que o usuário remova um ou mais parâmetros cadastrados a partir da tela de listagem. Esta ação pode ser utilizada de duas formas: - O usuário pode ir diretamente na linha selecionada, clicar no ícone de reticências e selecionar a opção Remover.
- O usuário pode selecionar registros na tabela utilizando a caixa de seleção e clicar no botão Remover.
Ao clicar no botão Remover, será apresentada uma tela para confirmação da exclusão dos registros. Nesta tela, o usuário pode conferir os registros selecionados antes de efetivamente remover os registros:  Image Added
Ao confirmar a remoção dos parâmetros, os registros são excluídos e a listagem é atualizada em seguida. |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | Geracao |
|---|
| Geração - Integração Apuração x Contas a Pagar Para a execução da integração, o usuário conta com uma tela dividida em duas abas: - Aba Seleção: Nesta aba, o usuário irá configurar os parâmetros como estabelecimentos, período da apuração e datas de vencimento para a geração do título.
- Aba Geração: Nesta aba, o usuário poderá selecionar a forma de execução da integração. As opções são Online, Central de Documentos e Batch.
Aba Seleção: Esta aba apresenta um formulário com campos para parametrizar a integração com o módulo de Contas a Pagar. Neste formulário, é possível configurar os estabelecimentos a serem considerados nesta integração, o período da apuração a ser considerado e as datas de vencimento de ICMS e IPI.  Image Added
Este formulário possui algumas regras a serem consideradas: - Caso o usuário tenha inserido algum estabelecimento e algum período de apuração, ao selecionar a caixa de seleção dos tipos de imposto a data de vencimento será carregada automaticamente considerando a configuração de dia de vencimento realizada no programa Parâmetros Integração Apuração x Contas a Pagar. Se não houver registro para o determinado estabelecimento e tipo de imposto, a data não será carregada.
- O carregamento da data depende da configuração correta do Calendário Comercial no produto Datasul para a empresa e estabelecimento selecionado (CD0999 e html-crm.commercialCalendar), pois feriados, sábados e domingos são verificados a partir deste programa.
- Caso o usuário selecione mais de um estabelecimento, os campos Data de Vencimento ICMS e Data de Vencimento IPI são desabilitados e o sistema considera o dia de vencimento cadastrado no parâmetro, por meio do programa Parâmetros Integração Apuração x Contas a Pagar, para cada estabelecimento selecionado. Este comportamento será informado ao usuário caso este selecione mais do que um estabelecimento por meio da mensagem:
"Para integração de múltiplos estabelecimentos, a data utilizada é baseada no parâmetro cadastrado para cada estabelecimento e tipo de imposto." - Não é permitido mês maior do que 12 no campo Período da Apuração.
- Caso a data não seja preenchida, será considerada a data de vencimento cadastrada no parâmetro de integração.
Aba Geração: Nesta aba, o usuário pode selecionar a forma de execução da integração com o Contas a Pagar, o que influencia na geração do relatório de conferência.  Image Added
Sobre as opções: - A opção Online realiza a execução e baixa o relatório de conferência pelo navegador de internet do usuário ao término da execução. O caminho de destino será o configurado como padrão no navegador do usuário.
- A opção Central de Documentos realiza a execução e disponibiliza o arquivo do relatório de conferência na Central de Documentos do produto Datasul.
A opção Batch realiza a execução no servidor de execução RPW de escolha do usuário e depois disponibiliza o arquivo no diretório de spool do servidor RPW selecionado.
| Nota |
|---|
Para a execução de uma geração para vários estabelecimentos é recomendada a utilização do modo Batch. |
Ao clicar no botão Gerar será iniciado o processo de geração dos títulos no Contas a Pagar. Caso já exista um título criado para o estabelecimento, período de apuração e imposto será apresentado erro em tela ao usuário na seguinte estrutura:  Image Added
Caso o processamento ocorra corretamente, será disponibilizado um arquivo em planilha (formato .xls) para conferência dos títulos que foram criados e parâmetros inseridos em tela para geração.  Image Added
 Image Added
Caso ocorram erros durante a integração, será criada uma aba de Erros na planilha com mensagens e códigos de erro mais detalhados. Todos os erros que ocorrerem durante a integração, sejam estes relacionados a configuração do produto ou aos dados informados nos parâmetros, programa Parâmetros Integração Apuração x APB, são informados nesta aba.  Image Added
Abaixo, seguem algumas configurações que devem ser realizadas para o correto funcionamento da integração: - Usuário deve ter relação com o estabelecimento e deve poder implantar.
- Para Conta Contábil escolhida, o estabelecimento, usuário e unidade de negócio devem estar autorizados.
- Deve existir uma Conta Contábil de integração com a finalidade contábil Conta Movimento.
- A Conta Contábil escolhida deve possuir uma Conta Contábil de integração.
- Habilitar a unidade de negócio para o centro de custo e permitir o seu usuário para este centro de custo.
- Espécie do Documento precisa ser vinculada ao tipo de transação Caixa. Espécie deve ser Normal, Nota Fiscal, Nota de Débito ou Nota de Crédito.
- Conta Grupo de Fornecedor deve existir para a empresa, finalidade, data de transação e espécie do documento.
- É necessário vincular a espécie do documento a ser utilizada a um Tipo de Transação de Caixa.
| Card documentos |
|---|
| Informacao | Caso ocorra erro durante a integração de algum dos parâmetros nenhum título será gerado no APB. Para a geração correta dos títulos, todos os parâmetros devem integrar sem erros para evitar inconsistências. |
|---|
| Titulo | Importante! |
|---|
|
|
|
05. ASSUNTOS RELACIONADOS
...
