Categorie: entities
Bijgewerkt: 2026-04-07
invoice factuur inkoop
Invoice (Factuur)
De Invoice-entiteit vertegenwoordigt een inkoopfactuur in Ultimo. Facturen worden gekoppeld aan bestellingen en leveranciers en doorlopen een goedkeuringsproces. Elke factuur bevat een of meer factuurregels (InvoiceLine) die de individuele kostenposten beschrijven.
Entiteitsnaam: Invoice
Databasetabel: Invoice
Primaire sleutel: INVID (nvarchar 9)
Contextsbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| 0 | InvoiceContext.None | Standaard |
| 1 | InvoiceContext.Standard | Standaard |
| 2 | InvoiceContext.Fleet | Fleet |
Statussenbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| -1 | InvoiceStatus.Trash | Trash |
| 0 | InvoiceStatus.None | None |
| 1 | InvoiceStatus.Created | Open |
| 2 | InvoiceStatus.Approved | Goedgekeurd |
| 4 | InvoiceStatus.CreditCreated | Credit open |
| 8 | InvoiceStatus.CreditApproved | Credit goedgekeurd |
| 32 | InvoiceStatus.CreatedNoPurchase | Open (zonder bestelling) |
| 64 | InvoiceStatus.ApprovedNoPurchase | Goedgekeurd (zonder bestelling) |
| 128 | InvoiceStatus.CreditCreatedNoPurchase | Credit open (zonder bestelling) |
| 256 | InvoiceStatus.CreditApprovedNoPurchase | Credit goedgekeurd (zonder bestelling) |
Statusverloopbewerken
Open (Created) --> Goedgekeurd (Approved)
Credit open (CreditCreated) --> Credit goedgekeurd (CreditApproved)
Facturen zonder gekoppelde bestelling doorlopen dezelfde statusstappen maar met aparte statuswaarden (NoPurchase-varianten).
Belangrijkste propertiesbewerken
| Property | Type | Kolom | Nullable | Omschrijving |
|---|---|---|---|---|
| Id | UltimoString(9) | INVID | Nee | Uniek factuur-ID |
| Description | UltimoString(200) | INVDESCR | Ja | Omschrijving |
| Status | Status | INVRECSTATUS | Nee | Recordstatus |
| Context | Context | INVCONTEXT | Nee | Context (default: 1) |
| BookDate | Date? | INVBOOKDATE | Ja | Boekingsdatum (default: SYSDATE) |
| Vendor | Vendor | INVVDRID | Ja | Leverancier |
| Purchase | Purchase | INVPCHID | Ja | Gekoppelde bestelling |
| Currency | Currency | INVCURID | Nee | Valuta |
| CurrencyRate | Decimal | INVCURRATE | Nee | Wisselkoers |
| Department | Department | INVDEPID | Ja | Afdeling |
| Total | TransactionMoney | INVTOTAL | Nee | Totaalbedrag (readonly) |
| StandardTotalPrice | CompanyMoney | INVSTDTOTPRICE | Nee | Standaard totaalprijs (readonly) |
| StandardTotalPriceIncludingVat | CompanyMoney | INVSTDTOTPRICEINCLVAT | Nee | Standaard totaalprijs incl. BTW (readonly) |
| StandardVatPrice | CompanyMoney | INVSTDVATPRICE | Nee | Standaard BTW-bedrag (readonly) |
| StatusApprovedDate | DateTime? | INVDATE | Ja | Datum goedkeuring |
| StatusApprovedEmployee | Employee | INVEMPID | Ja | Medewerker die goedkeurde |
| Lines | List[InvoiceLine] | INVLINVID | Nee | Factuurregels |
| Exported | Boolean | INVEXPORTED | Nee | Geexporteerd naar extern systeem |
| ExternalId | UltimoString(50) | INVEXTERNALID | Ja | Extern ID (bijv. ERP-factuurnummer) |
| PurchaseAddType | PurchaseAddType | INVPURCHASEADDTYPE | Nee | Koppeltype bestelling (None=0, Purchase=1, Receipt=2) |
| Site | Site | INVSITID | Ja | Vestiging |
| Text | UltimoString | INVTEXT | Ja | Vrij tekstveld |
Gerelateerde entiteitenbewerken
InvoiceLine (Factuurregel)bewerken
Elke factuur bevat een of meer factuurregels. Een factuurregel kan gekoppeld zijn aan een job, uitrusting, bestelling, ontvangstregel of servicecontract.
Primaire sleutel: INVLINVID + INVLLINEID
Belangrijkste properties:
| Property | Type | Kolom | Omschrijving |
|---|---|---|---|
| Invoice | Invoice | INVLINVID | Verwijzing naar factuur |
| LineId | UltimoString(4) | INVLLINEID | Regelnummer |
| Article | Article | INVLARTID | Artikel |
| Description | UltimoString(200) | INVLDESCR | Omschrijving |
| Quantity | Decimal | INVLQTY | Aantal |
| Price | TransactionMoney | INVLPRICE | Prijs per eenheid |
| TotalPrice | TransactionMoney | INVLTOTPRICE | Totaalprijs |
| GrossPrice | TransactionMoney | INVLGROSSPRICE | Brutoprijs |
| Discount | Decimal | INVLDISCOUNT | Korting |
| Vat | Vat | INVLVATID | BTW-code |
| VatPercentage | Decimal | INVLVATPERCENTAGE | BTW-percentage |
| Job | Job | INVLJOBID | Gekoppelde job |
| Equipment | Equipment | INVLEQMID | Gekoppelde uitrusting |
| PurchaseLine | PurchaseLine | INVLPCHID, INVLPCHLID | Bestellijn |
| ReceiptLine | ReceiptLine | INVLRCPID, INVLRCPLID | Ontvangstregel |
| CostCenter | CostCenter | INVLCCRID | Kostenplaats |
| CostType | CostType | INVLCSTTID | Kostensoort |
| Department | Department | INVLDEPID | Afdeling |
| Customer | Customer | INVLCUSID | Klant |
| Account | Account | INVLACCID | Grootboekrekening |
InvoiceLine-statussen:
| Value | Naam | Beschrijving |
|---|---|---|
| 1 | InvoiceLineStatus.Created | Open |
| 2 | InvoiceLineStatus.Approved | Goedgekeurd |
| 4 | InvoiceLineStatus.CreditCreated | Credit open |
| 8 | InvoiceLineStatus.CreditApproved | Credit goedgekeurd |
| 16 | InvoiceLineStatus.PurchaseLineAdded | Bestelregel |
| 512 | InvoiceLineStatus.InvoiceProposal | Factuurvoorstel |
| 1024 | InvoiceLineStatus.InvoiceZero | 0 factureren |
| 2048 | InvoiceLineStatus.InvoiceNextRun | Volgende run |
| 16384 | InvoiceLineStatus.Invoiced | Gefactureerd |
InvoiceGroup (Factuurgroep)bewerken
Factuurgroepen worden gebruikt om facturen te groeperen.
InvoicePeriod (Factuurperiode)bewerken
Factuurperiodes definieren een tijdvak waarbinnen kosten worden geboekt.
| Value | Naam | Beschrijving |
|---|---|---|
| 1 | InvoicePeriodStatus.Created | Open |
| 2 | InvoicePeriodStatus.Closed | Gesloten |
Relaties met andere entiteitenbewerken
- Vendor -- leverancier op de factuur
- Purchase -- de bestelling waartegen de factuur wordt geboekt
- Job -- factuurregels kunnen direct aan een job gekoppeld zijn
- Equipment -- factuurregels kunnen aan een uitrusting gekoppeld zijn
- Employee -- medewerker die de factuur goedkeurt
- Currency -- valuta van de factuur
- Site -- vestiging
Tipsbewerken
- Facturen kunnen zowel met als zonder bestelling worden aangemaakt. De NoPurchase-statusvarianten worden gebruikt wanneer er geen bestelling aan gekoppeld is.
- Via het veld
PurchaseAddTypekun je aangeven of de factuur aan een bestelling of aan een ontvangst moet worden gekoppeld. - Het veld
Exportedgeeft aan of de factuur al naar een extern systeem (bijv. ERP) is geexporteerd. Gebruik dit bij integraties. - Creditfacturen doorlopen een apart statuspad (CreditCreated --> CreditApproved).
- De boekingsdatum (
BookDate) bepaalt in welke factuurperiode de kosten vallen.