UC00001 - Cadastro de cliente

De Wiki Java - Interno
(Diferença entre revisões)
Ir para: navegação, pesquisa
(→‎Ficha cadastral pessoa física)
(→‎Ficha cadastral pessoa física)
Linha 435: Linha 435:
 
  || || Vazio ||
 
  || || Vazio ||
 
|-style="background-color:#DCDCDC"
 
|-style="background-color:#DCDCDC"
−
|Período de vigência || Sim || Input || Data || || Vazio || Dara inicial e final da vigência das alíquotas.
+
| Identidade || Não || Input || Data || || Vazio || Dara inicial e final da vigência das alíquotas.
 
|-
 
|-
 
|Chave || Sim || Input || Alfanuméricos || 25 || Vazio || O campo no banco terá o tamanho de 25, mas na tela o sistema deverá permitir que o usuário informe '''somente 6 caracteres'''.
 
|Chave || Sim || Input || Alfanuméricos || 25 || Vazio || O campo no banco terá o tamanho de 25, mas na tela o sistema deverá permitir que o usuário informe '''somente 6 caracteres'''.

Edição das 10h37min de 6 de abril de 2015

Conteúdo

Objetivo

  • Manter cadastro de clientes.

Atores

  • Usuário

Pré-requisitos

  • Considerar documento Padrões de desenvolvimento.
  • No projeto da rotina, em confsrc > META-INF > messages > view.properties definir o nome como Cadastro de cliente. Este nome será utilizado para criar a página no Wiki.
  • Gerar log/auditoria para as alterações realizadas na rotina.

Resultado esperado

  • Cadastrar clientes no sistema.

Diagrama de classes

Pessoa.png

Layouts sugeridos

  • Aba Dados gerais

Fluxo de eventos

Fluxos principais

Fluxo 1:

Fluxos alternativos

Fluxo 1:

Fluxos de exceção

Fluxo 1:

Regras de negócio

RN01 - Tela de pesquisa

RN02 - Dados gerais

Dados do cliente

  1. Código: Exibe o código do cliente após o mesmo ser cadastrado.
  2. Pessoa: Permite ao usuário determinar o tipo de pessoa do cliente com as seguintes opções:
    • Física: Determina que o cliente é uma pessoa física e renderiza na tela a seção Pessoa física.
    • Jurídica: Determina que o cliente é uma pessoa jurídica e renderiza na tela a seção Pessoa jurídica. Além disso o sistema exibirá na tela, já marcado por padrão, o parâmetro Contribuinte ICMS.
  3. Ativo: Marcado por padrão sempre que exibido, este parâmetro determina se o cadastro do cliente está ativo ou não. Clientes cadastrados cujo parâmetro em questão está desmarcado não poderão ser utilizados em rotinas de movimentação do sistema, somente relatórios e consultas. Um cliente inativo se assemelha a um cliente não cadastrado, porém seu cadastro é mantido (inativo) para que as movimentações já realizadas pelo mesmo possam ser visualizadas.
  4. Bloqueado: Desmarcado por padrão, este parâmetro determina se um cliente está bloqueado para uso ou não. Clientes bloqueados podem ser visualizados em telas de movimentação, mas não poderão ser utilizados. Caso um cliente bloqueado seja selecionado em uma tela de movimentação do sistema uma mensagem será exibida ao usuário alertando-o que o mesmo está bloqueado e portanto não poderá ser utilizado.
  5. Não protestar: Desmarcado por padrão, este parâmetro determina se um cliente poderá ou não ser protestado na rotina Protesto.
  6. Contribuinte ICMS: Visível somente quando o tipo de pessoa do cliente for Jurídica e marcado por padrão, este parâmetro determina que o cliente é um contribuinte do ICMS, ou seja, vendas para o mesmo não se encaixam nas regras de venda para consumidores finais.
  7. Nome: Campo onde o usuário deverá, obrigatoriamente, informar o nome do cliente.
  8. Segmento: Campo onde serão listados todos os segmentos cadastrados no sistema para que o usuário possa, opcionalmente, selecionar um segmento para o cliente em questão.
  9. Renovar cadastro em: Campo onde o usuário poderá estabelecer uma data de renovação do cadastro do cliente. Se este dado não for informado o sistema entenderá que o cadastro não tem uma data de validade/renovação. Se uma data de renovação for informada, o cliente em questão não poderá ser utilizado em rotinas de movimentação caso a data de renovação esteja expirada.
  10. Protestar em: Campo onde o usuário poderá, opcionalmente, definir um prazo em dias para protestar o cliente. Esta informação será utilizada nas bolitas emitidas para o cliente e também na rotina de Protesto.
  11. Limite de atraso: Campo onde o usuário poderá, opcionalmente, definir um limite de dias de atraso para o cliente. Esta informação poderá ser utilizada por rotinas que verificam se o cliente está em atraso, cálculo de juros/multa e etc.
  12. Limite de crédito: Campo onde o usuário poderá estabelecer um limite de crédito para compras a prazo de um determinado cliente. Este limite será confrontado com valor dos vencimentos em aberto/atraso e com o valor do novo vencimento sempre que uma venda a prazo for feita.
  13. Cliente residente no exterior: No XML da Nota Fiscal 2.0 se o UF do cliente for EX não pode validar CNPJ, CPF e/ou Insc. Estadual

