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

De GeoSales
Ir para navegação Ir para pesquisar
 
(50 revisões intermediárias por 5 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 potencializar a digitação de pedidos, o cliente tem a necessidade de inserir uma indicação visual na tela da escolha de itens, que diz se o produto é 'medicado' ou não. Posteriormente a isso nos 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.
  
−
== Soluçã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.
  
−
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, os 'Produtos medicados' serão marcados como sim ou não, de acordo com o que vem diretamente do cadastro do produto conforme o campo descrito acima trouxer.
 
  
−
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.
+
[[Arquivo:Auster final002.jpg|500px]]
  
−
== Implementação ==
 
  
−
Para implementar a funcionalidade será utilizada a tela de detalhamento de produtos indicada pelo ícone da letra 'i' tanto no portal quanto no app Geosales Evo. Em caso de produtos medicados 'sim' serão abertos dois campos para preenchimento apenas numérico. São eles: Número de animais e Dias de tratamento. Para casos de produto medicado não, se faz necessário apenas esta descrição, ou seja, sem necessidade de abrir os dois campos numéricos a mais do caso dos produtos medicados sim.
+
[[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==
 +
 
 +
'''[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.
  
−
Ao realizar o pedido, as informações de produto medicado, número de animais e dias de tratamento serão atreladas ao pedido através da tabela item_pedido.
+
==Regras de Negócio==
−
As mesmas informações também deverão retornar na tabela item_pedido_retorno.
 
  
−
'''- Protótipo de tela:'''
+
'''[RN1] - ''' A plataforma GeoSales só exibirá os campos 'Quantidade de Animais' e 'Quantidade de Dias de Tratamento' caso os produtos sejam medicados.
  
−
Para que isso ocorra, será necessário inserir alguns campos na tela de cadastro de pedido, como pode-se visualizar no protótipo abaixo:
+
'''[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.
  
−
[[Arquivo:Medicado definido.png|800px]]
+
'''[RN3] - '''As regras contidas nesse documento serão aplicadas somente na plataforma GeoSales EVO e no novo aplicativo mobile.
  
−
No momento de desenvolver, pode ocorrer alteração de acordo com a viabilidade técnica.
+
'''[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.
  
−
=== Integração ===
+
==Parametrização==
  
−
Para que os produtos sejam exibidos no GeoSales com a classificação de medicados ou não, será necessário criar duas estruturas de tabelas com os dados conforme o layout abaixo...
+
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:
  
−
{| class="wikitable"
+
{| class = "wikitable"
−
! colspan="6"  | PRODUTO_ESPECIFICACAO
+
!CD_CARACTEISTICA
 +
!ID_TIPO
 +
!DS_DESC
 +
!ICONE_PACOTE
 +
!ICONE-NOME
 
|-
 
|-
−
! style="width:300px" |Campo Protheus
+
| 1 || S || Nº dias || mt || local_hospital
−
! style="width:200px" |Coluna
 
−
! Tipo
 
−
! style="width:200px" |Obrigatório
 
−
! style="width:300px" |Chave Primária
 
−
! style="width:300px" |Explicação
 
−
|-
 
−
|
 
−
| CD_ESPECIFICA_PROD
 
−
| INT
 
−
| SIM
 
−
| NÃO
 
−
| Coluna que registrará o código de especificação do produto.
 
−
|-
 
−
|
 
−
| NM_ESPECIFICACAO_PROD
 
−
| VARCHAR(150)
 
−
| SIM
 
−
| NÃO
 
−
| Coluna que terá a descrição da especificação do produto.
 
 
|-
 
|-
−
|
+
| 2 || I || Nº animais || mt || local_hospital
−
| OBS_INFO_EXTRA
 
−
| VARCHAR(300)
 
−
| SIM
 
−
| NÃO
 
−
| Coluna que terá a observação da especificação do produto.
 
 
|-
 
|-
−
|  
+
| 3 || B || Decimo || mt || local_hospital
−
| EXIBE_PEDIDO
 
−
| VARCHAR(1)
 
−
| SIM
 
−
| NÃO
 
−
| Coluna que dirá se o produto terá a especificação exibida na aplicação.
 
−
|-
 
−
| B1_XMEDCTO
 
−
| CONTEM_MEDICAMENTO
 
−
| VARCHAR(80)
 
−
| SIM
 
−
| NÃO
 
−
| Campo do Protheus que trará a informação se o produto tem medicamento ou não
 
−
|}
 
−
 
 
−
{| class="wikitable"
 
−
! colspan="6"  | PRODUTO_CLASSIFICACAO
 
 
|-
 
|-
−
! style="width:300px" |Campo Protheus
+
| 4 || D || data inicial || mt || local_hospital
−
! style="width:200px" |Coluna
 
−
! Tipo
 
−
! style="width:200px" |Obrigatório
 
−
! style="width:300px" |Chave Primária
 
−
! style="width:300px" |Explicação
 
−
|-
 
−
|
 
−
| CD_ESPECIFICA_PROD
 
−
| INT
 
−
| SIM
 
−
| NÃO
 
−
| Coluna que registrará o código de especificação do produto.
 
−
|-
 
−
|
 
−
| CD_PRODUTO
 
−
| INT
 
−
| SIM
 
−
| NÃO
 
−
| Coluna que informa o código do produto.
 
 
|-
 
|-
 
|}
 
|}
  
 +
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.
  
−
'''- Regras de Integração'''
+
Os tipo de campos permitidos para criação são:
  
−
'''RN 1 - ''' Deverá ser inserida à tabela 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.
+
{|class="wikitable"
 +
!Tipo do campo
 +
!id_tipo
 +
|-
 +
| BigDecimal || B
 +
|-
 +
| Integer || I
 +
|-
 +
| String || S
 +
|-
 +
| Date || D
 +
|-
 +
|}
  
−
'''RN 2 - '''Deverá ser criada uma estrutura de tabela que receberá classificações de produto.
+
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:
  
−
'''RN 3 - '''Deverá ser criada uma estrutura de tabela que receberá especificação de produto.
+
{|class="wikitable"
 +
!CD_CARACTERISTICA
 +
!CD_PRODUTO
 +
|-
 +
| 1 || 1
 +
|-
 +
| 1 || 2
 +
|-
 +
| 2 || 1
 +
|-
 +
| 2 || 2
 +
|-
 +
| 3 || 1
 +
|-
 +
| 3 || 2
 +
|-
 +
| 4 || 1
 +
|-
 +
| 4 || 2
 +
|}
  
−
'''RN 4 - '''O campo PROD_MEDICADO irá registrar se o produto é medicado ou não conforme a integração trouxer do campo B1_XMEDCTO do Protheus.
+
Pelo exposto, vemos que os produtos 1 e 2 possui as 4 vinculações de características parametrizadas anteriormente.
  
−
'''RN 5 - '''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.
 
  
−
==Regras de Negócio==
+
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.
  
−
'''RN 1 - ''' A integração trará a informação de produto medicado.
 
  
−
'''RN 2 - ''' O Portal Evo só abrirá os campos de inserção de 'quantidade de animais' e 'dias de tratamento' somente para casos de 'produtos medicados' SIM.
 
  
−
'''RN 3 - ''' As informações de produto medicado, número de animais e número de dias de tratamento devem ser levadas aos relatórios de espelho de pedido.
+
{|class="wikitable"
−
 
+
!CD_PEDIDO_PALM
−
'''RN 4 - '''As implementações devem ser inseridas no app novo e portal Geosales Evo.
+
!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 147: Linha 167:
 
! style="width:100px" |Data
 
! style="width:100px" |Data
 
|-  
 
|-  
−
| Desenvolvimento - GeoSales || Anderson Gomes || 00/01/2021
+
| Desenvolvimento - GeoSales || Anderson Gomes || 26/02/2021
 
|-  
 
|-  
−
| Integração - GeoSales || Carlos Robson || 00/01/2021
+
| Integração - GeoSales || || 00/00/0000
 +
|-
 +
| Arquitetura - GeoSales ||  || 00/00/0000
 
|-
 
|-
 
|}
 
|}

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”