Módulo PDV - Histórico de revisão

Rodrigogml: Rodrigogml moveu PDV para Módulo PDV sem deixar um redirecionamento

2025-11-08T14:26:18Z

Rodrigogml moveu PDV para Módulo PDV sem deixar um redirecionamento

← Edição anterior	Edição das 14h26min de 8 de novembro de 2025
(Sem diferença)

Rodrigogml: /* por Código de Produto */

2015-10-02T21:44:49Z

por Código de Produto

← Edição anterior		Edição das 21h44min de 2 de outubro de 2015
Linha 199:		Linha 199:
	O relatório de Faturamento por Código de Produto visa exibir as informações das vendas agrupadas pelo código do produto.		O relatório de Faturamento por Código de Produto visa exibir as informações das vendas agrupadas pelo código do produto.

	~~Exemplo de SQL para MySQL para obter os dados como se espera no relatório:~~		* '''Caminho do Relatório''' - Caixa > Relatórios > Vendas > por Código de Item
	~~<syntaxhighlight lang="sql">~~
	~~SELECT ci.code, ci.displayline, min(ci.price), max(ci.price) , round(sum(ci.total)/sum(ci.quantity),2), sum(ci.quantity) as qt, ci.unit, ci.measureunit, SUM(ci.total) AS tot~~
	~~FROM pdv_cupomitem ci LEFT JOIN pdv_cupom c ON c.id = ci.idpdv_cupom LEFT JOIN item_itemcodes ic ON ic.code = ci.code~~
	~~-- LEFT JOIN item_itemcategory icat ON icat.id = ic.iditemcategory~~
	~~WHERE ci.STATUS =~~ '~~SOLD~~' ~~AND (c.STATUS =~~ '~~SOLD~~' ~~OR c.STATUS =~~ '~~ERROR_SYNC~~') -~~- where obrigatória~~
	~~-- WHERE de Filtros~~
	~~-- AND c.DATE~~ >~~= '2015-03-01 00:00:00' AND c.DATE <= '2015-03-31 23:59:59' -- Filtra~~ por ~~data~~
	~~-- and icat.id is null -- Filtra código exclúidos / Sem categoria~~
	~~-- and icat.id = 50 -- Filtra pela Categoria~~ de Item
	~~GROUP BY ci.code, ci.displayline, ci.unit -- GROUPS~~
	~~ORDER BY tot DESC; -- Order By~~
	~~</syntaxhighlight>~~

			==== Relacionamentos ====

	'''~~''Exibições''~~'''		* '''PDVCupomItemVO'''
	* ~~'''Listagem'''~~		** '''Left Join: ItemCodeVO''' - usado pois algum código de item que tenha sido vendido, mas tenha sido excluído vai constar na base de dados com o relacionamento 'null'. Sem o Left Join esses registros seriam removidos do resultado.
	* '''~~Gráfico Pizza~~'''		*** '''Left Join: ItemCategoryVO''' - usado como left join pelo mesmo motivo do ItemCodeVO. Como o relacionamento é feito com uma entidade que esta sendo anexada com LeftJoin, se este também não for registros seriam removidos do resultado.

	''~~'''Filtros~~ do ~~Relatório'''''~~
	* '''~~Período~~''' - ~~exibe dois campos de data para marcação~~ do ~~período~~ que se ~~deseja o relatório.~~
	* '''Categoria do ~~Item''' - filtra os itens de acordo com sua categoria. Exibir dados em forma hierárquica para escolha~~.

	=== por Categoria de Itens ===		=== por Categoria de Itens ===

Rodrigogml: /* Registro Falso: Troco */

2015-09-25T14:42:50Z

Registro Falso: Troco

@@ Linha 372: / Linha 372: @@
 </syntaxhighlight>