Caso o UF do cliente seja EX o município também deverá obrigatóriamente ser EX.

Pessoa física

  1. CPF: Campo onde o usuário poderá informar o CPF do cliente. A informação deste dado poderá ser obrigatória ou não de acordo com o estado do parâmetro Obrigar informação do CPF/CNPJ em cadastros? nos UC00006 - Parâmetros globais do sistema.
  2. Data de nascimento: Campo onde o usuário poderá informar a data de nascimento do cliente.
  3. Identidade: Campo onde o usuário poderá informar o RG do cliente.
  4. Emissor: Caso seja informado o RG, poderá ser informado neste campo o órgão emissor do mesmo. 
    
    As informações acima são renderizadas somente quando o tipo de pessoa selecionada para o cliente for Física.

Pessoa jurídica

  1. Nome fantasia: Campo onde o usuário poderá informar o nome fantasia do cliente que for pessoa jurídica.
  2. CNPJ: Campo onde o usuário poderá informar o CNPJ do cliente. A informação deste dado poderá ser obrigatória ou não de acordo com o estado do parâmetro Obrigar informação do CPF/CNPJ em cadastros? nos UC00006 - Parâmetros globais do sistema.
  3. Inscrição estadual: Campo onde o usuário poderá informar uma inscrição estadual para o cliente.
  4. Inscrição municipal: Campo onde o usuário poderá informar uma inscrição municipal para o cliente.
  5. Home page: Campo onde o usuário poderá informar o endereço da home page do cliente (caso exista). 
    
    As informações acima são renderizadas somente quando o tipo de pessoa selecionada para o cliente for Jurídica.

Endereço

  1. CEP: Campo onde o usuário poderá informar o CEP do cliente. Caso um CEP seja informado o sistema preencherá automaticamente os campos País, UF, Endereço, Bairro e Cidade.
  2. País: Campo que exibirá todos os países cadastrados e ativos no sistema. Somente será permitido selecionar um país.
  3. UF: Campo que exibirá todas as unidades federativas cadastradas e ativas no sistema. Somente será permitido selecionar uma unidade federativa por vez.
  4. Endereço: Campos onde o cliente poderá informar o logradouro e seu respectivo tipo. Os tipos comportados atualmente são:
    • RUA
    • ACESSO
    • AEROPORTO
    • ALAMEDA
    • APARTAMENTO
    • AREA
    • AVENIDA
    • BECO
    • BELVEDERE
    • BLOCO
    • CAMINHO
    • CAMPO
    • CANTO
    • CHACARA
    • COLONIA
    • CONDOMINIO
    • CORREDOR
    • CONJUNTO
    • DISTRITO
    • ESCADA
    • ESPLANADA
    • ESTACAO
    • ESTRADA
    • FAVELA
    • FAZENDA
    • FEIRA
    • FERROVIA
    • FORTALEZA
    • GALERIA
    • JARDIM
    • LADEIRA
    • LAGO
    • LAGOA
    • LARGO
    • LOTEAMENTO
    • MORRO
    • NUCLEO
    • PARQUE
    • PASSARELA
    • PATIO
    • PONTE
    • PRACA
    • PRAIA
    • QUADRA
    • QUILOMETRO
    • QUINTA
    • RECANTO
    • RESIDENCIAL
    • RODOVIA
    • SETOR
    • SITIO
    • SUBIDA
    • SUPERQUADRA
    • TRAVESSA
    • TRECHO
    • TREVO
    • VALE
    • VEREDA
    • VIA
    • VIADUTO
    • VIELA
    • VILA
  5. Nº
  6. Complemento
  7. Bairro
  8. Cidade: Campo onde o usuário poderá informar/pesquisar, dentre as cadastradas, uma cidade para o cliente.
  9. Observação: Campo livre para informações sobre o endereço.

