Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 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-8877

Subtarefa1

PDR_CP_MOV009-100

Chamado2

 

Release de Entrega Planejada

12.1.10

Réplica

Não

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 cadastro de Cupom Fiscal com o PDV PROTHEUS, viabilizando assim o CRUD completo do cadastro por recebimento de mensagem de integração.


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 cadastro de Cupom Fiscal, 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

Cupom Fiscal

Inclusão/Alteração/Exclusão

RM \ BackOffice \ Gestão de Estoque, Compras e Faturamento \ Cadastros \ Fiscais\ Mais...\ Cupom Fiscal

-

 

Tabelas Utilizadas

  • TCUPOMFISCAL – Cupom Fiscal
  • TCUPOMFISCALITM - Itens de Cupom Fiscal
  • TCUPOMFISCALFIN - Pagamentos do Cupom Fiscal

Entidades de Integração

  • DataServer envolvido
    • MovCupomFiscalData
  • Transformação
    • Id: RetailSales
    • Versão: 1_001
  • SourceCode (Evento)
    • GUID: 

Regras de Integridade:

Ao receber mensagem de Cupom Fiscal serão realizadas as seguintes ações para os campos abaixo:

Cupom Fiscal:

  • COO: será utilizado o mesmo campo que o número.
  • CRO: será obtido a partir do default do cadastro de Estação no RM.
  • Redução Z: deve ser preenchido após a integração do cupom fiscal, não sendo então integrado.

  • Acréscimo: No Protheus o acréscimo é por cupom, com rateio para os itens, sempre virá já rateado para os itens (Campo F2_VALACRS). No RM esta informação será preenchido no campo VALORDESP que é a soma das despesas dos itens ou despesa aplicada ao cupom, NÃO irá incluir itens CANCELADOS. Caso não seja enviado acréscimo, será considerado como valor default o valor 0 (zero).
  • Valor Líquido: a fórmula de cálculo para obter o valor líquido é:  VALORLIQUIDO = ( ∑ ( Preço item X Quantidade item) - Desconto + Acréscimo total ). Não deve ser considerado Itens Cancelados. O campo do Protheus referente ao valor líquido é o F2_VALBRUT. Caso não seja enviado o valor líquido será considerado como valor default o valor 0 (zero).
  • Valor Recebido: será o mesmo valor do campo Valor Líquido.
  • Desconto: No RM o campo que armazena esta informação é VALORDESC. Este campo é soma dos descontos dos itens ou desconto aplicado ao cupom, NÃO inclui itens CANCELADOS! Caso não seja enviado o valor líquido será considerado como valor default o valor 0 (zero). Sempre será lido o valor líquido e as despesas do valor original enviado. Mas os descontos, serão recalculados para evitar erro no arredondamento.
    Observação: no Protheus o desconto pode ser por item, por cupom, ou ambos. 
  • CNPJ Adquirente: desnecessário em integração com o Protheus pois sempre haverá um Cliente/Fornecedor.

  • Nome Adquirente: desnecessário em integração com o Protheus pois sempre haverá um Cliente/Fornecedor.

Item do Cupom Fiscal:

  • Preço unitário: O preço unitário enviado pelo Protheus é o valor unitário líquido obtido a partir da seguinte fórmula: (valor unit. - desconto + acréscimo).
  • Natureza da Operação: Obtida a partir da Tributação.
  • Alíquota: Obtida a partir da Tributação.

  • CST: Obtida a partir da Tributação.

Lista de Pagamentos:

  • Débito/Crédito: fixo crédito (não será trafegado).

 

Movimento associado ao Cupom Fiscal

O serviço de inclusão de Cupom Fiscal também realizar a inclusão de um movimento e associa este movimento ao Cupom. Sendo assim torna-se necessário informar no cadastro de Ponto de Venda qual será o Tipo de Movimento de Venda que será utilizado. Este tipo de movimento deve possuir as seguintes configurações mínimas:

