GeoSales - Contribuições do(a) usuário(a) [pt-br]

Acesso a duas versões distintas do SAV em um mesmo dispositivo

2022-10-20T11:41:32Z

Ramon.queiroz: Criou página com '== Histórico de Revisões == {| class="wikitable" ! Data ! Quem ! Comentários |- | 20/10/2022 || João Ramon || Criação do Documento |- |} == Necessidade == O c...'

== Histórico de Revisões ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 20/10/2022 || João Ramon || Criação do Documento
|-
|}

== Necessidade ==

O cliente tem a necessidade de uso de duas versões do SAV distintas a partir de um mesmo dispositivo, realizando sincronismo, já que uma das versões sincronizadas para ele é específica do cliente, e a outra será uma versão padrão GeoSales. Neste caso, necessitamos realizar tratativas que permitam a utilização de ambas as versões num mesmo aparelho, visto que este assunto constitui condição ''sine qua non'' para o prosseguimento do projeto do cliente.

== Solução ==

Realização de tratativas de aplicação, criação de ambiente, que permitirão a utilização de duas versões distintas num mesmo aparelho. Além disso, se fará necessário ajustar os serviços de integração e geração de versão, deixando-os ativos especificamente em um ambiente distinto para atendimento desta necessidade, criação de build e tag específicos de controle e identificação de código, que permitirá o gerenciamento, alteração e manutenção da versão e dos serviços utilizados que permitirá o uso de forma específica para entender o uso.

== Implementação ==

== Cenários ==

== Regras de negócio ==

'''RN1''' -

'''RN2''' -

'''RN3''' -

'''RN4''' -

'''RN5''' -

== 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.

{| class="wikitable"
! style="width:200px" |Setor
! Aprovado Por
! style="width:200px" |Data
! style="width:300px" |Assinatura
|-
| Gerente TI
|
|
|
|-
| Gerente Projeto
|
|
|
|-
| Gerente Comercial
|
|
|
|}

Projeto/Dovac

2022-10-20T11:20:13Z

Ramon.queiroz:

* [[Ata de Reunião]]
* [[Casos de Uso]]
* [[Doc. Tecnico]]
* [[Relatorio do Status]]
* [[Envio de Check in/Check out]]
* [[Acesso a duas versões distintas do SAV em um mesmo dispositivo]]

Cubagem em Carga

2022-09-26T13:03:16Z

Ramon.queiroz: /* Integração */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''.

Como ilustração, consideramos como item de venda uma caixa de balas sortidas cujas dimensões são: 42 cm de comprimento, 21 cm de altura e 23 cm de largura. Perceba que as informações foram coletadas em centímetros (cm). Ao trazer esta informação para o seu ERP, o valor de input que seu sistema considera é a dimensão em metros (m). Dessa forma, os valores de comprimento, altura e largura inseridos no sistema são, respectivamente, 0,42 m, 0,21 m e 0,23 m. Ao realizar o cálculo do volume deste item, temos que

<center><code>Volume = Comprimento * Altura * Largura</code></center>

Portanto, o valor do volume teria o valor de '''''0,020286 m³'''''.

Considere esta segunda ilustração de um produto que possui as seguintes dimensões:

* Altura: 0,25 m
* Largura: 0,20 m
* Comprimento: 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de '''''0,0235 m3'''''.

Este valor pode ser calculado pela sua quantidade. Neste caso, considerando um pedido com 10 unidades deste item, o valor do volume será 10*0,0235 m³, ou '''''0,235 m³'''''.

Ao realizar um pedido com mais de um item, a cubagem total será o somatório dos volumes de todos os itens em função da quantidade pedida.

== Integração ==

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

O cliente utiliza o Sistema Sapiens, da Sênior, como ERP. As informações das dimensões de um produto (altura, comprimento e largura) estão nos campos '''AltPro, LarPro e ComPro''' da tabela '''E075PRO'''. O cálculo fornecido para o volume do produto se dá conforme já citado, por meio da expressão

