Mudanças entre as edições de "Produtos Medicados"

De GeoSales
Ir para navegação Ir para pesquisar
 
(92 revisões intermediárias por 6 usuários não estão sendo mostradas)
Linha 7: Linha 7:
 
| 13/01/2021 || Romildo Santos || Criação do Documento  
 
| 13/01/2021 || Romildo Santos || Criação do Documento  
 
|-
 
|-
−
| /01/2021  || Anderson Gomes ||  Aprovação das Alterações no Documento pelo Desenvolvimento
+
| 03/02/2021  || Ana Júlia ||  Alteração no Documento  
 
|-
 
|-
 +
| 25/02/2021  || Renato Lima  ||  Alteração no Documento RN4
 +
|-
 +
| 02/06/2021  || Renato Lima  ||  Finalização do Documento RN4
 +
|-
 +
| 26/07/2021 || João Ramon || Atualização do documento
 
|}
 
|}
  
 
== Necessidade ==
 
== Necessidade ==
  
−
Para evitar erros durante a digitação e dar direcionamento correto para cada pedido, o cliente tem a necessidade de inserir uma indicação visual na tela de cadastro de pedido que diz se o produto é 'medicado' ou não. Posteriormente a isso no casos em que os produtos são medicados, devem ser informados em dois novos campos, o número de animais e número de dias de tratamento.
+
Alguns produtos possuem em sua composição medicamentos e essas informações são primordiais para prosseguir com a venda. Para os produtos nessa situação é necessário que seja informada a quantidade de dias de tratamento e o número de animais que farão uso.
 +
 
 +
== Implementação ==
 +
 
 +
Para que o usuário possa identificar se um produto possui medicamento em sua composição, a plataforma GeoSales EVO exibirá identificação no produto indicando que o produto é medicado. Através da integração entre o ERP e GeoSales será informado quais produtos são medicados ou não. Nessa situação teremos dois cenários:
 +
 
 +
''' Cenário 1''' Caso no ERP o produto esteja como medicado o produto será sinalizado como 'Medicado'.
 +
 
 +
''' Cenário 2''' Caso no ERP o produto esteja como '''não''' medicado o produto não apresentará sinalização.
 +
 
 +
No detalhamento de produto os campos 'Quantidade de dias de tratamento' e 'Números de Animais' serão apresentados para o preenchimento e serão obrigatórios de preenchimento dessas informações com valores numéricos, quando o produto estiver classificado como medicado. O Produto será indicado como medicado, com um ícone no card do produto na tela inicial em ambas as visões(card e lista) e a informação virá fixa nos detalhes internos do produto, que o usuário terá acesso ao clicar no ícone "i", para visualizar mais informações.
 +
 
 +
 
 +
[[Arquivo:Auster final002.jpg|500px]]
 +
 
 +
 
 +
[[Arquivo:Auster final003.1.jpg|500px]]
 +
 
 +
 
 +
As informações cadastradas nos campos 'Quantidade de dias de tratamento' e 'Números de Animais' serão integradas ao ERP, conforme regras de integrações previstas abaixo.
 +
 
 +
Caso o usuário tente realizar a finalização ou orçamento do pedido sem o preenchimento dos campos 'Quantidade de dias de tratamento' e 'Números de Animais' a plataforma não permitirá que o pedido seja concluído e exibirá uma mensagem de alerta, conforme descrito nas regras de negócios abaixo.
 +
 
 +
Para acompanhamento após a criação do pedido, será criado relatório que será possível emitir e apresentará o cliente, vendedor, número do pedido, item, quantidade comprada, se é um produto medicado, número de animais e quantidade de dias de tratamento. estará disponível na tela de detalhamento do pedido e no card de pedidos na mesa do cliente e será liberado para visualizar por meio de ação por perfil do usuário.
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
==Regras de Integração==
  
−
== Solução ==
+
'''[RN1] - ''' A informação do número de animais deverá ser integrada no campo UB_XANIMAL.
  
