====== Especificação Funcional: Integração com o Geoserviços ======

===== Resumo =====

Integração com o Geoserviços para troca das informações relacionadas aos atendimentos.

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

A integração permite enviar dados do Geagro para o Geoserviços para complementar e facilitar os cadastros. Ao mesmo tempo, informações do Geoserviços podem ser usadas no Geagro nas funcionalidades que tem dados em comum em ambos. Além dos atendimentos, cadastros relacionados como pessoas e pontos de atendimento podem ser alimentados pela integração.

A integração é opcional e deve ser feita de acordo com as especificações da [[softwares:geoservicos:requisitos:modulos:geoservicosapi|API do Geoserviços]].

==== Pessoas ====

Todas as pessoas cadastradas devem ser replicadas no Geoserviços, tanto na inclusão quando na alteração. As pessoas excluídas do Geagro também devem ser excluídas pela API se já tiverem sido replicadas, caso não estejam vinculadas a algum atendimento no Geoserviços.

==== Propriedades ====

Cada propriedade deve ser cadastrada no Geoserviços como um ponto de atendimento. Propriedades excluídas devem ser excluídas também pela API se já tiverem sido replicadas. 

Ao persistir um ponto de atendimento, as listas de pessoas e atividades devem ser informadas para que sejam vinculadas também no Geoserviços.

Na exibição do histórico de uma propriedade, a lista de serviços prestados para o ponto de atendimento correspondente no Geoserviços deve ser recuperada pela API para inclui-la no relatório.

==== Processos ====

Ao finalizar um processo, o mesmo deve ser convertido em um atendimento.

Os seguintes campos serão utilizados para cadastrar os atendimentos:


^  Campo do Geoserviços              ^  Campo do Geagro                                              ^
^ Atendimento                                                                                        ^^
|Data do atendimento                 | Data de término do processo                                    |
|Solicitante                         | Produtor                                                       |
|Ponto de atendimento                | Propriedade                                                    |
|Observações                         | Observações do processo                                        |
^ Serviço                                                                                            ^^
| Serviço definido nas [[softwares:geagro:requisitos:configuracoes:geral|configurações do sistema]] para cada tipo de processo ||
^Serviço  no atendimento                                                                            ^^
|Objetivo do atendimento             | "CONTROLE DE PROCESSOS"                                        |
|Descrição detalhada do serviço      | "Processo de [tipo do processo] nº [nº do processo]"           |
|Responsável pelo atendimento        | Usuário logado no momento da finalização do processo           |
|Técnico responsável                 | Usuário logado no momento da finalização do processo           |
|Quantidade solicitada               | 1                                                              |
|Quantidade atendida                 | 1                                                              |
|Status definido nas [[softwares:geagro:requisitos:configuracoes:geral|configurações do sistema]] para cada tipo de processo/serviço||
|Data de execução                    | Data de término do processo                                    |
|Valor unitário                      | 0,00                                                           |
|Valor total                         | 0,00                                                           |

**Obs.:** Nos processos de nova inscrição, alteração cadastral e reativação que também tiverem emissão de AIDF, deverá ser registrado um segundo serviço no mesmo atendimento. Este serviço deve corresponder ao serviço configurado para os processos de "REQUISIÇÃO DE TALÃO DE NOTAS FISCAIS".

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

  * **Integração com o Tecsystem Geoserviços** (ativa|inativa): determina se a integração deve ou não ser feita;
  * **Local do banco de dados do Geoserviços**: caminho do banco de dados do Geoserviços a ser passado para a API de integração;
  * **Local do banco de dados do Monnae**: caminho do banco de dados do Monnae para que a API faça a integração com o Monnae;
  * **Departamento padrão**: departamento do Geoserviços ao qual os registros criados pela API serão vinculados;
  * **Categorias**: uma categoria do Geoserviços para cada tipo de documento;
  * **Serviços**: um serviço para cada tipo de processo, com seu respectivo estado final.



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


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