CashFlow - Histórico de revisão

Rodrigogml: /* Contas Financeiras */

2019-05-04T20:00:06Z

Contas Financeiras

← Edição anterior		Edição das 20h00min de 4 de maio de 2019
Linha 2:		Linha 2:

	== Requisitos ==		== Requisitos ==

	~~=== Contas Financeiras ===~~

	O sistema deve gerenciar um cadastro de "Contas Financeiras" (CashFlowAccountVO). Essas contas tem a finalidade de organizar os fluxos de caixas da empresa. Seja uma conta bancária, uma conta de "caixa local", uma conta de investimentos/poupança, etc.
	~~# Tipos de Contas:~~
	~~## Contas Bancárias - são usadas para gerenciar as contas correntes da empresa em bancos e tem os seguintes requisitos:~~
	~~### devem ter o número do banco (número do banco deve ser associado ao BISBankVO), agência e conta corrente definidos obrigatoriamente.~~
	~~### permitem a definição dos dados da PJ da agência (associando um PersonVO), incluindo o CNPJ, endereço, contato (gerente), etc.~~
	## Caixa Local - usada para gerenciar as contas/caixas da empresa. Como o caixa principal, um caixa menor de responsabilidade do almoxarifado para pagamento de entregas a vista, um caixa de responsabilidade do RH para pequenos pagamentos e acertos, etc.
	# As contas devem ter um estado que defina a conta entre Ativa/Encerrada. O estado encerrado deveria ser como o estado excluído, e em UIs não deviam exibir as contas encerradas por padrão (sempre ter opção para exibi-las caso o usuário deseje). As contas não podem ser excluídas para que não se perca o histórico de movimentação da empresa. No entanto as contas encerradas devem de certa forma ser "invisíveis" durante a operação do sistema para não poluir nem confundir os usuários.
	# A conta só pode ser encerrada se tiver o saldo zerado! Sugira que o usuário transfira o saldo para outra conta ou faça um lançamento de ajuste caso o saldo esteja errado. Ninguém encerra uma conta, seja bancária ou local e joga fora o saldo.
	# Toda conta deve ser associada à uma empresa, já que filiais e empresas diferentes tem contas separadas. Para simplificar a geração de relatórios e orientar as informações financeiras da administração.
	~~# Toda conta deve ter o nome único, ou seja, não podem existir duas contas com o mesmo nome no sistema.~~

	=== Folhas de Cheque ===		=== Folhas de Cheque ===

Rodrigogml: /* Validações */

2015-06-08T16:05:43Z

Validações

← Edição anterior		Edição das 16h05min de 8 de junho de 2015
Linha 393:		Linha 393:
	*** Se '''Segumento''' = 5 (Órgãos Governamentais) e '''Órgão''' = "0179" (FGTS) ou = "0239" (FGTS Rescisório):		*** Se '''Segumento''' = 5 (Órgãos Governamentais) e '''Órgão''' = "0179" (FGTS) ou = "0239" (FGTS Rescisório):
	**** Validar se '''Vencmento''' é dia útil. Sendo dia útil neste caso de Segunda à Sexta e não feriados Municipais, Estaduais ou Federais. Caso não seja útil indicar a mensagem de que Guias de FGTS com vencimento em dia não útil deve ser apaga no dia útil '''ANTERIOR'''!		**** Validar se '''Vencmento''' é dia útil. Sendo dia útil neste caso de Segunda à Sexta e não feriados Municipais, Estaduais ou Federais. Caso não seja útil indicar a mensagem de que Guias de FGTS com vencimento em dia não útil deve ser apaga no dia útil '''ANTERIOR'''!
	****; ''Implementar apenas a validação de dia útil da semana''. A implementação de dia ser feriado ficará para o futuro, provavelmente com algum serviço do BIS que oriente os feriados.''		****: ''Implementar apenas a validação de dia útil da semana. A implementação de dia ser feriado ficará para o futuro, provavelmente com algum serviço do BIS que oriente os feriados.''
	** Se '''paykind''' = '''boletos''':		** Se '''paykind''' = '''boletos''':
	*** Validar se '''Favorecido''' está associado.		*** Validar se '''Favorecido''' está associado.
