Histórico da Página
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
Informações Gerais
Especificação | |||
Produto | TOTVS Gestão de Estoque, Compras e Faturamento | Módulo | Faturamento |
Segmento Executor | Construção e Projetos | ||
Projeto1 | Integração BackOffice RM x PDV Protheus | IRM1 | PCREQ-7769 |
Requisito1 | PCREQ-8879 | Subtarefa1 | PDR_CP_MOV010-37 |
Chamado2 |
| ||
País | ( X ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. | ||
Outros | <Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>. |
Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).
Objetivo
Implementação do adapter de integração via Mensagem Única TOTVS do Mapa Resumo - Redução Z. Este adapter irá viabilizar o recebimento da mensagem de Mapa Resumo (Redução Z) gerado pelo PDV PROTHEUS.
Definição da Regra de Negócio
Considera-se como escopo deste requisito a implementação do adapter de recebimento de Mensagens Únicas TOTVS para integração do Mapa Resumo (Redução Z), estando o adapter de envio desta mesma mensagem fora do escopo do requisito.
A análise e o desenvolvimento do adapter será efetuado considerando a integração com o PDV Protheus, mas também viabilizará a integração com outras fontes de dados desde que respeitado o layout da mensagem.
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
Redução Z | Inclusão/Alteração/Exclusão | RM \ BackOffice \ Gestão de Estoque, Compras e Faturamento \ Cadastros \ Fiscais\ Mais...\ Redução Z | - |
A Redução Z permite que o usuário, por exigência legal, informe diariamente os totais acumulados de cada contador ao término do expediente. Ao receber a mensagem do PDV Protheus será executado o DataServer "MovReducaoZData".
Tabelas Utilizadas
- TREDUCAOZ – Redução Z
- TREDUCAOZITEM – Item da Redução Z
- TCUPOMFISCAL – Cupom Fiscal
- TCUPOMFISCALITM – Itens de Cupom Fiscal
- TTRIBUTACAOECF – Tributação ECF
Entidades de Integração
- DataServer envolvido
- MovReducaoZData
- Transformação
- Id: Reduction
- Versão: 1_001
- SourceCode (Evento)
- GUID: c68d7d06-46c4-40f1-8e9d-245c45244eab
Regras de Integridade
Inclusão de Redução Z
Ao receber os dados recebidos da Redução Z enviada pelo PDV, são carregados os dados de Cupons Fiscais e Totalizadores.
A carga dos Totalizadores ocorre da seguinte maneira:
É gerada uma lista com todas as tributações disponíveis para a coligada.
- Se a tributação existir na tabela Item de Redução (TREDUCAOZITEM) carrega o campo ValorReducaoZ que corresponde ao total por tributação que é enviado.
- Se a tributação existir no contexto MovReducaoZCFCxt, faz o somatório e carrega o campo ValorCupomFiscal que corresponde ao total por tributação que é calculado pelo sistema a partir dos cupons fiscais vinculados à redução Z que está sendo inserida.
Esses dois campos são utilizados para verificar se o total de tributos enviados pelo PDV confere com o total de tributos somados para os itens dos cupons fiscais vinculados àquela redução Z.
Além destes dados também são carregados alguns valores defaults, quando não enviados, para a nova redução z que são:
- Série: busca a série do ponto de venda enviado na Redução.
- Tipo de Documento: busca qual é o código do modelo de documento parametrizado para tipo de movimento de venda do Ponto de Venda informado. O Código Modelo do documento é retornado para os códigos 37, 2B, 2C e 2D.
- Código do Cliente: busca qual é a coligada e código do Cliente na tabela de Parâmetros do Frente de Loja (TFPARAMETRO).
Consistências de Inclusão de Redução Z:
- Ponto de venda deve ser informado
- Número da redução Z deve ser informado.
- Série deve ser informado
- Cliente deve ser informado.
Cálculo da Redução Z
O cálculo da Redução Z será executado quando o Identificador da Redução Z for diferente de zero e a Capa do Lote para Escrituração não for informada.
É realizado o Cálculo das Diferenças onde são realizadas as somas dos Descontos, Acréscimos, Valor Bruto, Valor Líquido e Cancelamentos para cada Cupom Fiscal de Redução Z. Neste cálculo são gerados informações de log contendo as diferenças.
Após a realização dos cálculos das diferenças, o status da Redução Z será alterado para:
- Calculado: quando não existir diferenças no cálculo.
- Não Calculado: quando a lista de cupons fiscais for vazia.
- Inconsistente: quando a lista de cupons fiscais não for vazia.
Ao salvar a Redução Z é feito a vinculação com os Cupons Fiscais, inclusive os cancelados e é gerado um log de execução com as informações dos registros analisados.
Alteração de Redução Z
Exclusão de Redução Z
Tabelas Utilizadas
- TREDUCAOZ – Redução Z
- TREDUCAOZITEM – Item da Redução Z
- TCUPOMFISCAL – Cupom Fiscal
- TCUPOMFISCALITM – Itens de Cupom Fiscal
- TTRIBUTACAOECF – Tributação ECF
A inclusão de Redução Z no RM considera como obrigatórios a informação dos seguintes dados: Ponto de Venda, Número da Redução, Série e Cliente.
- O Ponto de Venda será enviado na mensagem única Reduction_1.001 na tag StationSalePointInternalId. Ao receber a mensagem deve-se buscar na tabela De-Para qual é o código do ponto de venda do RM.
- Número da Redução: será considerado o valor enviado pelo PDV Protheus na tag ReductionCode.
- Série: como esta informação não é trafegada na mensagem será buscado a Série do Ponto de Venda.
- Cliente: como esta informação não é enviada pelo PDV Protheus na mensagem, é necessário cadastrar o Cliente/Fornecedor Default nos Parâmetros de Integração Frente de Loja do TOTVS Gestão de Estoque, Compras e Faturamento. Acesse RM menu BackOffice >> Gestão de Estoque, Compras e Faturamento >> Ambiente >> Configuração >> Parâmetros >> 04.03 - Integrações >> 04.03.04 - Frente de Loja.
Além dos campos obrigatórios acima o campo Contador Não Sujeito ICMS receberá como valor default zero.
Itens de Redução Z
Estes dados são gerados com base nas seguintes informações recebidas da mensagem única:
- Lista de Alíquotas(ListOfAliquot)
- Nesta lista serão enviados os valores tributados de ICMS e ISS, onde na tag AliquotCode será enviado o código da tributação ECF e na tag AliquotBase será enviado o valor base da alíquota informada.
- Valor de Substituição tributária (TaxReplacementValue);
- Valor de Isentos (FreeValue);
- Valor de Não Tributado (UntaxedValue).
O PDV Protheus deverá enviar os Códigos dos Tributos ECF utilizados nos Cupons para que os Itens de Redução Z seja gerados corretamente.
Cálculo da Redução Z
Devido ao recálculo do rateio de descontos e acréscimos pode haver diferenças de arredondamento entre o valor líquido de alguns itens e assim gerando diferenças nos totalizadores de Tributação ECF, mas não nos valores absolutos do cupom.
Caso esta diferença ocorra no Cálculo da Redução Z o processo de "Recalculo dos Totalizadores Parciais" deve ser executado e posteriormente reexecutar o Cálculo da Redução Z.
Ponto de Atenção
- Valor dos Acréscimos: os acréscimos aplicados aos cupons fiscais nas vendas, devem ser enviados na Redução Z para que o cálculos dos valores sejam feitos corretamente. Para isso o PDV Protheus deve somar os acréscimos aplicados aos cupons enviados na Redução Z e enviar esta informação na tag "IncreasesValue'.
- Grande Total (GT): O grande total enviado deverá considerar os acréscimos.
- Acréscimo Financeiro: Devido os dois pontos listados acima e considerando que o Protheus somente utiliza acréscimos no Cupom Fiscal e não nos seus itens, o campo "IncreasesValue" será mapeado para o campo "Acréscimos Financeiros" do RM.
Opcional
Fluxo do Processo
<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>.
Mapeamento dos Campos
Mensagem: Reduction_1_000
Mensagem Padrão | Descrição | RM | ||||||
Tabela | Campo | Observação | ||||||
CompanyId | Código da empresa. | TREDUCAOZ | CODCOLIGADA | Código da Coligada é obtido a partir do De-Para de Filial. | ||||
BranchId | Código da filial |
|
| |||||
CompanyInternalId | InternalId da chave completa de empresa do produto |
| ||||||
InternalId | InternalId de Integração | TREDUCAOZ | CODCOLIGADA|IDREDUCAOZ|PONTOVENDA|NUMEROREDUCAO ou CODCOLIGADA|IDREDUCAOZ |
| ||||
MovementDate | Data do Movimento | TREDUCAOZ | DATAMOVIMENTO | StationCode | Código da Estação | |||
ReductionCode | Código da Redução | TREDUCAOZ | NUMEROREDUCAO | |||||
InitialValue | Grande Total Final do dia anterior | TREDUCAOZ | GRANDETOTALANT | Valor default Zero, caso não seja enviado na mensagem. | ||||
FinalValue | Grande Total Final do dia | TREDUCAOZ | GRANDETOTAL | |||||
InitialCounter | Número do Cupom Inicial do Dia | TREDUCAOZ | COOANT | |||||
FinalCounter | Número do Cupom Final do Dia | TREDUCAOZ | COO | |||||
ValueCancellations | Valor Total de Cancelamento | TREDUCAOZ | CANCELAMENTOS | |||||
SalesValueNet | Valor Contábil | -- | -- | Não utilizado no RM. | ||||
TaxReplacementValue | Valor Substituição Tributária | TREDUCAOZITEM | TOTALPARCIAL | Quando enviado o valor preencher o total parcial do Item de Redução Z e utilizar como código de tributação ECF o valor fixo F1. | ||||
DiscountValue | Valor de Descontos | TREDUCAOZ | DESCONTOS | |||||
FreeValue | Valor de Isentos | TREDUCAOZITEM | TOTALPARCIAL | Quando enviado o valor preencher o total parcial do Item de Redução Z e utilizar como código de tributação ECF o valor fixo I1. | ||||
UntaxedValue | Valor de Não Tributado | TREDUCAOZITEM | TOTALPARCIAL | Quando enviado o valor preencher o total parcial do Item de Redução Z e utilizar como código de tributação ECF o valor fixo N1. | ||||
CounterCode | Contador de Ordem de Operação | TREDUCAOZ | COORZ | |||||
ValueOfOthersReceivables | Valor de Outros Recebimentos | -- | -- | Não utilizado no RM. | ||||
AmountOfTaxDue | Valor do Imposto Devido | -- | -- | Não utilizado no RM. | ||||
IssValue | Valor Base do ISS | -- | -- | Não utilizado no RM. Os valores de ISS serão mapeados pela lista de alíquotas (ListOfAliquotType). | ||||
CounterReset | Contador de Ordem de Reinicio | -- | -- | Não utilizado no RM. | ||||
IssueDateReduction | Data de Emissão da Redução | TREDUCAOZ | DATAREDUCAO | |||||
StationSalePointCode | Código Ponto de Venda | TREDUCAOZ | PONTOVENDA | |||||
StationSalePointInternalId | InternalId do Ponto de Venda | TREDUCAOZ | CODCOLIGADA|PONTOVENDA | |||||
IncreasesValue | Valor dos Acréscimos da Venda | TREDUCAOZ | ACRESCIMOSFIN | |||||
ListOfAliquot\ListOfAliquotType | Lista de Alíquotas da Redução Z | As informações desta lista serão preenchidas para cada tipo de alíquota ICMS e ISS. Ver AliquotType. | ||||||
AliquotType | ||||||||
---|---|---|---|---|---|---|---|---|
AliquotCode | Identificador da Base ICMS | TREDUCAOZITEM | TRIBUTACAOECF | |||||
AliquotBase | Valor da Base ICMS | TREDUCAOZITEM | TOTALPARCIAL |
- Somente os campos marcados em negrito são tratados no Adapter.
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|