−
Baseado nesta necessidade, ao passo da criação de novos pedidos, devemos visualizar em tela se um produto é medicado ou não no ato da inserção dos itens do pedido. Esta informação será integrada a partir do campo B1_XMEDCTO do sistema de gestão Protheus. Ou seja, durante a escolha dos itens a label 'Produtos medicados' será marcada como sim ou não, de acordo com o que vem diretamente do cadastro do produto conforme o campo descrito acima trouxer.
+
'''[RN2] - ''' A informação sobre a quantidade de dias de tratamento  deverá ser integrada no campo UB_XDTRATA.
  
−
Para os casos de produto medicado 'sim', o sistema abrirá dois campos para preenchimento, são eles: número de animais e número de dias de tratamento respectivamente. Os campos do Protheus que receberão estas informações são: UB_XANIMAL e UB_XDTRATA respectivamente.
+
'''[RN3] - ''' Através do campo B1_XMEDCTO será informado se o produto é medicado ou não.
  
−
== Implementação ==
+
==Regras de Negócio==
 +
 
 +
'''[RN1] - ''' A plataforma GeoSales só exibirá os campos 'Quantidade de Animais' e 'Quantidade de Dias de Tratamento' caso os produtos sejam medicados.
 +
 
 +
'''[RN2] - ''' Caso o usuário tente finalizar ou orçar um pedido sem o preenchimento dos campos 'Quantidade de Animais' e 'Quantidade de Dias de Tratamento' a plataforma não permitirá que o usuário prossiga com o cadastrado e exibirá a seguinte mensagem 'As informações sobre a quantidade de animais e quantidade de dias de tratamento são obrigatórios de preenchimento.
 +
 
 +
'''[RN3] - '''As regras contidas nesse documento serão aplicadas somente na plataforma GeoSales EVO e no novo aplicativo mobile.
  
−
'''- Protótipo de tela:'''
+
'''[RN4] - ''' Para que o usuário possa verificar os dados informados no pedido, será criado um relatório especifico, que apresentará o cliente, vendedor, número do pedido, item, quantidade comprada, se é um produto medicado, número de animais e quantidade de dias de tratamento, terá acesso através do portal Geosales EVO.
  
−
Para que isso ocorra, será necessário inserir alguns campos na tela de cadastro de pedido, como pode-se visualizar no protótipo abaixo:
+
==Parametrização==
−
[[Arquivo:]]
 
  
−
'''- Regras de Integração'''
+
Para fins de parametrização, as seguintes tabelas vão fazer as referidas vinculações: TIPO_CARACTERISTICAS_PRODUTO, CARACTERISTICA_PRODUTO e CARACTERISTICAS_VALOR. A vinculação de todas elas se dará pela chave CD_CARACTERISTICA.
  
−
Deverá ser inserida às tabelas de PEDIDO e ITEM_PEDIDO mais dois campos que deverão conter as quantidades preenchidas informadas nos campos 'Número de Animais' e 'Número de dias de tratamento' durante o cadastro do pedido. Estas informações deverão ser enviadas para os campos UB_XANIMAL e UB_XDTRATA do ERP Protheus.
+
O primeiro passo para parametrização é inserir os valores que serão tratados os campos que serão exibidos na tela de produto, por meio da tabela TIPO_CARACTERISTICAS_PRODUTO. Os campos a serem populados nesta tabela são CD_CARACTERISTICA, ID_TIPO, DS_DESC, ICONE_PACOTE e ICONE_NOME. Para fins de ilustração, consideremos o modelo abaixo:
−
Deverá ser criada uma tabela auxiliar de 'Produto' para registrar as particularidades do produto. Esta tabela conterá os seguintes campos: CD_PRODUTO, NM_PRODUTO, OBS_PRODUTO, PROD_MEDICADO.  
 