Linha 419:		Linha 419:
	*** Validar se '''Valor total''' = '''Valor do INSS''' + '''Valor de Outras Entidades''' + '''ATM/Multa Juros'''.		*** Validar se '''Valor total''' = '''Valor do INSS''' + '''Valor de Outras Entidades''' + '''ATM/Multa Juros'''.
	*** Validar se '''Vencmento''' é dia útil. Sendo dia útil neste caso de Segunda à Sexta e não feriados Municipais, Estaduais ou Federais. Caso não seja útil indicar a mensagem de que GPS com vencimento em dia não útil deve ser apaga no dia útil '''ANTERIOR'''!		*** Validar se '''Vencmento''' é dia útil. Sendo dia útil neste caso de Segunda à Sexta e não feriados Municipais, Estaduais ou Federais. Caso não seja útil indicar a mensagem de que GPS com vencimento em dia não útil deve ser apaga no dia útil '''ANTERIOR'''!
	***; ''Implementar apenas a validação de dia útil da semana''. A implementação de dia ser feriado ficará para o futuro, provavelmente com algum serviço do BIS que oriente os feriados.''		***; ''Implementar apenas a validação de dia útil da semana. A implementação de dia ser feriado ficará para o futuro, provavelmente com algum serviço do BIS que oriente os feriados.''
	** Se '''paykind''' = '''CHECK''':		** Se '''paykind''' = '''CHECK''':
	*** Valida se a '''folha de cheque''' associada não está em uso por outro lançamento já existente.		*** Valida se a '''folha de cheque''' associada não está em uso por outro lançamento já existente.

Rodrigogml: /* CashFlowStatement */

2015-06-08T16:03:48Z

CashFlowStatement

← Edição anterior		Edição das 16h03min de 8 de junho de 2015
Linha 391:		Linha 391:
	*** Validar se '''valor original''' é igual ao valor existente no código de barras, quando o código de barras contiver essa informação.		*** Validar se '''valor original''' é igual ao valor existente no código de barras, quando o código de barras contiver essa informação.
	***: ''Caso o boleto tenha um valor no seu código de barras, o valor deve ser mantido no campo '''valor original''' e impedir alterações. Isso porque ao enviar o boleto para pagamento por malote eletrônico a instituição pode contrastar as informações e não executar o pagamento.''		***: ''Caso o boleto tenha um valor no seu código de barras, o valor deve ser mantido no campo '''valor original''' e impedir alterações. Isso porque ao enviar o boleto para pagamento por malote eletrônico a instituição pode contrastar as informações e não executar o pagamento.''
			*** Se '''Segumento''' = 5 (Órgãos Governamentais) e '''Órgão''' = "0179" (FGTS) ou = "0239" (FGTS Rescisório):
			**** Validar se '''Vencmento''' é dia útil. Sendo dia útil neste caso de Segunda à Sexta e não feriados Municipais, Estaduais ou Federais. Caso não seja útil indicar a mensagem de que Guias de FGTS com vencimento em dia não útil deve ser apaga no dia útil '''ANTERIOR'''!
			****; ''Implementar apenas a validação de dia útil da semana''. A implementação de dia ser feriado ficará para o futuro, provavelmente com algum serviço do BIS que oriente os feriados.''
	** Se '''paykind''' = '''boletos''':		** Se '''paykind''' = '''boletos''':
	*** Validar se '''Favorecido''' está associado.		*** Validar se '''Favorecido''' está associado.
Linha 415:		Linha 418:
	***: ''Todas as datas do GPS devem ser dia 1 do mês da competência. Só para a competência do 13° é que usaremos a data 31/12. Assim: 1/12/AAAA representa a competência '12/AAAA' e 31/13/AAAA representa a competência '13/AAAA'.''		***: ''Todas as datas do GPS devem ser dia 1 do mês da competência. Só para a competência do 13° é que usaremos a data 31/12. Assim: 1/12/AAAA representa a competência '12/AAAA' e 31/13/AAAA representa a competência '13/AAAA'.''
	*** Validar se '''Valor total''' = '''Valor do INSS''' + '''Valor de Outras Entidades''' + '''ATM/Multa Juros'''.		*** Validar se '''Valor total''' = '''Valor do INSS''' + '''Valor de Outras Entidades''' + '''ATM/Multa Juros'''.
			*** Validar se '''Vencmento''' é dia útil. Sendo dia útil neste caso de Segunda à Sexta e não feriados Municipais, Estaduais ou Federais. Caso não seja útil indicar a mensagem de que GPS com vencimento em dia não útil deve ser apaga no dia útil '''ANTERIOR'''!
			***; ''Implementar apenas a validação de dia útil da semana''. A implementação de dia ser feriado ficará para o futuro, provavelmente com algum serviço do BIS que oriente os feriados.''
	** Se '''paykind''' = '''CHECK''':		** Se '''paykind''' = '''CHECK''':
	*** Valida se a '''folha de cheque''' associada não está em uso por outro lançamento já existente.		*** Valida se a '''folha de cheque''' associada não está em uso por outro lançamento já existente.