-==== Registro Falso: Troco ====
+==== Registro "Fake": Troco ====
 Filtrando os dados pelos pagamentos do cupom obtemos os valores brutos dos pagamentos efetuados. Não obtemos o valor real do faturamento ou que ficou no caixa. Isso porque as formas de pagamentos podem gerar troco. O que indica que recebemos o tal valor, mas é possível que tenhamos devolvido algum troco. Não há um meio efetivo de já descontar o troco em cada forma de pagamento uma vez que mesmo durante a venda não é possível definir isso com precisão. Por exemplo, em uma compra com 4 amigos são realizados pagamentos separados sendo 2 em dinheiro, 1 em cartão e outro em cheque. No final o valor a ser devolvido seja de 10 reais. De qual pagamento é o troco? Múltiplos pagamentos podem aceitar troco, outros tantos podem aceitar só emissão de contra-vales. Não é trivial fazer essa distinção. Assim o sistema simplesmente guarda o "troco" da compra referenciando o cupom e não algum pagamento do cupom.
@@ Linha 393: / Linha 393: @@
 Facilitando assim que o usuário possa verificar o valor "líquido" do recebimento apenas selecionando os registros.}}

Rodrigogml: /* por Forma de Pagamento */

2015-09-25T00:11:54Z

por Forma de Pagamento

← Edição anterior		Edição das 00h11min de 25 de setembro de 2015
Linha 341:		Linha 341:
	<syntaxhighlight lang="sql">		<syntaxhighlight lang="sql">
	SELECT		SELECT
	-- *,		-- ==> Colunas Fixas
	-- Colunas Fixas
	cp.name, cp.type		cp.name, cp.type
	-- Colunas Distinguíveis		-- ==> Colunas Distinguíveis
	-- , cp.contract_type, cp.tef_acquirernet -- Usado quando o usuário escolher que quer Distinguir a coluna "Sub-Tipo"		-- , cp.contract_type, cp.tef_acquirernet -- Usado quando o usuário escolher que quer Distinguir a coluna "Sub-Tipo"
	-- , cp.contract_name, cp.tef_cardname -- Usado quando o usuário escolher que quer Distinguir a coluna "Nome"		-- , cp.contract_name, cp.tef_cardname -- Usado quando o usuário escolher que quer Distinguir a coluna "Nome"
	-- Colunas Adicionais		-- ==> Colunas Adicionais
	, COUNT(*) -- Contagem		, COUNT(*) -- Contagem
	, sum(cp.value) -- Recebido		, sum(cp.value) -- Recebido
	-- Colunas de GroupBy		-- ==> Colunas de GroupBy
	-- , c.date -- Usada para os "Agrupado Diariamente"e "Agrupado Mensal" para extrair a data		-- , c.date -- Usada para os "Agrupado Diariamente"e "Agrupado Mensal" para extrair a data
	-- , weekday(c.date) -- Usado no "Sumarizado por Dia Da Semana" para extratir o dia da semana		-- , weekday(c.date) -- Usado no "Sumarizado por Dia Da Semana" para extratir o dia da semana
Linha 361:		Linha 360:
	AND c.date >= '2015-08-01 00:00:00' AND c.date <= '2015-08-31 23:59:59' -- Filtro por periodo		AND c.date >= '2015-08-01 00:00:00' AND c.date <= '2015-08-31 23:59:59' -- Filtro por periodo
	GROUP BY cp.name, cp.type -- Group By Obrigatório		GROUP BY cp.name, cp.type -- Group By Obrigatório
			-- ==> Colunas Distinguíveis
	-- , cp.contract_type, cp.tef_acquirernet -- Usado quando o usuário escolher que quer Distinguir a coluna "Sub-Tipo"		-- , cp.contract_type, cp.tef_acquirernet -- Usado quando o usuário escolher que quer Distinguir a coluna "Sub-Tipo"
	-- , cp.contract_name, cp.tef_cardname -- Usado quando o usuário escolher que quer Distinguir a coluna "Nome"		-- , cp.contract_name, cp.tef_cardname -- Usado quando o usuário escolher que quer Distinguir a coluna "Nome"
	-- , cp.contract_name, cp.name, cp.tef_acquirernet, cp.tef_cardname -- Usado quando o usuário escolher que quer Distinguir a coluna "Nome"		-- , cp.contract_name, cp.name, cp.tef_acquirernet, cp.tef_cardname -- Usado quando o usuário escolher que quer Distinguir a coluna "Nome"
			-- ==> Colunas Exibição dos Dados
	-- , day(c.date), month(c.date), year(c.date) -- Agrupado Diariamente		-- , day(c.date), month(c.date), year(c.date) -- Agrupado Diariamente
	-- , month(c.date), year(c.date) -- Agrupado Mensalmente		-- , month(c.date), year(c.date) -- Agrupado Mensalmente

