Wiki Java - Interno - Páginas novas [pt-br]

Checklist para criação de menu

2019-08-08T18:37:43Z

192.168.0.21: Criou página com 'Passos necessários para o menu do Resulth Web funcionar corretamente: * Declarar no ''menu-principal.xml''; * Declarar no ''menu-transform.xml''; não se esqueça de usar a ...'

Passos necessários para o menu do Resulth Web funcionar corretamente:

* Declarar no ''menu-principal.xml'';
* Declarar no ''menu-transform.xml''; não se esqueça de usar a tag ''<herda>'';
* Declarar no ''menu.json'';
* Declarar o ''nomeView'' no backing bean;
* Declarar o ''navigation-case'' no ''faces-config.xml'';
* Lembre-se que o item deve estar declarado tanto no menu novo, quanto no menu antigo.

Configurar tomcat em outra porta

2019-07-02T14:16:37Z

192.168.0.21: Criou página com 'Para criar um Tomcat trabalhando em outra porta de forma que possa rodar simultaneamente com um Tomcat existente, os passos são: # Fazer uma cópia do Tomcat inteiro para ou...'

Para criar um Tomcat trabalhando em outra porta de forma que possa rodar simultaneamente com um Tomcat existente, os passos são:

# Fazer uma cópia do Tomcat inteiro para outra pasta;
# No arquivo "bin/tomcat-debug.bat", editar 'set JPDA_ADDRESS=7000' para apontar para uma porta que não esteja em uso; esta é a porta usada pelo depurador;
# No arquivo "conf/server.xml", editar a porta em '<Server port="8005" shutdown="SHUTDOWN">' para apontar para uma porta que não esteja em uso; esta é a porta utilizada para derrubar remotamente o servidor;
# No arquivo "conf/server.xml", editar a porta em '<Connector port="8080" protocol="HTTP/1.1"' para apontar para uma porta que não esteja em uso; esta é a porta HTTP utilizada pelo navegador.

Centro de distribuição

2019-06-19T18:24:35Z

192.168.0.21: "A aprovação/reprovação da solicitação deve ocorrer na filial solicitada."

Atenção: documentação parcial; o Centro de distribuição atualmente tem zero documentação.

== Solicitação de Mercadoria ==

* Para poder aprovar ou reprovar a mercadoria, o usuário atual deve estar cadastrado nos parâmetros por filial (Configurações -> Parâmetros por filial -> Vertical eletromóveis -> Permissões -> Usuários com permissão de aprovar/reprovar solicitações de mercadoria);
* A aprovação/reprovação da solicitação deve ocorrer na filial solicitada.

RN002 - Deixar vender sem estoque e transferir de outras filiais

2019-04-08T15:06:19Z

192.168.1.78:

Para habilitar o esquema de transferência de estoque de outras filiais, para atender pedidos sem estoque na filial logada (feito originalmente para Lojas Carajás, e que será utilizado no e-commerce da Anjo Azul) precisamos:

1- Precisa ter o sistema de distribuição na senha (JDT);

2- É necessário que nos Parâmetros de Venda, na aba GERAIS, esteja permitindo utilizar módulo de entrega;