Rodrigogml: /* CashFlowStatement */

2015-06-03T22:39:07Z

CashFlowStatement

← Edição anterior		Edição das 22h39min de 3 de junho de 2015
Linha 373:		Linha 373:
	=== CashFlowStatement ===		=== CashFlowStatement ===

			* Valida se o '''favorecido''' foi informado. Cadastra-lo caso seja novo, permitindo que o Core possa valida-lo.
	* Valida se '''categoria''' foi definida		* Valida se '''categoria''' foi definida
	** Valida se a '''categoria''' definida tem permissão de receber lançamentos.		** Valida se a '''categoria''' definida tem permissão de receber lançamentos.
Linha 418:		Linha 419:
	*** Valida se a '''folha de cheque''' associada não está em uso em mais de uma parcela deste pagamento.		*** Valida se a '''folha de cheque''' associada não está em uso em mais de uma parcela deste pagamento.
	** Se '''paykind''' = '''DEPOSIT''':		** Se '''paykind''' = '''DEPOSIT''':
	*** Valida se o '''favorecido''' foi informado. Cadastra-lo caso seja novo para o Core valida-lo.
	*** Valida se os '''dados bancários''' informados não pertencem à outro '''favorecido'''.		*** Valida se os '''dados bancários''' informados não pertencem à outro '''favorecido'''.
			**** Se os '''dados bancários''' não pertencem a outro '''favorecido''', cadastra-lo ao favorecido atual.

Rodrigogml: /* Lançamento Manual */

2015-06-03T22:09:19Z

Lançamento Manual