EtapaCampoValor
Mov - IdentificaçãoNumeração2.X.XX
Mov - Datas 1/2Edição da Data de EmissãoEdita ou Mostra
Mov - Valores Financeiros 1/4DescontoMarcado
Tipo de DescontoValor
DespesaMarcado
Tipo de DespesaValor
Item - Valores Financeiros 1/2Utilizar DescontoMarcado
Nome do DescontoDesconto
Afeta Desconto do MovimentoMarcado
Tipo do DescontoValor
Utilizar DespesaMarcado
Nome da DespesaDespesa
Tipo de DespesaValor
  
Fin - Condições de PagamentoUtiliza edição de Meios de PagamentoMarcado
Fis - DadosEmite Cupom FiscalMarcado

 

 

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 de Campos

 

Mensagem: RetailSales 1.001

 

Mensagem Padrão

Descrição

RM

Tabela

Campo

Observação

CompanyId

Código da empresa.

TCUPOMFISCAL

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

TCUPOMFISCAL

CODCOLIGADA|PONTOVENDA|CRO|NUMERO

 

SellerInternalIdInternalId do VendedorTPONTOVENDACODVEN1Buscar o código do vendedor no cadastro de Estação PDV

ComissionPercent

Percentual da Comissão   
CustomerVendorInternalIdInternalId do Código do ClienteTCUPOMFISCALCODCOLCFO|CODCFO 
TotalPriceValor Total da VendaTCUPOMFISCALVALORRECEBIDO 
DiscountValueValor Total de DescontoTCUPOMFISCALDESCONTO 
IncreaseValueValor de AcréscimoTCUPOMFISCALACRESCIMO 
NetPriceValor Líquido da VendaTCUPOMFISCALVALORLIQUIDO 
CashValueValor Pago em Dinheiro   
ChecksValueValor Pago em Cheques   
CardsValueValor Pago em Cartões de Crédito   
DebitValueValor Pago em Cartões de Débito   
CovenantValueValor Pago com Convênio   
VouchersValueValor Pago com Vales   
FinancedValueValor Pago com Financiamento   
OthersValueValor Pago com Outras Formas   
InputValueValor de Entrada   
IssueDateDocumentData de Emissão da Venda   
IssueDateDocumentData de Emissão da VendaTCUPOMFISCALDATAEMISSAO 
DocumentCodeNumero do DocumentoTCUPOMFISCALNUMERO

Consistir tamanho do campo:
RM: inteiro tamanho 4

PROTHEUS: string tamanho 9 