Rodrigogml: /* por Forma de Pagamento */

2015-09-25T00:08:25Z

por Forma de Pagamento

@@ Linha 313: / Linha 313: @@
 ** '''Período''' - Campo de filtro por período com precisão de minutos.
 **: '''Validações''' - Não permitir um período de consulta maior que 2 anos.
 * '''Exibição dos Dados:'''
 ** '''Agrupado Diariamente''' - Permite agrupar os valores por de acordo com seu dia, mês e ano.
@@ Linha 336: / Linha 338: @@
 *** '''%Recebido''' - Indica a participação em relação ao valor total recebido na forma de pagamento.
-* '''Registro Adicional''' -

Rodrigogml: /* por Forma de Pagamento */

2015-09-24T23:14:42Z

por Forma de Pagamento

← Edição anterior		Edição das 23h14min de 24 de setembro de 2015
Linha 308:		Linha 308:

	* '''Caminho do Relatório:''' Caixa / PDV > Vendas > por Forma de Pagamento		* '''Caminho do Relatório:''' Caixa / PDV > Vendas > por Forma de Pagamento
			* '''Condições (WHERE) Fixos:'''
			** '''Status do Pagamento = 'DONE'''' - Apenas os pagamentos com o status DONE devem ser considerados. É comum ter alguns pagamentos com o status 'CANCELED', principalmente durante o uso de TEF quando um pagamento é estornado. Assim esses pagamentos não foram recebidos e não devem fazer parte desse relatório.
	* '''Campos de Filtro:'''		* '''Campos de Filtro:'''
	** '''Período''' - Campo de filtro por período com precisão de minutos.		** '''Período''' - Campo de filtro por período com precisão de minutos.
			**: '''Validações''' - Não permitir um período de consulta maior que 2 anos.
	* '''Exibição dos Dados:'''		* '''Exibição dos Dados:'''
	** '''~~Agrupar~~ Diariamente''' - Permite agrupar os valores por de acordo com seu dia, mês e ano.		** '''Agrupado Diariamente''' - Permite agrupar os valores por de acordo com seu dia, mês e ano.
	** '''~~Agrupar~~ Mensalmente''' - Permite agrupar os valores por de acordo com seu mês e ano.		** '''Agrupado Mensalmente''' - Permite agrupar os valores por de acordo com seu mês e ano.
	** '''Sumarizado por Dias da Semana''' - Permite acumular os valores de acordo com o dia da semana (Dom-Sáb).		** '''Sumarizado por Dias da Semana''' - Permite acumular os valores de acordo com o dia da semana (Dom-Sáb).
	** '''Sumarizado por Horas do Dia''' - Permite acumular os valores de acordo com a hora do dia.		** '''Sumarizado por Horas do Dia''' - Permite acumular os valores de acordo com a hora do dia.
	* '''Validações'''
	** '''Período de Consulta''' - Não permitir um período de consulta maior que 2 anos.
	* '''Colunas do Relatório:'''		* '''Colunas do Relatório:'''
	** '''Colunas Fixas:'''		** '''Colunas Fixas:'''
	*** '''~~Nome~~''' - Exibe o ~~noma~~ da forma de pagamento. O mesmo nome exibido para o operador de caixa durante o uso do PDV.		*** '''Forma de Pagamento''' - Exibe o nome da forma de pagamento. O mesmo nome exibido para o operador de caixa durante o uso do PDV.
	*** '''Tipo''' - Exibe o tipo da forma de pagamento. O tipo é uma Enum do sistema, usara para 'enumerar' as diferentes formar de pagamento que o sistema consegue tratar.		*** '''Tipo''' - Exibe o tipo da forma de pagamento. O tipo é uma Enum do sistema, usara para 'enumerar' as diferentes formar de pagamento que o sistema consegue tratar.
	** '''Colunas ~~Destinguíveis~~:'''		** '''Colunas Distinguíveis:'''
	*** '''Sub-Tipo''' - Essa coluna não existe ~~propriamente~~ no banco de dados. ~~Terá~~ a ~~função~~ de ~~exibir informações extras~~ de ~~alguns tipos~~ de ~~pagamentos. Cada tipo~~ de ~~pagamento tem sua própria coleção~~ de colunas ~~usadas~~ para ~~não misturar diferentes tipos~~ de ~~dados. No entanto para a tela vamos aproveitar a mesma coluna para não perder espaço com muitas colunas vazias~~. Sendo assim, essa coluna deve receber o conteúdo das seguintes colunas:		*** '''Sub-Tipo''' - Essa coluna não existe no banco de dados. Será criada a partir de valores de diferentes colunas dependendo da forma de pagamento, evitando de termos um monte de colunas que só serão usada para algumas formas de pagamentos. Sendo assim, essa coluna deve receber o conteúdo das seguintes colunas:
	***: Recomendo que no Bean, para transportar os valores, seja declarado como Object. Garantindo assim que qualquer valor possa ser definido, já que não teremos um tipo único.		***: Recomendo que no Bean, para transportar os valores, seja declarado como Object. Garantindo assim que qualquer valor possa ser definido, já que não teremos um tipo único. Como quando uma coluna está definida as outra obrigatoriamente são nulas, não é necessário se preocupar em verificar o tipo da forma de pagamento. Simplesmente verifique, se alguma das colunas não for nula use seu valor. Esse resultado pode obtido diretamente no SQL com a função ''coalesce()''. (Só não sei se é uma boa ideia para tratar os tipos de cada coluna, já que uma é Enum e outra String).
	**** '''Tipo do Convênio''' - ''contract_type'' - esta coluna só é populada quando o tipo do pagamento é convênio. Com uma Enum indicando se é de Clientes ou de Funcionários.		**** '''Tipo do Convênio''' - ''contract_type'' - esta coluna só é populada quando o tipo do pagamento é convênio. Com uma Enum indicando se é de Clientes ou de Funcionários.
	**** '''Rede Adquirente''' - ''tef_acquirernet'' - esta coluna só é populada quando o tipo de pagamento é TEF. Apresenta um valor em String recebida do sistema do TEF que indica qual foi a rede usada para a transação. Ex: 'Rede', 'Cielo' (ainda chamada de Visanet no sistema), 'GetNet', 'Elavon', etc.		**** '''Rede Adquirente''' - ''tef_acquirernet'' - esta coluna só é populada quando o tipo de pagamento é TEF. Apresenta um valor em String recebida do sistema do TEF que indica qual foi a rede usada para a transação. Ex: 'Rede', 'Cielo' (ainda chamada de Visanet no sistema), 'GetNet', 'Elavon', etc.
	*** '''~~Identificação~~''' - Coluna utilizada para exibir uma identificação do pagamento. Similar à coluna Sub-Tipo, esta coluna não existe no banco, e será utilizada para exibir o valor de diferentes colunas de acordo com o tipo de pagamento.		*** '''Nome''' - Coluna utilizada para exibir uma identificação do pagamento. Similar à coluna Sub-Tipo, esta coluna não existe no banco, e será utilizada para exibir o valor de diferentes colunas de acordo com o tipo de pagamento.
	**** '''Nome do Conveniado''' - ''contract_name'' - Quando o pagamento é Convênio, esta coluna apresenta o nome do convênio.		**** '''Nome do Conveniado''' - ''contract_name'' - Quando o pagamento é Convênio, esta coluna apresenta o nome do convênio.
	**** '''Bandeira do Cartão''' - ''tec_cardname'' - Quando o pagamento é TEF, esta coluna apresenta o nome retornado pelo sistema do TEF para indicar qual era a bandeira do cartão utilizado.		**** '''Bandeira do Cartão''' - ''tec_cardname'' - Quando o pagamento é TEF, esta coluna apresenta o nome retornado pelo sistema do TEF para indicar qual era a bandeira do cartão utilizado.
			** '''Colunas Adicionais:'''
			*** '''Contagem''' - Indica o total de registros que foram sumarizados.
			*** '''%Contagem''' - Indica a participação em relação à contagem total dos registros exibidos.
			*** '''Recebido''' - Indica o valor total recebido na forma de pagamento.
			*** '''%Recebido''' - Indica a participação em relação ao valor total recebido na forma de pagamento.

			* '''Registro Adicional''' -

