BISPDV - Histórico de revisão

Rodrigogml: /* Ciclo de Vida do Documento Fiscal no PDV */

2025-11-25T18:52:09Z

Ciclo de Vida do Documento Fiscal no PDV

← Edição anterior		Edição das 18h52min de 25 de novembro de 2025
Linha 122:		Linha 122:
	=== Ciclo de Vida do Documento Fiscal no PDV ===		=== Ciclo de Vida do Documento Fiscal no PDV ===

	O BISPDV utiliza o DocFiscalVO para controlar o ciclo de venda que está ocorrendo, e faz isso através do status definido no objeto.		O BISPDV utiliza o <code>DocFiscalVO</code> do [[Módulo Fiscal]] para controlar o ciclo de venda que está ocorrendo, e faz isso através do status definido no objeto.


			O ciclo de vida do <code>DocFiscalVO</code> pode ser conferido na sessão: [[Módulo_Fiscal#Ciclo_de_Vida_Documento_Fiscal\|Ciclo de Vida Documento Fiscal]].

	= Cadastros do Sistema =		= Cadastros do Sistema =

Rodrigogml: /* NFC-e */

2025-11-25T18:46:24Z

NFC-e

← Edição anterior		Edição das 18h46min de 25 de novembro de 2025
Linha 117:		Linha 117:
	== NFC-e ==		== NFC-e ==

	A emissão de NFCe é realizada pelo mesmo ~~site~~ da NFe. O BISPDV utilizará o módulo [https://wiki.rodrigogml.eng.br/index.php/P%C3%A1gina_principal#RFW_-_Sefaz RFW.SEFAZ]. Toda a documentação técnica estará no site do módulo. '''Concentrar aqui apenas as informações relacionadas ao BISPDV e à configuração/utilização do módulo'''.		A emissão de NFCe é realizada pelo mesmo layout de WebService da NFe. O BISPDV utilizará o módulo [https://wiki.rodrigogml.eng.br/index.php/P%C3%A1gina_principal#RFW_-_Sefaz RFW.SEFAZ]. Toda a documentação técnica estará no site do módulo. '''Concentrar aqui apenas as informações relacionadas ao BISPDV e à configuração/utilização do módulo'''.


			=== Ciclo de Vida do Documento Fiscal no PDV ===

			O BISPDV utiliza o DocFiscalVO para controlar o ciclo de venda que está ocorrendo, e faz isso através do status definido no objeto.

	= Cadastros do Sistema =		= Cadastros do Sistema =

Rodrigogml: /* Items */

2025-11-19T22:33:22Z

Items

← Edição anterior		Edição das 22h33min de 19 de novembro de 2025
Linha 134:		Linha 134:
	* O <code>ID</code> aplicado no <code>PDVItemVO</code> é o mesmo do <code>ItemCodeVO</code>, utilizado como referência para sincronizar os novos códigos ou alterações do servidor.		* O <code>ID</code> aplicado no <code>PDVItemVO</code> é o mesmo do <code>ItemCodeVO</code>, utilizado como referência para sincronizar os novos códigos ou alterações do servidor.
	* O <code>IDItem</code> é atribuído em outro atibuto, e é utilizado pelo servidor para associar o item do cupom (vendas) ao ItemVO correto. Essa medida visa não perder o relacionamento entre os objetos de Item de Documentos fiscais com o cadastro de item. Isso porque o objeto ItemCodeVO pode ser excluído do sistema, já o ItemVO é só marcado como excluído no sistema e mantido para efeitos de histório, ou seja, ItemCodeVO é um objeto volátil e não pode ser utilizado para referência ou vinculação com objetos de registro ou histórico.		* O <code>IDItem</code> é atribuído em outro atibuto, e é utilizado pelo servidor para associar o item do cupom (vendas) ao ItemVO correto. Essa medida visa não perder o relacionamento entre os objetos de Item de Documentos fiscais com o cadastro de item. Isso porque o objeto ItemCodeVO pode ser excluído do sistema, já o ItemVO é só marcado como excluído no sistema e mantido para efeitos de histório, ou seja, ItemCodeVO é um objeto volátil e não pode ser utilizado para referência ou vinculação com objetos de registro ou histórico.
	* O servidor passar no atributo <code>startDate</code> a última data de alteração do <code>ItemVO</code> (ou seus subojetos como <code>ItemCodeVO<code> ou <code>ItemPrice~~<code>~~</code>), para que o PDV saiba qual foi a última alteração dos objetos na sua base e, consultando a maior dessas datas entre todos os objetos, consegue utilizar essa data para requisitar os objetos alterados a partir dessadata (ao invés da data da última alteração, evitando problemas de sincronia de datas e deixar algum item dessincronizados).		* O servidor passar no atributo <code>startDate</code> a última data de alteração do <code>ItemVO</code> (ou seus subojetos como <code>ItemCodeVO</code> ou <code>ItemPrice</code>), para que o PDV saiba qual foi a última alteração dos objetos na sua base e, consultando a maior dessas datas entre todos os objetos, consegue utilizar essa data para requisitar os objetos alterados a partir dessadata (ao invés da data da última alteração, evitando problemas de sincronia de datas e deixar algum item dessincronizados).
	* Como a venda ocorre com base nas definições do <code>ItemCodeVO</code>, mas o sistema precisa vincular a venda com o <code>ItemVO</code>, os campos que definem a "transformação" entre <code>ItemVO</code> e <code>ItemCodeVO</code> são atribuídas no objeto nos seguintes atributos:		* Como a venda ocorre com base nas definições do <code>ItemCodeVO</code>, mas o sistema precisa vincular a venda com o <code>ItemVO</code>, os campos que definem a "transformação" entre <code>ItemVO</code> e <code>ItemCodeVO</code> são atribuídas no objeto nos seguintes atributos:
	:* '''originalItemID''' - ID do <code>ItemVO</code> para associação com o item original.		:* '''originalItemID''' - ID do <code>ItemVO</code> para associação com o item original.

Rodrigogml: /* Items */

2025-11-19T22:32:21Z

Items

← Edição anterior		Edição das 22h32min de 19 de novembro de 2025
Linha 134:		Linha 134:
	* O <code>ID</code> aplicado no <code>PDVItemVO</code> é o mesmo do <code>ItemCodeVO</code>, utilizado como referência para sincronizar os novos códigos ou alterações do servidor.		* O <code>ID</code> aplicado no <code>PDVItemVO</code> é o mesmo do <code>ItemCodeVO</code>, utilizado como referência para sincronizar os novos códigos ou alterações do servidor.
	* O <code>IDItem</code> é atribuído em outro atibuto, e é utilizado pelo servidor para associar o item do cupom (vendas) ao ItemVO correto. Essa medida visa não perder o relacionamento entre os objetos de Item de Documentos fiscais com o cadastro de item. Isso porque o objeto ItemCodeVO pode ser excluído do sistema, já o ItemVO é só marcado como excluído no sistema e mantido para efeitos de histório, ou seja, ItemCodeVO é um objeto volátil e não pode ser utilizado para referência ou vinculação com objetos de registro ou histórico.		* O <code>IDItem</code> é atribuído em outro atibuto, e é utilizado pelo servidor para associar o item do cupom (vendas) ao ItemVO correto. Essa medida visa não perder o relacionamento entre os objetos de Item de Documentos fiscais com o cadastro de item. Isso porque o objeto ItemCodeVO pode ser excluído do sistema, já o ItemVO é só marcado como excluído no sistema e mantido para efeitos de histório, ou seja, ItemCodeVO é um objeto volátil e não pode ser utilizado para referência ou vinculação com objetos de registro ou histórico.
	* a		* O servidor passar no atributo <code>startDate</code> a última data de alteração do <code>ItemVO</code> (ou seus subojetos como <code>ItemCodeVO<code> ou <code>ItemPrice<code></code>), para que o PDV saiba qual foi a última alteração dos objetos na sua base e, consultando a maior dessas datas entre todos os objetos, consegue utilizar essa data para requisitar os objetos alterados a partir dessadata (ao invés da data da última alteração, evitando problemas de sincronia de datas e deixar algum item dessincronizados).
			* Como a venda ocorre com base nas definições do <code>ItemCodeVO</code>, mas o sistema precisa vincular a venda com o <code>ItemVO</code>, os campos que definem a "transformação" entre <code>ItemVO</code> e <code>ItemCodeVO</code> são atribuídas no objeto nos seguintes atributos:
			:* '''originalItemID''' - ID do <code>ItemVO</code> para associação com o item original.
			:* '''originalDivider''' - Divisor de conversão

	= DOCUMENTAÇÃO A SER REVISADA! =		= DOCUMENTAÇÃO A SER REVISADA! =

Rodrigogml: /* DOCUMENTAÇÃO A SER REVISADA! */

2025-11-19T21:52:22Z

DOCUMENTAÇÃO A SER REVISADA!

← Edição anterior		Edição das 21h52min de 19 de novembro de 2025
Linha 118:		Linha 118:

	A emissão de NFCe é realizada pelo mesmo site da NFe. O BISPDV utilizará o módulo [https://wiki.rodrigogml.eng.br/index.php/P%C3%A1gina_principal#RFW_-_Sefaz RFW.SEFAZ]. Toda a documentação técnica estará no site do módulo. '''Concentrar aqui apenas as informações relacionadas ao BISPDV e à configuração/utilização do módulo'''.		A emissão de NFCe é realizada pelo mesmo site da NFe. O BISPDV utilizará o módulo [https://wiki.rodrigogml.eng.br/index.php/P%C3%A1gina_principal#RFW_-_Sefaz RFW.SEFAZ]. Toda a documentação técnica estará no site do módulo. '''Concentrar aqui apenas as informações relacionadas ao BISPDV e à configuração/utilização do módulo'''.



			= Cadastros do Sistema =

			== Items ==

			A aplicação BISPDV não suporta cadastro de itens diretamente no aplicativo. A base de itens para venda é sincronizada diretamente do servidor para a aplicação.


			Para a aplicação é enviada apenas apenas os campos do cadastro de itens necessários para realizar a venda do produto, um objeto <code>PDVItemVO</code> é montado com as informações da estrutura de <code>ItemVO</code>.

			A conversão é feita a partir do <code>ItemCodeVO</code> e não de <code>ItemVO</code>. Isso porque cada código de item pode ser vendido por preços diferentes, quantidades diferentes, unidades de medidas diferentes entre outros. Para o BISPDV cada código funciona como um produto cadastro diferente que pode ser vendido. Já no servidor, a venda de cada código é tratada como uma venda do mesmo item (respeitando a quantidade, preços, etc.). A conversão/envio dos códigos para venda no PDV é realizada da seguinte forma:
			* Apenas produtos que tenham a finalidade marcada como '''Revenda''' ou '''Produto Acabado''' tem seus códigos sincronizados no PDV.
			* O <code>ID</code> aplicado no <code>PDVItemVO</code> é o mesmo do <code>ItemCodeVO</code>, utilizado como referência para sincronizar os novos códigos ou alterações do servidor.
			* O <code>IDItem</code> é atribuído em outro atibuto, e é utilizado pelo servidor para associar o item do cupom (vendas) ao ItemVO correto. Essa medida visa não perder o relacionamento entre os objetos de Item de Documentos fiscais com o cadastro de item. Isso porque o objeto ItemCodeVO pode ser excluído do sistema, já o ItemVO é só marcado como excluído no sistema e mantido para efeitos de histório, ou seja, ItemCodeVO é um objeto volátil e não pode ser utilizado para referência ou vinculação com objetos de registro ou histórico.
			* a

Rodrigogml: /* Pendências, Informações e Guia sobre a implementação */

2025-11-08T14:33:12Z

Pendências, Informações e Guia sobre a implementação

← Edição anterior		Edição das 14h33min de 8 de novembro de 2025
Linha 3:		Linha 3:

	= Pendências, Informações e Guia sobre a implementação =		= Pendências, Informações e Guia sobre a implementação =

			* O projeto anterior (bis2.pdv) está sendo descontinuado por ainda ter código com suporte a ECF e SAT, que estão em caindo em desuso. Para rever e simplificar o código um novo projeto (bis.pdv) foi criado e o código está sendo revisado e repassado para o novo projeto. Uma vez concluído o projeto bis2.pdv será descontinuado.

			'''Alterações em andamento:'''
	# Para agilidade, foi definido que não utilizaremos o RFWDAO, mas manter a arquitetura de DAO original.		# Para agilidade, foi definido que não utilizaremos o RFWDAO, mas manter a arquitetura de DAO original.
	# Removido código relacionados ao ECF e ao SAT, este novo projeto emitirá cupons apenas utilizando o NFCe, utilizando o código do módulo RFW.SEFAZ.		# Removido código relacionados ao ECF e ao SAT, este novo projeto emitirá cupons apenas utilizando o NFCe, utilizando o código do módulo RFW.SEFAZ.

Rodrigogml: /* Pendências da implementação */

2025-11-08T14:31:28Z

Pendências da implementação

← Edição anterior		Edição das 14h31min de 8 de novembro de 2025
Linha 2:		Linha 2:


	= Pendências da implementação =		= Pendências, Informações e Guia sobre a implementação =
	# Para agilidade, foi definido que não utilizaremos o RFWDAO, mas manter a arquitetura de DAO original.		# Para agilidade, foi definido que não utilizaremos o RFWDAO, mas manter a arquitetura de DAO original.
	# Removido código relacionados ao ECF e ao SAT, este novo projeto emitirá cupons apenas utilizando o NFCe, utilizando o código do módulo RFW.SEFAZ.		# Removido código relacionados ao ECF e ao SAT, este novo projeto emitirá cupons apenas utilizando o NFCe, utilizando o código do módulo RFW.SEFAZ.
	# O Bundle foi rebatizado para bispdvbundle.properties, e passou a utilizar as chaves BISPDV_NNNNNN. Todas as chaves antigas foram copiadas para o arquivo e ao fechamento da versão devem ser revisadas, e as sobreviventes renomeadas.		# O Bundle foi rebatizado para bispdvbundle.properties, e passou a utilizar as chaves BISPDV_NNNNNN. Todas as chaves antigas foram copiadas para o arquivo e ao fechamento da versão devem ser revisadas, e as sobreviventes renomeadas.


	= Inicialização do Sistema =		= Inicialização do Sistema =

Rodrigogml: /* Inicialização do Sistema */

2025-11-08T14:31:09Z

Inicialização do Sistema

← Edição anterior		Edição das 14h31min de 8 de novembro de 2025
Linha 1:		Linha 1:
	O BISPDV é a aplicação utilizada na frente de caixa para realização da venda ao consumidor e de outra funções pertinentes à venda e atendimento do cliente da loja.		O BISPDV é a aplicação utilizada na frente de caixa para realização da venda ao consumidor e de outra funções pertinentes à venda e atendimento do cliente da loja.


			= Pendências da implementação =
			# Para agilidade, foi definido que não utilizaremos o RFWDAO, mas manter a arquitetura de DAO original.
			# Removido código relacionados ao ECF e ao SAT, este novo projeto emitirá cupons apenas utilizando o NFCe, utilizando o código do módulo RFW.SEFAZ.
			# O Bundle foi rebatizado para bispdvbundle.properties, e passou a utilizar as chaves BISPDV_NNNNNN. Todas as chaves antigas foram copiadas para o arquivo e ao fechamento da versão devem ser revisadas, e as sobreviventes renomeadas.

Rodrigogml: /* Inicialização: StartCheckStatus */

2025-11-08T13:41:35Z

Inicialização: StartCheckStatus

← Edição anterior		Edição das 13h41min de 8 de novembro de 2025
Linha 92:		Linha 92:
	*: Se o cadastro estiver OK passa para '''LOAD_CHECKOUT_DATA''', caso contrário trava a aplicação em erro para garantir que seja reinstalada.		*: Se o cadastro estiver OK passa para '''LOAD_CHECKOUT_DATA''', caso contrário trava a aplicação em erro para garantir que seja reinstalada.

	* '''LOAD_CHECKOUT_DATA''' - Carrega as informações do ~~checkout~~, se ~~tiver persistido~~, ou se ~~encontrar~~ no banco de dados ~~algum~~ checkout aberto.		* '''LOAD_CHECKOUT_DATA''' - Carrega as informações do CheckoutData, se existir, para continuar com a aplicação a partir do ponto em que estava. Se não encontrar, procura manualmente se há algum caixa em aberto no banco de dados e "cria" o CheckoutData para continuar o checkout aberto (e não perder sessões de checkouts a cada vez que se perde o CheckoutData). '''Em adicional''', (re)carrega o CFSystem para que o sistema esteja pronto para emitir cupons fiscais.
	*: Passa para o '''START_SYNCDATA'''.		*: Passa para o '''START_SYNCDATA'''.

Rodrigogml: /* DOCUMENTAÇÃO A SER REVISADA! */

2025-11-07T21:17:57Z

DOCUMENTAÇÃO A SER REVISADA!

← Edição anterior		Edição das 21h17min de 7 de novembro de 2025
Linha 103:		Linha 103:
	== PDVUI ==		== PDVUI ==




			== NFC-e ==

			A emissão de NFCe é realizada pelo mesmo site da NFe. O BISPDV utilizará o módulo [https://wiki.rodrigogml.eng.br/index.php/P%C3%A1gina_principal#RFW_-_Sefaz RFW.SEFAZ]. Toda a documentação técnica estará no site do módulo. '''Concentrar aqui apenas as informações relacionadas ao BISPDV e à configuração/utilização do módulo'''.