Orderkosten berekeningen referentie
Met de Orderkosten berekening script kunnen aanvullende orderregels en tekstregels worden toegevoegd aan één of meerdere orders. Onderstaand is een overzicht van de beschikbare functies en objecten die in dit script gebruikt kunnen worden.
Beschikbare globale objecten
| Naam | Type | Beschrijving |
|---|---|---|
Relation | ScriptRelation | De relatie waarvoor de orderkosten worden berekend. |
Orders | IList<ScriptSalesOrder> | Alle orders die betrokken zijn bij de berekening. |
Lines | IList<ScriptOrderArticleLine> | Alle artikelregels uit alle orders. |
Result | AdditionalCharges | Bevat de gegenereerde orderkostenregels. |
Globale functies
CreateOrderLine functie
Maakt een nieuwe artikelregel aan.
Syntax
CreateOrderLine()Retourneert
| Type | Beschrijving |
|---|---|
ILineBuilder | Builder voor het opbouwen van een nieuwe artikelregel. |
Voorbeeld
CreateOrderLine()
.WithArticleCode(1000)
.WithQuantity(1)
.Build();CreateOrderTextLine functie
Maakt een zelfstandige tekstregel aan.
Syntax
CreateOrderTextLine()Retourneert
| Type | Beschrijving |
|---|---|
INewTextLineBuilder<ILineBuilder> | Builder voor het opbouwen van een tekstregel. |
Voorbeeld
CreateOrderTextLine()
.WithText("Transportkosten worden later berekend")
.ShowOnInvoice()
.Build();CompleteLineBuilders functie
Voltooit automatisch alle nog niet afgesloten builders.
Normaal gesproken is het niet nodig deze functie zelf aan te roepen.
Syntax
CompleteLineBuilders()Parameters
Geen.
Retourneert
Geen waarde.
GetDynamicFields functie
Haalt dynamische velden op van een object.
Syntax
GetDynamicFields(object domainObject)Parameters
| Naam | Type | Beschrijving |
|---|---|---|
domainObject | object | Het object waarvan je de dynamische velden wilt ophalen. Bijvoorbeeld een artikel of relatie. |
Retourneert
De dynamische velden.
Voorbeeld
var dynamicFields = await GetDynamicFields(articleGroup);
var bedrag = dynamicFields.Common.Common.IVK_BEDRAG ?? 0;ILineBuilder
Builder voor het opbouwen van een artikelregel.
ForOrder(ScriptSalesOrder targetOrder) functie
Koppelt de regel aan een specifieke order.
Syntax
ForOrder(ScriptSalesOrder targetOrder)Parameters
| Naam | Type | Beschrijving |
|---|---|---|
targetOrder | ScriptSalesOrder | Doelorder. |
Retourneert
| Type |
|---|
ILineBuilder |
ForOrder functie
Start een selectie van een order op basis van een zoekmethode.
Syntax
ForOrder()Retourneert
| Type |
|---|
ISearchAndSelectOrder<ILineBuilder> |
ForFirstOrder functie
Koppelt de regel aan de eerste order uit de collectie.
Syntax
ForFirstOrder()Retourneert
| Type |
|---|
ILineBuilder |
WithArticleCode functie
Stelt het artikelnummer in.
Syntax
WithArticleCode(long articleCode)Parameters
| Naam | Type | Beschrijving |
|---|---|---|
articleCode | long | Artikelnummer van de toe te voegen regel. |
Retourneert
| Type |
|---|
ILineBuilder |
WithQuantity functie
Stelt de hoeveelheid in.
Syntax
WithQuantity(decimal quantity)Parameters
| Naam | Type |
|---|---|
quantity | decimal |
Retourneert
ILineBuilder
WithPrice functie
Stelt een prijs in.
Syntax
WithPrice(decimal price)Parameters
| Naam | Type |
|---|---|
price | decimal |
Retourneert
ILineBuilder
WithWeight functie
Stelt het gewicht in kilogrammen in.
Syntax
WithWeight(decimal weight)Parameters
| Naam | Type |
|---|---|
weight | decimal |
Retourneert
ILineBuilder
WithPortionWeight functie
Stelt het portiegewicht in.
Syntax
WithPortionWeight(decimal portionWeight)Parameters
| Naam | Type |
|---|---|
portionWeight | decimal |
Retourneert
ILineBuilder
WithDescription functie
Stelt een omschrijving in.
Syntax
WithDescription(string description)Parameters
| Naam | Type |
|---|---|
description | string |
Retourneert
ILineBuilder
WithRemarks functie
Stelt opmerkingen in.
Syntax
WithRemarks(string remarks)Parameters
| Naam | Type |
|---|---|
remarks | string |
Retourneert
ILineBuilder
WithText functie
Voegt een gekoppelde tekstregel toe aan de artikelregel.
Syntax
WithText(string text)Parameters
| Naam | Type |
|---|---|
text | string |
Retourneert
| Type |
|---|
ITextLineBuilder<ILineBuilder> |
Build functie
Voltooit de artikelregel en voegt deze toe aan het resultaat.
Syntax
Build()Retourneert
| Type |
|---|
IBuildContext |
ISearchAndSelectOrder
WithLargestInvoiceAmount functie
Selecteert de order met het hoogste factuurbedrag.
Syntax
WithLargestInvoiceAmount()Retourneert
Het oorspronkelijke builderobject.
| Type |
|---|
ILineBuilder of INewTextLineBuilder<T> |
INewTextLineBuilder
Builder voor een zelfstandige tekstregel.
ForOrder functie
ForOrder(ScriptSalesOrder targetOrder)Parameters
| Naam | Type |
|---|---|
targetOrder | ScriptSalesOrder |
Retourneert
INewTextLineBuilder<TParentContext>
ForFirstOrder functie
ForFirstOrder()Retourneert
INewTextLineBuilder<TParentContext>
WithText functie
WithText(string text)Parameters
| Naam | Type |
|---|---|
text | string |
Retourneert
ITextLineBuilder<TParentContext>
ITextLineBuilder
Builder voor tekstregels.
ShowOnAllReports functie
Toont de tekstregel op rapport, factuur en pakbon.
Syntax
ShowOnAllReports()Retourneert
ITextLineBuilder<TParentContext>
ShowOnReport functie
Toont de tekstregel op rapporten.
Syntax
ShowOnReport()Retourneert
ITextLineBuilder<TParentContext>
ShowOnInvoice functie
Toont de tekstregel op facturen.
Syntax
ShowOnInvoice()Retourneert
ITextLineBuilder<TParentContext>
ShowOnPickList functie
Toont de tekstregel op pakbonnen.
Syntax
ShowOnPickList()Retourneert
ITextLineBuilder<TParentContext>
Build functie
Voltooit de tekstregel.
Syntax
Build()Retourneert
Het bovenliggende builderobject.
Objecten
ScriptRelation
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
Id | Guid | Unieke identificatie van de relatie. |
Code | long | Relatiecode. |
Name | string | Naam van de relatie. |
Dynamic | dynamic | Dynamische velden van de relatie. |
ScriptSalesOrder
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
Id | Guid | Unieke identificatie van de verkooporder. |
Type | ExportedOrderType | Type van de verkooporder. |
Code | long | Ordernummer van de verkooporder. |
Lines | IList<ScriptOrderArticleLine> | Artikelregels van de verkooporder. |
TotalAmounts | ScriptTotalAmounts | Totaalbedragen van de verkooporder. |
DeliveredTotalAmounts | ScriptTotalAmounts | Totaalbedragen van de geleverde order. |
Route | ScriptRoute | Route gekoppeld aan de verkooporder. |
Dynamic | dynamic | Dynamische velden van de verkooporder. |
ScriptOrderArticleLine
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
Id | Guid | Unieke identificatie van de orderregel. |
Article | ScriptArticle | Artikel van de orderregel. |
RegisteredQuantity | decimal | Geregistreerde hoeveelheid. |
RegisteredNetWeight | decimal | Geregistreerd nettogewicht. |
OrderedQuantity | decimal | Bestelde hoeveelheid. |
PortionWeight | decimal | Portiegewicht. |
OrderedWeight | decimal | Besteld gewicht. |
Dynamic | dynamic | Dynamische velden van de orderregel. |
ScriptArticle
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
Id | Guid | Unieke identificatie van het artikel. |
Code | long | Artikelcode. |
Name | string | Naam van het artikel. |
Sales | ScriptArticleSales | Verkoopinformatie van het artikel. |
VatType | VatType | BTW-type van het artikel. |
Dynamic | dynamic | Dynamische velden van het artikel. |
ScriptArticleSales
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
OrderUnit | decimal? | Verkoopeenheid van het artikel. |
PortionWeight | decimal | Standaard portiegewicht van het artikel. |
QuantityType | QuantityType | Type hoeveelheid waarin het artikel wordt verkocht. |
ScriptRoute
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
Code | long | Routecode. |
Name | string | Routenaam. |
ScriptTotalAmounts
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
CurrencyCode | string | Valutacode. |
TotalAmountExcludingInvoiceDiscount | decimal | Totaal exclusief factuurkorting. |
InvoiceDiscountPercentage | decimal | Factuurkorting percentage. |
TotalAmountExcludingInvoiceDiscountAndPacking | decimal | Totaal exclusief factuurkorting en emballage. |
TotalInvoiceDiscountAmount | decimal | Factuurkorting bedrag. |
TotalInvoiceAmount | decimal | Factuurbedrag. |
TotalVatAmount | decimal | BTW-bedrag. |
TotalAmountIncludingInvoiceDiscount | decimal | Totaal inclusief factuurkorting. |
TotalPurchaseAmount | decimal | Inkoopwaarde. |
Surcharge | decimal | Toeslag. |
GrossProfit | decimal | Brutowinst. |
Margin | decimal | Margepercentage. |
AdditionalCharges
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
Lines | List<ScriptOrderLine> | Lijst met orderregels die als aanvullende kosten aan de order worden toegevoegd. De lijst kan zowel ScriptArticleOrderLine als ScriptTextOrderLine bevatten. |
ScriptArticleOrderLine
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
TargetOrderId | Guid | Identificatie van de doelorder waarop deze regel betrekking heeft. |
ArticleCode | long | Artikelcode van het artikel. |
Quantity | decimal? | Hoeveelheid van het artikel. |
PortionWeight | decimal? | Portiegewicht van het artikel. |
Weight | decimal? | Gewicht van het artikel. |
Price | decimal? | Prijs van de orderregel. |
Description | string | Omschrijving van de orderregel. |
Remarks | string | Opmerkingen bij de orderregel. |
ScriptTextOrderLine
Eigenschappen
| Eigenschap | Type | Beschrijving |
|---|---|---|
TargetOrderId | Guid | Identificatie van de doelorder waarop deze regel betrekking heeft. |
Text | string | Tekst die op de orderregel wordt weergegeven. |
ShowOnReport | bool | Geeft aan of de tekst op rapporten wordt weergegeven. |
ShowOnInvoice | bool | Geeft aan of de tekst op facturen wordt weergegeven. |
ShowOnPickList | bool | Geeft aan of de tekst op de picklijst wordt weergegeven. |
AssociatedOrderLine | ScriptArticleOrderLine | Gekoppelde artikelorderregel. |
Enumeraties
ExportedOrderType
| Waarde | Beschrijving |
|---|---|
None | Geen type. |
Normal | Normale order. |
Return | Retourorder. |
QuantityType
| Waarde | Beschrijving |
|---|---|
None | Niet gespecificeerd. |
Pieces | Verkoop per stuk. |
Weight | Verkoop op gewicht. |
PiecesWithKgPrice | Verkoop per stuk met kilogramprijs. |
VatType
| Waarde | Beschrijving |
|---|---|
None | Geen BTW. |
Low | Laag BTW-tarief. |
Medium | Middel BTW-tarief. |
High | Hoog BTW-tarief. |
Packing | Verpakkings-BTW. |
Service | Diensten-BTW. |
Zero | Nultarief. |
Voorbeeld
CreateOrderLine()
.ForOrder()
.WithLargestInvoiceAmount()
.WithArticleCode(9000)
.WithQuantity(1)
.WithPrice(12.50m)
.WithDescription("Transportkosten")
.WithText("Deze kosten zijn automatisch berekend")
.ShowOnInvoice()
.ShowOnPickList()
.Build()
.Build();
CreateOrderTextLine()
.ForFirstOrder()
.WithText("Bedankt voor uw bestelling")
.ShowOnInvoice()
.Build();