Rodrigogml: /* por Categoria de Itens */

2015-09-24T21:40:04Z

por Categoria de Itens

@@ Linha 293: / Linha 293: @@
 {{nota|Criação dos Beans e IDs|Como o relatório é criado baseado em um objeto existente, o ItemCategoryVO, sugiro que o Bean que carregará todos copie as informações a serem utilizadas do ItemCategoryVO para ele. Como id, nome da categoria e tipo da categoria. Além dos outros campos que serão obtidos a partir do SQL de somatória de agrupamento do faturamento.
-Para a categoria a ser simulada dos "Sem Categoria", sugiro que jogue o id -1. Por ser um Long funciona normalmente nas telas e UIs, e com certeza não fará comflito com outros objetos.}}
+Para a categoria a ser simulada dos "Sem Categoria", sugiro que jogue o id -1. Por ser um Long funciona normalmente nas telas e UIs, e com certeza não fará conflito com outros objetos.}}
@@ Linha 301: / Linha 301: @@
 Os dados a serem gerados/calculados são a somatória dos itens filhos, que não são geradas pelo SQL e depois do total calculado, o calculo das porcentagens de participação.}}

Rodrigogml: /* Extrato de Consumos */

2015-09-18T21:55:29Z

Extrato de Consumos

← Edição anterior		Edição das 21h55min de 18 de setembro de 2015
Linha 87:		Linha 87:
	Para a geração do relatório, devem ser oferecidas as seguintes opções:		Para a geração do relatório, devem ser oferecidas as seguintes opções:
	* '''Filtros:'''		* '''Filtros:'''
	** '''por Período'''		** '''por Período''' - Filtrar por um período de datas. Não permitir um período maior que dois anos para evitar uma sobrecarga do sistema. Não permitir se a data inicial não for informada, e caso a final não seja informada, verificar se a inicial não é mais de dois anos atrás. A mesma validação está feita no "Consumos por Período", pode ser reutilizada.
	** '''por Convênio'''		** '''por Convênio''' - Filtrar pelo nome do convênio em um ComboBox.
	** '''por Tipo do Convênio'''		** '''por Tipo do Convênio''' - Filtrar pelos tipos de Convênios.

	{{nota\|Múltiplos Relatórios\|No caso em que um único convênio não for selecionado, a geração do relatório deve criar os relatórios de cada cliente como se fosse um relatório independente, reiniciando a contagem de páginas, etc. Similar ao que já é feito no "Consumos por ~~Periodo~~".}}
			{{nota\|Múltiplos Relatórios\|No caso em que um único convênio não for selecionado, a geração do relatório deve criar os relatórios de cada cliente como se fosse um relatório independente, reiniciando a contagem de páginas, etc. Similar ao que já é feito no "Consumos por Período".}}

	= InfoBoard =		= InfoBoard =

