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
Projeto¹	Integração BackOffice RM x PDV Protheus	IRM¹	PCREQ-7769
Requisito¹	PCREQ-8877	Subtarefa¹	PDR_CP_MOV009-100
Chamado²
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:

CRO: será obtido a partir do default do cadastro de Estação no RM.
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.
Redução Z: deve ser preenchido após a integração do cupom fiscal, não sendo então integrado.

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).

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
Mensagem Padrão	Descrição	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
SellerInternalId	InternalId do Vendedor
ComissionPercent	Percentual da Comissão
CustomerVendorInternalId	InternalId do Código do Cliente	TCUPOMFISCAL	CODCOLCFO\|CODCFO
TotalPrice	Valor Total da Venda	TCUPOMFISCAL	VALORRECEBIDO
DiscountValue	Valor Total de Desconto	TCUPOMFISCAL	DESCONTO
IncreaseValue	Valor de Acréscimo	TCUPOMFISCAL	ACRESCIMO
NetPrice	Valor Líquido da Venda	TCUPOMFISCAL	VALORLIQUIDO
CashValue	Valor Pago em Dinheiro
ChecksValue	Valor Pago em Cheques
CardsValue	Valor Pago em Cartões de Crédito
DebitValue	Valor Pago em Cartões de Débito
CovenantValue	Valor Pago com Convênio
VouchersValue	Valor Pago com Vales
FinancedValue	Valor Pago com Financiamento
OthersValue	Valor Pago com Outras Formas
InputValue	Valor de Entrada
IssueDateDocument	Valor de Entrada
IssueDateDocument	Data de Emissão da Venda
DocumentCode	Numero do Documento
SerieCode	Serie do Documento
GrossPrice	Valor Bruto da Venda
CommodityPrice	Valor Total da Mercadoria
DiscountPercent	Percentual de Desconto da Venda
OperatorCode	Codigo do Operador
CurrencyRate	Taxa da Moeda
Change	Valor do Troco na Venda
StationCode	Código da Estação
DiscountPaymentTerm	Desconto Financeiro na Venda
CreditValue	Valor de Crédito da Venda
KindOfDocument	Tipo do Documento
Md5	Código Md5 NewHotel
ElectronicInvoiceComplement	Informações Complementares NFCe
PersonalIdentification	CPF/CGC do Cliente
IsCanceled	Informa se venda esta cancelada
ListOfSaleItem\ListOfSaleItemType	Lista de Itens da Venda
ListOfSaleCondition\ListOfTaxesType	Lista de Impostos da Venda
StationSalePointCode	Código Ponto de Venda	TPONTOVENDA	PONTOVENDA
StationSalePointInternalId	InternalId do Ponto de Venda	TPONTOVENDA	CODCOLIGADA\|PONTOVENDA
ListOfSaleItemType
SaleItem\SaleItemType	Itens
InternalId	InternalId do Item da Venda	TCUPOMFISCALITM	CODCOLIGADA \| IDCUPOM \| NUMEROITEM
ItemInternalId	InternalId do Produto	TCUPOMFISCALITM	CODCOLIGADA\|IDPRD
ItemCode	Código do Produto
ItemOrder	Ordem do Item
Quantity	Quantidade do Item	TCUPOMFISCALITM	QUANTIDADE
UnitPrice	Preço Unitário do Item	TCUPOMFISCALITM	PRECOUNITARIO
ItemPrice	Valor do Item	TCUPOMFISCALITM	VALORBRUTO
DiscountPercentage	Percentual de Desconto do Item
DiscountAmount	Valor do Desconto do Item
OperationCode	Código Fiscal de Operações e Prestações
ListOfTaxes	Lista de Impostos do Item			Ver ListOfTaxesType
Increase	Valor de Acréscimo do Item	TCUPOMFISCALITM	ACRESCIMO
Lodging	Produto é Diaria			Não utilizado no RM.
IsCanceled	Informa se o item esta cancelado	TCUPOMFISCALITM	CANCELADO
WarehouseCode	Código do Local de Estoque(Armazém)
WarehouseInternalId	Id de integração do Local de Estoque(Armazém)
ECFTaxingCode	Código da Tributação ECF	TCUPOMFISCALITM	TRIBUTACAOECF
ListOfTaxesType \ Tax				ver TaxesType
ListOfSaleConditionType \ SaleCondition				ver SaleConditionType
SaleConditionType
AccountReceivableDocumentInternalId	InternalId do RA do cliente
DateOfPayment	Data de Vencimento da Parcela	TCUPOMFISCALFIN	DATAVENCIMENTO
PaymentValue	Valor do Pagamento	TCUPOMFISCALFIN	VALOR
PaymentMethodCode	Forma de Pagamento	TCUPOMFISCALFIN	IDFORMAPAGTO
PaymentMethodInternalId	Chave de Integração de Forma de Pagamento	TCUPOMFISCALFIN	CODCOLIGADA\|IDFORMAPAGTO
FinancialManagerCode	Código da Administradora Financeira
CardNumber	Numeração do Cheque	TCUPOMFISCALFIN	CHEQUE
SerieCheck	Série do Cheque			Não utilizado no RM
BankCheck	Banco do Cheque	TCUPOMFISCALFIN	BANCO
AgencyCheck	Agência Bancária do Cheque	TCUPOMFISCALFIN	AGENCIA
AccountCheck	Número da Conta do Cheque	TCUPOMFISCALFIN	CC
DocumentOfIdentification	Documento de Identidade do Cliente - Cheque			Não utilizado no RM
PhoneNumber	Telefone do Cliente - Cheque	TCUPOMFISCALFIN	TELEMITENTE
EftDate	Data do Pagamento - TEF
EftDocument	Documento de Identificação TEF
EftAutorization	Código de Autorização TEF
EftCancellationDate	Data de Cancelamento TEF
EftCancellationDocument	Número do Cancelamento TEF
EftInstitute	Código do Instituto TEF
UniqueSerialNumber	Código NSU - TEF
EftParcel	Parcelamento TEF

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

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 6

Nova versão 7

Chave