Webservicesqmb

{{QuatenusHeader}}

= 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) <code>http://services.quatenus-system.com.br/quatenus10/QDats/SrvGovernmentGet.svc?wsdl</code>
• Ativos <code>http://services.quatenus-system.com.br/quatenus10/QDats/SrvGtiAssetGet.svc?wsdl</code>
• Viaturas <code>http://services.quatenus-system.com.br/quatenus10/QDats/SrvGtiFleetGet.svc?wsdl</code>

---

=== QBMDats ===

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

---

=== 🔐 Autenticação ===

Parâmetros comuns:

{| class="wikitable"

! Parâmetro !! Descrição
companyId
-
deviceIds
-
userName
-
password
-
token
}

---

== 🧪 Serviços Disponíveis ==

=== 📦 Gamas ===

• <code>SrvGovernmentGet.GetPartnerCodesFamilies()</code>

=== 📱 Dispositivos ===

• <code>ISrvGtiAssetGet.GetAssetBrands()</code>
• <code>ISrvGtiAssetGet.GetAssetModels()</code>

=== 🚗 Viaturas ===

• <code>ISrvGtiFleetGet.GetVehiclesBrands()</code>
• <code>ISrvGtiFleetGet.GetVehiclesModels()</code>
• <code>ISrvGtiFleetGet.GetVehiclesClassType()</code>
• <code>ISrvGtiFleetGet.GetFuelTypes()</code>

=== 📦 Items ===

• <code>QbmItemsServices.GetLicensableItems()</code>
• <code>QbmItemsServices.GetLicensableItemExtras()</code>
• <code>QbmItemsServices.GetDeviceClasses()</code>

=== 👤 Entidades ===

• <code>IEntity.GetCustomers()</code>
• <code>IEntity.GetPartners()</code>

=== 📄 Documentos ===

• <code>IDocument.GetExternalContracts()</code>
• <code>IDocument.GetExternalBillingEvents()</code>

=== 💰 Pagamentos ===

• <code>IPaymentTermsServices.GetPaymentTermsExternal()</code>

---

== 🔎 Estrutura Geral dos Serviços ==

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

=== Argumentos Comuns ===

{| class="wikitable"

! Campo !! Descrição
filter
-
companyIds
-
cultureInfo
-
timeZoneOffset / timeZoneId
-
currentPage / pageNumber
-
pageSize / rowsPerPage
-
sortColumnName
-
sortDirection
-
userName
-
password
-
token
}

---

=== Estrutura de Resposta ===

Normalmente:

{| class="wikitable"

! 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:

<code> { "Data":{ "Global":"", "Extra":"", "Units":"", "ItemTypes":"", "IsEnabledFilter":"ALL" } } </code>

==== 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

---

{{QuatenusFooter}}