====== Integração com o Monnae ======

===== Resumo =====

Integração com o Tecsystem Monnae, de acordo com as especificações descritas na [[softwares:monnae:requisitos:modulos:api_integracao|API de integração]], com o objetivo de gerar títulos para cobrança de taxas.

===== Descrição =====

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 [[softwares:geoservicos:requisitos:modulos:pessoas|pessoas]] e [[softwares:geoservicos:requisitos:modulos:atendimentos|atendimentos]].

==== Cadastro de Pessoas ====

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.

==== Cadastro de Atendimentos ====

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:

|< 100% 50% 50%>|
^  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)                          |


===== Configurações e preferências do usuário =====

  * **Integração com o Tecsystem Monnae** (ativa|inativa): determina se a integração deve ou não ser feita;
  * **Local do banco de dados**: caminho do banco de dados do Monnae a ser passado para a API de integração.

===== Pontos de verificação =====





==== Atendimentos ====

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

===== Observações =====


~~DISCUSSION|Sugira mudanças, aponte falhas ou contribua de alguma forma aqui:~~