RN03 - Informações adicionais

Informações adicionais do cliente

  1. Classificação: Campo onde serão listadas todas as classificações de cliente cadastradas no sistema para que o usuário selecione uma a ser utilizada no cliente.
  2. Tabela de preços: Campo onde serão listadas todas as tabelas de preço cadastradas no sistema para que o usuário selecione uma a ser utilizada no cliente. Uma vez que o cadastro de clientes é global, o usuário poderá selecionar qualquer tabela de preço dentre as cadastradas, mesmo se não estiverem amarradas à filial logada.
  3. Rota: Campo onde serão listadas todas as rotas cadastradas para que o usuário selecione uma a ser utilizada no cliente.
  4. Vendedor: Campo onde serão listados todos os vendedores cadastrados para que o usuário selecione um a ser utilizado no cliente.
  5. Trasportadora: Campo onde serão listados todos os vendedores cadastrados para que o usuário selecione um a ser utilizado no cliente.
  6. Retém ISS: Parâmetro que determina se o cliente retem ISS quando uma nota de serviços (NFS-e) for emitida para o mesmo.
  7. Retém PIS/COFINS/CSLL: Parâmetro que determina se o cliente retem PIS/COFINS/CSLL quando uma nota de serviços (NFS-e) for emitida para o mesmo.

Endereço de cobrança

Com os mesmos campos utilizados no endereço principal, o usuário poderá cadastrar um endereço de cobrança para o cliente. 

    
    Caso um endereço de cobrança não seja informado, ele será automaticamente preenchido com as informações do endereço principal.

Endereço de entrega

Com os mesmos campos utilizados no endereço principal, o usuário poderá cadastrar um endereço de entrega para o cliente. 

    
    Caso um endereço de entrega não seja informado, ele será automaticamente preenchido com as informações do endereço principal.

RN04 - Ficha cadastral

Na aba de ficha cadastral poderão ser informados, opcionalmente, dados adicionais de um determinado cliente. Estes dados adicionais são voltados para análise de crédito ou qualquer outro tipo de análise necessária para cadastrar novos clientes ou vender para clientes já cadastrados, variando de acordo com cada segmento de mercado onde o Resulth WEB é utilizado.

Será possível ter dois tipos de ficha, uma para pessoa física e outra para pessoa jurídica conforme segue abaixo.

Pessoa física

Informações pessoais

  1. Data da última alteração: Campo somente leitura que exibe a data em que foi salva a última alteração realizada na ficha cadastral.
  2. Usuário da última alteração: Usuário do sistema que realizou a última alteração na ficha cadastral.
  3. Avalista: Campo onde poderá ser informada uma pessoa que será avalista do cliente em questão. O avalista pode ser outro cliente já cadastrado, um fornecedor, um vendedor ou uma transportadora.
  4. Filiação: Este field set irá agrupar informações sobre a filiação do cliente nos seguintes campos:
    • Nome do cônjuge: Campo onde poderá ser informado o nome do cônjuge do cliente (se houver).
    • Nome do pai: Campo onde poderá ser informado o nome do pai do cliente.
    • Nome da mãe: Campo onde poderá ser informado o nome da mãe do cliente.
  5. Estado civil: Campo onde poderá ser selecionado o estado civil do cliente com as seguintes opções:
    • Casado(a)
    • Solteiro(a)
    • União estável
    • Viúvo(a)
  6. Identidade: Campo onde poderá ser informado o RG do cliente.
  7. Informação profissional: Este field set irá agrupar as informações profissionais do cliente nos seguintes campos:
    • Empresa: Campo onde poderá ser informado o nome da empresa onde o cliente trabalha atualmente.
    • Contato na empresa: Campo onde poderá ser informado um contato na empresa onde o cliente trabalha atualmente.
    • Cargo: Campo onde poderá ser informado o cargo ocupado pelo cliente em seu emprego atual.
    • Salário: Campo onde poderá ser informado o salário atual do cliente na empresa onde ele trabalha.
  8. Renda total: Campo onde poderá ser informada a renda total do cliente, contabilizando o seu salário e outros eventuais rendimentos que ele possa ter.
  9. Observação: Campo livre onde poderão ser informadas observações sobre a ficha cadastral.
  10. Avaliação: Campo livre onde poderão ser inseridas informações pertinentes à avaliação da ficha cadastral.

