01. DADOS GERAIS
| Produto: |
TOTVS DMS |
|---|---|
| Linha de Produto: | Linha Protheus |
| Segmento: | Varejo |
| Módulo: |
Totvs DMS (Linha Protheus) - Oficina (SIGAOFI) Totvs DMS (Linha Protheus) - Autopeças (SIGAPEC) Totvs DMS (Linha Protheus) - Veículos (SIGAVEI) |
| Função: | Consulta de Tributos Gerados (OFIA001) |
| País: | Mercado Internacional (Argentina) |
| Ticket: | Não se aplica. |
| Requisito/Story/Issue (informe o requisito relacionado) : | DVARMIL-13811 |
02. SITUAÇÃO/REQUISITO
Implementação da Gravação de Tributos Gerados – Mercado Internacional
Visando atender às necessidades fiscais do Mercado Internacional, foi implementado um processo estruturado para gravação dos tributos gerados nas operações realizadas pelos módulos de Gestão de Concessionárias do Protheus.
→ Os tributos calculados passam a ser registrados de forma detalhada e rastreável, permitindo auditoria fiscal, validação de regras e aderência às legislações locais de cada país.
Adequações nos Módulos de Gestão de Concessionárias
- Abrangência dos Módulos: Implementação aplicada aos módulos de Oficina (SIGAOFI), Auto-Peças (SIGAPEC) e Veículos (SIGAVEI), garantindo consistência na gravação dos tributos em todas as operações comerciais.
- Gravação Estruturada: Os tributos gerados passam a ser armazenados de forma estruturada, permitindo identificar tipo de tributo, base de cálculo, alíquota aplicada e valores apurados.
- Rastreabilidade e Auditoria: Possibilita a consulta e validação dos tributos gravados, assegurando transparência fiscal e suporte a auditorias internas e externas no contexto internacional.
🚨 Benefício da Implementação
Antes desta implementação, os tributos gerados nas operações do Mercado Internacional não eram gravados de forma padronizada, dificultando análises fiscais e validações. Com a melhoria, o processo passa a oferecer maior confiabilidade, controle e aderência às exigências fiscais de cada região.
03. SOLUÇÃO
Com o objetivo de garantir a correta gravação, rastreabilidade e validação dos tributos gerados nas operações do Mercado Internacional, foram implementadas as seguintes soluções nos módulos de Gestão de Concessionárias do Protheus:
1. Adequação dos módulos OFICINA (SIGAOFI), Auto-Peças (SIGAPEC) e Veículos (SIGAVEI) para gravação de tributos no Mercado Internacional
- Processar os cálculos tributários conforme as regras fiscais aplicáveis a cada país e operação do Mercado Internacional;
- Realizar a gravação estruturada dos tributos gerados durante os processos de faturamento, movimentação e serviços;
- Garantir padronização e consistência dos tributos gravados entre os módulos de Veículos (SIGAVEI), Auto-Peças (SIGAPEC) e Oficina (SIGAOFI).
2. Implementação da Rotina de Consulta de Tributos Gerados (OFIA001)
A rotina Consulta de Tributos Gerados (OFIA001) foi desenvolvida para disponibilizar de forma clara e estruturada as informações fiscais geradas nos módulos de Gestão de Concessionárias, sendo responsável por:
- Exibir todos os tributos gravados durante os processos dos módulos SIGAOFI, SIGAPEC e SIGAVEI;
- Apresentar cada tributo de forma detalhada, contendo valores, bases de cálculo, alíquotas e identificação fiscal correspondente;
- Permitir a consulta, auditoria e validação dos tributos gerados, atendendo às exigências fiscais do Mercado Internacional;
- Assegurar total rastreabilidade dos tributos processados pelo sistema.
3. Registro persistente e estruturado dos tributos calculados
Todos os tributos gerados nos processos do Mercado Internacional são gravados de forma persistente no banco de dados, possibilitando controle e histórico fiscal das operações realizadas:
- Identificação individual de cada tributo gerado, conforme regras e parâmetros fiscais aplicados;
- Vinculação direta com o documento fiscal, pedido, nota ou operação de origem;
- Disponibilização de histórico completo para auditoria, suporte técnico e conferência fiscal.
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Menu (CFGX013) e informe as novas opções de menu dos módulos de Oficina (SIGAOFI), Auto-Peças (SIGAPEC) e Veículos (SIGAVEI) conforme instruções a seguir:
⚠️ Atenção
O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente!
Onde tal processo deve ser realizado exclusivamente pelo Configurador (SIGACFG).
🗃️ Criação de Tabela no Dicionário SX2
A criação de tabelas é feita no arquivo SX2, que define a estrutura lógica e o comportamento da nova tabela dentro do ambiente Protheus.
Tabela: VW2
Nome: Cadastro de Tributos.
| Propriedade SX2 | Valor Configurado |
| Nome (Sigla) | VW2 |
| Nome (Extenso) | Tributos |
| Modo | E |
| Chave Única | VW2_FILIAL+VW2_ID+VW2_ITEM |
| PYME | S |
🔑 Criação de Índices no Dicionário SIX
📌 Tabela: VW2
📌 Nome da Tabela: Tributos
Propriedades de Indexação (SIX)
| Índice | VW2 |
| Ordem | 1 |
| Chave | VW2_FILIAL+VW2_ID+VW2_ITEM |
| Descrição | ID+Item |
| Proprietário | S |
📘 Criação de Dicionário de Dados (Novos Campos)
📌 Tabela: VW2
📌 Nome da Tabela: Tributos
Propriedades do Dicionário (SX3) para a Tabela VW2
| Campo | VW2_FILIAL | VW2_ID | VW2_ITEM | VW2_CODTRI |
| Ordem | 01 | 02 | 03 | 04 |
| Grupos De Campos | 033 | |||
| Título | Filial | ID uni. | Seq. Item | Cod. Trib. |
| Descrição | Filial do Sistema | Identificador Único | Sequencial do Item | Código do Tributo |
| Tipo | Carácter | Carácter | Carácter | Carácter |
| Tamanho | 02 | 06 | 03 | 06 |
| Decimal | 0 | 0 | 0 | 0 |
| Contexto | 1-Real | 1-Real | 1-Real | 1-Real |
| Propriedade | 2-Visualizar | 2-Visualizar | 2-Visualizar | 2-Visualizar |
| Formato | @! | @! | @! | @! |
| Opções | ||||
| Condição (WHEN) | ||||
| Validação (Val. Sistema) | ||||
| Inicializador Padrão | ||||
| Ini. Browse | ||||
| Consulta Padrão | ||||
| Usado | Não | Sim | Sim | Sim |
| Obrigatório | Não | Sim | Sim | Não |
| Nível | 1 | 1 | 1 | 1 |
| Browse | Não | Sim | Sim | Sim |
| Help | Código que identifica a filial da empresa usuária do sistema. | Identificador único do registro no sistema. | Número sequencial que identifica de forma única cada item dentro do documento ou processo. | Código referente ao Tributo |
| Campo | VW2_REFER | VW2_BASE | VW2_ALIQ | VW2_VALOR |
| Ordem | 05 | 06 | 07 | 08 |
| Grupos De Campos | ||||
| Título | Ref. Fiscal | Base Trib. | Alíquota | Valor Trib. |
| Descrição | Referência no Fiscal | Base do Tributo | Alíquota do Tributo | Valor do Tributo |
| Tipo | Carácter | Numérico | Numérico | Numérico |
| Tamanho | 09 | 14 | 05 | 14 |
| Decimal | 0 | 2 | 2 | 2 |
| Contexto | 1-Real | 1-Real | 1-Real | 1-Real |
| Propriedade | 2-Visulizar | 1-Alterar | 1-Alterar | 1-Alterar |
| Formato | @! | @E 99,999,999,999.99 | @E 99.99 | @E 99,999,999,999.99 |
| Opções | ||||
| Condição (WHEN) | ||||
| Validação (Val. Sistema) | ||||
| Inicializador Padrão | ||||
| Ini. Browse | ||||
| Consulta Padrão | ||||
| Usado | Sim | Sim | Sim | Sim |
| Obrigatório | Não | Não | Não | Não |
| Nível | 1 | 1 | 1 | 1 |
| Browse | Sim | Sim | Sim | Sim |
| Help | Identificador de referência no fiscal. | Valor referente a Base do Tributo. | Percentual aplicado sobre a base de cálculo do tributo. | Valor do tributo calculado sobre a operação. |
| Campo | VW2_IDTRIB |
| Ordem | 09 |
| Grupos De Campos | |
| Título | ID Trib. |
| Descrição | Identificador do Tributo |
| Tipo | Carácter |
| Tamanho | 06 |
| Decimal | 0 |
| Contexto | 1-Real |
| Propriedade | 1-Alterar |
| Formato | @! |
| Opções | |
| Condição (WHEN) | |
| Validação (Val. Sistema) | Vazio() .or. ExistCpo("F2C",FwFldGet("VW2_IDTRIB")) |
| Inicializador Padrão | |
| Ini. Browse | |
| Consulta Padrão | F2C |
| Usado | Sim |
| Obrigatório | Não |
| Nível | 1 |
| Browse | Sim |
| Help | Código identificador do tributo referente a tabela de gravação F2C |
📌 Tabela: VVA
📌 Nome da Tabela: Itens das Saídas de Veículos
Propriedades do Dicionário (SX3) para a Tabela VVA
| Campo | VVA_IDVW2 |
| Ordem | HL |
| Grupos De Campos | |
| Título | ID Trib. |
| Descrição | Identificador do Tributo |
| Tipo | Carácter |
| Tamanho | 06 |
| Decimal | 0 |
| Contexto | 1-Real |
| Propriedade | 2-Visualizar |
| Formato | @! |
| Opções | |
| Condição (WHEN) | |
| Validação (Val. Sistema) | |
| Inicializador Padrão | |
| Ini. Browse | |
| Consulta Padrão | |
| Usado | Sim |
| Obrigatório | Não |
| Nível | 1 |
| Browse | Sim |
| Help | Identificador do tributo referente a tabela de Tributos (VW2). |
📌 Tabela: VV0
📌 Nome da Tabela: Saídas de Veículos
Propriedades do Dicionário (SX3) para a Tabela VV0
| Campo | VV0_IDVW2 |
| Ordem | JQ |
| Grupos De Campos | |
| Título | ID Trib. |
| Descrição | Identificador do Tributo |
| Tipo | Carácter |
| Tamanho | 06 |
| Decimal | 0 |
| Contexto | 1-Real |
| Propriedade | 2-Visualizar |
| Formato | @! |
| Opções | |
| Condição (WHEN) | |
| Validação (Val. Sistema) | |
| Inicializador Padrão | |
| Ini. Browse | |
| Consulta Padrão | |
| Usado | Sim |
| Obrigatório | Não |
| Nível | 1 |
| Browse | Sim |
| Help | Identificador do tributo referente a tabela de Tributos (VW2). |
📌 Tabela: VS1
📌 Nome da Tabela: Orçamento
Propriedades do Dicionário (SX3) para a Tabela VS1
| Campo | VS1_IDVW2 |
| Ordem | FN |
| Grupos De Campos | |
| Título | ID Trib. |
| Descrição | Identificador do Tributo |
| Tipo | Carácter |
| Tamanho | 06 |
| Decimal | 0 |
| Contexto | 1-Real |
| Propriedade | 2-Visualizar |
| Formato | @! |
| Opções | |
| Condição (WHEN) | |
| Validação (Val. Sistema) | |
| Inicializador Padrão | |
| Ini. Browse | |
| Consulta Padrão | |
| Usado | Sim |
| Obrigatório | Não |
| Nível | 1 |
| Browse | Sim |
| Help | Identificador do tributo referente a tabela de Tributos (VW2). |
📌 Tabela: VS3
📌 Nome da Tabela: Itens de Orçamento (Peças)
Propriedades do Dicionário (SX3) para a Tabela VS3
| Campo | VS3_IDVW2 |
| Ordem | A9 |
| Grupos De Campos | |
| Título | ID Trib. |
| Descrição | Identificador do Tributo |
| Tipo | Carácter |
| Tamanho | 06 |
| Decimal | 0 |
| Contexto | 1-Real |
| Propriedade | 2-Visualizar |
| Formato | @! |
| Opções | |
| Condição (WHEN) | |
| Validação (Val. Sistema) | |
| Inicializador Padrão | |
| Ini. Browse | |
| Consulta Padrão | |
| Usado | Sim |
| Obrigatório | Não |
| Nível | 1 |
| Browse | Sim |
| Help | Identificador do tributo referente a tabela de Tributos (VW2). |
📌 Tabela: VS4
📌 Nome da Tabela: Itens de Orçamento (Serviços)
Propriedades do Dicionário (SX3) para a Tabela VS4
| Campo | VS4_IDVW2 |
| Ordem | 52 |
| Grupos De Campos | |
| Título | ID Trib. |
| Descrição | Identificador do Tributo |
| Tipo | Carácter |
| Tamanho | 06 |
| Decimal | 0 |
| Contexto | 1-Real |
| Propriedade | 2-Visualizar |
| Formato | @! |
| Opções | |
| Condição (WHEN) | |
| Validação (Val. Sistema) | |
| Inicializador Padrão | |
| Ini. Browse | |
| Consulta Padrão | |
| Usado | Sim |
| Obrigatório | Não |
| Nível | 1 |
| Browse | Sim |
| Help | Identificador do tributo referente a tabela de Tributos (VW2). |
📌 Tabela: VVF
📌 Nome da Tabela: Entradas de Veículos
Propriedades do Dicionário (SX3) para a Tabela VVF
| Campo | VVF_IDVW2 |
| Ordem | A0 |
| Grupos De Campos | |
| Título | ID Trib. |
| Descrição | Identificador do Tributo |
| Tipo | Carácter |
| Tamanho | 06 |
| Decimal | 0 |
| Contexto | 1-Real |
| Propriedade | 2-Visualizar |
| Formato | @! |
| Opções | |
| Condição (WHEN) | |
| Validação (Val. Sistema) | |
| Inicializador Padrão | |
| Ini. Browse | |
| Consulta Padrão | |
| Usado | Sim |
| Obrigatório | Não |
| Nível | 1 |
| Browse | Sim |
| Help | Identificador do tributo referente a tabela de Tributos (VW2). |
📌 Tabela: VVG
📌 Nome da Tabela: Itens das Entradas de Veículos
Propriedades do Dicionário (SX3) para a Tabela VVG
| Campo | VVG_IDVW2 |
| Ordem | 67 |
| Grupos De Campos | |
| Título | ID Trib. |
| Descrição | Identificador do Tributo |
| Tipo | Carácter |
| Tamanho | 06 |
| Decimal | 0 |
| Contexto | 1-Real |
| Propriedade | 2-Visualizar |
| Formato | @! |
| Opções | |
| Condição (WHEN) | |
| Validação (Val. Sistema) | |
| Inicializador Padrão | |
| Ini. Browse | |
| Consulta Padrão | |
| Usado | Sim |
| Obrigatório | Não |
| Nível | 1 |
| Browse | Sim |
| Help | Identificador do tributo referente a tabela de Tributos (VW2). |
📌 Tabela: VEC
📌 Nome da Tabela: Avaliação de Venda de Peças
Propriedades do Dicionário (SX3) para a Tabela VEC
| Campo | VEC_IDVW2 |
| Ordem | 98 |
| Grupos De Campos | |
| Título | ID Trib. |
| Descrição | Identificador do Tributo |
| Tipo | Carácter |
| Tamanho | 06 |
| Decimal | 0 |
| Contexto | 1-Real |
| Propriedade | 2-Visualizar |
| Formato | @! |
| Opções | |
| Condição (WHEN) | |
| Validação (Val. Sistema) | |
| Inicializador Padrão | |
| Ini. Browse | |
| Consulta Padrão | |
| Usado | Sim |
| Obrigatório | Não |
| Nível | 1 |
| Browse | Sim |
| Help | Identificador do tributo referente a tabela de Tributos (VW2). |
📌 Tabela: VSC
📌 Nome da Tabela: Avaliação de Venda de Serviços
Propriedades do Dicionário (SX3) para a Tabela VSC
| Campo | VSC_IDVW2 |
| Ordem | 83 |
| Grupos De Campos | |
| Título | ID Trib. |
| Descrição | Identificador do Tributo |
| Tipo | Carácter |
| Tamanho | 06 |
| Decimal | 0 |
| Contexto | 1-Real |
| Propriedade | 2-Visualizar |
| Formato | @! |
| Opções | |
| Condição (WHEN) | |
| Validação (Val. Sistema) | |
| Inicializador Padrão | |
| Ini. Browse | |
| Consulta Padrão | |
| Usado | Sim |
| Obrigatório | Não |
| Nível | 1 |
| Browse | Sim |
| Help | Identificador do tributo referente a tabela de Tributos (VW2). |
🔗 Criação de Relacionamento (SX9)
📌 Relacionamento: F2C
📌 Tabela Relacionada (Domínio Pai): F2C - Tributos De/Para
Criação de Relacionamento (SX9) - Tabela VW2
| Tabela | VW2 |
| Descrição | Tributos |
| Domínio | F2C |
| Identificação | |
| C. Domínio | VW2 |
| E. Domínio | F2C_CODIGO |
| E. C. Domínio | VW2_IDTRIB |
| Propriedade | S |
| L. Domínio | 1 |
| L. C. Domínio | N |
| Condição SQL |
📌 Relacionamento: VW2
📌 Tabela Relacionada (Domínio Pai): VW2 - Tributos
Criação de Relacionamento (SX9) - Tabela VVA
| Tabela | VVA |
| Descrição | Itens das Saídas de Veículos |
| Domínio | VW2 |
| Identificação | |
| C. Domínio | VVA |
| E. Domínio | VW2_ID |
| E. C. Domínio | VVA_IDVW2 |
| Propriedade | S |
| L. Domínio | 1 |
| L. C. Domínio | N |
| Condição SQL |
📌 Relacionamento: VW2
📌 Tabela Relacionada (Domínio Pai): VW2 - Tributos
Criação de Relacionamento (SX9) - Tabela VV0
| Tabela | VV0 |
| Descrição | Saídas de Veículos |
| Domínio | VW2 |
| Identificação | |
| C. Domínio | VV0 |
| E. Domínio | VW2_ID |
| E. C. Domínio | VV0_IDVW2 |
| Propriedade | S |
| L. Domínio | 1 |
| L. C. Domínio | N |
| Condição SQL |
📌 Relacionamento: VW2
📌 Tabela Relacionada (Domínio Pai): VW2 - Tributos
Criação de Relacionamento (SX9) - Tabela VS1
| Tabela | VS1 |
| Descrição | Orçamentos |
| Domínio | VW2 |
| Identificação | |
| C. Domínio | VS1 |
| E. Domínio | VW2_ID |
| E. C. Domínio | VS1_IDVW2 |
| Propriedade | S |
| L. Domínio | 1 |
| L. C. Domínio | N |
| Condição SQL |
📌 Relacionamento: VW2
📌 Tabela Relacionada (Domínio Pai): VW2 - Tributos
Criação de Relacionamento (SX9) - Tabela VS3
| Tabela | VS3 |
| Descrição | Itens de Orçamento (Peças) |
| Domínio | VW2 |
| Identificação | |
| C. Domínio | VS3 |
| E. Domínio | VW2_ID |
| E. C. Domínio | VS3_IDVW2 |
| Propriedade | S |
| L. Domínio | 1 |
| L. C. Domínio | N |
| Condição SQL |
📌 Relacionamento: VW2
📌 Tabela Relacionada (Domínio Pai): VW2 - Tributos
Criação de Relacionamento (SX9) - Tabela VS4
| Tabela | VS4 |
| Descrição | Itens de Orçamento (Serviços) |
| Domínio | VW2 |
| Identificação | |
| C. Domínio | VS4 |
| E. Domínio | VW2_ID |
| E. C. Domínio | VS4_IDVW2 |
| Propriedade | S |
| L. Domínio | 1 |
| L. C. Domínio | N |
| Condição SQL |
📌 Relacionamento: VW2
📌 Tabela Relacionada (Domínio Pai): VW2 - Tributos
Criação de Relacionamento (SX9) - Tabela VVF
| Tabela | VVF |
| Descrição | Entradas de Veículos |
| Domínio | VW2 |
| Identificação | |
| C. Domínio | VVF |
| E. Domínio | VW2_ID |
| E. C. Domínio | VVF_IDVW2 |
| Propriedade | S |
| L. Domínio | 1 |
| L. C. Domínio | N |
| Condição SQL |
📌 Relacionamento: VW2
📌 Tabela Relacionada (Domínio Pai): VW2 - Tributos
Criação de Relacionamento (SX9) - Tabela VVG
| Tabela | VVG |
| Descrição | Itens das Entradas de Veículos |
| Domínio | VW2 |
| Identificação | |
| C. Domínio | VVG |
| E. Domínio | VW2_ID |
| E. C. Domínio | VVG_IDVW2 |
| Propriedade | S |
| L. Domínio | 1 |
| L. C. Domínio | N |
| Condição SQL |
📌 Relacionamento: VW2
📌 Tabela Relacionada (Domínio Pai): VW2 - Tributos
Criação de Relacionamento (SX9) - Tabela VEC
| Tabela | VEC |
| Descrição | Avaliação de Venda de Peças |
| Domínio | VW2 |
| Identificação | |
| C. Domínio | VEC |
| E. Domínio | VW2_ID |
| E. C. Domínio | VEC_IDVW2 |
| Propriedade | S |
| L. Domínio | 1 |
| L. C. Domínio | N |
| Condição SQL |
📌 Relacionamento: VW2
📌 Tabela Relacionada (Domínio Pai): VW2 - Tributos
Criação de Relacionamento (SX9) - Tabela VSC
| Tabela | VSC |
| Descrição | Avaliação de Venda de Serviços |
| Domínio | VW2 |
| Identificação | |
| C. Domínio | VSC |
| E. Domínio | VW2_ID |
| E. C. Domínio | VSC_IDVW2 |
| Propriedade | S |
| L. Domínio | 1 |
| L. C. Domínio | N |
| Condição SQL |
04. DEMAIS INFORMAÇÕES
| Pacotes Gerados: | 12.1.2310: https://r.totvs.io/p/1237327 12.1.2410: https://r.totvs.io/p/1237328 12.1.2510: https://r.totvs.io/p/1237329 |
|---|
Esta atualização de dicionário estará disponível nativamente na próxima release 12.01.2610 e Expedições Continuas com data superior a 01/09/2025IMPORTANTE!
05. ASSUNTOS RELACIONADOS
- Não há.
- documento_tecnico
- gestao_de_concessionarias
- totvs_gestao_de_concessionarias
- dms
- totvs_dms
- todos_paises
- versao_12_1_2210
- versao_12_1_2310
- versao_12_1_2410
- versao_12_1_2510
- versao_12_1_2610
- oficina
- sigaofi
- auto_pecas
- sigapec
- veiculos
- sigavei
- consulta_tributos_gerados
- ofia001
- dvarmil-13811
- gravacao_tributos_gerados
- mercado_internacional_dms