Integrando com a Central

Para que o software de gestão de plano de saúde, integre com a central de obrigações, o mesmo o faz a partir do uso dos Web Services disponibilizados pela central.

Esses Web Services, são modelos de dados de acordo com cada obrigação, que precisam ser enviados de acordo com cada processo daquela determinada obrigação.

Exemplo

Vamos utilizar como exemplo o SIB.

O SIB é uma legislação da ANS, que visa enviar toda e qualquer movimentação cadastral de um beneficiário da operadora com relação ao plano de saúde.

Com base no conceito dessa obrigação, as informações que devem ser encaminhadas para a Central deve ser toda a movimentação do beneficiário, desde a sua inclusão, alteração cadastral e exclusão da operadora.

O envio da informação, pelo software de gestão, pode ser de duas formas:

1. Em tempo real, ou seja, no momento em que a movimentação acontece
2. Em lote, que pode ser uma carga por semana, mensal ou da forma que o software de gestão entender ser o melhor para seu negócio
3. Em lote, podendo ser, uma carga por semana, quinzenal, mensal, ou de outra forma conforme definido pelo Software de Gestão para atender o seu negócio.

IMPORTANTE: A Central de Obrigações está preparada para receber o dado a qualquer momento e processá-lo. Vale lembrar que os processos executados pela Central também possuem um tempo de execução que não pode ser esquecido. Dessa maneira o período do envio de dados para a Central e seu tempo de execução devem ser respeitados para não impactar na entrega da obrigação.

Software de Gestão Integrados

Web Service de Integração

Como a central foi criada utilizando o padrão de MVC do Protheus, é utilizado a camada de comunicação MVC do framework Protheus para transitar os dados esperados pela Central.

Uma das premissas básicas do uso do MVC é que o envio dos dados, é feito através do preenchimento do MODEL de dados que por sua vez é enviado por um método do WS para ser persistido.

Abaixo está documentado quais o Web Service, métodos e suas particularidades para uso.

Web Service -> FWWSMODEL

Métodos

login()

Retorna o token que deve ser utilizado para consumir os demais métodos.

Parâmetros

GetSchema()

Retorna a estrutura xml (XSD) que um determinado model deve receber para ser consumido e persistido.

Parâmetros

PutXmlData()

Método que consome e persiste um determinado model.

Parâmetros

Obs.: Todo XML deve possuir como atributo "operation" na tag principal/pai. Os conteúdos devem ser 3 - para inclusão, 4 - para alteração ou 5 - para exclusão.

GeXmlDataUpdate()

Método que verifica se o dado persistido existe com base na chave de índice primário do model.

Parâmetros

IMPORTANTE: Para saber qual model utilizar, verificar a documentação contida em cada obrigação liberada na central.