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

Disponibilização de Link de Boleto Financeiro

2026-07-21T18:26:58Z

Renatolima: /* Solução */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Portal e Mobile para consumir o novo campo da tabela TITULO do ERP que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Portal e Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional, em ambiente Web por e-mail e já em Mobile (WhatsApp, E-mail ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Portal/Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela Título.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Portal e Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com portal e dispositivos Android e iOS, conforme versões suportadas pelo Mobile, no caso de ambiente web o compartilhamento por e-mail e no mobile pode ser usado e-mail, WhatsApp, Telegram e outras possibilidades de acordo com o sistema operacional do Smartphone.

== Regras de Integração ==

'''[RI1] -''' O ERP disponibilizará o novo campo contendo a URL do boleto na tabela TITULO.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP gera ou recebe o link do boleto e grava o endereço na tabela Titulo.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T18:25:43Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Portal e Mobile para consumir o novo campo da tabela TITULO do ERP que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Portal e Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Portal/Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela Título.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Portal e Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com portal e dispositivos Android e iOS, conforme versões suportadas pelo Mobile, no caso de ambiente web o compartilhamento por e-mail e no mobile pode ser usado e-mail, WhatsApp, Telegram e outras possibilidades de acordo com o sistema operacional do Smartphone.

== Regras de Integração ==

'''[RI1] -''' O ERP disponibilizará o novo campo contendo a URL do boleto na tabela TITULO.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP gera ou recebe o link do boleto e grava o endereço na tabela Titulo.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T17:51:16Z

Renatolima: /* Pré-condições */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Portal e Mobile para consumir o novo campo da tabela TITULO do ERP que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Portal e Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Portal/Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela Título.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Portal e Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com portal e dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Integração ==

'''[RI1] -''' O ERP disponibilizará o novo campo contendo a URL do boleto na tabela TITULO.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP gera ou recebe o link do boleto e grava o endereço na tabela Titulo.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T17:50:52Z

Renatolima: /* Regras de Integração */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Portal e Mobile para consumir o novo campo da tabela TITULO do ERP que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Portal e Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Portal/Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Portal e Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com portal e dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Integração ==

'''[RI1] -''' O ERP disponibilizará o novo campo contendo a URL do boleto na tabela TITULO.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP gera ou recebe o link do boleto e grava o endereço na tabela Titulo.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T17:50:26Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Portal e Mobile para consumir o novo campo da tabela TITULO do ERP que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Portal e Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Portal/Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Portal e Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com portal e dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Integração ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP gera ou recebe o link do boleto e grava o endereço na tabela Titulo.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:57:14Z

Renatolima: /* Solução */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Portal e Mobile para consumir o novo campo da tabela TITULO do ERP que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Portal e Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Portal/Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Portal e Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com portal e dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Integração ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:55:34Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Portal/Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Portal e Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com portal e dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Integração ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:53:57Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Portal/Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Portal e Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com portal e dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:53:05Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Portal/Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com portal e dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:51:21Z

Renatolima: /* Atores */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Portal/Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:51:05Z

Renatolima: /* Atores */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:50:52Z

Renatolima: /* Escopo Incluso */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela de titulo.
* Disponibilização do link no Portal e Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:48:59Z

Renatolima: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre ERP e Mobile para disponibilização do novo campo da tabela;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:48:09Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre Protheus e Mobile para disponibilização do novo campo da tabela SE1;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

'''1.''' O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

'''2.''' A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

'''3.''' O Mobile sincroniza os títulos e armazena o link do boleto.

'''4.''' O usuário acessa a rotina de Títulos.

'''5.''' O sistema identifica que o título possui um link de boleto.

'''6.''' O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

'''7.''' O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:47:32Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre Protheus e Mobile para disponibilização do novo campo da tabela SE1;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''

1. O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

2. A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

3. O Mobile sincroniza os títulos e armazena o link do boleto.

4. O usuário acessa a rotina de Títulos.

5. O sistema identifica que o título possui um link de boleto.

6. O usuário pode escolher entre:

* Visualizar o boleto, abrindo o navegador do dispositivo; ou

* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

7. O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:46:39Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre Protheus e Mobile para disponibilização do novo campo da tabela SE1;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''
1.O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.

2.A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.

3.O Mobile sincroniza os títulos e armazena o link do boleto.

4.O usuário acessa a rotina de Títulos.

5.O sistema identifica que o título possui um link de boleto.

6.O usuário pode escolher entre:
* Visualizar o boleto, abrindo o navegador do dispositivo; ou
* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.

7.O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:46:21Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre Protheus e Mobile para disponibilização do novo campo da tabela SE1;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

'''Fluxo Resumido'''
1.O ERP Protheus gera ou recebe o link do boleto e grava o endereço na tabela SE1.
2.A API de integração disponibiliza o campo de link no retorno dos títulos financeiros.
3.O Mobile sincroniza os títulos e armazena o link do boleto.
4.O usuário acessa a rotina de Títulos.
5.O sistema identifica que o título possui um link de boleto.
6.O usuário pode escolher entre:
* Visualizar o boleto, abrindo o navegador do dispositivo; ou
* Compartilhar o link utilizando um aplicativo compatível instalado no aparelho.
7.O cliente recebe o acesso ao boleto sem necessidade de uma nova consulta ao ERP.

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:44:41Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre Protheus e Mobile para disponibilização do novo campo da tabela SE1;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==
[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:44:30Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre Protheus e Mobile para disponibilização do novo campo da tabela SE1;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==
[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1200px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:44:20Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre Protheus e Mobile para disponibilização do novo campo da tabela SE1;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==
[[Arquivo:Diagrama_disponibilidade_link_boleto.png|1000px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:44:05Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre Protheus e Mobile para disponibilização do novo campo da tabela SE1;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==
[[Arquivo:Diagrama_disponibilidade_link_boleto.png|800px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Arquivo:Diagrama disponibilidade link boleto.png

2026-07-21T15:43:28Z

Renatolima: 800px

== Descrição do arquivo ==

[[Arquivo:Diagrama_disponibilidade_link_boleto.png|800px]]

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:37:13Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre Protheus e Mobile para disponibilização do novo campo da tabela SE1;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:36:12Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE está implementando um processo para geração de boletos financeiros por meio de uma instituição financeira, onde o boleto será disponibilizado através de um link armazenado no ERP Protheus.

Para suportar esse novo processo, será criado um campo na tabela SE1 responsável por armazenar a URL do boleto gerado. Entretanto, atualmente o Mobile não disponibiliza essa informação aos usuários da equipe comercial.

A necessidade consiste em evoluir a rotina de Títulos do Mobile para consumir esse campo do ERP, permitindo que o representante comercial visualize o boleto ou compartilhe seu link diretamente com o cliente, reduzindo o tempo de atendimento e facilitando o processo de cobrança.

== Solução ==
Será desenvolvida uma evolução na rotina de Títulos do Mobile para consumir o novo campo da tabela SE1 que armazenará o link do boleto financeiro.

Quando existir um link válido para o título, o Mobile disponibilizará funcionalidades que permitam ao usuário:

* Visualizar o boleto utilizando o navegador padrão do dispositivo;
* Compartilhar o link do boleto através dos recursos nativos do sistema operacional (WhatsApp, E-mail, SMS ou outros aplicativos compatíveis).

A solução utilizará exclusivamente o link disponibilizado pelo ERP, não sendo responsável pela geração, alteração ou armazenamento do boleto.

== Implementação ==
A implementação compreenderá as seguintes atividades:

* Adequação da integração entre Protheus e Mobile para disponibilização do novo campo da tabela SE1;
* Inclusão do novo atributo no serviço/API responsável pela sincronização dos títulos financeiros;
* Alteração da tela de consulta de Títulos do Mobile para exibição da opção de boleto quando houver link disponível;
* Implementação da funcionalidade de abertura do link utilizando navegador externo;
* Implementação da funcionalidade de compartilhamento utilizando os recursos nativos do dispositivo;
* Tratamento de situações onde o título não possua boleto disponível.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Consumo do novo campo da tabela SE1.
* Disponibilização do link no Mobile.
* Visualização do boleto através do navegador do dispositivo.
* Compartilhamento do link utilizando aplicativos instalados no aparelho.
* Tratamento para títulos sem boleto.

=== Escopo Não Incluso ===
* Geração do boleto financeiro.
* Alterações na instituição financeira.
* Alterações na lógica financeira do ERP.
* Armazenamento ou edição do link no Mobile.
* Controle de expiração ou validade do boleto.
* Impressão de boletos.

== Atores ==
* Representante Comercial
* Supervisor Comercial
* ERP Protheus
* API de Integração
* Aplicação Mobile
* Instituição Financeira (provedora do boleto)

== Pré-condições ==
* O título financeiro deverá existir no ERP.
* O campo de link do boleto deverá estar preenchido na tabela SE1.
* O dispositivo deverá possuir acesso à internet para abertura do boleto.
* O usuário deverá possuir permissão para acessar a rotina de Títulos.
* A sincronização entre ERP e Mobile deverá estar concluída.

== Regras de Negócio ==
'''[RN1] -''' A funcionalidade será disponibilizada somente para títulos que possuam link de boleto preenchido.

'''[RN2] -''' Caso o campo do boleto esteja vazio, nenhuma opção de visualização ou compartilhamento deverá ser apresentada.

'''[RN3] -''' O Mobile apenas consumirá o link disponibilizado pelo ERP, não realizando qualquer validação sobre sua composição.

'''[RN4] -''' A visualização do boleto ocorrerá utilizando o navegador padrão do dispositivo.

'''[RN5] -''' O compartilhamento utilizará os mecanismos nativos do sistema operacional, respeitando os aplicativos instalados no aparelho.

'''[RN6] -''' Caso o link esteja inválido ou indisponível, a mensagem retornada será proveniente do navegador ou da instituição financeira, não sendo tratada pela aplicação Mobile.

'''[RN7] -''' A funcionalidade não permitirá edição do link pelo usuário.

'''[RN8] -''' O comportamento deverá ser compatível com dispositivos Android e iOS, conforme versões suportadas pelo Mobile.

== Regras de Negócio ==

'''[RI1] -''' O ERP Protheus disponibilizará o novo campo contendo a URL do boleto na tabela SE1.

'''[RI2] -''' A API de integração deverá disponibilizar o novo atributo em seu retorno JSON durante a sincronização dos títulos.

'''[RI3] -''' O Mobile deverá armazenar localmente o link recebido juntamente com os demais dados do título.

'''[RI4] -''' Durante a sincronização, caso o link seja alterado no ERP, o Mobile deverá atualizar a informação local.

'''[RI5] -''' O consumo do novo campo deverá manter compatibilidade com clientes que ainda não possuam a funcionalidade implementada, tratando o campo como opcional.

'''[RI6] -''' A integração deverá preservar integralmente a URL recebida, sem alterações ou formatações.

'''[RI7] -''' O Mobile deverá abrir exatamente a URL disponibilizada pela integração, sem redirecionamentos ou manipulações adicionais.

== Fluxograma ==

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:32:54Z

Renatolima: /* Pré-condições */

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:32:25Z

Renatolima: /* Atores */

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:32:04Z

Renatolima: /* Escopo Não Incluso */

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:31:12Z

Renatolima: /* Escopo Incluso */

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:30:38Z

Renatolima: /* Implementação */

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:30:02Z

Renatolima: /* Solução */

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:29:36Z

Renatolima: /* Necessidade */

Disponibilização de Link de Boleto Financeiro

2026-07-21T15:23:46Z

Renatolima: Criou página com '== Histórico de Alterações == {| class="wikitable" ! Data ! Quem ! Comentários |- | 21/07/2026 || Renato Lima || Criação do documento |- |} == Necessidade == ==...'

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 21/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

== Solução ==

== Implementação ==

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===

=== Escopo Não Incluso ===

== Atores ==

== Pré-condições ==

== Regras de Negócio ==
'''[RN1] -'''

'''[RN2] -'''

'''[RN3] -'''

'''[RN4] -'''

'''[RN5] -'''

'''[RN6] -'''

'''[RN7] -'''

'''[RN8] -'''

'''[RN9] -'''

== Fluxograma ==

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Projeto/Paulus

2026-07-21T15:15:11Z

Renatolima:

* [[Integrar das imagens dos produtos]]

* [[Apresentar ao vendedor a data da última visita]]

* [[Adicionar alerta ao finalizar pedido apresentando condição pagamento para confirmação do vendedor]]

* [[Sinalizar ao vendedor os clientes com contrato de produtos]]

* [[Apresentar ao vendedor a data da última compra]]

* [[Disponibilização de Link de Boleto Financeiro]]

Realizar atualização da integração de verbas

2026-07-17T11:52:25Z

Renatolima: /* Regras de Negócios */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 17/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O cliente utiliza a funcionalidade de verbas vinculadas aos pedidos e atualmente realiza a integração dessas informações por meio de uma view disponibilizada no banco de dados, consumida por seu processo de integração com o ERP.

Com a evolução da arquitetura de integração para utilização exclusiva de APIs REST, o cliente necessita que as informações das verbas lançadas nos pedidos também sejam disponibilizadas através da API em formato JSON, eliminando a dependência de acesso direto ao banco de dados e padronizando o processo de integração.

Essa necessidade permitirá que todas as informações relacionadas ao pedido, incluindo as verbas aplicadas, sejam consumidas por um único mecanismo de integração, garantindo maior segurança, padronização e aderência à arquitetura atual do cliente.

== Solução ==
Será realizada a evolução da API de integração de pedidos para disponibilizar, no retorno em formato JSON, as informações referentes às verbas vinculadas ao pedido.

A implementação contemplará a inclusão de uma estrutura específica para verbas dentro do objeto do pedido, contendo os mesmos dados atualmente disponibilizados pela view utilizada pelo cliente, preservando a consistência das informações já consumidas pelo processo de integração.

Com essa alteração, o integrador poderá obter todas as informações necessárias por meio da API, sem necessidade de consultas adicionais ao banco de dados, mantendo o padrão de comunicação baseado em serviços REST e simplificando a manutenção das integrações futuras.

== Regras de Negócios ==

'''[RN01] –''' As verbas vinculadas ao pedido deverão ser disponibilizadas no retorno da API de pedidos em formato JSON.

'''[RN02] –''' O retorno das verbas deverá conter todas as informações atualmente disponibilizadas pela view utilizada pelo processo de integração, garantindo compatibilidade com a implementação existente.

'''[RN03] –''' Para pedidos que não possuírem verbas associadas, a API deverá retornar a estrutura de verbas vazia (array vazio), mantendo o padrão do contrato da API.

'''[RN04] –''' Cada verba vinculada ao pedido deverá ser retornada como um objeto individual dentro da coleção de verbas do pedido.

'''[RN05] –''' A API deverá refletir o estado atual das verbas registradas no sistema no momento da consulta, considerando inclusões, alterações e exclusões já efetivadas.

'''[RN06] –''' A inclusão das informações de verbas não deverá alterar o comportamento atual da API para consumidores que não utilizam esse novo conjunto de dados, preservando a compatibilidade com integrações existentes.

'''[RN07] –''' A estrutura JSON deverá seguir o padrão de nomenclatura e serialização já adotado pelas demais entidades disponibilizadas pela API.

'''[RN08] –''' A disponibilização das verbas deverá respeitar os mesmos critérios de autenticação, autorização e segurança aplicados aos demais dados retornados pela API.

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

Realizar atualização da integração de verbas

2026-07-17T11:41:51Z

Renatolima: /* Solução */

Realizar atualização da integração de verbas

2026-07-17T11:41:21Z

Renatolima: /* Necessidade */

Realizar atualização da integração de verbas

2026-07-17T11:29:40Z

Renatolima: Criou página com '== Histórico de Alterações == {| class="wikitable" ! Data ! Quem ! Comentários |- | 17/07/2026 || Renato Lima || Criação do documento |- |} == Necessidade == == S...'

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 17/07/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

== Solução ==

== Regras de Negócios ==

'''[RN01] –'''

'''[RN02] –'''

'''[RN03] –'''

'''[RN04] –'''

'''[RN05] –'''

'''[RN06] –'''

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

Projeto/Casakm

2026-07-17T11:27:42Z

Renatolima:

* [[Cadastro de Sequência de aprovação de pendências]]

* [[ Sequência de aprovação de pendências]]

* [[ Cadastro de frete por % ou peso]]

* [[ Taxa financeira para pedidos neogrid]]

* [[ Criação de Visão de Relatório de Log de Pedidos Auto]]

* [[ Criação de Relatório de Verbas]]

* [[ Alteração de Condição de Pagamento para pedidos NeoGrid]]

* [[ Bloqueio de edição do campo tipo de frete]]

* [[ Realizar atualização da integração de verbas]]

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-07-09T15:22:25Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Possui a necessidade de ampliar a flexibilidade na aplicação de descontos comerciais, permitindo a criação de um novo tipo de desconto agrupado por tabela de preço e produto, com controle de validade por período de vigência.

Atualmente, o sistema contempla a funcionalidade de desconto por hierarquia, porém este modelo não atende integralmente ao cenário desejado, onde é necessário um nível adicional de segmentação e controle, possibilitando a definição de políticas comerciais mais específicas e aderentes às estratégias de precificação da empresa.

Dessa forma, torna-se necessária a implementação de uma nova modalidade de desconto que permita maior granularidade na concessão de descontos, mantendo a compatibilidade com as regras e processos já existentes no sistema.

== Solução ==
Será desenvolvida uma nova modalidade de desconto baseada na combinação de Tabela de Preço e Produto, utilizando como referência a estrutura já existente de desconto por hierarquia.

A solução contemplará:

Cadastro de descontos vinculados a uma tabela de preço específica;
Associação dos descontos a produtos específicos;
Definição de período de vigência através de data inicial e data final;
Reaproveitamento da estrutura operacional do desconto por hierarquia;
Aplicação automática durante o cálculo dos descontos do pedido;
Respeito às validações, restrições e comportamentos já existentes no mecanismo atual de descontos;
Consideração das regras de priorização já definidas pelo sistema para determinação do desconto aplicável.

== Implementação ==
Será implementada uma nova opção de Desconto por Tabela de Preço e Produto na funcionalidade de desconto hierarquia, com o objetivo de proporcionar maior flexibilidade na definição de políticas comerciais e permitir uma segmentação mais granular na concessão de descontos.

A solução será construída utilizando como referência a estrutura já existente de Desconto por Hierarquia, aproveitando seus mecanismos de validação, processamento e aplicação, de forma a manter a consistência operacional do sistema e minimizar impactos nos processos atualmente em uso.

A nova funcionalidade permitirá o cadastro de descontos vinculados simultaneamente a uma tabela de preço e a um produto específico, possibilitando a definição de um percentual de desconto e seu respectivo período de vigência, através de data inicial e data final.

Durante o processo de formação do pedido, o sistema realizará automaticamente a consulta dos descontos cadastrados e vigentes para a combinação de tabela de preço e produto selecionada, aplicando o desconto conforme as regras de cálculo e priorização já existentes no GeoSales.

Todas as validações, restrições e comportamentos atualmente utilizados no modelo de desconto por hierarquia serão preservados, garantindo que a nova modalidade de desconto opere de forma integrada ao processo comercial já estabelecido, sem comprometer a padronização das regras de negócio existentes.

A implementação contemplará os ajustes necessários nas estruturas de cadastro, consultas e processamento dos descontos, permitindo que o novo tipo de desconto seja administrado pelos usuários autorizados e considerado automaticamente pelo sistema durante a inclusão e manutenção dos pedidos.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Criação de estrutura para cadastro de desconto por tabela de preço e produto;
* Inclusão de campos para controle de vigência do desconto;
* Desenvolvimento das regras de consulta e validação durante a digitação do pedido;
* Integração com o motor de cálculo de descontos existente;
* Reutilização das regras e comportamentos já implementados para desconto hierárquico;
* Ajustes de telas e processos necessários para manutenção dos novos registros;
* Testes unitários e integrados da funcionalidade.

=== Escopo Não Incluso ===
* Alterações nas regras de prioridade atualmente existentes;
* Criação de novos tipos de descontos além do descrito neste documento;
* Alterações em processos de integração com sistemas terceiros;
* Desenvolvimento de relatórios gerenciais específicos;
* Revisão ou remodelagem da política comercial da CONTRATANTE.

== Atores ==
'''Administrador Comercial -''' Responsável por cadastrar, alterar, consultar e inativar os descontos por tabela de preço e produto.

'''Gestor Comercial -''' Responsável por definir as políticas comerciais e validar as configurações dos descontos cadastrados.

'''Vendedor -'''Usuário que realiza a inclusão de pedidos e terá os descontos aplicados automaticamente conforme as configurações vigentes.

'''Sistema GeoSales -'''Responsável por validar, consultar e aplicar automaticamente os descontos configurados durante o processo de formação do pedido.

== Pré-condições ==
* O usuário deverá possuir permissão de acesso ao cadastro de descontos.
* A tabela de preço deverá estar previamente cadastrada e ativa no sistema.
* O produto deverá estar previamente cadastrado e ativo no sistema.
* O percentual de desconto deverá estar dentro dos limites definidos pelas regras comerciais da empresa.
* O período de vigência informado deverá possuir data inicial e data final válidas.
* O pedido deverá possuir uma tabela de preço associada para que o desconto possa ser identificado e aplicado.
* As parametrizações relacionadas ao cálculo de descontos deverão estar devidamente configuradas no ambiente.

== Regras de Negócio ==

'''[RN1] - ''' '''Cadastro do Desconto'''

O sistema deverá permitir o cadastro de descontos vinculados obrigatoriamente a uma combinação de Tabela de Preço e Produto.

'''[RN2] - ''' '''Vigência do Desconto'''

Todo desconto cadastrado deverá possuir uma Data Inicial e uma Data Final de vigência. O desconto somente poderá ser considerado para aplicação quando a data do pedido estiver compreendida dentro do período informado.

'''[RN3] - ''' '''Validação de Período'''

O sistema não deverá permitir o cadastro de registros onde a Data Final seja inferior à Data Inicial.

'''[RN4] - ''' '''Produto Válido'''

O desconto somente poderá ser associado a produtos ativos e devidamente cadastrados no sistema.

'''[RN5] - ''' '''Tabela de Preço Válida'''

O desconto somente poderá ser associado a tabelas de preço ativas e devidamente cadastradas no sistema.

'''[RN6] - ''' '''Aplicação Automática'''

Durante a inclusão ou manutenção do pedido, o sistema deverá consultar automaticamente os descontos vigentes cadastrados para a combinação de tabela de preço e produto do item.

'''[RN7] - ''' '''Respeito às Regras Existentes'''

A nova modalidade de desconto deverá utilizar as mesmas validações, restrições e comportamentos já existentes na funcionalidade de Desconto por Hierarquia.

'''[RN8] - ''' '''Controle de Permissão'''

Somente usuários com permissão para manutenção de descontos poderão incluir, alterar, consultar ou excluir registros de desconto por tabela de preço e produto.

'''[RN9] - ''' '''Consideração da Vigência'''

Descontos com vigência expirada ou ainda não iniciada não deverão ser considerados durante o cálculo do pedido.

'''[RN10] - ''' '''Aplicação por Item'''

A validação e aplicação do desconto deverão ocorrer individualmente para cada item do pedido, considerando o produto e a tabela de preço utilizados no respectivo item.

'''[RN11] - ''' '''Priorização de Descontos'''

Quando existirem múltiplas regras de desconto elegíveis para um mesmo item, o sistema deverá respeitar as regras de priorização já implementadas no GeoSales.

'''[RN12] - ''' '''Atualização Imediata'''

Após o cadastro, alteração ou exclusão de um desconto, as novas informações deverão ser consideradas nas próximas inclusões e recálculos de pedidos, sem necessidade de intervenção manual adicional.

'''[RN13] - ''' '''Integridade dos Dados'''

O sistema deverá garantir a integridade dos vínculos entre desconto, produto e tabela de preço, impedindo referências a registros inexistentes ou inativos.

'''[RN14] - ''' '''Compatibilidade com Funcionalidades Existentes'''

A implementação não deverá alterar o comportamento das funcionalidades atualmente existentes de desconto por hierarquia, mantendo a compatibilidade com as regras já homologadas e em produção.

'''[RN15] - ''' '''Aplicação de Desconto'''

Aplicação de desconto, vai seguir o padrão da funcionalidade desconto hierarquia, já que o Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade, será mais uma opção da funcionalidade desconto hierarquia, onde de acordo com a configuração este desconto cadastrado pode alterar toda a faixa ou alterar apenas o valor mínimo da faixa.

== Fluxograma ==
[[Arquivo:Diagrama_sem_nome.drawio.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Implementação do Funil de Vendas Unificado para CRM no GeoSales - Funil de Vendas (CRM GeoSales)

2026-07-03T11:15:20Z

Renatolima: /* Integrações */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 24/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A necessidade de estruturar e acompanhar o processo comercial de forma padronizada, permitindo o gerenciamento completo de oportunidades de negócio desde a prospecção até a conversão em pedido.

Atualmente, existe a necessidade de disponibilizar uma funcionalidade de CRM que permita a criação de funis de vendas configuráveis, compostos por fases, regras de aplicação e histórico de movimentações, possibilitando maior controle sobre a evolução das negociações comerciais.

A solução deverá permitir que diferentes funis sejam utilizados conforme critérios previamente definidos, possibilitando o acompanhamento da jornada comercial dos prospects, oportunidades e pedidos, além da geração de indicadores de desempenho e auditoria das movimentações realizadas pelos usuários.

== Solução ==

Será disponibilizada no GeoSales uma funcionalidade de CRM baseada em um modelo de Funil Unificado, permitindo a configuração de funis para prospecção e vendas.

A solução contemplará:

* Cadastro de Funis de Vendas.
* Cadastro de fases por funil.
* Definição de ordem e percentual de progresso de cada fase.
* Configuração de critérios de aplicação dos funis.
* Inclusão de prospects, oportunidades ou pedidos dentro dos funis.
* Movimentação entre fases.
* Registro completo do histórico de tramitações.
* Consulta da situação atual de cada item no funil.
* Disponibilização de informações para relatórios e indicadores de conversão.

O modelo permitirá que um mesmo conceito de funil seja utilizado tanto para oportunidades comerciais quanto para pedidos, reduzindo complexidade de manutenção e aumentando a flexibilidade da solução.

== Implementação ==
A implementação será realizada através da criação da estrutura de CRM composta pelas entidades:

=== Cadastro de Funis ===

Responsável pela definição dos funis existentes no sistema.

Campos principais:

* Código do Funil
* Nome
* Tipo do Funil
* Prospect
* Pedido
* Status Ativo/Inativo

=== Cadastro de Fases do Funil ===

Permite configurar as etapas de cada funil.

Campos principais:

* Código da Fase
* Funil
* Nome da Fase
* Ordem
* Percentual de Conversão
* Status Ativo/Inativo

=== Configuração de Aplicação do Funil ===

Permite definir quais combinações de filtros utilizarão determinado funil.

Exemplos:

* Organização de Venda
* Canal de Venda
* Tipo de Venda
* Família de Produto

=== Cadastro de Itens no Funil ===

Permite vincular uma entidade comercial ao funil.

Exemplos:

* Prospect
* Pedido

Informações armazenadas:

* Funil utilizado
* Entidade vinculada
* Fase atual

=== Histórico de Tramitações ===

Responsável por registrar todas as movimentações realizadas durante o processo comercial.

Informações registradas:

* Data/Hora
* Usuário
* Fase de destino
* Observação da movimentação

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===

==== Configurações ====

* Cadastro de Funis.
* Cadastro de Fases.
* Ativação/Inativação.
* Configuração dos critérios de aplicação.

==== Operação CRM ====

* Inclusão de itens no funil.
* Atualização de fase.
* Consulta da fase atual.
* Consulta do histórico.
* Registro de observações.

==== Controle ====

* Auditoria de movimentações.
* Rastreabilidade completa.
* Percentual de evolução por fase.

==== Integrações ====

* Associação com Prospect.
* Associação com Pedidos.

=== Escopo Não Incluso ===

* Automatização de envio de e-mails.
* Integração com ferramentas externas de CRM.
* Integração com WhatsApp.
* Integração com telefonia.
* Workflows automáticos de aprovação.
* Inteligência artificial para sugestão de fases.
* Dashboards analíticos avançados.
* Metas comerciais.
* Gestão de campanhas de marketing.
* Automação de marketing.
* Previsão de vendas baseada em algoritmos estatísticos.

== Atores ==
'''Administrador CRM'''

Responsável por:

* Criar e manter funis.
* Criar e manter fases.
* Configurar critérios de aplicação.
* Consultar históricos.

'''Gestor Comercial'''

Responsável por:

* Acompanhar indicadores.
* Consultar evolução dos funis.
* Analisar conversões.
* Monitorar desempenho da equipe.

'''Vendedor'''

Responsável por:

* Incluir oportunidades.
* Atualizar fases.
* Registrar observações.
* Acompanhar negociações.

'''Sistema GeoSales'''

Responsável por:

* Identificar automaticamente o funil aplicável.
* Registrar histórico de movimentações.
* Controlar a fase atual do item.
* Aplicar regras de negócio.

== Pré-condições ==

* Usuário autenticado no sistema.
* Funil previamente cadastrado.
* Fases previamente configuradas.
* Critérios de aplicação definidos.
* Usuário possuir permissão para utilização do CRM.

== Regras de Negócio ==

'''[RN1] - Tipo de Funil'''

Todo funil deverá possuir um tipo:

* Prospect (P)
* Pedido (O)

'''[RN2] - Fases Obrigatórias'''

Um funil somente poderá ser ativado se possuir pelo menos uma fase cadastrada.

'''[RN3] - Ordem das Fases'''

Cada fase deverá possuir uma ordem única dentro do mesmo funil.

'''[RN4] - Percentual de Evolução'''

Cada fase poderá possuir um percentual representando o avanço médio esperado da negociação.

Valor permitido:

* 0 a 100%

'''[RN5] - Aplicação do Funil'''

O sistema deverá identificar automaticamente o funil aplicável considerando os filtros configurados.

'''[RN6] - Fase Atual'''

Todo item vinculado a um funil deverá possuir uma fase atual.

'''[RN7] - Histórico Obrigatório'''

Toda alteração de fase deverá gerar um registro de histórico.

'''[RN8] - Inativação'''

Funis e fases inativas não poderão ser utilizados em novos registros.

'''[RN9] - Integridade do Histórico'''

Registros históricos não poderão ser alterados ou excluídos após sua criação.

'''[RN10] - '''

== Fluxograma ==

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Implementação do Funil de Vendas Unificado para CRM no GeoSales - Funil de Vendas (CRM GeoSales)

2026-07-03T11:14:41Z

Renatolima: /* Cadastro de Itens no Funil */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 24/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A necessidade de estruturar e acompanhar o processo comercial de forma padronizada, permitindo o gerenciamento completo de oportunidades de negócio desde a prospecção até a conversão em pedido.

Atualmente, existe a necessidade de disponibilizar uma funcionalidade de CRM que permita a criação de funis de vendas configuráveis, compostos por fases, regras de aplicação e histórico de movimentações, possibilitando maior controle sobre a evolução das negociações comerciais.

A solução deverá permitir que diferentes funis sejam utilizados conforme critérios previamente definidos, possibilitando o acompanhamento da jornada comercial dos prospects, oportunidades e pedidos, além da geração de indicadores de desempenho e auditoria das movimentações realizadas pelos usuários.

== Solução ==

Será disponibilizada no GeoSales uma funcionalidade de CRM baseada em um modelo de Funil Unificado, permitindo a configuração de funis para prospecção e vendas.

A solução contemplará:

* Cadastro de Funis de Vendas.
* Cadastro de fases por funil.
* Definição de ordem e percentual de progresso de cada fase.
* Configuração de critérios de aplicação dos funis.
* Inclusão de prospects, oportunidades ou pedidos dentro dos funis.
* Movimentação entre fases.
* Registro completo do histórico de tramitações.
* Consulta da situação atual de cada item no funil.
* Disponibilização de informações para relatórios e indicadores de conversão.

O modelo permitirá que um mesmo conceito de funil seja utilizado tanto para oportunidades comerciais quanto para pedidos, reduzindo complexidade de manutenção e aumentando a flexibilidade da solução.

== Implementação ==
A implementação será realizada através da criação da estrutura de CRM composta pelas entidades:

=== Cadastro de Funis ===

Responsável pela definição dos funis existentes no sistema.

Campos principais:

* Código do Funil
* Nome
* Tipo do Funil
* Prospect
* Pedido
* Status Ativo/Inativo

=== Cadastro de Fases do Funil ===

Permite configurar as etapas de cada funil.

Campos principais:

* Código da Fase
* Funil
* Nome da Fase
* Ordem
* Percentual de Conversão
* Status Ativo/Inativo

=== Configuração de Aplicação do Funil ===

Permite definir quais combinações de filtros utilizarão determinado funil.

Exemplos:

* Organização de Venda
* Canal de Venda
* Tipo de Venda
* Família de Produto

=== Cadastro de Itens no Funil ===

Permite vincular uma entidade comercial ao funil.

Exemplos:

* Prospect
* Pedido

Informações armazenadas:

* Funil utilizado
* Entidade vinculada
* Fase atual

=== Histórico de Tramitações ===

Responsável por registrar todas as movimentações realizadas durante o processo comercial.

Informações registradas:

* Data/Hora
* Usuário
* Fase de destino
* Observação da movimentação

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===

==== Configurações ====

* Cadastro de Funis.
* Cadastro de Fases.
* Ativação/Inativação.
* Configuração dos critérios de aplicação.

==== Operação CRM ====

* Inclusão de itens no funil.
* Atualização de fase.
* Consulta da fase atual.
* Consulta do histórico.
* Registro de observações.

==== Controle ====

* Auditoria de movimentações.
* Rastreabilidade completa.
* Percentual de evolução por fase.

==== Integrações ====

* Associação com Leads.
* Associação com Oportunidades.
* Associação com Pedidos.

=== Escopo Não Incluso ===

* Automatização de envio de e-mails.
* Integração com ferramentas externas de CRM.
* Integração com WhatsApp.
* Integração com telefonia.
* Workflows automáticos de aprovação.
* Inteligência artificial para sugestão de fases.
* Dashboards analíticos avançados.
* Metas comerciais.
* Gestão de campanhas de marketing.
* Automação de marketing.
* Previsão de vendas baseada em algoritmos estatísticos.

== Atores ==
'''Administrador CRM'''

Responsável por:

* Criar e manter funis.
* Criar e manter fases.
* Configurar critérios de aplicação.
* Consultar históricos.

'''Gestor Comercial'''

Responsável por:

* Acompanhar indicadores.
* Consultar evolução dos funis.
* Analisar conversões.
* Monitorar desempenho da equipe.

'''Vendedor'''

Responsável por:

* Incluir oportunidades.
* Atualizar fases.
* Registrar observações.
* Acompanhar negociações.

'''Sistema GeoSales'''

Responsável por:

* Identificar automaticamente o funil aplicável.
* Registrar histórico de movimentações.
* Controlar a fase atual do item.
* Aplicar regras de negócio.

== Pré-condições ==

* Usuário autenticado no sistema.
* Funil previamente cadastrado.
* Fases previamente configuradas.
* Critérios de aplicação definidos.
* Usuário possuir permissão para utilização do CRM.

== Regras de Negócio ==

'''[RN1] - Tipo de Funil'''

Todo funil deverá possuir um tipo:

* Prospect (P)
* Pedido (O)

'''[RN2] - Fases Obrigatórias'''

Um funil somente poderá ser ativado se possuir pelo menos uma fase cadastrada.

'''[RN3] - Ordem das Fases'''

Cada fase deverá possuir uma ordem única dentro do mesmo funil.

'''[RN4] - Percentual de Evolução'''

Cada fase poderá possuir um percentual representando o avanço médio esperado da negociação.

Valor permitido:

* 0 a 100%

'''[RN5] - Aplicação do Funil'''

O sistema deverá identificar automaticamente o funil aplicável considerando os filtros configurados.

'''[RN6] - Fase Atual'''

Todo item vinculado a um funil deverá possuir uma fase atual.

'''[RN7] - Histórico Obrigatório'''

Toda alteração de fase deverá gerar um registro de histórico.

'''[RN8] - Inativação'''

Funis e fases inativas não poderão ser utilizados em novos registros.

'''[RN9] - Integridade do Histórico'''

Registros históricos não poderão ser alterados ou excluídos após sua criação.

'''[RN10] - '''

== Fluxograma ==

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Criação da fase dos prospect web e mobile

2026-06-25T18:09:58Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

Atualmente, o processo de gestão de prospects no CRM do Força de Vendas não possui uma identificação estruturada da '''fase do prospect''', o que limita o acompanhamento da evolução das oportunidades comerciais ao longo do funil de vendas.

A ausência dessa informação dificulta a geração de '''relatórios gerenciais e analíticos''', reduzindo a visibilidade sobre o estágio das negociações, taxa de conversão, tempo de permanência em cada etapa, identificação de gargalos e desempenho da equipe comercial.

Sem uma classificação padronizada das fases, o acompanhamento das oportunidades ocorre de forma subjetiva, comprometendo a confiabilidade das informações e dificultando a tomada de decisões estratégicas relacionadas à prospecção e conversão de clientes.

== Solução ==

Para atender a essa necessidade, será criada uma funcionalidade de '''Fase do Prospect''' no CRM do Força de Vendas, permitindo que cada prospect seja classificado de acordo com sua etapa dentro do processo comercial.

A solução contemplará a criação de um cadastro de fases, onde será possível definir a descrição da fase e seu percentual de conversão, permitindo a padronização do funil de vendas.

A fase selecionada será vinculada ao prospect e poderá ser atualizada durante todo o ciclo de negociação, possibilitando o acompanhamento da evolução das oportunidades comerciais.

As informações serão armazenadas e disponibilizadas para '''relatórios, dashboards e análises''', permitindo uma gestão mais eficiente do pipeline comercial, maior previsibilidade de vendas e acompanhamento do desempenho das negociações.

== Escopo ==

=== Escopo Incluso ===

* Criação do cadastro de '''Fases do Prospect''' no CRM.

* Possibilidade de cadastrar descrição e percentual de conversão para cada fase.

* Inclusão do campo '''Fase do Prospect''' no cadastro e manutenção de prospects.

* Persistência da informação da fase do prospect na base de dados.

* Registro do histórico de alterações da fase.

* Disponibilização da informação para relatórios e consultas analíticas.

* Controle de acesso através das permissões de perfil do sistema.

* Atualização da fase durante todo o ciclo de vida do prospect.

=== Escopo Não Incluso ===

* Criação ou customização de novos relatórios ou dashboards específicos.

* Automação de movimentação de fases através de integrações externas.

* Implementação de regras de automação de marketing.

* Integração da fase do prospect com sistemas externos não relacionados ao Força de Vendas.

* Revisão completa da metodologia comercial utilizada pela empresa.

* Treinamentos, materiais de capacitação ou definição de processos internos de vendas.

== Atores ==

'''Vendedor / Representante Comercial -'''
Responsável por cadastrar prospects, atualizar fases e acompanhar a evolução das oportunidades comerciais.

'''Gestor Comercial -'''
Responsável por monitorar o funil de vendas, acompanhar indicadores e analisar a evolução dos prospects através de relatórios e dashboards.

'''Administrador do Sistema -'''
Responsável por cadastrar e manter as fases do prospect, definir percentuais e controlar permissões de acesso.

'''CRM Força de Vendas -'''
Responsável por armazenar, controlar e disponibilizar as informações das fases para consultas e análises.

== Pré-condições ==

* O usuário deverá estar autenticado no CRM do Força de Vendas.

* O usuário deverá possuir permissão para inclusão ou manutenção de prospects.

* As fases do prospect deverão estar previamente cadastradas e ativas.

* O prospect deverá estar em situação que permita atualização de informações.

== Regras de Negócio ==

'''[RN1] -'''
O campo '''Fase do Prospect''' deverá estar disponível no cadastro e manutenção de prospects, sendo sua exibição controlada pelas permissões de perfil do usuário.

'''[RN2] -'''
O preenchimento da '''Fase do Prospect''' deverá ocorrer através de uma lista padronizada de fases previamente cadastradas no sistema, contendo descrição e percentual de conversão.

'''[RN3] -'''
O sistema deverá disponibilizar uma tela de manutenção para cadastro das fases, permitindo informar:

* Descrição da fase;
* Percentual de conversão;
* Situação (Ativa/Inativa).

'''[RN4] -'''
A fase do prospect poderá ser alterada durante todo o ciclo de vida da oportunidade, respeitando as permissões do usuário.

'''[RN5] -'''
A informação registrada deverá ser persistida e disponibilizada para relatórios, dashboards e consultas analíticas.

'''[RN6] -'''
Toda alteração da fase deverá refletir imediatamente nas informações consolidadas do CRM.

'''[RN7] -'''
A ausência de preenchimento da fase, quando não obrigatória, não deverá impedir o cadastro ou manutenção do prospect.

'''[RN8] -'''
As alterações realizadas na fase deverão gerar histórico, registrando obrigatoriamente:

* Fase anterior;
* Nova fase;
* Data e hora da alteração;
* Usuário responsável pela alteração.

'''[RN9] -'''
O histórico das alterações deverá permanecer disponível para consultas e auditorias, permitindo acompanhar o tempo de permanência do prospect em cada etapa do funil.

'''[RN10] -'''
Quando um prospect for convertido em cliente ou oportunidade efetivada conforme regra do processo comercial da empresa, o sistema deverá permitir associar automaticamente a fase final configurada para encerramento do funil.

'''[RN11] -'''
Fases marcadas como inativas não poderão ser utilizadas em novos cadastros ou alterações, porém deverão permanecer visíveis nos registros históricos.

'''[RN12] -'''
Os relatórios deverão permitir filtros, agrupamentos e análises por fase do prospect e percentual de conversão.

== Fluxograma ==
'''Fluxograma do Cadastro de Fases do Prospect'''

[[Arquivo:fase prospect.drawio.png|1100px]]

'''Fluxograma Completo do Funil Comercial'''

[[Arquivo:Funil_prospect.drawio.png|1100px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Arquivo:Funil prospect.drawio.png

2026-06-25T18:09:09Z

Renatolima:

Criação da fase dos prospect web e mobile

2026-06-25T18:07:41Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

Atualmente, o processo de gestão de prospects no CRM do Força de Vendas não possui uma identificação estruturada da '''fase do prospect''', o que limita o acompanhamento da evolução das oportunidades comerciais ao longo do funil de vendas.

A ausência dessa informação dificulta a geração de '''relatórios gerenciais e analíticos''', reduzindo a visibilidade sobre o estágio das negociações, taxa de conversão, tempo de permanência em cada etapa, identificação de gargalos e desempenho da equipe comercial.

Sem uma classificação padronizada das fases, o acompanhamento das oportunidades ocorre de forma subjetiva, comprometendo a confiabilidade das informações e dificultando a tomada de decisões estratégicas relacionadas à prospecção e conversão de clientes.

== Solução ==

Para atender a essa necessidade, será criada uma funcionalidade de '''Fase do Prospect''' no CRM do Força de Vendas, permitindo que cada prospect seja classificado de acordo com sua etapa dentro do processo comercial.

A solução contemplará a criação de um cadastro de fases, onde será possível definir a descrição da fase e seu percentual de conversão, permitindo a padronização do funil de vendas.

A fase selecionada será vinculada ao prospect e poderá ser atualizada durante todo o ciclo de negociação, possibilitando o acompanhamento da evolução das oportunidades comerciais.

As informações serão armazenadas e disponibilizadas para '''relatórios, dashboards e análises''', permitindo uma gestão mais eficiente do pipeline comercial, maior previsibilidade de vendas e acompanhamento do desempenho das negociações.

== Escopo ==

=== Escopo Incluso ===

* Criação do cadastro de '''Fases do Prospect''' no CRM.

* Possibilidade de cadastrar descrição e percentual de conversão para cada fase.

* Inclusão do campo '''Fase do Prospect''' no cadastro e manutenção de prospects.

* Persistência da informação da fase do prospect na base de dados.

* Registro do histórico de alterações da fase.

* Disponibilização da informação para relatórios e consultas analíticas.

* Controle de acesso através das permissões de perfil do sistema.

* Atualização da fase durante todo o ciclo de vida do prospect.

=== Escopo Não Incluso ===

* Criação ou customização de novos relatórios ou dashboards específicos.

* Automação de movimentação de fases através de integrações externas.

* Implementação de regras de automação de marketing.

* Integração da fase do prospect com sistemas externos não relacionados ao Força de Vendas.

* Revisão completa da metodologia comercial utilizada pela empresa.

* Treinamentos, materiais de capacitação ou definição de processos internos de vendas.

== Atores ==

'''Vendedor / Representante Comercial -'''
Responsável por cadastrar prospects, atualizar fases e acompanhar a evolução das oportunidades comerciais.

'''Gestor Comercial -'''
Responsável por monitorar o funil de vendas, acompanhar indicadores e analisar a evolução dos prospects através de relatórios e dashboards.

'''Administrador do Sistema -'''
Responsável por cadastrar e manter as fases do prospect, definir percentuais e controlar permissões de acesso.

'''CRM Força de Vendas -'''
Responsável por armazenar, controlar e disponibilizar as informações das fases para consultas e análises.

== Pré-condições ==

* O usuário deverá estar autenticado no CRM do Força de Vendas.

* O usuário deverá possuir permissão para inclusão ou manutenção de prospects.

* As fases do prospect deverão estar previamente cadastradas e ativas.

* O prospect deverá estar em situação que permita atualização de informações.

== Regras de Negócio ==

'''[RN1] -'''
O campo '''Fase do Prospect''' deverá estar disponível no cadastro e manutenção de prospects, sendo sua exibição controlada pelas permissões de perfil do usuário.

'''[RN2] -'''
O preenchimento da '''Fase do Prospect''' deverá ocorrer através de uma lista padronizada de fases previamente cadastradas no sistema, contendo descrição e percentual de conversão.

'''[RN3] -'''
O sistema deverá disponibilizar uma tela de manutenção para cadastro das fases, permitindo informar:

* Descrição da fase;
* Percentual de conversão;
* Situação (Ativa/Inativa).

'''[RN4] -'''
A fase do prospect poderá ser alterada durante todo o ciclo de vida da oportunidade, respeitando as permissões do usuário.

'''[RN5] -'''
A informação registrada deverá ser persistida e disponibilizada para relatórios, dashboards e consultas analíticas.

'''[RN6] -'''
Toda alteração da fase deverá refletir imediatamente nas informações consolidadas do CRM.

'''[RN7] -'''
A ausência de preenchimento da fase, quando não obrigatória, não deverá impedir o cadastro ou manutenção do prospect.

'''[RN8] -'''
As alterações realizadas na fase deverão gerar histórico, registrando obrigatoriamente:

* Fase anterior;
* Nova fase;
* Data e hora da alteração;
* Usuário responsável pela alteração.

'''[RN9] -'''
O histórico das alterações deverá permanecer disponível para consultas e auditorias, permitindo acompanhar o tempo de permanência do prospect em cada etapa do funil.

'''[RN10] -'''
Quando um prospect for convertido em cliente ou oportunidade efetivada conforme regra do processo comercial da empresa, o sistema deverá permitir associar automaticamente a fase final configurada para encerramento do funil.

'''[RN11] -'''
Fases marcadas como inativas não poderão ser utilizadas em novos cadastros ou alterações, porém deverão permanecer visíveis nos registros históricos.

'''[RN12] -'''
Os relatórios deverão permitir filtros, agrupamentos e análises por fase do prospect e percentual de conversão.

== Fluxograma ==
'''Fluxograma do Cadastro de Fases do Prospect'''

[[Arquivo:fase prospect.drawio.png|1100px]]

'''Fluxograma Completo do Funil Comercial'''

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Criação da fase dos prospect web e mobile

2026-06-25T18:07:23Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

Atualmente, o processo de gestão de prospects no CRM do Força de Vendas não possui uma identificação estruturada da '''fase do prospect''', o que limita o acompanhamento da evolução das oportunidades comerciais ao longo do funil de vendas.

A ausência dessa informação dificulta a geração de '''relatórios gerenciais e analíticos''', reduzindo a visibilidade sobre o estágio das negociações, taxa de conversão, tempo de permanência em cada etapa, identificação de gargalos e desempenho da equipe comercial.

Sem uma classificação padronizada das fases, o acompanhamento das oportunidades ocorre de forma subjetiva, comprometendo a confiabilidade das informações e dificultando a tomada de decisões estratégicas relacionadas à prospecção e conversão de clientes.

== Solução ==

Para atender a essa necessidade, será criada uma funcionalidade de '''Fase do Prospect''' no CRM do Força de Vendas, permitindo que cada prospect seja classificado de acordo com sua etapa dentro do processo comercial.

A solução contemplará a criação de um cadastro de fases, onde será possível definir a descrição da fase e seu percentual de conversão, permitindo a padronização do funil de vendas.

A fase selecionada será vinculada ao prospect e poderá ser atualizada durante todo o ciclo de negociação, possibilitando o acompanhamento da evolução das oportunidades comerciais.

As informações serão armazenadas e disponibilizadas para '''relatórios, dashboards e análises''', permitindo uma gestão mais eficiente do pipeline comercial, maior previsibilidade de vendas e acompanhamento do desempenho das negociações.

== Escopo ==

=== Escopo Incluso ===

* Criação do cadastro de '''Fases do Prospect''' no CRM.

* Possibilidade de cadastrar descrição e percentual de conversão para cada fase.

* Inclusão do campo '''Fase do Prospect''' no cadastro e manutenção de prospects.

* Persistência da informação da fase do prospect na base de dados.

* Registro do histórico de alterações da fase.

* Disponibilização da informação para relatórios e consultas analíticas.

* Controle de acesso através das permissões de perfil do sistema.

* Atualização da fase durante todo o ciclo de vida do prospect.

=== Escopo Não Incluso ===

* Criação ou customização de novos relatórios ou dashboards específicos.

* Automação de movimentação de fases através de integrações externas.

* Implementação de regras de automação de marketing.

* Integração da fase do prospect com sistemas externos não relacionados ao Força de Vendas.

* Revisão completa da metodologia comercial utilizada pela empresa.

* Treinamentos, materiais de capacitação ou definição de processos internos de vendas.

== Atores ==

'''Vendedor / Representante Comercial -'''
Responsável por cadastrar prospects, atualizar fases e acompanhar a evolução das oportunidades comerciais.

'''Gestor Comercial -'''
Responsável por monitorar o funil de vendas, acompanhar indicadores e analisar a evolução dos prospects através de relatórios e dashboards.

'''Administrador do Sistema -'''
Responsável por cadastrar e manter as fases do prospect, definir percentuais e controlar permissões de acesso.

'''CRM Força de Vendas -'''
Responsável por armazenar, controlar e disponibilizar as informações das fases para consultas e análises.

== Pré-condições ==

* O usuário deverá estar autenticado no CRM do Força de Vendas.

* O usuário deverá possuir permissão para inclusão ou manutenção de prospects.

* As fases do prospect deverão estar previamente cadastradas e ativas.

* O prospect deverá estar em situação que permita atualização de informações.

== Regras de Negócio ==

'''[RN1] -'''
O campo '''Fase do Prospect''' deverá estar disponível no cadastro e manutenção de prospects, sendo sua exibição controlada pelas permissões de perfil do usuário.

'''[RN2] -'''
O preenchimento da '''Fase do Prospect''' deverá ocorrer através de uma lista padronizada de fases previamente cadastradas no sistema, contendo descrição e percentual de conversão.

'''[RN3] -'''
O sistema deverá disponibilizar uma tela de manutenção para cadastro das fases, permitindo informar:

* Descrição da fase;
* Percentual de conversão;
* Situação (Ativa/Inativa).

'''[RN4] -'''
A fase do prospect poderá ser alterada durante todo o ciclo de vida da oportunidade, respeitando as permissões do usuário.

'''[RN5] -'''
A informação registrada deverá ser persistida e disponibilizada para relatórios, dashboards e consultas analíticas.

'''[RN6] -'''
Toda alteração da fase deverá refletir imediatamente nas informações consolidadas do CRM.

'''[RN7] -'''
A ausência de preenchimento da fase, quando não obrigatória, não deverá impedir o cadastro ou manutenção do prospect.

'''[RN8] -'''
As alterações realizadas na fase deverão gerar histórico, registrando obrigatoriamente:

* Fase anterior;
* Nova fase;
* Data e hora da alteração;
* Usuário responsável pela alteração.

'''[RN9] -'''
O histórico das alterações deverá permanecer disponível para consultas e auditorias, permitindo acompanhar o tempo de permanência do prospect em cada etapa do funil.

'''[RN10] -'''
Quando um prospect for convertido em cliente ou oportunidade efetivada conforme regra do processo comercial da empresa, o sistema deverá permitir associar automaticamente a fase final configurada para encerramento do funil.

'''[RN11] -'''
Fases marcadas como inativas não poderão ser utilizadas em novos cadastros ou alterações, porém deverão permanecer visíveis nos registros históricos.

'''[RN12] -'''
Os relatórios deverão permitir filtros, agrupamentos e análises por fase do prospect e percentual de conversão.

== Fluxograma ==
'''Fluxograma do Cadastro de Fases do Prospect'''

[[Arquivo:fase prospect.drawio.png|1200px]]

'''Fluxograma Completo do Funil Comercial'''

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Criação da fase dos prospect web e mobile

2026-06-25T18:02:40Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

Atualmente, o processo de gestão de prospects no CRM do Força de Vendas não possui uma identificação estruturada da '''fase do prospect''', o que limita o acompanhamento da evolução das oportunidades comerciais ao longo do funil de vendas.

A ausência dessa informação dificulta a geração de '''relatórios gerenciais e analíticos''', reduzindo a visibilidade sobre o estágio das negociações, taxa de conversão, tempo de permanência em cada etapa, identificação de gargalos e desempenho da equipe comercial.

Sem uma classificação padronizada das fases, o acompanhamento das oportunidades ocorre de forma subjetiva, comprometendo a confiabilidade das informações e dificultando a tomada de decisões estratégicas relacionadas à prospecção e conversão de clientes.

== Solução ==

Para atender a essa necessidade, será criada uma funcionalidade de '''Fase do Prospect''' no CRM do Força de Vendas, permitindo que cada prospect seja classificado de acordo com sua etapa dentro do processo comercial.

A solução contemplará a criação de um cadastro de fases, onde será possível definir a descrição da fase e seu percentual de conversão, permitindo a padronização do funil de vendas.

A fase selecionada será vinculada ao prospect e poderá ser atualizada durante todo o ciclo de negociação, possibilitando o acompanhamento da evolução das oportunidades comerciais.

As informações serão armazenadas e disponibilizadas para '''relatórios, dashboards e análises''', permitindo uma gestão mais eficiente do pipeline comercial, maior previsibilidade de vendas e acompanhamento do desempenho das negociações.

== Escopo ==

=== Escopo Incluso ===

* Criação do cadastro de '''Fases do Prospect''' no CRM.

* Possibilidade de cadastrar descrição e percentual de conversão para cada fase.

* Inclusão do campo '''Fase do Prospect''' no cadastro e manutenção de prospects.

* Persistência da informação da fase do prospect na base de dados.

* Registro do histórico de alterações da fase.

* Disponibilização da informação para relatórios e consultas analíticas.

* Controle de acesso através das permissões de perfil do sistema.

* Atualização da fase durante todo o ciclo de vida do prospect.

=== Escopo Não Incluso ===

* Criação ou customização de novos relatórios ou dashboards específicos.

* Automação de movimentação de fases através de integrações externas.

* Implementação de regras de automação de marketing.

* Integração da fase do prospect com sistemas externos não relacionados ao Força de Vendas.

* Revisão completa da metodologia comercial utilizada pela empresa.

* Treinamentos, materiais de capacitação ou definição de processos internos de vendas.

== Atores ==

'''Vendedor / Representante Comercial -'''
Responsável por cadastrar prospects, atualizar fases e acompanhar a evolução das oportunidades comerciais.

'''Gestor Comercial -'''
Responsável por monitorar o funil de vendas, acompanhar indicadores e analisar a evolução dos prospects através de relatórios e dashboards.

'''Administrador do Sistema -'''
Responsável por cadastrar e manter as fases do prospect, definir percentuais e controlar permissões de acesso.

'''CRM Força de Vendas -'''
Responsável por armazenar, controlar e disponibilizar as informações das fases para consultas e análises.

== Pré-condições ==

* O usuário deverá estar autenticado no CRM do Força de Vendas.

* O usuário deverá possuir permissão para inclusão ou manutenção de prospects.

* As fases do prospect deverão estar previamente cadastradas e ativas.

* O prospect deverá estar em situação que permita atualização de informações.

== Regras de Negócio ==

'''[RN1] -'''
O campo '''Fase do Prospect''' deverá estar disponível no cadastro e manutenção de prospects, sendo sua exibição controlada pelas permissões de perfil do usuário.

'''[RN2] -'''
O preenchimento da '''Fase do Prospect''' deverá ocorrer através de uma lista padronizada de fases previamente cadastradas no sistema, contendo descrição e percentual de conversão.

'''[RN3] -'''
O sistema deverá disponibilizar uma tela de manutenção para cadastro das fases, permitindo informar:

* Descrição da fase;
* Percentual de conversão;
* Situação (Ativa/Inativa).

'''[RN4] -'''
A fase do prospect poderá ser alterada durante todo o ciclo de vida da oportunidade, respeitando as permissões do usuário.

'''[RN5] -'''
A informação registrada deverá ser persistida e disponibilizada para relatórios, dashboards e consultas analíticas.

'''[RN6] -'''
Toda alteração da fase deverá refletir imediatamente nas informações consolidadas do CRM.

'''[RN7] -'''
A ausência de preenchimento da fase, quando não obrigatória, não deverá impedir o cadastro ou manutenção do prospect.

'''[RN8] -'''
As alterações realizadas na fase deverão gerar histórico, registrando obrigatoriamente:

* Fase anterior;
* Nova fase;
* Data e hora da alteração;
* Usuário responsável pela alteração.

'''[RN9] -'''
O histórico das alterações deverá permanecer disponível para consultas e auditorias, permitindo acompanhar o tempo de permanência do prospect em cada etapa do funil.

'''[RN10] -'''
Quando um prospect for convertido em cliente ou oportunidade efetivada conforme regra do processo comercial da empresa, o sistema deverá permitir associar automaticamente a fase final configurada para encerramento do funil.

'''[RN11] -'''
Fases marcadas como inativas não poderão ser utilizadas em novos cadastros ou alterações, porém deverão permanecer visíveis nos registros históricos.

'''[RN12] -'''
Os relatórios deverão permitir filtros, agrupamentos e análises por fase do prospect e percentual de conversão.

== Fluxograma ==
'''Fluxograma do Cadastro de Fases do Prospect'''

[[Arquivo:fase prospect.drawio.png|1000px]]

'''Fluxograma Completo do Funil Comercial'''

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Criação da fase dos prospect web e mobile

2026-06-25T18:00:53Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

Atualmente, o processo de gestão de prospects no CRM do Força de Vendas não possui uma identificação estruturada da '''fase do prospect''', o que limita o acompanhamento da evolução das oportunidades comerciais ao longo do funil de vendas.

A ausência dessa informação dificulta a geração de '''relatórios gerenciais e analíticos''', reduzindo a visibilidade sobre o estágio das negociações, taxa de conversão, tempo de permanência em cada etapa, identificação de gargalos e desempenho da equipe comercial.

Sem uma classificação padronizada das fases, o acompanhamento das oportunidades ocorre de forma subjetiva, comprometendo a confiabilidade das informações e dificultando a tomada de decisões estratégicas relacionadas à prospecção e conversão de clientes.

== Solução ==

Para atender a essa necessidade, será criada uma funcionalidade de '''Fase do Prospect''' no CRM do Força de Vendas, permitindo que cada prospect seja classificado de acordo com sua etapa dentro do processo comercial.

A solução contemplará a criação de um cadastro de fases, onde será possível definir a descrição da fase e seu percentual de conversão, permitindo a padronização do funil de vendas.

A fase selecionada será vinculada ao prospect e poderá ser atualizada durante todo o ciclo de negociação, possibilitando o acompanhamento da evolução das oportunidades comerciais.

As informações serão armazenadas e disponibilizadas para '''relatórios, dashboards e análises''', permitindo uma gestão mais eficiente do pipeline comercial, maior previsibilidade de vendas e acompanhamento do desempenho das negociações.

== Escopo ==

=== Escopo Incluso ===

* Criação do cadastro de '''Fases do Prospect''' no CRM.

* Possibilidade de cadastrar descrição e percentual de conversão para cada fase.

* Inclusão do campo '''Fase do Prospect''' no cadastro e manutenção de prospects.

* Persistência da informação da fase do prospect na base de dados.

* Registro do histórico de alterações da fase.

* Disponibilização da informação para relatórios e consultas analíticas.

* Controle de acesso através das permissões de perfil do sistema.

* Atualização da fase durante todo o ciclo de vida do prospect.

=== Escopo Não Incluso ===

* Criação ou customização de novos relatórios ou dashboards específicos.

* Automação de movimentação de fases através de integrações externas.

* Implementação de regras de automação de marketing.

* Integração da fase do prospect com sistemas externos não relacionados ao Força de Vendas.

* Revisão completa da metodologia comercial utilizada pela empresa.

* Treinamentos, materiais de capacitação ou definição de processos internos de vendas.

== Atores ==

'''Vendedor / Representante Comercial -'''
Responsável por cadastrar prospects, atualizar fases e acompanhar a evolução das oportunidades comerciais.

'''Gestor Comercial -'''
Responsável por monitorar o funil de vendas, acompanhar indicadores e analisar a evolução dos prospects através de relatórios e dashboards.

'''Administrador do Sistema -'''
Responsável por cadastrar e manter as fases do prospect, definir percentuais e controlar permissões de acesso.

'''CRM Força de Vendas -'''
Responsável por armazenar, controlar e disponibilizar as informações das fases para consultas e análises.

== Pré-condições ==

* O usuário deverá estar autenticado no CRM do Força de Vendas.

* O usuário deverá possuir permissão para inclusão ou manutenção de prospects.

* As fases do prospect deverão estar previamente cadastradas e ativas.

* O prospect deverá estar em situação que permita atualização de informações.

== Regras de Negócio ==

'''[RN1] -'''
O campo '''Fase do Prospect''' deverá estar disponível no cadastro e manutenção de prospects, sendo sua exibição controlada pelas permissões de perfil do usuário.

'''[RN2] -'''
O preenchimento da '''Fase do Prospect''' deverá ocorrer através de uma lista padronizada de fases previamente cadastradas no sistema, contendo descrição e percentual de conversão.

'''[RN3] -'''
O sistema deverá disponibilizar uma tela de manutenção para cadastro das fases, permitindo informar:

* Descrição da fase;
* Percentual de conversão;
* Situação (Ativa/Inativa).

'''[RN4] -'''
A fase do prospect poderá ser alterada durante todo o ciclo de vida da oportunidade, respeitando as permissões do usuário.

'''[RN5] -'''
A informação registrada deverá ser persistida e disponibilizada para relatórios, dashboards e consultas analíticas.

'''[RN6] -'''
Toda alteração da fase deverá refletir imediatamente nas informações consolidadas do CRM.

'''[RN7] -'''
A ausência de preenchimento da fase, quando não obrigatória, não deverá impedir o cadastro ou manutenção do prospect.

'''[RN8] -'''
As alterações realizadas na fase deverão gerar histórico, registrando obrigatoriamente:

* Fase anterior;
* Nova fase;
* Data e hora da alteração;
* Usuário responsável pela alteração.

'''[RN9] -'''
O histórico das alterações deverá permanecer disponível para consultas e auditorias, permitindo acompanhar o tempo de permanência do prospect em cada etapa do funil.

'''[RN10] -'''
Quando um prospect for convertido em cliente ou oportunidade efetivada conforme regra do processo comercial da empresa, o sistema deverá permitir associar automaticamente a fase final configurada para encerramento do funil.

'''[RN11] -'''
Fases marcadas como inativas não poderão ser utilizadas em novos cadastros ou alterações, porém deverão permanecer visíveis nos registros históricos.

'''[RN12] -'''
Os relatórios deverão permitir filtros, agrupamentos e análises por fase do prospect e percentual de conversão.

== Fluxograma ==
[[Arquivo:fase prospect.drawio.png|1000px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Criação da fase dos prospect web e mobile

2026-06-25T18:00:40Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

Atualmente, o processo de gestão de prospects no CRM do Força de Vendas não possui uma identificação estruturada da '''fase do prospect''', o que limita o acompanhamento da evolução das oportunidades comerciais ao longo do funil de vendas.

A ausência dessa informação dificulta a geração de '''relatórios gerenciais e analíticos''', reduzindo a visibilidade sobre o estágio das negociações, taxa de conversão, tempo de permanência em cada etapa, identificação de gargalos e desempenho da equipe comercial.

Sem uma classificação padronizada das fases, o acompanhamento das oportunidades ocorre de forma subjetiva, comprometendo a confiabilidade das informações e dificultando a tomada de decisões estratégicas relacionadas à prospecção e conversão de clientes.

== Solução ==

Para atender a essa necessidade, será criada uma funcionalidade de '''Fase do Prospect''' no CRM do Força de Vendas, permitindo que cada prospect seja classificado de acordo com sua etapa dentro do processo comercial.

A solução contemplará a criação de um cadastro de fases, onde será possível definir a descrição da fase e seu percentual de conversão, permitindo a padronização do funil de vendas.

A fase selecionada será vinculada ao prospect e poderá ser atualizada durante todo o ciclo de negociação, possibilitando o acompanhamento da evolução das oportunidades comerciais.

As informações serão armazenadas e disponibilizadas para '''relatórios, dashboards e análises''', permitindo uma gestão mais eficiente do pipeline comercial, maior previsibilidade de vendas e acompanhamento do desempenho das negociações.

== Escopo ==

=== Escopo Incluso ===

* Criação do cadastro de '''Fases do Prospect''' no CRM.

* Possibilidade de cadastrar descrição e percentual de conversão para cada fase.

* Inclusão do campo '''Fase do Prospect''' no cadastro e manutenção de prospects.

* Persistência da informação da fase do prospect na base de dados.

* Registro do histórico de alterações da fase.

* Disponibilização da informação para relatórios e consultas analíticas.

* Controle de acesso através das permissões de perfil do sistema.

* Atualização da fase durante todo o ciclo de vida do prospect.

=== Escopo Não Incluso ===

* Criação ou customização de novos relatórios ou dashboards específicos.

* Automação de movimentação de fases através de integrações externas.

* Implementação de regras de automação de marketing.

* Integração da fase do prospect com sistemas externos não relacionados ao Força de Vendas.

* Revisão completa da metodologia comercial utilizada pela empresa.

* Treinamentos, materiais de capacitação ou definição de processos internos de vendas.

== Atores ==

'''Vendedor / Representante Comercial -'''
Responsável por cadastrar prospects, atualizar fases e acompanhar a evolução das oportunidades comerciais.

'''Gestor Comercial -'''
Responsável por monitorar o funil de vendas, acompanhar indicadores e analisar a evolução dos prospects através de relatórios e dashboards.

'''Administrador do Sistema -'''
Responsável por cadastrar e manter as fases do prospect, definir percentuais e controlar permissões de acesso.

'''CRM Força de Vendas -'''
Responsável por armazenar, controlar e disponibilizar as informações das fases para consultas e análises.

== Pré-condições ==

* O usuário deverá estar autenticado no CRM do Força de Vendas.

* O usuário deverá possuir permissão para inclusão ou manutenção de prospects.

* As fases do prospect deverão estar previamente cadastradas e ativas.

* O prospect deverá estar em situação que permita atualização de informações.

== Regras de Negócio ==

'''[RN1] -'''
O campo '''Fase do Prospect''' deverá estar disponível no cadastro e manutenção de prospects, sendo sua exibição controlada pelas permissões de perfil do usuário.

'''[RN2] -'''
O preenchimento da '''Fase do Prospect''' deverá ocorrer através de uma lista padronizada de fases previamente cadastradas no sistema, contendo descrição e percentual de conversão.

'''[RN3] -'''
O sistema deverá disponibilizar uma tela de manutenção para cadastro das fases, permitindo informar:

* Descrição da fase;
* Percentual de conversão;
* Situação (Ativa/Inativa).

'''[RN4] -'''
A fase do prospect poderá ser alterada durante todo o ciclo de vida da oportunidade, respeitando as permissões do usuário.

'''[RN5] -'''
A informação registrada deverá ser persistida e disponibilizada para relatórios, dashboards e consultas analíticas.

'''[RN6] -'''
Toda alteração da fase deverá refletir imediatamente nas informações consolidadas do CRM.

'''[RN7] -'''
A ausência de preenchimento da fase, quando não obrigatória, não deverá impedir o cadastro ou manutenção do prospect.

'''[RN8] -'''
As alterações realizadas na fase deverão gerar histórico, registrando obrigatoriamente:

* Fase anterior;
* Nova fase;
* Data e hora da alteração;
* Usuário responsável pela alteração.

'''[RN9] -'''
O histórico das alterações deverá permanecer disponível para consultas e auditorias, permitindo acompanhar o tempo de permanência do prospect em cada etapa do funil.

'''[RN10] -'''
Quando um prospect for convertido em cliente ou oportunidade efetivada conforme regra do processo comercial da empresa, o sistema deverá permitir associar automaticamente a fase final configurada para encerramento do funil.

'''[RN11] -'''
Fases marcadas como inativas não poderão ser utilizadas em novos cadastros ou alterações, porém deverão permanecer visíveis nos registros históricos.

'''[RN12] -'''
Os relatórios deverão permitir filtros, agrupamentos e análises por fase do prospect e percentual de conversão.

== Fluxograma ==
[[Arquivo:fase prospect.drawio.png|600px]]

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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

Arquivo:Fase prospect.drawio.png

2026-06-25T18:00:15Z

Renatolima: 200px

== Descrição do arquivo ==
[[Arquivo:fase prospect.drawio.png|200px]]

Criação da fase dos prospect web e mobile

2026-06-25T17:53:41Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 25/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

Atualmente, o processo de gestão de prospects no CRM do Força de Vendas não possui uma identificação estruturada da '''fase do prospect''', o que limita o acompanhamento da evolução das oportunidades comerciais ao longo do funil de vendas.

A ausência dessa informação dificulta a geração de '''relatórios gerenciais e analíticos''', reduzindo a visibilidade sobre o estágio das negociações, taxa de conversão, tempo de permanência em cada etapa, identificação de gargalos e desempenho da equipe comercial.

Sem uma classificação padronizada das fases, o acompanhamento das oportunidades ocorre de forma subjetiva, comprometendo a confiabilidade das informações e dificultando a tomada de decisões estratégicas relacionadas à prospecção e conversão de clientes.

== Solução ==

Para atender a essa necessidade, será criada uma funcionalidade de '''Fase do Prospect''' no CRM do Força de Vendas, permitindo que cada prospect seja classificado de acordo com sua etapa dentro do processo comercial.

A solução contemplará a criação de um cadastro de fases, onde será possível definir a descrição da fase e seu percentual de conversão, permitindo a padronização do funil de vendas.

A fase selecionada será vinculada ao prospect e poderá ser atualizada durante todo o ciclo de negociação, possibilitando o acompanhamento da evolução das oportunidades comerciais.

As informações serão armazenadas e disponibilizadas para '''relatórios, dashboards e análises''', permitindo uma gestão mais eficiente do pipeline comercial, maior previsibilidade de vendas e acompanhamento do desempenho das negociações.

== Escopo ==

=== Escopo Incluso ===

* Criação do cadastro de '''Fases do Prospect''' no CRM.

* Possibilidade de cadastrar descrição e percentual de conversão para cada fase.

* Inclusão do campo '''Fase do Prospect''' no cadastro e manutenção de prospects.

* Persistência da informação da fase do prospect na base de dados.

* Registro do histórico de alterações da fase.

* Disponibilização da informação para relatórios e consultas analíticas.

* Controle de acesso através das permissões de perfil do sistema.

* Atualização da fase durante todo o ciclo de vida do prospect.

=== Escopo Não Incluso ===

* Criação ou customização de novos relatórios ou dashboards específicos.

* Automação de movimentação de fases através de integrações externas.

* Implementação de regras de automação de marketing.

* Integração da fase do prospect com sistemas externos não relacionados ao Força de Vendas.

* Revisão completa da metodologia comercial utilizada pela empresa.

* Treinamentos, materiais de capacitação ou definição de processos internos de vendas.

== Atores ==

'''Vendedor / Representante Comercial -'''
Responsável por cadastrar prospects, atualizar fases e acompanhar a evolução das oportunidades comerciais.

'''Gestor Comercial -'''
Responsável por monitorar o funil de vendas, acompanhar indicadores e analisar a evolução dos prospects através de relatórios e dashboards.

'''Administrador do Sistema -'''
Responsável por cadastrar e manter as fases do prospect, definir percentuais e controlar permissões de acesso.

'''CRM Força de Vendas -'''
Responsável por armazenar, controlar e disponibilizar as informações das fases para consultas e análises.

== Pré-condições ==

* O usuário deverá estar autenticado no CRM do Força de Vendas.

* O usuário deverá possuir permissão para inclusão ou manutenção de prospects.

* As fases do prospect deverão estar previamente cadastradas e ativas.

* O prospect deverá estar em situação que permita atualização de informações.

== Regras de Negócio ==

'''[RN1] -'''
O campo '''Fase do Prospect''' deverá estar disponível no cadastro e manutenção de prospects, sendo sua exibição controlada pelas permissões de perfil do usuário.

'''[RN2] -'''
O preenchimento da '''Fase do Prospect''' deverá ocorrer através de uma lista padronizada de fases previamente cadastradas no sistema, contendo descrição e percentual de conversão.

'''[RN3] -'''
O sistema deverá disponibilizar uma tela de manutenção para cadastro das fases, permitindo informar:

* Descrição da fase;
* Percentual de conversão;
* Situação (Ativa/Inativa).

'''[RN4] -'''
A fase do prospect poderá ser alterada durante todo o ciclo de vida da oportunidade, respeitando as permissões do usuário.

'''[RN5] -'''
A informação registrada deverá ser persistida e disponibilizada para relatórios, dashboards e consultas analíticas.

'''[RN6] -'''
Toda alteração da fase deverá refletir imediatamente nas informações consolidadas do CRM.

'''[RN7] -'''
A ausência de preenchimento da fase, quando não obrigatória, não deverá impedir o cadastro ou manutenção do prospect.

'''[RN8] -'''
As alterações realizadas na fase deverão gerar histórico, registrando obrigatoriamente:

* Fase anterior;
* Nova fase;
* Data e hora da alteração;
* Usuário responsável pela alteração.

'''[RN9] -'''
O histórico das alterações deverá permanecer disponível para consultas e auditorias, permitindo acompanhar o tempo de permanência do prospect em cada etapa do funil.

'''[RN10] -'''
Quando um prospect for convertido em cliente ou oportunidade efetivada conforme regra do processo comercial da empresa, o sistema deverá permitir associar automaticamente a fase final configurada para encerramento do funil.

'''[RN11] -'''
Fases marcadas como inativas não poderão ser utilizadas em novos cadastros ou alterações, porém deverão permanecer visíveis nos registros históricos.

'''[RN12] -'''
Os relatórios deverão permitir filtros, agrupamentos e análises por fase do prospect e percentual de conversão.

== Fluxograma ==

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

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

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