MultiClubes Members API v2

Esta é a documentação dos serviços de comunicação da solução MultiClubes. Este manual tem como objetivo ajudar no entendimento e na implementação de uso dos serviços que compoem a API.

Comunicação

A comunicação suportada é SOAP sobre HTTPS com o uso do protocolo TLS 1.0 e SSL 3.0. O certificado fornecido pelo servidor deve ser inspecionado a cada nova conexão, para confirmar que se trata de um certificado confiável. A URL do servidor contida no certificado deve corresponder ao endereço correto do MultiClubes (multiclubes.com.br). Os dados devem estar codificados no formato UTF8.

Autenticação

O acesso à API é restrito aos parceiros cadastrados, sendo necessário informar, em cada conexão, a chave de autenticação fornecida pela nossa equipe de suporte técnico ao parceiro. A duração da chave é indeterminada, somente perdendo a validade caso a conta de acesso seja desativada. A chave de autenticação deve ser informada pelo cabeçalho da chamada pelo header com nome _AuthenticationKey com namespace ns.

Glossário

  • Sócio: é a pessoa física ou jurídica que possui um título, podendo ser titular ou dependente.
  • Título: é um documento que comprova o direito do sócio de acesso ao clube.
  • Código de acesso: é um código único do sócio que o identifica no clube.

Funcionamento

  • Consulta de dados do título e de seus sócios, incluindo titular e dependentes.
  • Valida se o sócio está válido.
  • Edição de dados do título e de seus sócios, incluindo titular e dependentes.

Como começar

  1. Obtenha o endereço do serviço de homologação.
  2. Abra o endereço do serviço no navegador e obtenha a documentação WSDL.
  3. Realize chamadas em homologação para testes de reconhecimento.
  4. Integre as chamadas com seu software em homologação.
  5. Obtenha o endereço do serviço de produção.
  6. Realize chamadas em produção para testes de finalização.

Notas de versão

2.0.0

26/07/2018

  1. Criada esta documentação para auxiliar no entendimento e implementação.

2.1.0

12/09/2018

  1. Foi adicionado o método Authenticate que valida a senha do título e retorna um token de autenticação.
  2. Método Edit passa a exigir token de autenticação para ser utilizado.

2.2.0

27/02/2019

  1. Atualizado a descrição e obrigatoriedade dos paramêtros:
    • AddressData
    • AuthenticateData
    • EditData
    • MemberData
    • SearchData
    • TitleData

2.2.1

18/08/2023

  1. Adicionado o campo opcional LastEntranceDate ao MemberResult para retornar a data de último acesso do sócio.