Bancos onde opera

Aba onde o usuário poderá adicionar um ou mais bancos onde o cliente da ficha opera através dos seguintes campos e funcionalidades:

  1. Descrição: Descrição ou nome do banco.
  2. Banco: Código Febraban do banco.
  3. Agência: Número da agência (com ou sem dígito).
  4. Conta: Número da conta (corrente ou poupança, com dígito).
  5. Telefone: Telefone do banco.
  6. Cliente desde: Data de abertura da conta.
  7. Botão [Adicionar]: Quando acionado, verifica se os campos obrigatórios foram informados e adiciona o registro no grid.
  8. Grid: Lista os bancos já adicionados nas seguintes colunas:
    • DESCRIÇÃO
    • BANCO
    • AGÊNCIA
    • CONTA
    • TELEFONE
    • CLIENTE DESDE

Referências

Aba onde o usuário poderá inserir uma ou mais referências do cliente através dos seguintes campos e funcionalidades:

  1. Tipo de referência: Campo onde deverá ser selecionado o tipo de referência com as seguintes opções:
    • Pessoal
    • Comercial
  2. Nome: Campo onde poderá ser informado o nome da empresa ou pessoa que será a referência.
  3. Telefone: Campo onde poderá ser informado o telefone da referência.
  4. Última compra: Visível somente quando o tipo de referência for Comercial, neste campo poderão ser informados a data e valor total da última compra realizada.
  5. Botão [Adicionar]: Botão que quando acionado insere a referência no grid.
  6. Grid: Lista todas as referências já adicionadas nas seguintes colunas:
    • TIPO
    • NOME
    • TELEFONE
    • DATA DA ÚLTIMA COMPRA
    • VALOR DA ÚLTIMA COMPRA

Situação no SPC

Esta aba ficará em branco até que seja desenvolvido o mecanismo de consulta ao SPC (requisito 2).

Pessoa jurídica

Informações

  1. Data da última alteração: Campo somente leitura que exibe a data em que foi salva a última alteração realizada na ficha cadastral.
  2. Usuário da última alteração: Usuário do sistema que realizou a última alteração na ficha cadastral.
  3. Avalista:Campo onde poderá ser informada uma pessoa que será avalista do cliente em questão. O avalista pode ser outro cliente já cadastrado, um fornecedor, um vendedor ou uma transportadora.
  4. Registro junta comercial: Número de registro de junta comercial, caso exista.
  5. Data da fundação: Data de abertura da empresa/CNPJ.
  6. Avaliação: Campo livre onde poderão ser inseridas informações pertinentes à avaliação da ficha cadastral.
  7. Limite de crédito: Campo que exibirá a mesma informação do campo Limite de crédito da aba Dados gerais do cadastro do cliente em questão. Caso o limite de crédito seja alterado na ficha cadastral, esta alteração será aplicada também no respectivo campo da aba Dados gerais.
  8. Saldo utilizado: Campo somente leitura que exibe o saldo utilizado atualmente. O saldo utilizado é obtido através da soma dos documentos a receber que se encontram em aberto ou em atraso para o cliente em questão.
  9. Saldo disponível: Obtido na subtração do valor do limite pelo saldo utilizado.
  10. Observação: Campo livre onde poderão ser informadas observações sobre a ficha cadastral.

Bancos onde opera

