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.
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
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 XXX 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: caso este campo não seja enviado 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.
Totalizadores:
O cálculo 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.
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
Item de Redução Z
Estes dados são gerados com base nas informações de Lista de Alíquotas ICMS da Redução Z, enviadas na tag "ListOfAliquot". Para cada tipo de tributação será gerado um novo item com seu respectivo valor. São considerados os tributos:
- ICMS (0,01%, 7%, 12%, 17%, 18%, 19%, 25%),
- ISS,
- Isento (I),
- Substituição Tributária (F) e
- Não Tributado (N).
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:
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 |
| |
MovementDate | Data do Movimento | TREDUCAOZ | DATAMOVIMENTO | ||
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 ISSTREDUCAOZITEM | -- | TOTALPARCIAL | -- | Não utilizado no RM. Os valores de ISS serão mapeados pela lista de alíquotas (ListOfAliquotType)Quando enviado o valor preencher o total parcial do Item de Redução Z. |
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 | ValueIncreases | |
IncreasesValue | Valor dos Acréscimos da Venda | TREDUCAOZ | ACRESCIMOSACRESCIMOSFIN | ||
ListOfAliquot\ListOfAliquotType | Lista de Alíquotas ICMS 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. |
---|