← Edição anterior		Edição das 22h09min de 3 de junho de 2015
Linha 562:		Linha 562:
	***:[[Image:LancarDebitoManualFatCheque.png\|center\|link=\|framed\|Forma de Pagamento: Cheque]]		***:[[Image:LancarDebitoManualFatCheque.png\|center\|link=\|framed\|Forma de Pagamento: Cheque]]
	*** '''Depósito''' Esta opção define no VO o valor PAYKIND.DEPOSIT. Devendo solicitar os campos '''Data de Vencimento''', '''Data de Pagamento''', '''Valor''' e '''Dados Bancários de Destino'''.		*** '''Depósito''' Esta opção define no VO o valor PAYKIND.DEPOSIT. Devendo solicitar os campos '''Data de Vencimento''', '''Data de Pagamento''', '''Valor''' e '''Dados Bancários de Destino'''.
	**** '''~~Dados Bancários~~ de ~~Destino~~''' ~~Este é um combo que exibe as informações bancárias do PersonVO definido no campo~~ '''~~Favorecido~~'''~~. Caso nenhum favorecido tenha sido selecionado este campo deve ficar desabilitado.~~ '''~~Em sua caixa de ajuda popup deve constar que para selecionar os dados bancários é necessário escolher o Favorecido~~.		**** '''Banco:''' Campo para entrada/escolha da instituição financeira de destino.
	***** Associado ao campo de escolha ~~há um botão~~ de ~~"+"~~. ~~Este botão permite que~~ o ~~usuário adicione uma nova informação bancária~~ para ~~o Favorecido~~ selecionado. (A ser ~~melhor~~ definido ~~ainda)~~		**** '''Agência:''' Agência da conta bancária de destino.
			**** '''Conta Corrente:''' Conta corrente do destinatário.
			**** '''Botão Procurar:''' O botão procurar abre uma tela de [[PersonBankDataPicker]] para escolha da conta corrente de destino.
			****: Caso o Favorecido já esteja preenchido na tela de lançamento, defini-lo também no [[PersonBankDataPicker]] para que ele só exiba os dados bancários do favorecido selecionado. Caso o favorecido do lançamento esteja desabilitado (impedido de ser trocado), configurar o DataPicker para também desabilitar o campo de filtro do favorecido para o usuário não possa troca-lo. Caso nenhum favorecido esteja definido no lançamento atualmente, não informar nenhum favorecido para o DataPicker, no entanto, ao confirmar o valor do DataPicker definir o favorecido do lançamento igual ao favorecido da conta recebido do DataPicker.
	***:[[Image:LancarDebitoManualFatDeposito.png\|center\|link=\|framed\|Forma de Pagamento: Depósito]]		***:[[Image:LancarDebitoManualFatDeposito.png\|center\|link=\|framed\|Forma de Pagamento: Depósito]]
	*** '''Boleto Bancário''' Esta forma de pagamento solicita os campos '''Código de Barras / Linha Digitável''', '''Data de Vencimento''', '''Data de Pagamento''' e '''Valor'''. Nesta forma de pagamento o Boleto o código do boleto é solicitado antes dos outros campos para induzir o usuário a informa-lo primeiro, já que a partir desta informação podemos definir o vencimento e valor.		*** '''Boleto Bancário''' Esta forma de pagamento solicita os campos '''Código de Barras / Linha Digitável''', '''Data de Vencimento''', '''Data de Pagamento''' e '''Valor'''. Nesta forma de pagamento o Boleto o código do boleto é solicitado antes dos outros campos para induzir o usuário a informa-lo primeiro, já que a partir desta informação podemos definir o vencimento e valor.

Rodrigogml: /* BankSlipDataBean completeBankSlipData(BankSlipDataBean bean, String bankcode) throws BISException */

2015-06-01T19:56:15Z

BankSlipDataBean completeBankSlipData(BankSlipDataBean bean, String bankcode) throws BISException

← Edição anterior		Edição das 19h56min de 1 de junho de 2015
Linha 475:		Linha 475:
	Toda a informação adicional que for possível extrair deverá ser completada no Bean e retornado.		Toda a informação adicional que for possível extrair deverá ser completada no Bean e retornado.


			{{stop\|Verificação do Código de Barras\|Ao escrever a implementação deste método para cada banco procure validar as informações específicas de cada banco.

			Por exemplo:
			* caso dentro do campo livre o banco use DVs próprios para validar seus próprios campos, implemente a mesma validação para garantir que o código de barras que você está interpretando tem o layout exato que você espera;
			* caso dentro do campo livre o banco especifique a codificação de "Carteiras", verifique se a carteira passada é conhecida, caso contrário não extraia os dados. Em geral carteiras diferentes tem layouts diferentes por terem finalidades diferentes e informações diferentes.

			Uma interpretação errada do código de barras poderá fazer com que o BIS comece a gerar dados bancários inválidos para o PersonVO e depois será difícil de corrigi-los misturados com os dados corretos.}}

	=== Factory BankDirectionFactory - br.com.biserp.bismodules.cashflow.bankdirection.BankDirectionFactory ===		=== Factory BankDirectionFactory - br.com.biserp.bismodules.cashflow.bankdirection.BankDirectionFactory ===

Rodrigogml: /* Lançar Débito Financeiro */

2015-06-01T18:40:30Z

Lançar Débito Financeiro

← Edição anterior		Edição das 18h40min de 1 de junho de 2015
Linha 508:		Linha 508:

	=== Lançar Débito Financeiro ===		=== Lançar Débito Financeiro ===


			{{stop\|Component CashFlowDebitComponent\|Todo o conteúdo descrito nesta sessão deve ser criado dentro de um componente chamado '''CashFlowDebitComponent'''. Para permitir a reutilização do conteúdo desta tela em outras telas distintas.
			O mesmo conteúdo de criar um novo lançamento será usado na tela de gerenciamento das contas, de gerenciamento de contas futuras, lançamento rápido, etc..

			A criação da janela popup como sugerida nos screenshots pode ser feita para fins de testes de desenvolvimento já as telas que utilizarão este componente ainda não foram total definidas.
			}}


	O sistema deve ter uma tela de entrada de débito financeiro. Essa tela basicamente lançar as "contas á pagar", só não chamamos de Contas à Pagar para evitar confusão, afinal contas à pagar são as contas que ainda não foram pagas, e a tela permite o lançamento de contas já pagas.		O sistema deve ter uma tela de entrada de débito financeiro. Essa tela basicamente lançar as "contas á pagar", só não chamamos de Contas à Pagar para evitar confusão, afinal contas à pagar são as contas que ainda não foram pagas, e a tela permite o lançamento de contas já pagas.

Rodrigogml: /* BankDirections */

2015-06-01T18:08:42Z

BankDirections

@@ Linha 436: / Linha 436: @@
 == BankDirections ==
-Esta mesma interface será usada para qualquer serviço bancário a ser implementado no futuro como geração de instruções de cobrança (Boletos), ou geração de instrução para pagamentos de salários, etc.
+BankDirections é uma "serviço" que permite a abstração e implementação de classes com as funções específicas de cada banco. O BankDirections é composto por 3 componentes descritos abaixo:
-=== '''byte[] createBankPaymentDirectionFile(Lond idaccount, List<Long> idstatementinstallmentlist) throws BISException''' ===
+==== '''byte[] createBankPaymentDirectionFile(Lond idaccount, List<Long> idstatementinstallmentlist) throws BISException''' ====
 <pre>
@@ Linha 457: / Linha 465: @@
 # Caso algum dos métodos não seja suportado pela implementação do banco, uma exceção deve ser lançada.
-=== '''BankSlipDataBean completeBankSlipData(BankSlipDataBean bean, String bankcode) throws BISException''' ===
+==== '''BankSlipDataBean completeBankSlipData(BankSlipDataBean bean, String bankcode) throws BISException''' ====
 <pre>
@@ Linha 466: / Linha 474: @@
 Este método recebe um objeto já parcialmente completado com as informações padrões da guia e a parte do código de barras que é de uso da privado da instituição. Desse código é possível extrair algumas outras informações úteis da guia/boleto que podem otimizar o uso para o usuário.
 Toda a informação adicional que for possível extrair deverá ser completada no Bean e retornado.
 == UI Vaadin ==

Rodrigogml: /* CashFlowStatement */

2015-06-01T16:10:13Z

CashFlowStatement

Rodrigogml: /* CashFlowStatement */

2015-05-31T22:52:11Z

CashFlowStatement

← Edição anterior		Edição das 22h52min de 31 de maio de 2015
Linha 421:		Linha 421:
	** Valida se '''conta de destino''' foi definida		** Valida se '''conta de destino''' foi definida
	** Valida se '''conta de origem''' foi definida		** Valida se '''conta de origem''' foi definida


			* Se '''documentos''' anexados
			** Se '''documento''' é NFe
			*** Validar se NFe não está associada à nenhum outro lançamento.

	== BankDirections ==		== BankDirections ==

← Edição anterior		Edição das 16h10min de 1 de junho de 2015
Linha 387:		Linha 387:
	*** Validar se '''código de barras''' é único em relação aos objetos do banco e às parcelas deste objeto.		*** Validar se '''código de barras''' é único em relação aos objetos do banco e às parcelas deste objeto.
	*** Validar se '''código de barras''' de todas as parcelas pertencem ao mesmo favorecido. Utilizar o campo 06 "Identificação do Órgão/Empresa", descrito [[Especificação_de_Guias_e_Boletos#C.C3.B3digo_de_Barras_de_Arrecada.C3.A7.C3.A3o\|aqui]].		*** Validar se '''código de barras''' de todas as parcelas pertencem ao mesmo favorecido. Utilizar o campo 06 "Identificação do Órgão/Empresa", descrito [[Especificação_de_Guias_e_Boletos#C.C3.B3digo_de_Barras_de_Arrecada.C3.A7.C3.A3o\|aqui]].
			*** Verificar se a Identificação do Órgão/Empresa e Segmento não for conhecida de acordo com esta [[Especificação_de_Guias_e_Boletos#Lista_de_Identifica.C3.A7.C3.B5es_Conhecidas\|tabela]], fazer um log de ''Warning'' para avisar os desenvolvedores de um novo tipo de boleto encontrado no cliente, aumentando a base de conhecimento e possíveis melhorias futuras. Incluir no Log o código de barras completo e a descrição usada pelo usuário para identificar o lançamento. '''Não lançar validação, pois o não conhecimento da empresa/órgão até o momento não atrapalha o funcionamento do sistema.'''
			*** Validar se '''valor original''' é igual ao valor existente no código de barras, quando o código de barras contiver essa informação.
			***: ''Caso o boleto tenha um valor no seu código de barras, o valor deve ser mantido no campo '''valor original''' e impedir alterações. Isso porque ao enviar o boleto para pagamento por malote eletrônico a instituição pode contrastar as informações e não executar o pagamento.''
	** Se '''paykind''' = '''boletos''':		** Se '''paykind''' = '''boletos''':
	*** Validar se '''Favorecido''' está associado.		*** Validar se '''Favorecido''' está associado.
	***: ''Se temos algum novo, caso PersonVO sem ID, tentar inseri-lo para que o Core faça sua validação.		***: ''Se temos algum novo, caso PersonVO sem ID, tentar inseri-lo para que o Core faça sua validação.
	*** Validar se '''código de barras''' + '''vencimento''' é único em relação aos objetos do banco e às parcelas deste objeto.		*** Validar se '''código de barras''' + '''vencimento''' + '''valor final''' é único em relação aos objetos do banco e às parcelas deste objeto.
	***: ''Como alguns boletos não tem data de vencimento nem valor no código de barras, o mesmo código pode se repetir mensalmente para dívidas mensais, como cartões de crédito e outros prestadores de serviços.''		***: ''Como alguns boletos não tem data de vencimento nem valor no código de barras, o mesmo código pode se repetir mensalmente para dívidas mensais, como cartões de crédito e outros prestadores de serviços.''
	*** Validar se '''Dados bancários''' extraídos do código de barras de todas as parcelas, não pertencem à outro favorecido.		*** Validar se '''Dados bancários''' extraídos do código de barras de todas as parcelas, não pertencem à outro favorecido.
	***: ''Caso ainda não sejam conhecidas, se preparar para associar e salvar no banco os novos dados associados à este favorecido.''		***: ''Caso ainda não sejam conhecidas, se preparar para associar e salvar no banco os novos dados associados à este favorecido.''
	*** Validar se '''Valor total''' = '''Valor Original''' + '''Multas/ Acréscimos''' - '''Descontos'''.		*** Validar se '''Valor total''' = '''Valor Original''' + '''Multas/ Acréscimos''' - '''Descontos'''.
			*** Validar se '''valor original''' é igual ao valor existente no código de barras, quando o código de barras contiver essa informação.
			***: ''Caso o boleto tenha um valor no seu código de barras, o valor deve ser mantido no campo '''valor original''' e impedir alterações. Isso porque ao enviar o boleto para pagamento por malote eletrônico a instituição pode contrastar as informações e não executar o pagamento.''
	** Se '''paykind''' = '''DARF''':		** Se '''paykind''' = '''DARF''':
	*** Validar se quantidade de '''parcelas''' é = 1		*** Validar se quantidade de '''parcelas''' é = 1
	***: ''DARF não suporta múltiplas parcelas.''		***: ''DARF não suporta múltiplas parcelas.''
	*** Validar se '''vencimento''' + '''valor''' + '''código da receita''' + '''número referência''' é único em relação aos objetos do banco.		*** Validar se '''vencimento''' + '''valor''' + '''código da receita''' + '''número referência''' é único em relação aos objetos do banco.
			*** Validar se o campo '''cpfcnpj''' contém um CNPJ válido. Não aceita CPF.
			**** Validar se o CNPJ informado em '''cpfcnpj''' é o mesmo do '''companyvo''', caso o '''companyvo''' tenha um CNPJ cadastrado.
			**** ''Uma empresa não deve pagar guias de outras empresas ou contas particulares de PF.''
	** Se '''paykind''' = '''GPS''':		** Se '''paykind''' = '''GPS''':
	*** Validar se quantidade de '''parcelas''' é = 1		*** Validar se quantidade de '''parcelas''' é = 1