<center><code>Volume = AltPro*ComPro*LarPro</code></center>

Os campos '''AltPro, LarPro e ComPro''' são do tipo '''''double'''''.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura
! Comprimento
! Largura
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1000 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-26T11:58:00Z

Ramon.queiroz: /* Integração */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''.

Como ilustração, consideramos como item de venda uma caixa de balas sortidas cujas dimensões são: 42 cm de comprimento, 21 cm de altura e 23 cm de largura. Perceba que as informações foram coletadas em centímetros (cm). Ao trazer esta informação para o seu ERP, o valor de input que seu sistema considera é a dimensão em metros (m). Dessa forma, os valores de comprimento, altura e largura inseridos no sistema são, respectivamente, 0,42 m, 0,21 m e 0,23 m. Ao realizar o cálculo do volume deste item, temos que

<center><code>Volume = Comprimento * Altura * Largura</code></center>

Portanto, o valor do volume teria o valor de '''''0,020286 m³'''''.

Considere esta segunda ilustração de um produto que possui as seguintes dimensões:

* Altura: 0,25 m
* Largura: 0,20 m
* Comprimento: 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de '''''0,0235 m3'''''.

Este valor pode ser calculado pela sua quantidade. Neste caso, considerando um pedido com 10 unidades deste item, o valor do volume será 10*0,0235 m³, ou '''''0,235 m³'''''.

Ao realizar um pedido com mais de um item, a cubagem total será o somatório dos volumes de todos os itens em função da quantidade pedida.

== Integração ==

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

O cliente utiliza o Sistema Sapiens, da Sênior, como ERP. As informações das dimensões de um produto (altura, comprimento e largura) estão nos campos '''AltPro, LarPro e ComPro''' da tabela '''E075PRO'''. O cálculo fornecido para o volume do produto se dá conforme já citado, por meio da expressão

<center><code>Volume = AltPro*ComPro*LarPro</code></center>

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura
! Comprimento
! Largura
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1000 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-26T11:57:30Z

Ramon.queiroz: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''.

Como ilustração, consideramos como item de venda uma caixa de balas sortidas cujas dimensões são: 42 cm de comprimento, 21 cm de altura e 23 cm de largura. Perceba que as informações foram coletadas em centímetros (cm). Ao trazer esta informação para o seu ERP, o valor de input que seu sistema considera é a dimensão em metros (m). Dessa forma, os valores de comprimento, altura e largura inseridos no sistema são, respectivamente, 0,42 m, 0,21 m e 0,23 m. Ao realizar o cálculo do volume deste item, temos que

<center><code>Volume = Comprimento * Altura * Largura</code></center>

Portanto, o valor do volume teria o valor de '''''0,020286 m³'''''.

Considere esta segunda ilustração de um produto que possui as seguintes dimensões:

* Altura: 0,25 m
* Largura: 0,20 m
* Comprimento: 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de '''''0,0235 m3'''''.

Este valor pode ser calculado pela sua quantidade. Neste caso, considerando um pedido com 10 unidades deste item, o valor do volume será 10*0,0235 m³, ou '''''0,235 m³'''''.

Ao realizar um pedido com mais de um item, a cubagem total será o somatório dos volumes de todos os itens em função da quantidade pedida.

== Integração ==

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

O cliente utiliza o Sistema Sapiens, da Sênior, como ERP. As informações das dimensões de um produto (altura, comprimento e largura) estão nos campos AltPro, LarPro e ComPro da tabela E075PRO. O cálculo fornecido para o volume do produto se dá conforme já citado, por meio da expressão

<center><code>Volume = AltPro*ComPro*LarPro</code></center>

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura
! Comprimento
! Largura
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1000 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-23T14:51:06Z

Ramon.queiroz:

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''.

