Categorie: entities
Bijgewerkt: 2026-04-05
contract servicecontract SLA onderhoud huurcontract
ServiceContract (Contract)
De ServiceContract-entiteit beheert alle contracten in Ultimo, van onderhoudscontracten en SLA's tot huurcontracten en verzekeringspolissen. Een contract legt afspraken vast met leveranciers of klanten over serviceniveaus, kosten en looptijd.
Entiteitsnaam: ServiceContract
Databasetabel: ServiceContract
Primaire sleutel: SVCID (nvarchar 9)
Contextsbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| 0 | ServiceContractContext.None | TD |
| 1 | ServiceContractContext.Standard | TD |
| 2 | ServiceContractContext.Standby | Inkoop |
| 4 | ServiceContractContext.ITServiceLevelAgreement | IT SLA |
| 8 | ServiceContractContext.IT | IT |
| 16 | ServiceContractContext.RentalContract | Huurcontract |
| 32 | ServiceContractContext.Building | Gebouw |
| 64 | ServiceContractContext.MID | MID |
| 128 | ServiceContractContext.Fleet | Fleet |
| 256 | ServiceContractContext.Insurance | Verzekering |
| 512 | ServiceContractContext.PriceAgreement | Prijsafspraak |
| 32768 | ServiceContractContext.Infra | Infra |
Statussenbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| -1 | ServiceContractStatus.Trash | Trash |
| 0 | ServiceContractStatus.None | None |
| 2 | ServiceContractStatus.Open | Open |
| 8 | ServiceContractStatus.Concept | Concept |
| 32 | ServiceContractStatus.Approved | Goedgekeurd |
| 128 | ServiceContractStatus.Active | Actief |
| 512 | ServiceContractStatus.Inactive | Inactief |
| 2048 | ServiceContractStatus.Terminated | Beeindigd |
Belangrijkste propertiesbewerken
| Property | Type | Kolom | Nullable | Omschrijving |
|---|---|---|---|---|
| Id | UltimoString(9) | SVCID | Nee | Contract-ID |
| Description | UltimoString(200) | SVCDESCR1 | Ja | Omschrijving |
| StartDate | Date? | SVCSTARTDATE | Ja | Ingangsdatum |
| EndDate | Date? | SVCENDDATE | Ja | Einddatum |
| Commences | Date? | SVCCOMMENCES | Ja | Aanvangsdatum |
| Expires | Date? | SVCEXPIRES | Ja | Vervaldatum |
| Cost1 | CompanyMoney | SVCCOST1 | Nee | Contractkosten 1 |
| Cost2 | CompanyMoney | SVCCOST2 | Nee | Contractkosten 2 |
| Excess | CompanyMoney | SVCEXCESS | Nee | Eigen risico |
| InsuredValue | CompanyMoney | SVCINSUREDVALUE | Nee | Verzekerde waarde |
| PolicyFee | CompanyMoney | SVCPOLICYFEE | Nee | Poliskosten |
| SilentProlong | Boolean | SVCSILENTPROLONG | Nee | Stilzwijgend verlengen |
| ToExpire | Boolean | SVCTOEXPIRE | Nee | Markering: te beeindigen |
| FinalNoticeTerm | Int32 | SVCTERMWARNING | Nee | Opzegtermijn |
| InvoicedCurrentYear | CompanyMoney | SVCINVOICED | Nee | Gefactureerd huidig jaar (readonly) |
| InvoicedLastYear | CompanyMoney | SVCINVOICEDLY | Nee | Gefactureerd vorig jaar (readonly) |
| NumberOfVisits | Decimal | SVCNROFVISITS | Nee | Aantal bezoeken |
| LastVisitDate | Date? | SVCDATEVISIT | Ja | Laatste bezoekdatum |
| FileNumber | UltimoString(41) | SVCFILEID | Ja | Dossiernummer |
| ContractAssessmentScore | Int16 | SVCCONTRACTASSESSMENTSCORE | Nee | Beoordelingsscore |
| ArticleDiscountPercentage | Decimal | SVCARTICLEDISCOUNTPERCENTAGE | Nee | Artikelkortingspercentage |
Relaties met andere entiteitenbewerken
| Property | Verwijst naar | Omschrijving |
|---|---|---|
| Vendor | Vendor (supplier) | Leverancier |
| Customer | Customer | Klant |
| Manager | employee | Contractbeheerder |
| Owner | employee | Eigenaar |
| Department | Department | Afdeling |
| ManageDepartment | Department | Beherende afdeling |
| CostCenter | CostCenter | Kostenplaats |
| Site | Site | Vestiging |
| Space | Space | Ruimte |
| ServiceContractType | ServiceContractType | Contracttype |
| ServiceContractForm | ServiceContractForm | Contractvorm |
| PaymentTerms | PaymentTerms | Betalingsvoorwaarden |
| PaymentMethod | PaymentMethod | Betaalwijze |
| RenewalTermFrequency | Frequency | Verlengingsfrequentie |
| Lines | List[ServiceContractLine] | Contractregels |
| EquipmentServiceContracts | List[EquipmentServiceContract] | Equipment-koppelingen |
| ProcessFunctionServiceContracts | List[ProcessFunctionServiceContract] | Procesfunctie-koppelingen |
| ServiceContractServiceLevels | List[ServiceContractServiceLevel] | Serviceniveaus |
| ServiceContractNotifications | List[ServiceContractNotification] | Notificaties |
| ServiceServiceContracts | List[ServiceServiceContract] | Diensten |
| Payer | Customer | Betaler |
| PayerEmployee | employee | Betalende medewerker |
| Impact | Impact | Impact |
Sub-entiteitenbewerken
ServiceContractLine (Contractregel)bewerken
Detailregels op een contract, bijv. artikelen of diensten met prijsafspraken.
Primaire sleutel: SVCLSVCID + SVCLLINEID (composiet)
| Property | Type | Omschrijving |
|---|---|---|
| Article | Article | Artikel |
| ArticleGroup | ArticleGroup | Artikelgroep |
| ArticleUnitPrice | TransactionMoney | Stuksprijs |
| Craftsman | Craftsman | Vakman |
| Currency | Currency | Valuta |
| Discount | Decimal | Korting (%) |
| PurchaseContract | CompanyMoney | Contractbedrag |
| PurchaseContractQuantity | Decimal | Contracthoeveelheid |
| PurchaseCommit | CompanyMoney | Inkoopcommitment (readonly) |
| Invoiced | CompanyMoney | Gefactureerd bedrag |
| LeadTime | Int32 | Levertijd (dagen) |
| PurchaseCode | UltimoString(60) | Inkoopcode leverancier |
ServiceContractNotification (Contractnotificatie)bewerken
Notificatieregels die waarschuwingen genereren bij SLA-overschrijding.
Primaire sleutel: SVCNSVCID + SVCNLINEID (composiet)
| Property | Type | Omschrijving |
|---|---|---|
| Percentage | Decimal | Percentage van doorlooptijd |
| NotificationEmail | Boolean | E-mail versturen |
| NotificationReminder | Boolean | Herinnering versturen |
| SendToEmployee | Boolean | Naar medewerker |
| SendToManager | Boolean | Naar manager |
Contexts: None (0), Oplos (1), Respons (2).
ServiceContractServiceLevel (SLA-koppeling)bewerken
Koppelt serviceniveaus aan een contract voor respons- en oplostijdbewaking.
Primaire sleutel: SVCSLSVCID + SVCSLSRVID + SVCSLSRVLID (composiet)
| Property | Type | Omschrijving |
|---|---|---|
| ServiceContract | ServiceContract | Contract |
| ServiceLevel | ServiceLevel | Serviceniveau |
Tips voor consultantsbewerken
- Context bepaalt het type: TD (1) voor onderhoudscontracten, IT SLA (4) voor IT-serviceovereenkomsten, Huurcontract (16) voor vastgoed, Verzekering (256) voor polissen.
- Statusflow: Concept (8) -> Open (2) -> Goedgekeurd (32) -> Actief (128) -> Inactief (512) -> Beeindigd (2048).
- Stilzwijgend verlengen: Met
SilentProlong = truewordt het contract automatisch verlengd na de einddatum. - SLA-bewaking: Via
ServiceContractServiceLevelsworden reactie- en oplostijden gedefinieerd die bewaakt worden bij jobs. - Equipment-koppeling: Via
EquipmentServiceContractsworden individuele assets aan het contract gekoppeld. - Notificaties: Via
ServiceContractNotificationskunnen waarschuwingen worden ingesteld voor einddatum, verlenging, etc. - Contractbeoordeling: Via
ContractAssessmentScoreen gerelateerde velden kan periodieke contractevaluatie worden ingericht. - Inkoop: Bij context Inkoop (2) kunnen inkoopafspraken en raamcontracten worden vastgelegd.
Database Detailsbewerken
De tabel dba.ServContract bevat 85 kolommen.
Computed columns (berekende velden)bewerken
| Kolom | Formule | Toelichting |
|---|---|---|
SvcFileExtension |
'.html' |
Vast bestandstype voor rich-text velden |
SVCTEXT_FT |
HTML-wrapping van tekstveld | Full-text search representatie |
Kolommen gezet door triggersbewerken
| Kolom | Type | Toelichting |
|---|---|---|
SvcCost1 |
decimal(21,5) | Contractkosten -- berekend uit ObjectServContract en ServContractLine |
SvcSetCost1 |
smallint | Indicator of Cost1 handmatig is gezet |
SvcInvoiced |
decimal(21,5) | Gefactureerd bedrag huidig jaar |
SvcInvoicedLY |
decimal(21,5) | Gefactureerd bedrag vorig jaar |
SvcTotalInvoiced |
decimal(21,5) | Totaal gefactureerd (all-time) |
SvcPurchCommit |
decimal(21,5) | Inkoopcommitment huidig jaar |
SvcPurchCommitLY |
decimal(21,5) | Inkoopcommitment vorig jaar |
SvcTotalPurchCommit |
decimal(21,5) | Totaal inkoopcommitment |
SvcTotalPurchContract |
decimal(21,5) | Totaal inkoopcontractbedrag |
SvcTotalPurchContractQty |
decimal(21,2) | Totaal inkoopcontract-hoeveelheid |
Belangrijke defaultsbewerken
| Kolom | Default | Toelichting |
|---|---|---|
SvcContext |
1 (TD) |
Standaard context Technische Dienst |
SvcRecStatus |
0 (None) |
Standaard status |
SvcSilentProlong |
0 (false) |
Niet stilzwijgend verlengen |
SvcToExpire |
0 (false) |
Niet gemarkeerd als te beeindigen |
SvcTermWarning |
0 |
Opzegtermijn (moet ingesteld worden) |
SvcJobContext |
0 |
Job-context voor gegenereerde jobs |
SvcCorrespondenceAddress |
0 |
Correspondentieadres-type |
SvcArticleDiscountPercentage |
0 |
Geen artikelkorting standaard |
SvcContractAssessmentScore |
0 |
Beoordelingsscore initieel 0 |
SvcContractAssessmentFrequency |
0 |
Beoordelingsfrequentie (moet geconfigureerd worden) |
SvcContractAssessmentPeriodic |
0 (false) |
Periodieke beoordeling standaard uit |
SvcNrOfVisits |
0 |
Aantal bezoeken |
SvcRenewalTermFrqCount |
0 |
Verlengingsperiode (moet geconfigureerd worden) |
SvcRecCreateDate |
sysdatetimeoffset() |
Aanmaakdatum automatisch |
Triggers en externe triggersbewerken
ServContract heeft 1 eigen trigger (UPDATE) en wordt beinvloed door 7 externe triggers:
- Cost-triggers: Kostenboekingen updaten facturatie- en inkoopcommitment-velden
- ObjectServContract-triggers: Bij koppeling/ontkoppeling van equipment wordt SvcCost1 herberekend
- ServContractLine-triggers: Bij wijzigingen in contractregels worden totalen herberekend
- UmmGlobals-triggers: Globale instellingswijzigingen propageren
Consultanttip: De financiele velden op ServContract (Invoiced, PurchCommit, etc.) worden volledig trigger-gestuurd. Let erop dat
SvcCost1automatisch wordt berekend uit ObjectServContract-koppelingen tenzijSvcSetCost1 = 1, dan is het een handmatige waarde. Bij de overgang van boekjaren wordenSvcInvoicedenSvcPurchCommitgereset naar 0 en de vorige waarden opgeslagen in de LY-kolommen.