O WebService tem como objetivo devolver o código ANS (Agência Nacional de Saúde Suplementar) do usuário informado no momento da requisição da AP, e abrir uma ocorrência com base nas informações enviadas.

Atualmente o fluxo de uso dessa funcionalidade ocorre no momento da ligação do cliente para a URA, que faz uma solicitação para a API verificando a existência desse usuário, nesse momento é possível identificar o cliente  através de dois modos: Carteirinha e CPF.

Caso o cliente exista dentro da base de dados multidados, será feita outra requisição para a Unimed para verificar o código ANS, Também existe um retorno de um código interno caso ocorra algum erro na comunicação com a Unimed.

Alguns prestadores de serviço tem um Carteirinha com 12 dígitos e não há a necessidade de fazer a comunicação final com a API unimed para retornar o código ANS, nesse momento irá utilizar o próprio código interno para  validar o usuário e abrir a ocorrência em conjunto com o código Categoria.

O código XML para a utilização do Soap ou ferramenta semelhante pode ser encontrado através do caminho:

 “webservices/uraUnimedSAOCARLOS.php/?wsdl”.

Possíveis erro na utilização da API:

• Não foi informado um id da chamada.

• Utilizou a Carteirinha com 12 dígitos e sem categoria.

• Não informou Carteirinha ou CPF.

• Informou uma Carteirinha incorreta ou CPF incorreto.

• Utilizou uma categoria inexistente, ou com símbolos e letras.

Possíveis erro para abertura da ocorrência:

• Não aplicou as configurações necessárias, na tabela de configuração.

• Não criou uma divisão com o código: “telefone”.

• Não criou uma solicitação com o código: “telefone”.

• Não foi possível completar a comunicação com a API unimed.