SerieCodeSerie do DocumentoTPONTOVENDASERIE 
GrossPriceValor Bruto da VendaTCUPOMFISCALVALORRECEBIDORepetir ou desconsiderar?
CommodityPriceValor Total da Mercadoria   
DiscountPercentPercentual de Desconto da Venda   
OperatorCodeCodigo do Operador   
CurrencyRateTaxa da Moeda   
ChangeValor do Troco na Venda   
StationCodeCódigo da Estação   
DiscountPaymentTermDesconto Financeiro na Venda   
CreditValueValor de Crédito da Venda   
KindOfDocumentTipo do Documento   
Md5Código Md5 NewHotel   
ElectronicInvoiceComplementInformações Complementares NFCe   
PersonalIdentificationCPF/CGC do ClienteTCUPOMFISCALCNPJCPFADQUIRENTE 
IsCanceledInforma se venda esta canceladaTCUPOMFISCALCANCELADO 
ListOfSaleItem\ListOfSaleItemTypeLista de Itens da Venda   
ListOfSaleCondition\ListOfTaxesTypeLista de Impostos da Venda   
StationSalePointCodeCódigo Ponto de VendaTPONTOVENDAPONTOVENDA 
StationSalePointInternalIdInternalId do Ponto de VendaTPONTOVENDACODCOLIGADA|PONTOVENDA 
ListOfSaleItemTypeLista de Itens da Venda
SaleItem\SaleItemTypeItens   
InternalIdInternalId do Item da VendaTCUPOMFISCALITMCODCOLIGADA | IDCUPOM | NUMEROITEM 
ItemInternalIdInternalId do ProdutoTCUPOMFISCALITMCODCOLIGADA|IDPRD 
ItemCodeCódigo do ProdutoTPRODUTOCODIGOPRDNo RM campo tem tamanho 30 e na mensagem está definido com tamanho 15
ItemOrderOrdem do ItemTCUPOMFISCALITMNUMEROITEMNo RM este campo é inteiro de tamanho 4.
QuantityQuantidade do ItemTCUPOMFISCALITMQUANTIDADE 
UnitPricePreço Unitário do ItemTCUPOMFISCALITMPRECOUNITARIO 
ItemPriceValor do ItemTCUPOMFISCALITMVALORBRUTO 
DiscountPercentagePercentual de Desconto do Item  Não utilizado no RM.
DiscountAmountValor do Desconto do ItemTCUPOMFISCALITMDESCONTO 
OperationCodeCódigo Fiscal de Operações e PrestaçõesDCFOPCODNAT 
ListOfTaxesLista de Impostos do ItemVer ListOfTaxesType
IncreaseValor de Acréscimo do ItemTCUPOMFISCALITMACRESCIMO 
LodgingProduto é Diaria  Não utilizado no RM.
IsCanceledInforma se o item esta canceladoTCUPOMFISCALITMCANCELADO 
WarehouseCodeCódigo do Local de Estoque(Armazém)TPONTOVENDACODLOC 
WarehouseInternalIdId de integração do Local de Estoque(Armazém)TPONTOVENDACODCOLIGADA|CODFILIAL|CODLOC 
ECFTaxingCodeCódigo da Tributação ECFTCUPOMFISCALITMTRIBUTACAOECF 
ListOfTaxesTypeLista de Impostos da VendaTipo responsável por trafegar os impostos:
ITF, COFINS, CSLL, FABOV, FACS, INSS-PF, INSS-PJ, INSS-RUR, IOF, IR-CARRETEIRO, IR-PF, IR-PJ, IRRF–PF, IRRF–PJ, ISS, ISS-ARQ-ELET, PIS, PIS/COFINS/CSLL, PIS/COFINS-CRED, PIS/COFINS-PROD, SEST/SENAT,ICM, IPI, II.
Arquivo: "Tax_1_002.xsd"
ListOfSaleConditionType \ SaleConditionCondições de Pagamento da Vendaver SaleConditionType
SaleConditionType
AccountReceivableDocumentInternalIdInternalId do RA do cliente   
DateOfPaymentData de Vencimento da ParcelaTCUPOMFISCALFINDATAVENCIMENTO 
PaymentValueValor do PagamentoTCUPOMFISCALFINVALOR 
PaymentMethodCodeForma de PagamentoTFORMAPAGTOCODFORMAPAGTONo RM o campo possui tamanho 10 e no xsd está definido como 15.  
PaymentMethodInternalIdChave de Integração de Forma de PagamentoTCUPOMFISCALFINCODCOLIGADA|IDFORMAPAGTO 
FinancialManagerCodeCódigo da Administradora Financeira   Não utilizado no RM.
CardNumberNumeração do ChequeTCUPOMFISCALFINCHEQUE No RM o campo possui tamanho 20 caracteres. Criar consistência para quando receber valor maior que 20, uma vez que no XSD da mensagem está definido tamanho 30 caracteres.
SerieCheckSérie do Cheque  Não utilizado no RM
BankCheckBanco do ChequeTCUPOMFISCALFINBANCO 
AgencyCheckAgência Bancária do ChequeTCUPOMFISCALFINAGENCIA No RM campo possui tamanho de 20 caracteres e no XSD está definido tamanho 8 caracteres. Não teremos problemas no Recebimento, mas se for enviar esta mensagem talvez seja necessário alterar o tamanho do campo.
AccountCheckNúmero da Conta do ChequeTCUPOMFISCALFINCC 
DocumentOfIdentificationDocumento de Identidade do Cliente - Cheque  Não utilizado no RM
PhoneNumberTelefone do Cliente - ChequeTCUPOMFISCALFINTELEMITENTE 
EftDateData do Pagamento - TEF   
EftDocumentDocumento de Identificação TEF   
EftAutorizationCódigo de Autorização TEF   
EftCancellationDateData de Cancelamento TEF   
EftCancellationDocumentNúmero do Cancelamento TEF   
EftInstituteCódigo do Instituto TEF   
UniqueSerialNumberCódigo NSU - TEF   
EftParcelParcelamento TEF   

 

 

 

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.