Como ilustração, consideramos como item de venda uma caixa de balas sortidas cujas dimensões são: 42 cm de comprimento, 21 cm de altura e 23 cm de largura. Perceba que as informações foram coletadas em centímetros (cm). Ao trazer esta informação para o seu ERP, o valor de input que seu sistema considera é a dimensão em metros (m). Dessa forma, os valores de comprimento, altura e largura inseridos no sistema são, respectivamente, 0,42 m, 0,21 m e 0,23 m. Ao realizar o cálculo do volume deste item, temos que

<center><code>Volume = Comprimento * Altura * Largura</code></center>

Portanto, o valor do volume teria o valor de '''''0,020286 m³'''''.

Considere esta segunda ilustração de um produto que possui as seguintes dimensões:

* Altura: 0,25 m
* Largura: 0,20 m
* Comprimento: 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de '''''0,0235 m3'''''.

Este valor pode ser calculado pela sua quantidade. Neste caso, considerando um pedido com 10 unidades deste item, o valor do volume será 10*0,0235 m³, ou '''''0,235 m³'''''.

Ao realizar um pedido com mais de um item, a cubagem total será o somatório dos volumes de todos os itens em função da quantidade pedida.

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura
! Comprimento
! Largura
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1000 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T16:15:50Z

Ramon.queiroz: /* Conceito de Cubagem na Visão do Cliente */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, ou H, de Height; largura, ou W, de Width; e comprimento, ou L, de Lenght) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''.

Como ilustração, consideramos como item de venda uma caixa de balas sortidas cujas dimensões são: 42 cm de comprimento, 21 cm de altura e 23 cm de largura. Perceba que as informações foram coletadas em centímetros (cm). Ao trazer esta informação para o seu ERP, o valor de input que seu sistema considera é a dimensão em metros (m). Dessa forma, os valores de comprimento, altura e largura inseridos no sistema são, respectivamente, 0,42 m, 0,21 m e 0,23 m. Ao realizar o cálculo do volume deste item, temos que

<center><code>Volume = Lenght * Height * Width</code></center>

Portanto, o valor do volume teria o valor de '''''0,020286 m³'''''.

Considere esta segunda ilustração de um produto que possui as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de '''''0,0235 m3'''''.

Este valor pode ser calculado pela sua quantidade. Neste caso, considerando um pedido com 10 unidades deste item, o valor do volume será 10*0,0235 m³, ou '''''0,235 m³'''''.

Ao realizar um pedido com mais de um item, a cubagem total será o somatório dos volumes de todos os itens em função da quantidade pedida.

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1000 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T15:19:03Z

Ramon.queiroz: /* Conceito de Cubagem na Visão do Cliente */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, ou H, de Height; largura, ou W, de Width; e comprimento, ou L, de Lenght) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''.

Como ilustração, consideramos como item de venda uma caixa de balas sortidas cujas dimensões são: 42 cm de comprimento, 21 cm de altura e 23 cm de largura. Perceba que as informações foram coletadas em centímetros (cm). Ao trazer esta informação para o seu ERP, o valor de input que seu sistema considera é a dimensão em metros (m). Dessa forma, os valores de comprimento, altura e largura inseridos no sistema são, respectivamente, 0,42 m, 0,21 m e 0,23 m. Ao realizar o cálculo do volume deste item, temos que

<center><code>Volume = Lenght * Height * Width</code></center>

Portanto, o valor do volume teria o valor de '''''0,020286 m³'''''.

Considere esta segunda ilustração de um produto que possui as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de '''''0,0235 m3'''''.

Este valor pode ser calculado pela sua quantidade. Neste caso, considerando um pedido com 10 unidades deste item, o valor do volume será 10*0,0235 m³, ou '''''0,235 m³'''''.

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1000 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T15:17:50Z

Ramon.queiroz: /* Conceito de Cubagem na Visão do Cliente */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, ou H, de Height; largura, ou W, de Width; e comprimento, ou L, de Lenght) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''.