Rodrigogml: /* Extrato de Consumos */

2015-09-18T21:36:40Z

Extrato de Consumos

@@ Linha 48: / Linha 48: @@
 O Relatório "Extrato de Consumos" tem a finalidade de montar um extrato da movimentação do convênio, como se fosse um extrato bancário. Sua aparência e dados deve ser a mesma do relatório já existente (mas não documentado na wiki até o momento) "Consumos por Período".
-A diferença deste novo relatório para o anterior consiste apenas em dois itens:
+A diferença deste novo relatório para o anterior consiste no seguinte:
 * '''Linha de Saldo Anterior''' - No início do relatório deverá constar uma linha inicial com a data igual a data inicial do filtro escolhido pelo usuário e a seguinte descrição: "Saldo Anterior". Na coluna '''Total''' deverá apresentar o saldo anterior ao início do relatório.
 * '''Total Acumulado''' - O relatório já apresenta uma somatória de total acumulado ao final da linha de totalização. No entanto no relatório já existente o Total Acumulado começa em "0,00". Tanto que sempre o primeiro totalizador é igual ao total do primeiro cupom. Neste relatório extrato, o valor inicial deverá ser igual ao calculado para a linha de Saldo Anterior. Assim, o primeiro "Total Acumulado" a aparecer no relatório será o resultado da soma entre o "Saldo Anterior" e o total do primeiro cupom.
