Webservicesqmb

From QuatenusWiki

Template:Página de Documentação Técnica

Web Services Quatenus® Core

O Quatenus Core é uma plataforma de localização inteligente mundial (WWIL) que disponibiliza uma série de Web Services para a obtenção de dados de licenciamento, gestão de ativos e frotas[cite: 185, 186, 189].

Endereços e Autenticação (Servidores de Produção)

Os serviços estão organizados por categorias e podem ser acedidos através dos seguintes endpoints WSDL (Infraestrutura Brasil)[cite: 213, 223]:

Serviço Categoria URL de Produção (WSDL)
QDats Licenciamento e Gamas http://services.quatenus-system.com.br/quatenus10/QDats/SrvGovernmentGet.svc?wsdl [cite: 215]
QDats Ativos (Assets) http://services.quatenus-system.com.br/quatenus10/QDats/SrvGtiAssetGet.svc?wsdl [cite: 217]
QDats Viaturas e Combustíveis http://services.quatenus-system.com.br/quatenus10/QDats/SrvGtiFleetGet.svc?wsdl [cite: 221]
QBMDats Itens e Serviços http://services.quatenus-system.com.br/quatenus10/QBMDats/Business/QbmItems/QbmltemsServices.svc?wsdl [cite: 231]
QBMDats Entidades (Clientes/Parceiros) http://services.quatenus-system.com.br/quatenus10/QBMDats/Administration/Entities/Entity.svc?wsdl [cite: 236]
QBMDats Documentos (Contratos/Propostas) http://services.quatenus-system.com.br/quatenus10/QBMDats/Documents/Document.svc?wsdl [cite: 242]

Dados para Testes

Para chamadas de teste, devem ser utilizados os seguintes argumentos de autenticação[cite: 249]:

  • userName: agoraqbmadmin@testesst.pt [cite: 249]
  • password: Ipiranga2013 [cite: 249]

Principais Métodos Disponíveis

Abaixo estão listados alguns dos métodos fundamentais para integração[cite: 256]:

Gamas e Dispositivos

  • SrvGovernmentGet.GetPartnerCodesFamilies(): Obtém a lista de gamas de produtos[cite: 258, 282].
  • ISrvGtiAssetGet.GetAssetBrands(): Obtém a lista de marcas de dispositivos[cite: 262, 326].
  • ISrvGtiAssetGet.GetAssetModels(): Lista de modelos de dispositivos[cite: 338].

Gestão de Frota

  • ISrvGtiFleetGet.GetVehiclesBrands(): Marcas de veículos[cite: 263].
  • ISrvGtiFleetGet.GetVehiclesModels(): Modelos de veículos[cite: 263].
  • ISrvGtiFleetGet.GetVehiclesClassType(): Classes de viaturas[cite: 266].

Estrutura de Dados Exemplo

Muitos serviços devolvem um objeto do tipo `QTableGridDataSource`, que contém uma coleção de linhas (`Rows`) e o número total de registos (`TotalRows`)[cite: 286, 330].

Exemplo: PartnerCodeFamily

Campo Tipo Descrição
PartnerCodeFamilyId Int ID único da gama [cite: 293]
Code String Código identificador (ex: "QAE.INT") [cite: 293]
Description String Descrição (ex: "QUATENUS ASSET EDITION") [cite: 293]
InsertedDate String Data de criação formatada conforme a cultura [cite: 293]

Configurações Suportadas

A plataforma suporta múltiplas culturas (ex: `pt-PT`, `pt-BR`, `en-US`) e fusos horários globais[cite: 283, 340].

Categoria:Documentação Técnica Categoria:Web Services Categoria:Quatenus