Como ilustração, consideramos como item de venda uma caixa de balas sortidas cujas dimensões são: 42 cm de comprimento, 21 cm de altura e 23 cm de largura. Perceba que as informações foram coletadas em centímetros (cm). Ao trazer esta informação para o seu ERP, o valor de input que seu sistema considera é a dimensão em metros (m). Dessa forma, os valores de comprimento, altura e largura inseridos no sistema são, respectivamente, 0,42 m, 0,21 m e 0,23 m. Ao realizar o cálculo do volume deste item, temos que

<center><code>Volume = Lenght * Height * Width</code></center>

Portanto, o valor do volume teria o valor de '''''0,020286 m³'''''.

Considere esta segunda ilustração de um produto que possui as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1000 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T14:52:40Z

Ramon.queiroz: /* Conceito de Cubagem na Visão do Cliente */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, ou H, de Height; largura, ou W, de Width; e comprimento, ou L, de Lenght) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''.

Como ilustração, consideramos como item de venda uma caixa de balas sortidas cujas dimensões são: 42 cm de comprimento, 21 cm de altura e 23 cm de largura. Perceba que as informações foram coletadas em centímetros (cm). Ao trazer esta informação para o seu ERP, o valor de input que seu sistema considera é a dimensão em metros (m). Dessa forma, os valores de comprimento, altura e largura inseridos no sistema são, respectivamente, 0,42 m, 0,21 m e 0,23 m. Ao realizar o cálculo do volume deste item, temos que

<center><code>Volume = Lenght * Height * Width</code></center>

Portanto, o valor do volume teria o valor de '''''0,020286 m³'''''.

Com isso, o volume deste item seria 42 * 21 * 23 = 20.286 cm³. Este não é o método empregado pelo cliente.

Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1000 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T14:50:52Z

Ramon.queiroz: /* Conceito de Cubagem na Visão do Cliente */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''.

Como ilustração, consideramos como item de venda uma caixa de balas sortidas cujas dimensões são: 42 cm de comprimento, 21 cm de altura e 23 cm de largura. Perceba que as informações foram coletadas em centímetros (cm). Ao trazer esta informação para o seu ERP, o valor de input que seu sistema considera é a dimensão em metros (m). Dessa forma, os valores de comprimento, altura e largura inseridos no sistema são, respectivamente, 0,42 m, 0,21 m e 0,23 m. Ao realizar o cálculo do volume deste item, temos que

<center><code>V = Lenght * Height * Witdh</code></center>

Portanto, o valor do volume teria o valor de '''''0,020286 m³'''''.

Com isso, o volume deste item seria 42 * 21 * 23 = 20.286 cm³. Este não é o método empregado pelo cliente.

Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1000 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T13:12:40Z

Ramon.queiroz: /* Cenários */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1000 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T12:36:33Z

Ramon.queiroz: /* Conceito de Cubagem na Visão do Cliente */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada, as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T12:32:19Z

Ramon.queiroz: /* Cenário Descritivo */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' acessa o ícone de informação de item
'''When''' o card do item estiver aberto
'''Then''' as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a tela de pedidos
'''And''' realiza a seleção dos itens e as suas respectivas quantidades
'''And''' direciona-se para a tela de finalização do pedido
'''When''' o usuário acessar a aba de 'Resumo do Pedido'
'''Then''' as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' solicita extração de um relatório do pedido no formato pdf
'''When''' o usuário abrir o relatório de pedidos
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
'''Given''' Usuário está logado no sistema
'''And''' acessa a lista de pedidos realizados
'''And''' seleciona um pedido xpto
'''And''' acessa as informações gerais do pedido
'''When''' o usuário abrir as informações de endereço
'''Then''' as informações de cubagem total do pedido estarão visíveis para o usuário.
'''But''' se o usuário deseja ver informações de cubagem referentes ao item
'''When''' o usuário abrir as informações de itens do pedido
'''And''' selecionar um item específico
'''Then''' as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T12:31:03Z