−
Deverá ser criado um campo na tabela de PRODUTO para receber a informação se o produto é medicado. B1_XMEDCTO será o campo do Protheus de onde vamos buscar esta informação.
 
  
 +
{| class = "wikitable"
 +
!CD_CARACTEISTICA
 +
!ID_TIPO
 +
!DS_DESC
 +
!ICONE_PACOTE
 +
!ICONE-NOME
 +
|-
 +
| 1 || S || Nº dias || mt || local_hospital
 +
|-
 +
| 2 || I || Nº animais || mt || local_hospital
 +
|-
 +
| 3 || B || Decimo || mt || local_hospital
 +
|-
 +
| 4 || D || data inicial || mt || local_hospital
 +
|-
 +
|}
  
 +
Pela tela, verificamos que o código '''1''' representa o tipo de preenchimento tipo '''S (string)''' denominado '''Nº de dias''', que utiliza o ícone chamado '''local hospital''' do pacote '''mt''' do site https://gwtmaterialdesign.github.io/gwt-material-demo/#icons.
  
 +
Os tipo de campos permitidos para criação são:
  
−
{| class="wikitable"
+
{|class="wikitable"
−
! CD_TIPO
+
!Tipo do campo
−
! DS_TIPO
+
!id_tipo
−
! CD_TIPO_PAI
+
|-
−
! ID_MOVIMENTO_ITEM
+
| BigDecimal || B
−
! ID_UTILIZAVEL
+
|-
−
! OBSERVAÇÃO
+
| Integer || I
 +
|-
 +
| String || S
 +
|-
 +
| Date || D
 +
|-
 +
|}
 +
 
 +
O próximo passo é associar o produto às características criadas na tabela TIPO_CARACTERISTICAS_PRODUTO. Para isso, é necessário popular a tabela CARACTERISTICA_PRODUTO. A tabela fará a vinculação de CD_CARACTERISTICA com CD_PRODUTO, como no exemplo abaixo:
 +
 
 +
{|class="wikitable"
 +
!CD_CARACTERISTICA
 +
!CD_PRODUTO
 +
|-
 +
| 1 || 1
 +
|-
 +
| 1 || 2
 +
|-
 +
| 2 || 1
 +
|-
 +
| 2 || 2
 +
|-
 +
| 3 || 1
 +
|-
 +
| 3 || 2
 +
|-
 +
| 4 || 1
 
|-
 
|-
 +
| 4 || 2
 +
|}
 +
 +
Pelo exposto, vemos que os produtos 1 e 2 possui as 4 vinculações de características parametrizadas anteriormente.
  
−
==Regras de Negócio==
 
  
−
'''RN1 - '''
+
A próxima tabela que deverá ser populada é a CARACTERISTICAS_VALOR. Ela recebe as informações dadas pelo usuário no pedido, vinculando estas informações com os parâmetros já cadastrados nas duas tabelas anteriores.
  
−
'''RN2 - '''
 
  
−
'''RN3 - '''
+
 
 +
{|class="wikitable"
 +
!CD_PEDIDO_PALM
 +
!NR_ITEM_PEDIDO
 +
!CD_CARACTERISTICA
 +
!VR_CARACTERISTICA
 +
|-
 +
| 2107211758323274 || 3 || 1 || cinco dias
 +
|-
 +
| 2107211758323274 || 3 || 2 || 6
 +
|-
 +
| 2107211758323274 || 3 || 3 || 4.000000000000000000
 +
|-
 +
| 2107211758323274 || 3 || 4 || 2021-07-22
 +
|-
 +
|}
  
 
== Aprovação ==
 
== Aprovação ==
Linha 58: Linha 160:
 
Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.  
 
Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.  
  
 +
=== GeoSales ===
 +
 +
{| class="wikitable"
 +
! style="width:200px" |Setor
 +
! style="width:180px" |Aprovado Por
 +
! style="width:100px" |Data
 +
|-
 +
| Desenvolvimento - GeoSales || Anderson Gomes || 26/02/2021
 +
|-
 +
| Integração - GeoSales ||  || 00/00/0000
 +
|-
 +
| Arquitetura - GeoSales ||  || 00/00/0000
 +
|-
 +
|}
 +
 +
=== Empresa solicitante ===
 +
 +
{| class="wikitable"
 
! style="width:200px" |Setor  
 
! style="width:200px" |Setor  
 
! style="width:180px" |Aprovado Por
 
! style="width:180px" |Aprovado Por
−
! style="width:200px" |Data
+
! style="width:100px" |Data
−
! style="width:300px" |Assinatura
+
! style="width:200px" |Assinatura
 +
|-
 +
| Gerente TI - Cliente        ||  ||  ||
 
|-  
 
|-  
−
| Gerente TI
+
| Gerente de Projeto - Cliente || ||  ||
−
|  
 
−
|
 
−
|
 
 
|-  
 
|-  
−
| Gerente Projeto
+
| Gerente Comercial - Cliente  || ||  ||
−
|  
 
−
|
 
−
|
 
 
|-  
 
|-  
−
| Gerente Comercial
 
−
|
 
−
|
 
−
|
 
 
|}
 
|}