Aba onde o usuário poderá adicionar um ou mais bancos onde o cliente da ficha opera através dos seguintes campos e funcionalidades:

  1. Descrição: Descrição ou nome do banco.
  2. Banco: Código Febraban do banco.
  3. Agência: Número da agência (com ou sem dígito).
  4. Conta: Número da conta (corrente ou poupança, com dígito).
  5. Telefone: Telefone do banco.
  6. Cliente desde: Data de abertura da conta.
  7. Botão [Adicionar]: Quando acionado, verifica se os campos obrigatórios foram informados e adiciona o registro no grid.
  8. Grid: Lista os bancos já adicionados nas seguintes colunas:
    • DESCRIÇÃO
    • BANCO
    • AGÊNCIA
    • CONTA
    • TELEFONE
    • CLIENTE DESDE

Referências comerciais

Aba onde o usuário poderá inserir uma ou mais referências comerciais do cliente através dos seguintes campos e funcionalidades:

  1. Tipo de referência: Campo onde deverá ser selecionado o tipo de referência com as seguintes opções:
    • Pessoal
    • Comercial
  2. Nome: Campo onde poderá ser informado o nome da empresa ou pessoa que será a referência.
  3. Telefone: Campo onde poderá ser informado o telefone da referência.
  4. Última compra: Visível somente quando o tipo de referência for Comercial, neste campo poderão ser informados a data e valor total da última compra realizada.
  5. Botão [Adicionar]: Botão que quando acionado insere a referência no grid.
  6. Grid: Lista todas as referências já adicionadas nas seguintes colunas:
    • TIPO
    • NOME
    • TELEFONE
    • DATA DA ÚLTIMA COMPRA
    • VALOR DA ÚLTIMA COMPRA

Sócios

Nesta aba poderão ser incluídos os sócios do cliente é que pessoa jurídica através dos seguintes campos e funcionalidades.

  1. Nome: Campo onde deverá ser informado o nome do sócio.
  2. Capital: Campo onde poderá ser informado o valor do capital do sócio.
  3. CPF: Campo onde poderá ser informado o CPF do sócio.
  4. Identidade: Campo onde poderá ser informado o número de identidade do sócio.
  5. Botão [Adicionar]: Botão que quando acionado insere o registro no grid.

RN05 - Contato

RN06 - Dependentes

Retenção de imposto na NFS-e

Quando o cliente for o tomador de serviços em uma nota fiscal de serviço é possível que ele retenha alguns impostos. Para isto, serão exibidos na aba Dados gerais os seguintes parâmetros:

  1. Retem ISS: Este parâmetro determina se o cliente em questão retem ISS em notas fiscais de serviço.
  2. Retém PIS/COFINS/CSLL: Este parâmetro determina se o cliente em questão retem PIS, COFINS e CSLL em notas fiscais de serviço. 
    
    Caso nos parâmetros da filial logada o parâmetro Utiliza NFS-e esteja marcado como Não, os parâmetros citados acima serão visíveis, mas desmarcados e desabilitados na tela.

    
    O cliente somente irá reter impostos federais caso os valores do mesmo seja maior que o mínimo configurado nos parâmetros de NFS-e da filial.

Histórico

A última guia do cadastro de clientes, pessoa física ou jurídica, teremos a guia de histórico. A mesma será dividida em três sub-abas:


  1. Dados Estatísticos
  2. Documentos Abertos
  3. Documentos Pagos


Dados estatísticos

Exibir as seguintes informações:


DADOS DE VENDA


  • Primeira Compra: Data, Valor, Número Pedido, Número da OS (apenas para sistemas de OS)
  • Última Compra: Data, Valor, Número Pedido, Número da OS (apenas para sistemas de OS)
  • Maior Compra: Data, Valor, Número Pedido, Número da OS (apenas para sistemas de OS)
  • Menor Compra: Data, Valor, Número Pedido, Número da OS (apenas para sistemas de OS)
  • Quantidade de pedidos
  • Valor total dos pedidos
  • Média R$ dos pedidos


Para os dados acima, apenas obejtos cuja operação "considera em vendas".


DADOS DO CONTAS A RECEBER EM ABERTO


  • Títulos vencidos e não protestados: quantidade e valor total destes títulos (títulos abertos, com data de vencimento até 'ontem' e que não foram protestados)
  • Títulos vencidos e protestados: vencidos, da mesma forma acima, mas, que foram protestados
  • Vencendo hoje: quantidade e valor total destes títulos (títulos abertos, com data de vencimento 'hoje')
  • A vencer: quantidade e valor total destes títulos (títulos abertos, com data de vencimento 'amanhã' ou posterior)