Ramon.queiroz: /* Cenário Descritivo */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
'''Given''' Usuário está logado no sistema
And acessa a tela de pedidos
And acessa o ícone de informação de item
When o card do item estiver aberto
Then as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
Given Usuário está logado no sistema
And acessa a tela de pedidos
And realiza a seleção dos itens e as suas respectivas quantidades
And direciona-se para a tela de finalização do pedido
When o usuário acessar a aba de 'Resumo do Pedido'
Then as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
Given Usuário está logado no sistema
And acessa a lista de pedidos realizados
And seleciona um pedido xpto
And solicita extração de um relatório do pedido no formato pdf
When o usuário abrir o relatório de pedidos
Then as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
Given Usuário está logado no sistema
And acessa a lista de pedidos realizados
And seleciona um pedido xpto
And acessa as informações gerais do pedido
When o usuário abrir as informações de endereço
Then as informações de cubagem total do pedido estarão visíveis para o usuário.
But se o usuário deseja ver informações de cubagem referentes ao item
When o usuário abrir as informações de itens do pedido
And selecionar um item específico
Then as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T12:30:43Z

Ramon.queiroz: /* Cenário Descritivo */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

'''Feature''': Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

'''Scenario1''': Cubagem habilitada - visualização unitária por item
Given Usuário está logado no sistema
And acessa a tela de pedidos
And acessa o ícone de informação de item
When o card do item estiver aberto
Then as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

'''Scenario2''': Cubagem habilitada - visualização total por pedido
Given Usuário está logado no sistema
And acessa a tela de pedidos
And realiza a seleção dos itens e as suas respectivas quantidades
And direciona-se para a tela de finalização do pedido
When o usuário acessar a aba de 'Resumo do Pedido'
Then as informações de cubagem total do pedido estará visível para o usuário.

'''Scenario3''': Cubagem habilitada - visualização em relatório do pedido
Given Usuário está logado no sistema
And acessa a lista de pedidos realizados
And seleciona um pedido xpto
And solicita extração de um relatório do pedido no formato pdf
When o usuário abrir o relatório de pedidos
Then as informações de cubagem total do pedido estarão visíveis para o usuário.

'''Scenario4''': Cubagem habilitada - visualização nas informações do pedido em tela
Given Usuário está logado no sistema
And acessa a lista de pedidos realizados
And seleciona um pedido xpto
And acessa as informações gerais do pedido
When o usuário abrir as informações de endereço
Then as informações de cubagem total do pedido estarão visíveis para o usuário.
But se o usuário deseja ver informações de cubagem referentes ao item
When o usuário abrir as informações de itens do pedido
And selecionar um item específico
Then as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T12:28:15Z

Ramon.queiroz: /* Cenários */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

Feature: Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

Scenario1: Cubagem habilitada - visualização unitária por item
Given Usuário está logado no sistema
And acessa a tela de pedidos
And acessa o ícone de informação de item
When o card do item estiver aberto
Then as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

Scenario2: Cubagem habilitada - visualização total por pedido
Given Usuário está logado no sistema
And acessa a tela de pedidos
And realiza a seleção dos itens e as suas respectivas quantidades
And direciona-se para a tela de finalização do pedido
When o usuário acessar a aba de 'Resumo do Pedido'
Then as informações de cubagem total do pedido estará visível para o usuário.

Scenario3: Cubagem habilitada - visualização em relatório do pedido
Given Usuário está logado no sistema
And acessa a lista de pedidos realizados
And seleciona um pedido xpto
And solicita extração de um relatório do pedido no formato pdf
When o usuário abrir o relatório de pedidos
Then as informações de cubagem total do pedido estarão visíveis para o usuário.

Scenario4: Cubagem habilitada - visualização nas informações do pedido em tela
Given Usuário está logado no sistema
And acessa a lista de pedidos realizados
And seleciona um pedido xpto
And acessa as informações gerais do pedido
When o usuário abrir as informações de endereço
Then as informações de cubagem total do pedido estarão visíveis para o usuário.
But se o usuário deseja ver informações de cubagem referentes ao item
When o usuário abrir as informações de itens do pedido
And selecionar um item específico
Then as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-21T12:25:28Z