Edição atual tal como às 18h54min de 26 de julho de 2021

Histórico de Revisões

Data Quem Comentários
13/01/2021 Romildo Santos Criação do Documento
03/02/2021 Ana Júlia Alteração no Documento
25/02/2021 Renato Lima Alteração no Documento RN4
02/06/2021 Renato Lima Finalização do Documento RN4
26/07/2021 João Ramon Atualização do documento

Necessidade

Alguns produtos possuem em sua composição medicamentos e essas informações são primordiais para prosseguir com a venda. Para os produtos nessa situação é necessário que seja informada a quantidade de dias de tratamento e o número de animais que farão uso.

Implementação

Para que o usuário possa identificar se um produto possui medicamento em sua composição, a plataforma GeoSales EVO exibirá identificação no produto indicando que o produto é medicado. Através da integração entre o ERP e GeoSales será informado quais produtos são medicados ou não. Nessa situação teremos dois cenários:

Cenário 1 Caso no ERP o produto esteja como medicado o produto será sinalizado como 'Medicado'.

Cenário 2 Caso no ERP o produto esteja como não medicado o produto não apresentará sinalização.

No detalhamento de produto os campos 'Quantidade de dias de tratamento' e 'Números de Animais' serão apresentados para o preenchimento e serão obrigatórios de preenchimento dessas informações com valores numéricos, quando o produto estiver classificado como medicado. O Produto será indicado como medicado, com um ícone no card do produto na tela inicial em ambas as visões(card e lista) e a informação virá fixa nos detalhes internos do produto, que o usuário terá acesso ao clicar no ícone "i", para visualizar mais informações.


Auster final002.jpg


Auster final003.1.jpg


As informações cadastradas nos campos 'Quantidade de dias de tratamento' e 'Números de Animais' serão integradas ao ERP, conforme regras de integrações previstas abaixo.

Caso o usuário tente realizar a finalização ou orçamento do pedido sem o preenchimento dos campos 'Quantidade de dias de tratamento' e 'Números de Animais' a plataforma não permitirá que o pedido seja concluído e exibirá uma mensagem de alerta, conforme descrito nas regras de negócios abaixo.

Para acompanhamento após a criação do pedido, será criado relatório que será possível emitir e apresentará o cliente, vendedor, número do pedido, item, quantidade comprada, se é um produto medicado, número de animais e quantidade de dias de tratamento. estará disponível na tela de detalhamento do pedido e no card de pedidos na mesa do cliente e será liberado para visualizar por meio de ação por perfil do usuário.





Regras de Integração

[RN1] - A informação do número de animais deverá ser integrada no campo UB_XANIMAL.

[RN2] - A informação sobre a quantidade de dias de tratamento deverá ser integrada no campo UB_XDTRATA.

[RN3] - Através do campo B1_XMEDCTO será informado se o produto é medicado ou não.

Regras de Negócio

