Disponibilização de Link de Boleto Financeiro

Histórico de Alterações

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.

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.

Aprovação

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

GeoSales

Setor	Aprovado Por	Data
Integração - GeoSales		dd/mm/aaaa

Empresa solicitante

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