Totalizar quantidade e valor, de todos os títulos acima. Não se preocupar com juros e multa nesta seção.


DOCUMENTOS PAGOS


  • TOTAL GERAL: Quantidade e Total de documentos pagos (quantidade de movimentos de pagamentos e o valor deles)
  • ANTECIPADOS: Quantidade e Total de documentos pagos, cuja da do movimento de pagamento seja menor que a data de vencimeto do título
  • ATRASADOS, SEM PROTESTO: Quantidade e Total de documentos pagos, cuja da do movimento de pagamento seja maior que a data de vencimento, mas, não estejam atrasados.
  • PAGOS APOS PROTESTO: Quantidade e Total de documentos pagos, cuja da do movimento de pagamento seja maior que a data de vencimento, e que estejam protestados.


Documentos a Receber

Criar uma sub-aba, dentro de histórico, que vai trazer as seguintes informações, em ordem crescente de data de vencimento


Os dados são os mesmos da consulta de vencimentos a receber.


  • código reduzido da filial
  • data da emissão
  • data do vencimento
  • código do tipo de documento (AV, NF, DP por exemplo)
  • código do documento
  • valor do documento (seria valor orginal - descontos + acréscimos do documento)
  • valor pago (não se preocupar com valor devolvido)
  • valor aberto
  • juros
  • multa
  • valor final
  • dias de atraso
  • situação do documento (aberto, parcialmente pago, protestado)
  • banco
  • carteira


Exibir o total do valor final.


Documentos Recebidos

Criar uma sub-aba, dentro de histórico, que vai trazer as seguintes informações, em ordem crescente de data de pagamento:


Os dados são os mesmos da consulta de contas recebidas


  • código reduzido da filial
  • data da emissão
  • data do vencimento
  • data da liquidação
  • código do tipo de documento (AV, NF, DP por exemplo)
  • código do documento
  • valor do documento (seria valor orginal - descontos + acréscimos do documento)
  • valor pago
  • desconto (que foi dado ao liquidar)
  • juros (que foi dado ao liquidar)
  • multa (que foi dado ao liquidar)


Exibir, ao final, o total do valor pago.

Quadro de dados

Ficha cadastral pessoa física

NOME OBRIGATÓRIO TIPO DE ENTRADA VALORES POSSÍVEIS TAMANHO VALOR PADRÃO OBSERVAÇÃO
Data da última alteração Sim Input Data Vazio Campo somente leitura
Usuário da última alteração Sim Input Alfanuméricos 60 Campo somente leitura
Avalista Não Input Pessoas cadastradas no sistema Vazio Pessoa pode ser um cliente, um vendedor e etc.
Nome do cônjuge Não Input Alfanuméricos 60 Vazio
Nome do pai Não Input Alfanuméricos 60 Vazio
Nome da mãe Não Input Alfanuméricos 60 Vazio
Estado civil Não Combobox
  • Casado(a)
  • Solteiro(a)
  • União estável
  • Viúvo(a)
Vazio
Identidade Não Input Data Vazio Dara inicial e final da vigência das alíquotas.
Chave Sim Input Alfanuméricos 25 Vazio O campo no banco terá o tamanho de 25, mas na tela o sistema deverá permitir que o usuário informe somente 6 caracteres.
Versão Não Input Alfanuméricos 10 Vazio Este dado não é obrigatório somente na inclusão ou alteração manual de um registro. Na importação da tabela este dado devera constar, obrigatoriamente, na tabela IBPT. No banco o campo terá o tamanho de 10, mas na tela o sistema deverá permitir que o usuário informe somente 6 caracteres.
Fonte Sim Input Alfanumérico 50 Vazio No banco o campo terá o tamanho de 50, mas na tela o sistema deverá permitir que o usuário informe somente 34 caracteres.

Disponível em "http://wiki.atsinformatica.com.br/wikijavainterno/index.php?title=UC00001_-_Cadastro_de_cliente&oldid=5613"
Ferramentas pessoais
Espaços nominais

Variantes
Visualizações
Ações
Navegação
Ferramentas