[RN1] - A plataforma GeoSales só exibirá os campos 'Quantidade de Animais' e 'Quantidade de Dias de Tratamento' caso os produtos sejam medicados.

[RN2] - Caso o usuário tente finalizar ou orçar um pedido sem o preenchimento dos campos 'Quantidade de Animais' e 'Quantidade de Dias de Tratamento' a plataforma não permitirá que o usuário prossiga com o cadastrado e exibirá a seguinte mensagem 'As informações sobre a quantidade de animais e quantidade de dias de tratamento são obrigatórios de preenchimento.

[RN3] - As regras contidas nesse documento serão aplicadas somente na plataforma GeoSales EVO e no novo aplicativo mobile.

[RN4] - Para que o usuário possa verificar os dados informados no pedido, será criado um relatório especifico, que apresentará o cliente, vendedor, número do pedido, item, quantidade comprada, se é um produto medicado, número de animais e quantidade de dias de tratamento, terá acesso através do portal Geosales EVO.

Parametrização

Para fins de parametrização, as seguintes tabelas vão fazer as referidas vinculações: TIPO_CARACTERISTICAS_PRODUTO, CARACTERISTICA_PRODUTO e CARACTERISTICAS_VALOR. A vinculação de todas elas se dará pela chave CD_CARACTERISTICA.

O primeiro passo para parametrização é inserir os valores que serão tratados os campos que serão exibidos na tela de produto, por meio da tabela TIPO_CARACTERISTICAS_PRODUTO. Os campos a serem populados nesta tabela são CD_CARACTERISTICA, ID_TIPO, DS_DESC, ICONE_PACOTE e ICONE_NOME. Para fins de ilustração, consideremos o modelo abaixo:

CD_CARACTEISTICA ID_TIPO DS_DESC ICONE_PACOTE ICONE-NOME
1 S Nº dias mt local_hospital
2 I Nº animais mt local_hospital
3 B Decimo mt local_hospital
4 D data inicial mt local_hospital

Pela tela, verificamos que o código 1 representa o tipo de preenchimento tipo S (string) denominado Nº de dias, que utiliza o ícone chamado local hospital do pacote mt do site https://gwtmaterialdesign.github.io/gwt-material-demo/#icons.

Os tipo de campos permitidos para criação são:

Tipo do campo id_tipo
BigDecimal B
Integer I
String S
Date D

O próximo passo é associar o produto às características criadas na tabela TIPO_CARACTERISTICAS_PRODUTO. Para isso, é necessário popular a tabela CARACTERISTICA_PRODUTO. A tabela fará a vinculação de CD_CARACTERISTICA com CD_PRODUTO, como no exemplo abaixo:

CD_CARACTERISTICA CD_PRODUTO
1 1
1 2
2 1
2 2
3 1
3 2
4 1
4 2

Pelo exposto, vemos que os produtos 1 e 2 possui as 4 vinculações de características parametrizadas anteriormente.


A próxima tabela que deverá ser populada é a CARACTERISTICAS_VALOR. Ela recebe as informações dadas pelo usuário no pedido, vinculando estas informações com os parâmetros já cadastrados nas duas tabelas anteriores.


CD_PEDIDO_PALM NR_ITEM_PEDIDO CD_CARACTERISTICA VR_CARACTERISTICA
2107211758323274 3 1 cinco dias
2107211758323274 3 2 6
2107211758323274 3 3 4.000000000000000000
2107211758323274 3 4 2021-07-22

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

GeoSales

Setor Aprovado Por Data
Desenvolvimento - GeoSales Anderson Gomes 26/02/2021
Integração - GeoSales 00/00/0000
Arquitetura - GeoSales 00/00/0000

Empresa solicitante

Setor Aprovado Por Data Assinatura
Gerente TI - Cliente
Gerente de Projeto - Cliente
Gerente Comercial - Cliente
Disponível em “http://wiki.geosales.com.br:8000/index.php?title=Produtos_Medicados&oldid=15918”