Ramon.queiroz: /* Cenários */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Cenário Descritivo ==

Feature: Cubagem
Como um usuário do sistema GeoSales
Usuário quer visualizar a cubagem no sistema GeoSales (portal e mobile)

Scenario1: Cubagem habilitada - visualização unitária por item
Given Usuário está logado no sistema
And acessa a tela de pedidos
And acessa o ícone de informação de item
When o card do item estiver aberto
Then as informações de dimensões (H, L, W), volume e a cubagem por quantidade estarão visíveis para a o usuário.

Scenario2: Cubagem habilitada - visualização total por pedido
Given Usuário está logado no sistema
And acessa a tela de pedidos
And realiza a seleção dos itens e as suas respectivas quantidades
And direciona-se para a tela de finalização do pedido
When o usuário acessar a aba de 'Resumo do Pedido'
Then as informações de cubagem total do pedido estará visível para o usuário.

Scenario3: Cubagem habilitada - visualização em relatório do pedido
Given Usuário está logado no sistema
And acessa a lista de pedidos realizados
And seleciona um pedido xpto
And solicita extração de um relatório do pedido no formato pdf
When o usuário abrir o relatório de pedidos
Then as informações de cubagem total do pedido estarão visíveis para o usuário.

Scenario4: Cubagem habilitada - visualização nas informações do pedido em tela
Given Usuário está logado no sistema
And acessa a lista de pedidos realizados
And seleciona um pedido xpto
And acessa as informações gerais do pedido
When o usuário abrir as informações de endereço
Then as informações de cubagem total do pedido estarão visíveis para o usuário.
But se o usuário deseja ver informações de cubagem referentes ao item
When o usuário abrir as informações de itens do pedido
And selecionar um item específico
Then as informações de cubagem unitárias do item estarão visíveis para o usuário.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-20T18:27:51Z