3- O usuário logado precisa ter acesso a estoque de outras filiais (parâmetros do pdv, aba "controle de acesso", DbCheckBox "Aba estoque de outras filiais";

4- É necessário que nos Parâmetros de Venda, na aba ITENS/Geral, esteja permitindo utilizar estoque de outra filial;

5- É necessário que nos Parâmetros de Venda, na aba ITENS/Estoque de outra filial, esteja selecionadas as filiais e suas respectivas prioridades;

Atenção:
* Verificar/Utilizar a filial do Ecommerce definida no Parâmetro Ecommerce;
* A operação padrão de venda (no Parâmetro PDV) e a operação de venda (no Parâmetro Ecommerce) tem que ser iguais;
* Verificar/Selecionar: as filiais selecionadas no Parâmetros de Venda devem ser as mesmas também no Parâmetro Ecommerce;

Lições aprendidas

2019-01-21T10:42:01Z

192.168.0.21: Observação sobre criação de scripts liquibase em branches.

== Hibernate ==

* @OneToOne: Cuidado ao usar a anotação @OneToOne se o campo for nulável; se isto for feito o Hibernate vai sempre puxar os dados da relação, mesmo que ela seja Lazy, e vai fazer isto de forma ineficiente. Recomenda-se utilizar o @OneToOne apenas se for combinado com "not null"; caso contrário, utilize @ManyToOne.

== Scripts do Liquibase ==

* Se estiver trabalhando em um branch temporário e precisar criar um novo changelog, lembre-se de fazer o merge do AtualizaBanco do branch pai, pois há uma boa chance de que ele já esteja criado. Criar arquivos com o mesmo nome em dois branches separados vai atrapalhar o merge.

UCTL00009 - Ponto de venda telefonia

2016-05-11T11:53:07Z

Felipecorrea: /* RN-01 - Aba Itens */

= Generalização - [[UC00072 - Ponto de venda]] =

= Objetivo =
*Definir regras especificas para o ponto de venda das empresas de telefonia.

= Pré-requisitos =
*Considerar documento [[Padrões de desenvolvimento]].
*Tomar conhecimento do caso de uso [[UC00064 - Parâmetros do PDV]].
*Tomar conhecimento do caso de uso [[UC00072 - Ponto de venda]].

= Resultado esperado =
*Assim como o UC00072, porém especificamente para empresas do segmento Telefonia.

= Fluxo de eventos =
== Fluxos principais ==
'''Fluxo 1:'''

= Regras de negócio =
== RN-01 - Aba Itens ==
[[Arquivo:Manual_de_vendas_JTL.pdf‎]]

'''ICCID:''' Campo para que seja informado o código contido no Chip de um aparelho de telefonia.
*O campo não é de preenchimento obrigatório e deve ser habilitado apenas para a Operação de Venda: Migração pré para pós.

UC00130 - Relatório de Séries em Estoque

2016-04-29T10:35:52Z

Felipecorrea:

= Objetivo =
*Possibilitar ao usuário a consulta das séries em estoque dos produtos.

= 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 '''Séries em estoque'''. Este nome será utilizado para criar a página no Wiki.
*Ter desenvolvido o mecanismo de controle de séries dos produtos.

= Resultado esperado =
*Gerar a consulta de séries em estoque, possibilitando gerar os vários formatos de arquivos.

= Fluxo de eventos =
== Fluxos principais ==
'''Fluxo 1:''' Usuário acessa a rotina no menu '''Relatórios -> Faturamento -> Controle de séries -> Séries em estoque.
*Sistema exibe os campos de filtragem conforme [[#RN01 - Tela inicial de filtragem| RN01]].

'''Fluxo 2:''' Usuário informa dados para filtragem.
*Sistema procede conforme regra de negócio [[#RN02 - Filtragem das séries em estoque | RN02]], e em seguida, após clicar em <Pesquisa> o sistema exibe os dados conforme [[#RN03 - Tela exibição dos dados| RN03]].

== Fluxos alternativos ==
'''Fluxo 1:''' Usuário informa uma visão para impressão e aciona o comando '''Imprimir''' de acordo com o formado de documento desejado.
*Sistema imprime o relatório conforme [[#RN04 - Impressão do relatório| RN04]] [[#FE01 - Fluxo de exceção 01| FE01]] [[#FE02 - Fluxo de exceção 02| FE02]].

== Fluxos de exceção ==
=== Fluxo de exceção 1 ===
Usuário aciona o comando de impressão sem resultados de pesquisa.
*Sistema exibe a mensagem de erro: '''Não existe dados consultados a serem impressos. Efetue uma consulta válida e tente novamente imprimir.'''
=== Fluxo de exceção 2 ===
Usuário aciona o comando de impressão sem ter selecionado um tipo de visão a ser impresso.
*Sistema exibe a mensagem de erro: '''Nenhum tipo de visão selecionado. Escolha um tipo de visão para imprimir.'''

= Regras de negócio =
== RN01 - Tela inicial de filtragem ==
*'''Filiais:''' Componente de múltipla seleção, padrão do sistema.
*'''Produto:''' Componente de seleção de itens via lookup, padrão do sistema.
*'''Fornecedor:''' Componente de seleção de pessoas via lookup, padrão do sistema.

== RN02 - Filtragem das séries em estoque ==
O sistema irá filtrar por séries atribuída a produtos, esses controlados por séries, e suas informações de estoque.
*'''Filiais:''' Serão consideradas as séries em estoque, das filiais selecionadas neste filtro, caso nenhuma filial for selecionada ou todas as filiais forem selecionadas, deve ser considerado os serias em estoque de todas as filiais da empresa.
*'''Produto:''' Quando este campo for preenchido com um valor válido, serão pesquisadas séries em estoque do produto preenchido.
*'''Fornecedor:''' Quando este campo for preenchido com um valor válido, serão pesquisadas séries em estoque que tiveram entrada por este fornecedor.

== RN03 - Tela de exibição de dados ==
*'''Código:''' Código interno do produto.
*'''Produto:''' Descrição do produto.
*'''Nº Série:''' Número da série.
*'''Últ. Movimentação:''' Data da ultima movimentação da série.
*'''Custo (R$):''' Preço de custo do produto.
*'''Filial Ent.:''' Código da filial que ocorreu a entrada da série no estoque da empresa.
*'''Filial Est.:''' Código da filial em que a série se encontra em estoque.
*'''Cód. Fornecedor.:''' Código do fornecedor da série;
*'''Fornecedor:''' Nome/descrição do fornecedor da série.
*'''Documento:''' Número do documento de entrada da série.
*'''Entrada:''' Data em que ocorreu a entrada da série no estoque da empresa.
*'''Dias estoque:''' Quantidade de dias que a série está em estoque na empresa, diferença da data atual até a data de entrada em estoque.

Exportação de arquivo de carga para a Suíte Mobile

2015-06-25T12:55:25Z

Gregorypacheco:

'''Descrição'''

A rotina de carga de dados Mobile deverá possibilitar a geração de arquivos de exportação para carregar dispositivos mobile bem como importar arquivos gerados nos dispositivos Móveis para carga e atualização do Resulth Web.

'''Localização'''

Menu >> Dispositivos móveis >> Carga de dados

'''Gerando o arquivo de carga'''
De acordo com as tabelas selecionadas (veja layout de tela em anexo) o sistema deverá gerar um arquivo de texto com as informações que deverão ser carregadas para o dispositivo.

'''Importando arquivos de integração'''
A rotina deverá possibilitar o apontamento de um arquivo de texto com as informações geradas pelo dispositivo, e posterior carregamenteo do mesmo para o sistema. Caso hajam problemas durante a importação/processamento dos dados, o sistema deverá informar essas diveregências

'''Dependências de integração'''

[[Arquivo:Carga de dados.png]]

===Roteiro de testes===
* Gerar arquivo de importação
* Importar o mesmo no smartphone
* Validar via Smartphone a integridade dos dados integrados
** Cliente
** Pedido
** Produto
** Estoque
** Tabelas de preço
** Série
** Fabricantes
** Grades
** Relacionamentos de grade
** Relacionamento de produtos agregados e similares
** Condições de pagamento
** Localização de produtos
** Administradoras de cartão
** Planos de financeira
** Bancos
** Agências
** Contas bancárias

* Realizar cadastros de clientes no Dispositivo Móvel
* Realizar vendas
** Vendas comuns
** Vendas com vários produtos
** Vendas com grades simples e compostas
** Vendas com várias formas de pagamento
* Exportar o arquivo do dispositivo
* Importar o mesmo no Resulth
* Validar a correta aparição dos erros no grid de log de integração
* Validar a integridade dos dados importados
* Realizar alterações nas vendas e nos clientes importados e recomeçar o processo.

Estoque

2015-06-23T13:13:45Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover uma consulta dos dados básicos de estoque no sistema. '''URL''' * Retorna a lista de complementos de produto com version maior que...'

'''Descrição'''
Responsável por prover uma consulta dos dados básicos de estoque no sistema.

'''URL'''

* Retorna a lista de complementos de produto com version maior que <version>
** /cxf/mobile/estoques?key=<token_seguranca>&version=<version>

* Retorna o complemento de produto com id 1
** /cxf/mobile/estoques/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de complementos ou de um complemento específico de acordo com a URL

'''Campos'''
* ID
* Version
* ID da filial
* ID do produto
* ID da grade
* Estoque disponível

Filiais

2015-06-23T12:35:58Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos de filiais no sistema. '''URL''' * Retorna a lista de filiais com version maior que <version> ** /cxf/mobil...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos de filiais no sistema.

'''URL'''

* Retorna a lista de filiais com version maior que <version>
** /cxf/mobile/filiais?key=<token_seguranca>&version=<version>

* Retorna o filiais com id 1
** /cxf/mobile/filiais/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de filiais ou de uma filial específica de acordo com a URL

'''Campos'''
* ID
* Version
* Código
* Nome

Relacionamento de produtos similares

2015-06-23T12:33:20Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos de itens similares no sistema. '''URL''' * Retorna a lista de itens similares com version maior que <versio...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos de itens similares no sistema.

'''URL'''

* Retorna a lista de itens similares com version maior que <version>
** /cxf/mobile/itenssimilares?key=<token_seguranca>&version=<version>

* Retorna um grupo de itens similares com id 1
** /cxf/mobile/itenssimilares/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de grupos ou de um grupo de itens similares específico de acordo com a URL

'''Campos'''
* ID
* Version
* Itens IDs (IDs dos produtos similares)

Relacionamento de produtos agregados

2015-06-23T12:32:05Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos de itens agregados no sistema. '''URL''' * Retorna a lista de itens agregados com version maior que <versio...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos de itens agregados no sistema.

'''URL'''

* Retorna a lista de itens agregados com version maior que <version>
** /cxf/mobile/itensagregados?key=<token_seguranca>&version=<version>

* Retorna um grupo de itens agregados com id 1
** /cxf/mobile/itensagregados/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de grupos ou de um grupo de itens agregados específico de acordo com a URL

'''Campos'''
* ID
* Version
* Origem IDs (IDs dos produtos de origem)
* Destino IDs (IDs dos produtos de destino)

Contas bancárias

2015-06-23T12:24:30Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos de contas bancárias no sistema. '''URL''' * Retorna a lista de contas com version maior que <version> ** /...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos de contas bancárias no sistema.

'''URL'''

* Retorna a lista de contas com version maior que <version>
** /cxf/mobile/contasbancarias?key=<token_seguranca>&version=<version>

* Retorna a conta com id 1
** /cxf/mobile/contasbancarias/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de contas ou de uma conta específica de acordo com a URL

'''Campos'''
* ID
* Version
* Número
* Digito verificador
* ID da agência bancaria

Agências

2015-06-23T12:22:43Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos de agências no sistema. '''URL''' * Retorna a lista de agências com version maior que <version> ** /cxf/m...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos de agências no sistema.

'''URL'''

* Retorna a lista de agências com version maior que <version>
** /cxf/mobile/agenciasbancarias?key=<token_seguranca>&version=<version>

* Retorna a agência com id 1
** /cxf/mobile/agenciasbancarias/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de agências ou de uma agência específico de acordo com a URL

'''Campos'''
* ID
* Version
* Código
* Digito verificador
* Nome
* ID do banco

Bancos

2015-06-23T12:20:57Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos de bancos no sistema. '''URL''' * Retorna a lista de bancos com version maior que <version> ** /cxf/mobile/...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos de bancos no sistema.

'''URL'''

* Retorna a lista de bancos com version maior que <version>
** /cxf/mobile/bancos?key=<token_seguranca>&version=<version>

* Retorna o banco com id 1
** /cxf/mobile/bancos1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de bancos ou de um banco específico de acordo com a URL

'''Campos'''
* ID
* Version
* Código
* Nome

Planos de financeira

2015-06-23T12:01:43Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos dos planos financeiras no sistema. '''URL''' * Retorna a lista de planos com version maior que <version> **...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos dos planos financeiras no sistema.

'''URL'''

* Retorna a lista de planos com version maior que <version>
** /cxf/mobile/planosfinanceiras?key=<token_seguranca>&version=<version>

* Retorna o plano com id 1
** /cxf/mobile/planosfinanceiras/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de planos ou de um plano específico de acordo com a URL

'''Campos'''
* ID
* Version
* Ativo
* Código
* ID da administradora de cartão

Administradoras de cartão

2015-06-23T11:58:30Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos das administradoras de cartão no sistema. '''URL''' * Retorna a lista de administradoras com version maior...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos das administradoras de cartão no sistema.

'''URL'''

* Retorna a lista de administradoras com version maior que <version>
** /cxf/mobile/admcartaofinanceira?key=<token_seguranca>&version=<version>

* Retorna a administradora com id 1
** /cxf/mobile/admcartaofinanceira/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de administradoras ou de uma administradora específica de acordo com a URL

'''Campos'''
* ID
* Version
* Código
* Apelido

Localização de estoque

2015-06-23T11:54:55Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos das localizações de estoque no sistema. '''URL''' * Retorna a lista de localizações com version maior q...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos das localizações de estoque no sistema.

'''URL'''

* Retorna a lista de localizações com version maior que <version>
** /cxf/mobile/localizacoes?key=<token_seguranca>&version=<version>

* Retorna a localização com id 1
** /cxf/mobile/localizacoes/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de localizações ou de uma localização específica de acordo com a URL

'''Campos'''
* ID
* Version
* Código
* Descrição

Condições de pagamento

2015-06-23T11:32:14Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos das condições de pagamento do sistema. '''URL''' * Retorna a lista de condições de pagamento com versio...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos das condições de pagamento do sistema.

'''URL'''

* Retorna a lista de condições de pagamento com version maior que <version>
** /cxf/mobile/condicoespagamento?key=<token_seguranca>&version=<version>

* Retorna a condição de pagamento com id 1
** /cxf/mobile/condicoespagamento/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de condições de pagamento ou de uma condição específica de acordo com a URL

'''Campos'''
* ID
* Version
* Ativo
* Código
* Descrição

Fabricantes

2015-06-23T11:29:49Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos de fabricante no sistema. '''URL''' * Retorna a lista de fabricantes com version maior que <version> ** /cx...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos de fabricante no sistema.

'''URL'''

* Retorna a lista de fabricantes com version maior que <version>
** /cxf/mobile/fabricantes?key=<token_seguranca>&version=<version>

* Retorna o fabricante com id 1
** /cxf/mobile/fabricantes/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de fabricantes ou de um fabricante específico de acordo com a URL

'''Campos'''
* ID
* Version
* Nome

Clientes

2015-06-23T11:18:21Z

Niwrodrigues: Criou página com ''''Descrição''' Responsável por prover CRUD dos dados básicos de pessoas no sistema. OBS: Este método retornas os tipos de pessoas que podem ser usados na venda como cli...'

'''Descrição'''
Responsável por prover CRUD dos dados básicos de pessoas no sistema.

OBS: Este método retornas os tipos de pessoas que podem ser usados na venda como cliente. (Cliente / Fornecedor)

'''URL'''

* Retorna a lista de pessoas com version maior que <version>
** /cxf/mobile/pessoas?key=<token_seguranca>&version=<version>

* Retorna a pessoa com id 1
** /cxf/mobile/pessoas/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de pessoas ou de uma pessoa específica de acordo com a URL

'''Campos'''
* ID
* Version
* Ativo
* Bloqueado
* Código
* Nome
* E-mail
* Telefone
** ID
** DDD
** Fone
* Celular
** ID
** DDD
** Fone
* Endereço
** Tipo
** Logradouro
** Numero
** Complemento
** Bairro
** Nome cidade
** UF
** CEP
* Tipo (CLIENTE / FORNECEDOR)

Tabelas de preço

2015-06-23T11:07:07Z

Niwrodrigues:

'''Descrição'''
Responsável por prover CRUD dos dados básicos das tabelas de preço no sistema.

'''URL'''

* Retorna a lista de tabelas de preço com version maior que <version>
** /cxf/mobile/tabelaspreco?key=<token_seguranca>&version=<version>

* Retorna a tabela com id 1
** /cxf/mobile/tabelaspreco/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de tabelas ou de uma tabela específica de acordo com a URL

'''Campos'''
* ID
* Version
* Ativo
* Padrão
* Descrição
* Percentual de desconto
* Filiais (Lista de ids (Long) das filiais)

RN001 - Validação de links de dispositivos móveis

2015-06-17T17:58:46Z

192.168.0.1:

Para que um cliente possa utilizar a Suíte mobile ele deverá adquirir via PDU a compra das funcionalidades desejadas para o mesmo, ou seja, cada função que o aplicativo terá deverá ser adquirida via PDU, ao ser integrada esta PDU a senha do cliente passará a ter informação da sigla da funcionalidade bem como a quantidade de links adquiridos.

No Resulth Web o cliente terá a possibilidade de vincular o acesso a uma determinada rotina adquirida e aos dispositivos desejados respeitando sempre o número de licenças compradas.

Regras de negócio

2015-06-17T17:57:35Z

192.168.1.78:

*[[RN001 - Validação de links de dispositivos móveis]]
*[[RN002 - Deixar vender sem estoque e transferir de outras filiais]]

Registro de dispositivos móveis

2015-06-17T15:06:19Z

Gregorypacheco:

'''Descrição'''
Rotina destinada a possibilitar o registro de dispositivos móveis no sistema, ou seja, através da mesma será possível gerar um Token que libera um Smartphone ou Tablet através do aplicativo da Suíte Mobile a integrar com o Resulth Web. Apenas dispositivos móveis registrados poderão enviar ou receber informações do Web Service.

'''Localização'''

Menu >> Dispositivos móveis >> Registro de dispositivos

'''Registrando um novo dispositivo'''

Grid principal

Ao ser acessada, a rotina de registro de dispositivos deverá mostrar um grid com a lista dos dispositivos registrados para aquela filial, neste deverão haver os seguintes campos:

* ID, código inteiro, auto-incremental gerado pelo sistema
* Token, código hash SHA1 gerado automaticamente pelo cliente, este código será utilizado posteriormente para autenticar cada dispositivo. No grid deverão ser mostrados os 5 primeiros dígitos deste número, que contém na verdade 128 caracteres.
* IMEI, código de identificação do dispositivo móvel, este é enviado pelo aparelho na sua primeira conexão ao Web Service do sistema.
* Nome do dispositivo, nome capturado pelo aplicativo e enviado para o Web Service na primeira conexão com o sistema, este nome refere-se ao nome do aparelho que pode ser conferido nas configurações do Android.
* Apelido, nome dado a cada dispositivo no momento do registro
* Data do registro

[[Arquivo:Grid registro dispositivo.JPG]]

Novo dispositivo

Ao ser acessada a função de Registro de Novo Dispositivo, através do clique no botão presente na tela, o usuário deverá ser levado para uma tela semelhante a tela abaixo, nela o usuário deverá ter a possibilidade de informar as filiais na qual este aplicativo poderá logar. Deverá também informar o apelido do dispositivo que esta sendo registrado. No momento da seleção das filiais o sistema deverá validar se o cliente possui links suficientes de dispositivos móveis para aquela filial, de acordo com a regra de negócio [[RN001 - Validação de links de dispositivos móveis]]
[[Arquivo:Novo dispositivo.JPG]]

Geração do Token

Ao ser concluído o preenchimento das informações o usuário deverá clicar no botão registrar dispositivo, neste momento um QR code com o token e a URL de destino deverão ser mostrados na tela, abaixo do QR code deverá ser mostrado de forma textual tanto o token quanto a URL do Web Service para casos em que a câmera do dispositivo não consiga ler o QR code.

[[Arquivo:Qr code.JPG]]

Produto

2015-06-11T17:20:06Z

Niwrodrigues:

'''Descrição'''
Responsável por prover CRUD dos dados básicos de produtos no sistema.

'''URL'''

* Retorna a lista de itens (produtos/serviços) com version maior que <version>
** /cxf/mobile/itens?key=<token_seguranca>&version=<version>

* Retorna o item com id 1
** /cxf/mobile/itens/1?key=<token_seguranca>

'''Métodos disponíveis'''

GET, recupera informação de uma lista de itens ou de um item específico de acordo com a URL

'''Campos'''
* ID
* Version
* Código
* Referência
* Descrição completa
* Descrição estendida
* ID do fabricante
* Referência do fabricante
* Garantia
* Código Grupo
* Código sub-grupo
* Usa série
* Usa grade
* Alerta
* Tipo (PRODUTO / SERVICO)
* Grades (Relacionamentos de grade)
** ID
** Descrição
* Localizações (Localizações de estoque do produto)
** ID
** Localização ID
* Preços (Tabela preço item)
** ID
** ID tabela de preço

Fila de integração

2015-06-11T13:40:49Z

192.168.0.1:

'''Descrição'''
A fila de integração é uma rotina que visa possibilitar o acompanhamento dos itens que foram integrados
Na mesma deverá existir o id da integração, tipo do registro, a data em que a integração foi gerada bem como alguma outra eventual observação como log de erro ou informações adicionais.

'''Geração de fila de integração'''
Toda a integração do sistema se baseará através do campo version do registro. O campo version é um campo datetime que é atualizado sempre que o registro é atualizado ou inserido no sistema, ao nível de centésimos de segundos. A fila de integração mostrará em ordem cronológica de alteração/inserção os últimos X registros de cada entidade. Quando a integração perguntar ao Web Service por produtos pendentes de integração por exemplo, e passar a data de sua última integração o Web Service deverá realizar a mesma busca no banco de dados que a fila de integração faz para montar a fila, ou seja, irá retornar os registros com data/hora de integração maior a data/hora passados pela chamada de Web Service.

'''Objetivo'''

Esta rotina visa possibilitar o acompanhamento da integração para saber se o registro foi ou não integrado, debug de eventuais falhas e etc. A cada vez que uma rotina altera um registro integrável ela deve gerar um registro nesta fila, que na verdade

'''Localização'''

A rotina deverá ficar situada em Resulth Web >> Menu >> Movimento >> Integração

'''Layout de tela'''

[[Arquivo:Grid integração.JPG]]

Web Service REST

2015-06-11T13:14:14Z

Niwrodrigues:

'''Descrição'''

Originalmente construído para prover integração com a [http://ajuda.atsinformatica.com.br/wikidelphiinterno/index.php/SU%C3%8DTE_MOBILE_-_MANUAL_T%C3%89CNICO#Funcionalidades Suíte Mobile do Resulth Web] o Web Service (WS) do Resulth Web provê métodos de integração para as principais rotinas do sistema.
Toda requisição para este Web Service é autenticada através de um token que na verdade é o IMEI do aparelho, para isso o usuário deve primeiramente realizar o registro do dispositivo no seu link do Resulth Web através da rotina de registro de dispositivos móveis.

'''Métodos'''
*[[Filiais]]
*[[Produto]]
*[[Estoque]]
*[[Tabelas de preço]]
*[[Clientes]]
*[[Fabricantes]]
*[[Relacionamento de produtos agregados]]
*[[Relacionamento de produtos similares]]
*[[Condições de pagamento]]
*[[Localização de estoque]]
*[[Administradoras de cartão]]
*[[Planos de financeira]]
*[[Bancos]]
*[[Agências]]
*[[Contas bancárias]]

Rotinas

2015-06-11T13:08:52Z

Gregorypacheco:

*[[Web Service REST]]
*[[Fila de integração]]
*[[Registro de dispositivos móveis]]
*[[Exportação de arquivo de carga para a Suíte Mobile]]
*[[Importação de arquivo de carga da Suíte Mobile]]

UC00129 - Registro de dispositivo móvel

2015-06-11T12:02:42Z

192.168.0.2: /* RN01 - Registro de dispositivo */

= Objetivo =
*Possibilitar o registro de aplicativos móveis que irão integrar com o Resulth Web.

= 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 '''Registro de dispositivo móvel'''. Este nome será utilizado para criar a página no Wiki.
*Gerar log/auditoria para as alterações realizadas na rotina.

= Resultado esperado =
*Quando um cliente adquirir a Suíte Mobile do Resulth Web seja possível registrar os dispositivos móveis que irão integrar com o mesmo.

= Diagrama de classes =

= Fluxo de eventos =
== Fluxos principais ==
'''Fluxo 1:'''
Usuário acessa o Resulth Web na rotina de registro de dispositivos móveis. O sistema abre um grid com a listagem de todos os dispositivos já registrados mostrando os campos, Código, que é um número sequencial para controle da contagem de dispositivos registrados, Identificação do dispositivo, que é o nome do dispositivo escolhido pelo usuário no momento do dispositivo, IMEI que o número de identificação do dispositivo.
Usuário decide registrar um novo dispositivo, neste o momento o sistema deverá possibilitar o registro do dispositivo de acordo com a seguinte regra de negócio: [[#RN01 - Registro de dispositivo | RN01]]

== Fluxos alternativos ==
'''Fluxo 1:'''

== Fluxos de exceção ==
'''Fluxo 1:'''

= Regras de negócio =
== RN01 - Registro de dispositivo ==
Caso o cliente possua na senha links de dispositivos móveis disponíveis, o sistema deverá gerar um QR code com a URL do web service daquele link do RW.
O sistema deverá possibilitar imprimir o QR para os casos em que o dispositivo não seja capaz de ler o QR code.
O sistema também deverá mostrar em formato texto o link do Web Service para que em casos críticos de leitura do QR code o cliiente possa informar manualment o mesmo.

Painel de versões do Resulth WEB

2015-06-01T12:37:43Z

Daniel: /* Administração */

= Cadastro =
O acesso ao painel é restrito a usuários cadastrados com permissões específicas para cada um. Para cadastrar-se solicite autorização ao responsável pelo setor de desenvolvimento.

= Administração =
== Grupos ==
Rotina onde podem ser criados grupos com perfis de acesso específicos no painel, que futuramente serão utilizados no cadastro de usuários.

== Usuários ==
Rotina onde são cadastrados os usuários autorizados a acessar o painel com suas devidas permissões de acesso.

== Repositório de versões ==
Rotina onde são cadastrados os repositórios de versão do painel. É destes repositórios que serão buscadas as versões tanto para atualização quanto para criação.

== Servidores ==

== Servidores de banco de dados ==

== Sistemas ==

= Servidores =

= Agendamento =
Nesta rotina é possível agendar tarefas para serem executadas em um determinado dia e horário no servidor através das seguintes funcionalidades:

#'''Botão [Agendar tarefa]:''' Quando acionado direciona o usuário para tela de agendamento de tarefas que é composta por:
#*'''Tarefa:''' ''Combobox'' que exibe as tarefas podem ser executadas através do agendamento pelo painel. Atualmente as opções são as seguintes:
#*#'''Atualizar versão:'''
#*#'''Criar link:'''
#*#'''Limpar índices do lucene:'''
#*#'''Parar tomcat:'''
#*#'''Reiniciar tomcat:'''
#*#'''Iniciar tomcat:'''
#*'''Data agendada:''' Campo onde deverão ser selecionados data e hora em que a tarefa selecionada será executada. Atualmente os horários autorizados para o agendamento de tarefas são de '''23:01 as 05:00'''.

<font face="Arial">
'''É expressamente proibido''' o agendamento de qualquer tarefa entre os horários de '''05:01 as 23:00 de segunda a domingo'''.
Qualquer agendamento fora do período autorizado só pode ser feito diante autorização de um superior.

= Logs de usuários =

UCOS00009 - Controle de requisição e expecição de itens de estoque

2015-05-11T18:53:27Z

Gregorypacheco: /* Layouts de tela */

= Objetivo =

Possibilitar o usuário realizar requisição e devolução de itens de estoque na ordem de serviço. Esta rotina será mais comumente utilizada pelo mecânicos da oficina, onde os mesmos irão requisitar os itens da OS que ele precisará para prosseguir com a manutenção.

= Atores =

*Usuário

= Pré-requisitos =

*Deverão estar cadastradas no sistema:

:*Produtos
* Os produtos precisam ter estoque disponível

= Resultado esperado =

= Diagrama de classes =

= Fluxo de eventos =

== Fluxo principais ==

* O cliente deseja incluir um registro do tipo requisição de peças [[#RN01 - Requisição | RN01]]
* O cliente deseja incluir um registro do tipo devoluão de peças [[#RN02 - Devolução | RN02]]

== Fluxo alternativos ==

== Fluxo de exceções ==

= Regras de negócio =

== RN01 - Requisição ==

O usuário acessa o menu na opção Cadastro >> Ordem de Serviços >> Controle de requisição e Expedição. Quando a mesma for acessada através desta opção, um grid padrão do sistema deverá ser aberto, com opção para abrir uma nova requisição, ou realizar uma filtragem para impressão.
O usuário deverá preencher os campos e informar os itens desta requisição. Ao final do processo o sistema permite ao usuário imprimir a requisição.

A rotina de requisição estará disponível também dentro da tela da OS, ou seja, assim que uma OS é gravada no sistema, o Resutlth Web habilita 2 botões de controle de requisição e expedição, um fica na parte superior da tela da OS e possbilita ao usuário abrir uma requisição já preenchida com os itens que aida não foram requisitados da OS emquestão, quando acesso este botão o sistema já deverá abrir a tela com os dados de data, mecânico e número da OS já preenchidos. Assim que aberta a tela, o usuário deverá proceder normalmente com a inclusão de itens e suas respectivas quantidades.
Ao concluir o processo, o sistema deverá prover uma forma de o usuário imprimir a requisição através de um botão de imprimir. Caso o usuário acione o botão de imprimir antes de salvar o registro, o sistema deverá salvá-lo e posteriormente prosseguir com a impressão, caso ele acione primeiro o botão de salvar, o sistema já deverá perguntar ao usuário se o mesmo deseja imprimir o registro.

Dados da impressão:

O documento a ser impresso deverá prover as seguintes informações:
* Cabeçalho com nome da empresa e logo
* Data
* Número da OS
* Tipo do registro (Requisição ou devolução)
* Lista de itens
* Local para assinatura do gerente do almoxarifado
* Local para assinatura da pessoa que esta recebendo a mercadoria

Ao ser acessada a tela de uma OS o sistema deverá avisar se a mesma possui itens incluídos na mesma que ainda não foram requisitados, para isso deverá ser incluída uma mensagem na tela que deverá permanecer piscando de vermelho para alertar ao usuário, ao ser clicada, a mesma deverá mostrar a lista dos itens e sua quantidades, e caso tenha grades mostrar as grades que não foram requisitadas.

O outro botão que fica disponível na tela da OS possibilita a inclusão de uma requisição/devolução feita do zero, ou seja, diferentemente do botão citado anteriormente esta não traz a requisição já preenchida.

== RN02 - Devolução ==
Quando a opção escolhida por uma devolução:

O usuário deverá proceder normalmente com a inclusão de itens e suas respectivas quantidades, no entanto o sistema não deverá permitir que sejam incluídos itens que não estão na OS como requisitados.
Ao concluir o processo, o sistema deverá prover uma forma de o usuário imprimir a requisição através de um botão de imprimir. Caso o usuário acione o botão de imprimir antes de salvar o registro, o sistema deverá salvá-lo e posteriormente prosseguir coma impressão, caso ele acione primeiro o botão de salvar, o sistema já deverá perguntar ao usuário se o mesmo deseja imprimir o registro.

Uso da tela inicial para consultas e impressões:

A tela deverá prover uma forma do usuário realizar consultas e imprimir relatórios das requisições e devolução realizadas no sistema, para isso o mesmo deverá permitir filtrar por:

Tipo:
Requisição
Devolução
Data
Mecânico
Responsável por realizar a requisição/devolução

No documento impresso deverá possuir todos os campos citados na filtragem. Quando não for selecionado um “tipo” deverá ser listados/impressos todos os registros, independentemente de ser requisição ou devolução.
Caso o usuário não queira imprimir a listagem e sim, apena localizar um registro, o mesmo deverá ter a possibilidade de acionar o botão visualizar, e dentro da tela que se abre, re-imprimir o registro com exatamente o mesmo layout que a requisição/devolução foi impressa pela primeira vez.

Controle de acessos:

A função de controle de expedição e devolução deverá ser liberada apenas para clientes que possuem o módulo de OS e deverá prover de controle de permissões tais como todas as demais rotinas do sistema.

= Layouts de tela =

<gallery>
</gallery>

UC00009 - Manifestação de destinatário

2015-04-13T17:21:49Z

Gregorypacheco: /* RN06 - Envio do XML de manifesto à receita */

= Objetivo =
*Possibilitar ao usuário realizar as operações de manifestação de destinatário.

De acordo com Nota Técnica 2012/002 (NT2012_002.pdf), disponibilizada pela Secretaria da Fazenda (SEFAZ), a partir do dia 01/07/2012, todos os eventos vinculados ao processo de Manifestação do Destinatário estarão disponíveis para testes (homologação) no ambiente nacional da NF-e. A partir de 01/08/2012 as empresas destinatárias poderão registrar os ventos em ambiente operacional.

= Atores =
*Usuário
*Sistema

= Pré-requisitos =
*Considerar documento [[Padrões de desenvolvimento]].
*No projeto da rotina, em confsrc > META-INF > messages > view.properties definir o nome como '''Manifestação de destinatário'''. Este nome será utilizado para criar a página no Wiki.

= Resultado esperado =
O novo processo permite que o destinatário da NF-e possa se manifestar sobre a sua participação comercial descrita na NF-e, confirmadas informações prestadas pelo seu fornecedor e emissor do respectivo documento fiscal.
Este XML tem a mesma estrutura do XML de um cancelamento, passando-se apenas algumas informações diferentes bem como algumas poucas outras tags conforme serão descritas logo mais.

Deverá ser disponibilizada uma nova rotina no sistema que deverá ser acessada através do menu:
Movimento >> Faturamento >> Manifesto de Destinatário

= Diagrama de classes =

= Layouts sugeridos =
<gallery>
File:Manif destinatario.png | Tela '''Manifestação de destinatário'''
File:Grid tela manif destinatario.png | Tela de consulta '''Manifestação de destinatário'''
</gallery>

= Fluxo de eventos =
== Fluxos principais ==
'''Fluxo 1:'''
Cliente acessa a rotina para manifestar ciência da emissão. O sistema deverá proceder de acordo com a regra de negócio [[#RN01 - Evento de ciência da emissão | RN01]].

'''Fluxo 2:'''
Cliente acessa a rotina para manifestar confirmação da operação. O sistema deverá proceder de acordo com a regra de negócio [[#RN02 - Evento de confirmação da operação | RN02]]

'''Fluxo 3:'''
Cliente acessa a rotina para manifestar desconhecimento da operação . O sistema deverá proceder de acordo com a regra de negócio [[#RN03 - Evento de desconhecimento da operação | RN03]]

'''Fluxo 4:'''
Cliente acessa a rotina para manifestar que a operação não foi realizada. O sistema deverá proceder de acordo com a regra de negócio [[#RN04 - Evento de operação não realizada | RN04]]

'''Fluxo 5:'''
O cliente acessa a rotina para realizar uma consulta dos manifestos já realizados. O sistema devera proceder de acordo com a regra de negócio [[#RN05 - Consulta de manifestos | RN05]].

== Fluxos alternativos ==
'''Fluxo 1:'''

== Fluxos de exceção ==
'''Fluxo 1:'''
O sistema apresentou erro, gerou o manifesto mas não conseguiu transmitir. O cliente deverá ter a possibilidade de consultar o manifesto e tentar reemitir a partir da mesma tela de emissão.

'''Fluxo 1:'''
O sistema esta fora do ar no momento da tentativa de emissão do manifesto. O manifesto deverá ser gravado localmente e permitir posterior consulta para reenvio.

= Regras de negócio =
== RN01 - Evento de ciência da emissão ==
1 - Ciência da Operação
Este evento registra na NF-e que o destinatário da operação, constante nesta NF-e, tem conhecimento que o documento foi emitido, mas ainda não expressou uma manifestação conclusiva para a operação.
É um evento opcional e pode ser evitado, já que normalmente o destinatário da NF-e deve possuir o arquivo XML da NF-e enviado e/ou disponibilizado pelo emitente.
Toda nota informada ao contribuinte tem que ter registrada a sua respectiva manifestação até um prazo máximo de 180 dias, contados da data da ciência. A manifestação poderá ser a Confirmação da Operação, Desconhecimento da Operação ou Operação não Realizada.

Para realizar um manifesto de ciência da operação o cliente deverá informar o número da NF ou a chave de acesso e clicar no botão Ciência da operação.

Apenar um evento deste tipo poderá ser registrado para cada nota.

Ao ser acionado o botão de ciência da emissão o sistema deverá proceder conforme [[#RN06 - Envio do XML de manifesto à receita | RN06]].

== RN02 - Evento de confirmação da operação ==
O evento será registrado após a realização da operação, e significa que a operação ocorreu conforme informado na NF-e.
Confirma a operação e o recebimento da mercadoria (para as operações com circulação de
mercadoria). Quando a NF-e trata de uma circulação de mercadorias, o momento de registro do evento deve ser posterior à entrada física da mercadoria no estabelecimento do destinatário.
Este evento também deve ser registrado para NF-e onde não existem movimentações de mercadorias, mas foram objeto de ciência por parte do destinatário. Após a Confirmação da Operação pelo destinatário, a empresa emitente fica impedida de cancelar a NF-e. Apenas o evento Ciência da Operação não inibe a autorização para o pedido de cancelamento da NF-e, conforme o prazo definido na legislação vigente.

Para realizar um manifesto de confirmação da operação o cliente deverá informar o número da NF ou a chave de acesso e clicar no botão confirmação da operação.

Apenar um evento deste tipo poderá ser registrado para cada nota.
Caso exista um manifesto de desconhecimento ou de rejeição da operação este último que passará a valer definitivamente.

Ao ser acionado o botão de confirmação da operação o sistema deverá proceder conforme [[#RN06 - Envio do XML de manifesto à receita | RN06]].

== RN03 - Evento de desconhecimento da operação ==
Este evento tem como finalidade possibilitar ao destinatário se manifestar quando da utilização indevida de sua Inscrição Estadual, por parte do emitente da NF-e, para acobertar operações fraudulentas de remessas de mercadorias para destinatário diverso. Este evento protege o destinatário de passivos tributários envolvendo o uso indevido de sua Inscrição Estadual/CNPJ.
O destinatário poderá enviar uma única mensagem de Confirmação da Operação, Desconhecimento da Operação ou Operação não Realizada, valendo apenas a última mensagem registrada. Exemplo: o destinatário pode desconhecer uma operação que havia confirmado inicialmente ou confirmar uma operação que havia desconhecido inicialmente.
O evento de ‘Ciência da Operação’ não configura a manifestação final do destinatário, portanto
não cabe o registro deste evento após a manifestação final do destinatário.

Ao ser acionado o botão de desconhecimento da operação o sistema deverá proceder conforme [[#RN06 - Envio do XML de manifesto à receita | RN06]].

== RN04 - Evento de operação não realizada ==
Este evento será informado pelo destinatário quando, por algum motivo, a operação legalmente acordada entre as partes não se realizou (devolução sem entrada física da mercadoria no estabelecimento do destinatário, sinistro da carga durante seu transporte, etc.), não cabendo neste caso a emissão de uma Nota Fiscal de devolução.
Este evento permite o registro da declaração de Operação não Realizada pelo destinatário, permitindo também a informação complementar da justificativa desta informação.

Para realizar um manifesto de desconhecimento da operação o cliente deverá informar o número da NF ou a chave de acesso e clicar no botão descinhecimento da operação.

Apenar um evento deste tipo poderá ser registrado para cada nota. Caso exista um manifesto de conhecimento ou de rejeição da operação este último que passará a valer definitivamente.

Caso o usuário opte por manifestar uma operação não realizada o sistema deverá exigir que ele informe o motivo, este trata-se de um campo texto onde o usuário irá informar o motivo que deverá ser validado para ter entre 15 e 255 caracteres.

Ao ser acionado o botão de operação não realizada o sistema deverá proceder conforme [[#RN06 - Envio do XML de manifesto à receita | RN06]].

== RN05 - Consulta de manifestos ==
De acordo com o layout sugerido em anexo, a rotina deverá possibilitar consultar os eventos manifestados para aquela nota, para isso o usuário deverá pesquisar pela chave de acesso, data de emissão do evento ou pelo número da NF; casos sejam localizados eventos registros para aqueles filtros, o sistema deverá listar em um grid as informações dos mesmos com as seguintes colunas:

Nota fiscal => número da nota fiscal.

Emissão => data de envio da operação.

Evento => ‘Ciência da Operação’, ‘Confirmação da Operação’, ‘Operação não realizada’ ou ‘Desconhecimento da operação’.

Protocolo => número do protocolo de retorno da operação, quando status = ‘registrada’.

Chave de acesso => Chave de acesso da NF-e.

Status => situação do retorno da operação: registrada ou rejeitada.

Motivo operação não realizada => descrição da justificativa da operação não realizada.

== RN06 - Envio do XML de manifesto à receita ==
O sistema deverá dispor de um botão para cada tipo de manifesto que ao ser acionado deverá montar o XML do evento e submeter à receita federal.

Caso o usuário opte por manifestar uma operação não realizada o sistema deverá exigir que ele informe o motivo, este trata-se de um campo texto onde o usuário irá informar o motivo que deverá ser validado para ter entre 15 e 255 caracteres.

Quando um manifesto for registrado o XML do mesmo deverá ser gravado no banco de dados bem como o seu XML de retorno correspondente.

Caso seja confirmada a operação selecionada, será gerado e transmitido o XML. O retorno da SEFAZ poderá ser registrada’ ou ‘rejeitada’. Caso haja autorização, será retornado o número do protocolo.

Validações:

- O destinatário poderá enviar uma única mensagem de Confirmação de Operação, Desconhecimento da Operação ou Operação não Realizada.

- O destinatário poderá desconhecer uma operação que havia confirmado incialmente ou poderá confirmar uma operação que havia desconhecido inicialmente.

- A Ciência da Operação poderá ser realizada uma única vez.