Webservicesqmb

From QuatenusWiki
Revision as of 15:19, 28 April 2026 by Administrator (talk | contribs)

Web Services Quatenus® Core – Licenciamento

📌 Introdução

Este documento descreve os Web Services do Quatenus® Core para obtenção de dados de licenciamento.

Versão: 12.00 Data: Outubro 2025 Fonte:

🌐 Endereços e Autenticação

QDats

Licenciamento (Gamas) http://services.quatenus-system.com.br/quatenus10/QDats/SrvGovernmentGet.svc?wsdl Ativos http://services.quatenus-system.com.br/quatenus10/QDats/SrvGtiAssetGet.svc?wsdl Viaturas http://services.quatenus-system.com.br/quatenus10/QDats/SrvGtiFleetGet.svc?wsdl

QBMDats

Items / Extras .../QBMDats/Business/QbmItems/QbmItemsServices.svc?wsdl Entidades .../QBMDats/Administration/Entities/Entity.svc?wsdl Documentos .../QBMDats/Documents/Document.svc?wsdl Payment Terms .../QbmDats/Business/PaymentTerms/PaymentTermsServices.svc?wsdl

🔐 Autenticação

Parâmetros comuns:

Parâmetro Descrição

companyId - deviceIds - userName - password - token }

🧪 Serviços Disponíveis

📦 Gamas

SrvGovernmentGet.GetPartnerCodesFamilies()

📱 Dispositivos

ISrvGtiAssetGet.GetAssetBrands() ISrvGtiAssetGet.GetAssetModels()

🚗 Viaturas

ISrvGtiFleetGet.GetVehiclesBrands() ISrvGtiFleetGet.GetVehiclesModels() ISrvGtiFleetGet.GetVehiclesClassType() ISrvGtiFleetGet.GetFuelTypes()

📦 Items

QbmItemsServices.GetLicensableItems() QbmItemsServices.GetLicensableItemExtras() QbmItemsServices.GetDeviceClasses()

👤 Entidades

IEntity.GetCustomers() IEntity.GetPartners()

📄 Documentos

IDocument.GetExternalContracts() IDocument.GetExternalBillingEvents()

💰 Pagamentos

IPaymentTermsServices.GetPaymentTermsExternal()

🔎 Estrutura Geral dos Serviços

A maioria dos serviços segue o mesmo padrão:

Argumentos Comuns

Campo Descrição

filter - companyIds - cultureInfo - timeZoneOffset / timeZoneId - currentPage / pageNumber - pageSize / rowsPerPage - sortColumnName - sortDirection - userName - password - token }

Estrutura de Resposta

Normalmente:

Campo Descrição

Rows - TotalRows }

📦 Exemplos de Serviços

SrvGovernmentGet.GetPartnerCodesFamilies

Obtém gamas de produtos.

Retorno

PartnerCodeFamilyId Code Description Type (B2B / B2C)

ISrvGtiAssetGet.GetAssetBrands

Obtém marcas de dispositivos.

Retorno

AssetBrandId Name Origin (Global / Local)

ISrvGtiAssetGet.GetAssetModels

Obtém modelos de dispositivos.

= Notas

Pode filtrar por tipo (mobile, computer, machine) Pode filtrar ativos/inativos

ISrvGtiFleetGet.GetVehiclesBrands

Obtém marcas de viaturas.

ISrvGtiFleetGet.GetVehiclesModels

Obtém modelos de viaturas.

Inclui:

Dados técnicos (motor, consumo, dimensões) Marca associada Categoria e classe

QbmItemsServices.GetLicensableItems

Obtém produtos licenciáveis QBM.

= Filtros avançados

Formato JSON:

{ "Data":{ "Global":"", "Extra":"", "Units":"", "ItemTypes":"", "IsEnabledFilter":"ALL" } }

= Retorno

Code Description ItemType (Produto / Serviço) UnitPrice TaxRate Discount

QbmItemsServices.GetLicensableItemExtras

Obtém extras associados a um item.

QbmItemsServices.GetDeviceClasses

Obtém tipos de ativos.

Exemplos:

VEHICLE MOTORCYCLE

IEntity.GetCustomers

Obtém clientes externos.

= Filtros disponíveis

Estado (ACTIVE / INACTIVE) VIP País Data última atualização

= Informação retornada

Dados de faturação Métodos de pagamento Contactos Moeda Estado (ativo/inativo)

⚙️ Serviços Auxiliares

Incluem:

Países Regiões Moedas Idiomas Fusos horários

📎 Notas Importantes

⚠️ Os endpoints podem variar consoante a infraestrutura

⚠️ Alguns serviços exigem parâmetros obrigatórios dependendo da configuração

⚠️ Datas devem respeitar formato e timezone definidos

🧩 Apêndices

Lista de fusos horários suportados Lista de culturas suportadas