Integração com o Tecsystem Monnae, de acordo com as especificações descritas na API de integração, com o objetivo de gerar títulos para cobrança de taxas.
Alguns órgãos da prefeitura podem cobrar taxas por prestação de serviços, e o dinheiro arrecadado deve ser gerenciado pelos próprios. O pagamento das taxas será feito através de títulos de cobrança do Monnae. Para permitir que os usuários possam gerar títulos e gerenciar pagamentos, deve ser feita a integração do sistema com o banco de dados do Monnae. Todos os dados serão transmitidos do Geoserviços para o Monnae, exceto as contas que somente serão recuperadas para permitir a vinculação com os títulos.
Para isto, a funcionalidade de integração deve ser incluída nos módulos de cadastro de pessoas e atendimentos.
Os títulos são emitidos em nome de Pessoas (físicas ou jurídicas). Por isso, o cadastro de Pessoas deve ser mantido em sincronia com o Monnae, incluindo, alterando ou excluindo Pessoas em ambos os sistemas.
Os usuários poderão emitir títulos para os serviços solicitados. Para cada serviço, podem ser emitidos vários títulos.
Na interface de cadastro de serviços no atendimento, é apresentada a listagem dos títulos cadastrados para o serviço e solicitante selecionados, junto com as opções de incluir, alterar ou excluir títulos;
Na inclusão ou alteração de títulos:
O sistema apresenta a interface para inclusão ou alteração de títulos;
O usuário preenche os dados do título e edita as contas;
Na inclusão ou alteração de contas:
O sistema exibe a interface de edição de contas;
O usuário seleciona uma conta, centro de custo e valor;
O usuário salva a conta;
O sistema salva o título com o plano de contas.
Na exclusão de títulos:
O usuário seleciona um título cadastrado e aciona a opção “Excluir”;
O sistema verifica se o título ainda não foi pago;
Caso o título tenha sido pago, o sistema não permite a exclusão e alerta o usuário;
O título é excluído.
Os seguintes campos serão utilizados para cadastrar os títulos:
| Campo do Monnae | Campo do Geoserviços |
| Contas | Contas recuperadas pela API |
| Operação | Tipo de operação da conta (crédito) |
| Pessoa | Solicitante do atendimento |
| Histórico | Descrição do serviço (do cadastro de serviços) |
| Portador | – |
| Número | Código do atendimento |
| Data de competência | Data prevista do serviço |
| Data de emissão | Data de emissão (padrão: data atual) |
| Data de vencimento | Data prevista do serviço |
| Valor | Valor do serviço |
| Observações | Descrição do serviço (no atendimento) |
Ao incluir ou alterar um título para um determinado serviço, tanto a Pessoa (solicitante do atendimento) quanto o título devem ser persistidos no Monnae;
Títulos pagos não podem ser excluídos ou alterados;
Não se pode alterar o solicitante quanto algum serviço tiver ao menos um título pago;
Serviços com títulos pagos não podem ser excluídos;
A operação dos títulos gerados deve ser “Crédito”;
Para novos títulos:
O histórico deve ter o valor da descrição do serviço;
A data de competência e a data de vencimento devem ter o valor da data prevista do serviço;
O valor do título no momento da inclusão deve ser igual ao valor total do serviço informado no atendimento;
As observações devem ter o valor das informações adicionais do serviço.
Para qualquer título:
O valor total das contas incluídas no plano de contas deve ser igual ao valor do título;
Na inclusão ou alteração de uma conta, as contas repetidas na lista devem ser mescladas e os seus valores somados;
Os campos obrigatórios para o cadastro do título são: N° do documento, valor, data de emissão e data de vencimento;
A data de vencimento não pode ser anterior à data corrente.