Ramon.queiroz: /* Cenários */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato '''pdf''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-20T18:19:19Z

Ramon.queiroz: /* Cenários */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato pdf '''''(apenas?)''''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

'''7.''' Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-20T18:04:01Z

Ramon.queiroz: /* Conceito de Cubagem na Visão do Cliente */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para a formação destes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato pdf '''''(apenas?)''''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

7. Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-20T18:03:42Z

Ramon.queiroz: /* Conceito de Cubagem na Visão do Cliente */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) e possui estes dados em seu ERP para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para estes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato pdf '''''(apenas?)''''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

7. Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-20T17:33:50Z

Ramon.queiroz: /* Regras de Negócios */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 19/09/2022 || João Ramon || Criação do documento
|-
|}

== Necessidade ==

O vendedor, ao fazer um pedido, possui a necessidade de saber a cubagem referente a todos os produtos inseridos nele. Por vezes, ele precisa recorrer ao seu gestor/setor de logística, para que ele seja informado da questão da cubagem e, porventura, repassar estes dados ao cliente.

Como cubagem, a empresa entende ser o somatório dos volumes das mercadorias em um pedido, para fins de fornecer ao vendedor a noção que ele precisa ter para poder gerir de forma mais assertiva as suas vendas.

== Solução ==

Proceder com a criação das estruturas necessárias para a produção e cálculo da cubagem do pedido, que deverá estar disponível no ambiente de portal e para os dispositivos móveis.
Ao trazer tais informações, estes dados deverão ser tratados dentro da plataforma e os valores de cubagem apresentados ao vendedor ao final do pedido. Estas informações deverão estar visíveis para acesso ao cliente pelos seguintes caminhos:
* De forma individual, no item do pedido, ao acessar o ícone de informações de produto, no card de item;
* de forma geral, no momento do fechamento do pedido, ao lado da informação do peso total do pedido, deve ser exibido o total de cubagem geral do pedido;
* No relatório do pedido, que é importado em pdf, ao lado das informações do peso total do pedido, deve ser exibido o valor da cubagem total do mesmo;
* Na tela de relatório de pedido na própria plataforma, na aba de informações gerais, Na seção 'informações de endereço', inserir um campo novo contando os dados de cubagem do pedido;
* Na mesma tela de relatório do pedido na plataforma (visualização em tela), na apresentação dos itens do pedido, inserir os dados individuais de cubagem por item e total.

== Implementação ==

=== Conceito de Cubagem na Visão do Cliente ===

De acordo com o que foi apanhado, o cliente considera as três dimensões (altura, largura e comprimento) para realizar o cálculo de cubagem, o que equivale ao volume, que deve ser apresentado em '''metros cúbicos (m³)'''. Considere a seguinte ilustração de um produto com as seguintes dimensões:

* Altura (H): 0,25 m
* Largura (W): 0,20 m
* Comprimento (L): 0,47 m

O volume será dado pelo produto entre H, W e L, portanto, este item terá o volume de 0,0235 m3. Este valor pode ser calculado pela sua quantidade. Neste caso, para um pedido com 10 unidades deste produto, o valor do volume será 10*0,0235 m³, ou 0,235 m³.

O cliente já possui, de forma estruturada as informações de Altura, Largura e Comprimento no seu ERP. Portanto, estas informações '''deverão ser integradas para o GeoSales''', para possibilitar a manipulação dos cálculos para estes valores.

== Cenários ==

'''1.''' Consideremos para a ilustração desta simulação dos itens 'X0001', 'X0002' e 'X0003', cada um com as seguintes dimensões.

{| class=wikitable
! Produto
! Altura (H)
! Comprimento (L)
! Largura (W)
|-
| X0001 || 0,20 || 0,30 || 0,40
|-
| X0002 || 0,25 || 0,40 || 0,60
|-
| X0003 || 0,80 || 0,50 || 0,30
|-
|}

Estas dimensões passarão a compor o quadro de informações de item, ao expandir o card do item acessando o ícone [[arquivo:info.png]].

'''2.''' Pelo exposto, temos que os volumas respectivos para os itens 'X0001', 'X0002' e 'X0003' são, respectivamente, 0,024 m³, 0,06 m³ e 0,12 m³. Estes valores também deverão estar visíveis no card de informações do item, acessando o ícone [[arquivo:info.png]].

'''3.''' Fornecidos estes dados, o vendedor irá realizar um pedido formatado na seguinte estrutura:

{| class=wikitable
! Produto
! Quantidade
|-
| X0001 || 15
|-
| X0002 || 20
|-
| X0003 || 50
|-
|}

'''4.''' Pelo exposto, teremos que, para o item 'X0001', o volume pela quantidade indicada será de 0,36 m³ (15 * 0,024), para o item 'X0002' será 1,2 m³ (20 * 0,6) e para o item 'X0003' será 6,0 m³ (50 * 0,12).

'''5.''' Como o pedido contempla os três itens e suas respectivas quantidades, teremos que a cubagem deste pedido é o somatório dos resultados dos volumes calculados em função do produto das quantidades solicitadas pelo vendedor. Assim sendo, a cubagem deste pedido será dada pela soma dos valores obtidos em (4): 0,36 + 1,2 + 6,0 = 7,56 m³.

'''6.''' Feitas as devidas considerações sobre a composição dos valores e como eles deverão se relacionar, deve-se definir as visualizações nos seguintes campos:

* No card de informações do item, por meio do acesso ao ícone [[arquivo:info.png]]; neste card deverão constar '''as três dimensões do item''' (que já existem no ERP do cliente e que deverão ser integradas para o GeoSales), o cálculo do volume pelas dimensões do item, '''de forma unitária''', e seu respectivo '''valor proporcional à quantidade''' inserida;

* Durante o fechamento do pedido, na aba de 'Resumo Pedido', além das informações já existentes (valores, taxas de frete, peso total), deve ser inserido o valor da cubagem total do pedido, considerando o somatório da quantidade de todos os itens solicitados. Neste espaço, o importante é saber os valores totais;

* Na retirada do relatório de pedidos, em formato pdf '''''(apenas?)''''', próximo às informações de peso total, deverá ser inserido o valor total da cubagem, considerando todos os cálculos e métodos supracitados;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações Gerais >>> Informações de Endereço, inserir o total da cubagem ao lado do valor do peso total, já existente na tela;

* Na visualização do pedido na própria tela do GeoSales (portal e mobile), nas Informações de Itens do Pedido, devem ser apresentados os valores individuais de cubagem.

[[arquivo:cubagem.png | 1300 px ]]

7. Por se tratar de uma funcionalidade específica, esta deverá ser habilitada via controle de ações. Portanto, deve-se inserir a função de habilitar a visualização de cubagem no pedido por meio do Controle de Permissões GeoSales.

== Regras de Negócios ==

'''[RN1]''' – A ordem de grandeza para aplicação da cubagem no GeoSales EVO será em metros cúbicos (m³), consistindo no produto das dimensões do item, multiplicado pela quantidade desejada e somada aos volumes e quantidades dos demais itens dentro de um pedido.

'''[RN2]''' – Os valores apresentados das dimensões do item, bem como seus cálculos de volume e quantidades, serão para fins de exibição, e não terão participação em outras questões de sistema, tais como lead time de faturamento/entrega, cálculo de frete, dentre outros. Os valores apresentados e calculados terão um propósito exclusivamente informativo, para fins de gestão de vendas.

'''[RN3]''' – Todas as informações referentes às dimensões dos itens já existem do lado do cliente, portanto, esta estrutura deverá ser trazida via integração para o GeoSales.

'''[RN4]''' – A visualização dos dados das dimensões dos itens e dos cálculos de volume para a cubagem dos pedidos deverão estar disponíveis tanto para o portal EVO quanto para a aplicação móvel.

'''[RN5]''' – A funcionalidade deverá ter a opção de ser habilitada/desabilitada por meio do controle de permissão >>> Controle de ações.

== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
|-
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data
! Assinatura
|-
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
|-
|}

Cubagem em Carga

2022-09-20T17:30:13Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-20T17:17:29Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-20T17:17:17Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-20T17:16:55Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-20T17:16:35Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-20T17:15:38Z

Ramon.queiroz: /* Cenários */

Arquivo:Cubagem.png

2022-09-20T17:14:54Z

Ramon.queiroz:

Cubagem em Carga

2022-09-20T13:02:18Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-20T13:01:44Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-20T12:47:55Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-20T12:47:27Z

Ramon.queiroz: /* Conceito de Cubagem na Visão do Cliente */

Cubagem em Carga

2022-09-20T12:32:06Z

Ramon.queiroz:

Cubagem em Carga

2022-09-20T11:48:59Z

Ramon.queiroz: /* Regras de Negócios */

Cubagem em Carga

2022-09-20T11:46:32Z

Ramon.queiroz: /* Necessidade */

Cubagem em Carga

2022-09-19T17:58:35Z

Ramon.queiroz: /* Regras de Negócios */

Cubagem em Carga

2022-09-19T17:57:55Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-19T17:37:48Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-19T17:29:12Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-19T17:28:11Z

Ramon.queiroz: /* Cenários */

Arquivo:Info.png

2022-09-19T17:26:49Z

Ramon.queiroz:

Cubagem em Carga

2022-09-19T17:24:40Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-19T17:19:50Z

Ramon.queiroz: /* Cenários */

Cubagem em Carga

2022-09-19T17:17:35Z

Ramon.queiroz:

Cubagem em Carga

2022-09-19T17:14:25Z

Ramon.queiroz: /* Implementação */

Cubagem em Carga

2022-09-19T17:12:37Z

Ramon.queiroz: /* Implementação */

Cubagem em Carga

2022-09-19T16:51:10Z

Ramon.queiroz:

Cubagem em Carga

2022-09-19T16:48:33Z

Ramon.queiroz: /* Implementação */