@@ Linha 70: / Linha 82: @@
 Embora a chance disso pareça remota de acontecer, as chances são muitas já que as telas de inclusão manual de pagamento incluem as data sempre com a "hora zero" do dia, e os filtros tendem a usar as mesmas horas quando a precisão é de apenas data (e mesmo nas de precisão de minutos, em caso de DateRage o horário padrão sugerido já é o próprio 0:00)}}
 = InfoBoard =

Rodrigogml: /* Relatórios */

2015-09-18T21:12:05Z

Relatórios

← Edição anterior		Edição das 21h12min de 18 de setembro de 2015
Linha 43:		Linha 43:

	= Relatórios =		= Relatórios =

			== Extrato de Consumos ==

			O Relatório "Extrato de Consumos" tem a finalidade de montar um extrato da movimentação do convênio, como se fosse um extrato bancário. Sua aparência e dados deve ser a mesma do relatório já existente (mas não documentado na wiki até o momento) "Consumos por Período".

			A diferença deste novo relatório para o anterior consiste apenas em dois itens:
			* '''Linha de Saldo Anterior''' - No início do relatório deverá constar uma linha inicial com a data igual a data inicial do filtro escolhido pelo usuário e a seguinte descrição: "Saldo Anterior". Na coluna '''Total''' deverá apresentar o saldo anterior ao início do relatório.
			* '''Total Acumulado''' - O relatório já apresenta uma somatória de total acumulado ao final da linha de totalização. No entanto no relatório já existente o Total Acumulado começa em "0,00". Tanto que sempre o primeiro totalizador é igual ao total do primeiro cupom. Neste relatório extrato, o valor inicial deverá ser igual ao calculado para a linha de Saldo Anterior. Assim, o primeiro "Total Acumulado" a aparecer no relatório será o resultado da soma entre o "Saldo Anterior" e o total do primeiro cupom.


			Para gerar o resultado do "Saldo Anterior" deve-se criar o método "findContractPreviousBalance(Long idContract, Date date)" no PDVContractDAO do módulo PDV. Este método recebe o ID do convênio e a data limite. Deve executar a consulta já com o conteúdo sumarizado conforme o seguinte SQL exemplo:

			<syntaxhighlight lang="sql">
			select
			sum(total)
			from pdv_contractstatement
			where idpdv_contract = 9
			and date < '2015-10-01 00:00:00';
			</syntaxhighlight>


			{{nota\|Saldo até a data limite, mas sem incluir!\|Quando o resultado para o relatório é consultado a data limite é incluída na busca, isto é, os dados para o relatório são os registros cuja data seja "maior ou igual" a data mínima.

			Por isso ao consultar o "Saldo Anterior" devemos tomar o cuidado de usar apenas o "menor". Evitando que registros possam ser incluídos tanto no "Saldo Anterior" como no corpo do relatório, causando uma diferença dos valores de "Total Acumulado" dependendo da data usada para fazer o filtro.

			Embora a chance disso pareça remota de acontecer, as chances são muitas já que as telas de inclusão manual de pagamento incluem as data sempre com a "hora zero" do dia, e os filtros tendem a usar as mesmas horas quando a precisão é de apenas data (e mesmo nas de precisão de minutos, em caso de DateRage o horário padrão sugerido já é o próprio 0:00)}}


			= InfoBoard =

	== Analítico ==		== Analítico ==