@vario-software/types 2026.21.3 → 2026.22.0

package/scripting/services.d.ts

@@ -3,14 +3,15 @@ import {
     AccountLoanValue, AccountManufacturer, AccountManufacturerDescription, 
     AccountPerson, AccountRelation, AdditionalParameter, ApiCreatableReference, 
     ApiObjectReference, Article, Article$Metric, 
-    ArticleAvailabilityDetermination, ArticleIdentifier, ArticleListing, 
-    ArticlePrintLabelSettings, ArticleSerialNumber, ArticleStorage, 
-    ArticleSupplier, BulkTransferRequestApi, BulkTransferResult, Contact, 
-    CountryReference, CreateNewDocumentRequest, CrmActivity, CrmActivityType, 
-    CrmChecklistItem, CrmDeal, CrmDealTopic, CrmObjectRef, CrmParticipant, 
-    CrmPriority, CrmProject, CrmReference, CrmReminder, CrmState, CrmSubType, 
-    CrmTask, CrmTaskParticipant, CrmTypedDocumentRef, CrmTypedDocumentRefList, 
-    CurrencyReference, Customer, DealNotificationEventConfig, DeliveryMethod, 
+    ArticleAvailabilityDetermination, ArticleCustomer, ArticleIdentifier, 
+    ArticleListing, ArticlePrintLabelSettings, ArticleSerialNumber, 
+    ArticleStorage, ArticleSupplier, BulkTransferRequestApi, 
+    BulkTransferResult, Contact, CountryReference, CreateNewDocumentRequest, 
+    CrmActivity, CrmActivityType, CrmChecklistItem, CrmDeal, CrmDealTopic, 
+    CrmObjectRef, CrmParticipant, CrmPriority, CrmProject, CrmReference, 
+    CrmReminder, CrmState, CrmSubType, CrmTask, CrmTaskParticipant, 
+    CrmTypedDocumentRef, CrmTypedDocumentRefList, CurrencyReference, Customer, 
+    DangerousGoodInformation, DealNotificationEventConfig, DeliveryMethod, 
     DeliveryTerm, Document, DocumentAdditionalInfo, 
     DocumentAdditionalInfo$IncomingGoodsTarget, 
     DocumentAdditionalInfo$IncomingGoodsTargetOfLine, 
@@ -37,10 +38,11 @@ import {
     PicklistTemplate$PicklistCreationOptions, 
     PicklistTemplate$PicklistProcessingOptions, 
     PicklistTemplate$PicklistScript, PriceSelectionCriteria, Product, 
-    ProductDiscount, ProductGroup, ProductMainGroup, ProductPrice, 
-    RecommendedRetailPrice, RequestDocument, RequestDocumentLine, 
+    ProductArticleRef, ProductDiscount, ProductGroup, ProductMainGroup, 
+    ProductPrice, RecommendedRetailPrice, RequestDocument, RequestDocumentLine, 
     RequestDocumentLineBooking, RequestDocumentLineCommission, 
-    RequestDocumentLineFabricationDetail, RequestDocumentPriceModifier, 
+    RequestDocumentLineFabricationDetail, 
+    RequestDocumentLineShippingCostDetail, RequestDocumentPriceModifier, 
     RequestDocumentText, RevenueCalculation, SalesAgent, Scenario, 
     ScenarioActualValue, ScenarioDimension, ScenarioDimensionValue, 
     ScriptOutputRequest, ScriptingDate, ScriptingDateTime, SecureHttpClient, 
@@ -371,6 +373,82 @@ export interface AccountScriptingService {
     updateRelation(accountId: number, relation: AccountRelation): AccountRelation;
 }
 
+/**
+ * Service zur Verarbeitung von Artikel-Kundenbeziehungen im Skripten
+ */
+export interface ArticleCustomerScriptingService {
+
+    /**
+     * Aktiviert ein DTO
+     * 
+     * @param {number} idToActivate - ID vom zu aktivierenden DTO
+     * @return {ArticleCustomer} Das aktivierte DTO
+     */
+    activate(idToActivate: number): ArticleCustomer;
+
+    /**
+     * Persistiert ein DTO
+     * 
+     * @param {ArticleCustomer} toCreate - Das zu persistierende DTO
+     * @return {ArticleCustomer} Das persistierte DTO
+     */
+    create(toCreate: ArticleCustomer): ArticleCustomer;
+
+    /**
+     * Deaktiviert ein DTO
+     * 
+     * @param {number} idToDeactivate - ID vom zu deaktivierenden DTO
+     * @return {ArticleCustomer} Das deaktivierte DTO
+     */
+    deactivate(idToDeactivate: number): ArticleCustomer;
+
+    /**
+     * Löscht eine Entity
+     * 
+     * @param {number} id - ID der zu löschenden Entity
+     */
+    deleteById(id: number): void;
+
+    /**
+     * Erstellt eine neue DTO-Instanz
+     * 
+     * @return {ArticleCustomer} Die neue DTO-Instanz
+     */
+    getNewDto(): ArticleCustomer;
+
+    /**
+     * Liest eine Liste von DTOs
+     * 
+     * @param {Array<number>} ids - Die Liste der gelesenen DTOs
+     * @return {Array<ArticleCustomer>} Die Liste der gelesenen DTOs
+     */
+    readAllById(ids: Array<number>): Array<ArticleCustomer>;
+
+    /**
+     * Liest ein DTO
+     * 
+     * @param {number} id - ID vom zu lesenden DTO
+     * @return {ArticleCustomer} Das gelesene DTO
+     */
+    readById(id: number): ArticleCustomer;
+
+    /**
+     * Persistiert eine DTO
+     * 
+     * @param {ArticleCustomer} toStore - Das zu persistierende DTO
+     * @return {ArticleCustomer} Das persistierte DTO
+     */
+    store(toStore: ArticleCustomer): ArticleCustomer;
+
+    /**
+     * Aktualisiert ein persistiertes DTO
+     * 
+     * @param {ArticleCustomer} toUpdate - Die zu aktualisierende Entity
+     * @return {ArticleCustomer} Das aktualisierte DTO
+     */
+    update(toUpdate: ArticleCustomer): ArticleCustomer;
+}
+
 /**
  * Service zur Verarbeitung von Artikel-Listings im Skripten
  */
@@ -471,27 +549,27 @@ export interface ArticleScriptingService {
      * 
      * @param {string} batchIdentifier - ID des Etikettendrucklaufs
      * @param {number} articleId - ID des zu druckenden Artikels
-     * @param {number} articleSerialNumberId - ID der zu druckenden Seriennummer
-     * @param {number} labelCount - Anzahl der zu druckenden Etiketten
      */
-    addLabelToPrintBatch(batchIdentifier: string, articleId: number, articleSerialNumberId: number, labelCount: number): void;
+    addLabelToPrintBatch(batchIdentifier: string, articleId: number): void;
 
     /**
      * Fügt Informationen zum Druck Etiketten zu einem Artikel zu einem Etikettendrucklauf hinzu
      * 
      * @param {string} batchIdentifier - ID des Etikettendrucklaufs
      * @param {number} articleId - ID des zu druckenden Artikels
+     * @param {number} articleSerialNumberId - ID der zu druckenden Seriennummer
      * @param {number} labelCount - Anzahl der zu druckenden Etiketten
      */
-    addLabelToPrintBatch(batchIdentifier: string, articleId: number, labelCount: number): void;
+    addLabelToPrintBatch(batchIdentifier: string, articleId: number, articleSerialNumberId: number, labelCount: number): void;
 
     /**
      * Fügt Informationen zum Druck Etiketten zu einem Artikel zu einem Etikettendrucklauf hinzu
      * 
      * @param {string} batchIdentifier - ID des Etikettendrucklaufs
      * @param {number} articleId - ID des zu druckenden Artikels
+     * @param {number} labelCount - Anzahl der zu druckenden Etiketten
      */
-    addLabelToPrintBatch(batchIdentifier: string, articleId: number): void;
+    addLabelToPrintBatch(batchIdentifier: string, articleId: number, labelCount: number): void;
 
     /**
      * Persistiert einen Artikel. Die Texte werden zur Sprache {@code languageCode} gespeichert
@@ -549,16 +627,16 @@ Die Texte werden zur Sprache der eigenen Adresse gespeichert.
      * Führt einen Etikettendrucklauf aus
      * 
      * @param {string} batchIdentifier - ID des Etikettendrucklaufs
-     * @param {string} reportGroupIdentifier - Name einer Etiketten-Report-Gruppe
      */
-    executeLabelPrintBatch(batchIdentifier: string, reportGroupIdentifier: string): void;
+    executeLabelPrintBatch(batchIdentifier: string): void;
 
     /**
      * Führt einen Etikettendrucklauf aus
      * 
      * @param {string} batchIdentifier - ID des Etikettendrucklaufs
+     * @param {string} reportGroupIdentifier - Name einer Etiketten-Report-Gruppe
      */
-    executeLabelPrintBatch(batchIdentifier: string): void;
+    executeLabelPrintBatch(batchIdentifier: string, reportGroupIdentifier: string): void;
 
     /**
      * Liefert die Einkaufsrabatte zu einem Artikel
@@ -1567,35 +1645,35 @@ export interface DocumentScriptingService {
      * Löst einen Beleg auf
      * 
      * @param {number} documentId - ID des aufzulösenden Belegs
-     * @param {Array<AdditionalParameter>} additionalParameters - Zusätzliche Parameter
      * @return {Document} Der aufgelöste Beleg
      */
-    dissolve(documentId: number, additionalParameters: Array<AdditionalParameter>): Document;
+    dissolve(documentId: number): Document;
 
     /**
      * Löst einen Beleg auf
      * 
      * @param {number} documentId - ID des aufzulösenden Belegs
+     * @param {Array<AdditionalParameter>} additionalParameters - Zusätzliche Parameter
      * @return {Document} Der aufgelöste Beleg
      */
-    dissolve(documentId: number): Document;
+    dissolve(documentId: number, additionalParameters: Array<AdditionalParameter>): Document;
 
     /**
      * Startet die Bearbeitung eines Belegs (Transition SAVED -> EDIT)
      * 
      * @param {number} documentId - ID des Belegs
+     * @param {Array<AdditionalParameter>} additionalParameters - Zusätzliche Parameter
      * @return {Document} Der Beleg in Bearbeitung
      */
-    edit(documentId: number): Document;
+    edit(documentId: number, additionalParameters: Array<AdditionalParameter>): Document;
 
     /**
      * Startet die Bearbeitung eines Belegs (Transition SAVED -> EDIT)
      * 
      * @param {number} documentId - ID des Belegs
-     * @param {Array<AdditionalParameter>} additionalParameters - Zusätzliche Parameter
      * @return {Document} Der Beleg in Bearbeitung
      */
-    edit(documentId: number, additionalParameters: Array<AdditionalParameter>): Document;
+    edit(documentId: number): Document;
 
     /**
      * Erstellt ein AdditionalParameter-Objekt
@@ -1698,16 +1776,16 @@ export interface DocumentScriptingService {
      * Versendet einen Beleg per Mail
      * 
      * @param {number} documentId - ID des zu versendenden Belegs
+     * @param {string} reportGroupIdentifier - 
      */
-    sendViaMail(documentId: number): void;
+    sendViaMail(documentId: number, reportGroupIdentifier: string): void;
 
     /**
      * Versendet einen Beleg per Mail
      * 
      * @param {number} documentId - ID des zu versendenden Belegs
-     * @param {string} reportGroupIdentifier - 
      */
-    sendViaMail(documentId: number, reportGroupIdentifier: string): void;
+    sendViaMail(documentId: number): void;
 
     /**
      * Überführt einen Beleg in einen anderen Status
@@ -2585,14 +2663,14 @@ export interface ScriptingServiceList {
     accountService: AccountScriptingService;
 
     /**
-     * Logging im Scripting
+     * Verwaltung von Versandarten
      */
-    logger: LoggingScriptingService;
+    deliveryMethodService: DeliveryMethodScriptingService;
 
     /**
-     * Verwaltung von Versandarten
+     * Logging im Scripting
      */
-    deliveryMethodService: DeliveryMethodScriptingService;
+    logger: LoggingScriptingService;
 
     /**
      * Service zur Verarbeitung von Deals
@@ -2610,14 +2688,14 @@ export interface ScriptingServiceList {
     productGroupService: ProductGroupScriptingService;
 
     /**
-     * Ausgabe-Support Methoden
+     * Service zur Verarbeitung von Hauptwarengruppen im Skripten
      */
-    outputHelper: ScriptOutputHelperService;
+    productMainGroupService: ProductMainGroupScriptingService;
 
     /**
-     * Service zur Verarbeitung von Hauptwarengruppen im Skripten
+     * Ausgabe-Support Methoden
      */
-    productMainGroupService: ProductMainGroupScriptingService;
+    outputHelper: ScriptOutputHelperService;
 
     /**
      * Service zur Verarbeitung von Account-Listings in Skripten
@@ -2639,6 +2717,11 @@ export interface ScriptingServiceList {
      */
     utils: ScriptingUtilities;
 
+    /**
+     * Service zur Verarbeitung von Artikel-Kundenbeziehungen im Skripten
+     */
+    articleCustomerService: ArticleCustomerScriptingService;
+
     /**
      * Service zur Verarbeitung von Variantenschemas in Skripten
      */
@@ -2670,14 +2753,14 @@ export interface ScriptingServiceList {
     articleStorageService: ArticleStorageScriptingService;
 
     /**
-     * Anfragen von neuen Zählerkreis-Nummern
+     * Verwaltung von Zahlungsarten
      */
-    freeSequencerService: FreeSequencerScriptingService;
+    paymentMethodService: PaymentMethodScriptingService;
 
     /**
-     * Verwaltung von Zahlungsarten
+     * Anfragen von neuen Zählerkreis-Nummern
      */
-    paymentMethodService: PaymentMethodScriptingService;
+    freeSequencerService: FreeSequencerScriptingService;
 
     /**
      * Service zur Bestandsabfrage und Lagerbuchung in Skripten
@@ -2830,24 +2913,24 @@ export interface ShelfDocumentScriptingService {
     deleteAttribution(attributionId: number): void;
 
     /**
-     * Lädt eine Datei von einer URL mit Authentifizierung herunter und erstellt ein neues DMS-Dokument
+     * Lädt eine Datei von einer URL herunter und erstellt ein neues DMS-Dokument
      * 
      * @param {string} url - Download-URL
-     * @param {EScriptingAuthenticationType} authenticationType - Art der Authentifizierung (BASIC_AUTH, BEARER_TOKEN)
-     * @param {string} authValue - Authentifizierungswert — Platzhalter (z.B. {{secret:myApi:token}}) oder Klartext. Bei BASIC_AUTH im Format 'username:password'
      * @param {string} documentTypeKey - Schlüssel der Dokumentenart
      * @return {ShelfDocument} Das neu erstellte DMS-Dokument
      */
-    downloadIntoDMS(url: string, authenticationType: EScriptingAuthenticationType, authValue: string, documentTypeKey: string): ShelfDocument;
+    downloadIntoDMS(url: string, documentTypeKey: string): ShelfDocument;
 
     /**
-     * Lädt eine Datei von einer URL herunter und erstellt ein neues DMS-Dokument
+     * Lädt eine Datei von einer URL mit Authentifizierung herunter und erstellt ein neues DMS-Dokument
      * 
      * @param {string} url - Download-URL
+     * @param {EScriptingAuthenticationType} authenticationType - Art der Authentifizierung (BASIC_AUTH, BEARER_TOKEN)
+     * @param {string} authValue - Authentifizierungswert — Platzhalter (z.B. {{secret:myApi:token}}) oder Klartext. Bei BASIC_AUTH im Format 'username:password'
      * @param {string} documentTypeKey - Schlüssel der Dokumentenart
      * @return {ShelfDocument} Das neu erstellte DMS-Dokument
      */
-    downloadIntoDMS(url: string, documentTypeKey: string): ShelfDocument;
+    downloadIntoDMS(url: string, authenticationType: EScriptingAuthenticationType, authValue: string, documentTypeKey: string): ShelfDocument;
 
     /**
      * Findet ein Dokumentenart über ihren Schlüssel
@@ -3749,6 +3832,13 @@ export interface dtoFactory {
      */
     createCustomer(): Customer;
 
+    /**
+     * Erstellt einen neue Instanz von DangerousGoodInformation
+     * 
+     * @return {DangerousGoodInformation} Neue Instanz von DangerousGoodInformation
+     */
+    createDangerousGoodInformation(): DangerousGoodInformation;
+
     /**
      * Erstellt einen neue Instanz von PicklistTemplate$DateRange
      * 
@@ -4141,6 +4231,13 @@ export interface dtoFactory {
      */
     createPrintedTranslatedField(): DocumentAdditionalInfo$PrintedTranslatedField;
 
+    /**
+     * Erstellt einen neue Instanz von ProductArticleRef
+     * 
+     * @return {ProductArticleRef} Neue Instanz von ProductArticleRef
+     */
+    createProductArticleRef(): ProductArticleRef;
+
     /**
      * Erstellt einen neue Instanz von RecommendedRetailPrice
      * 
@@ -4183,6 +4280,13 @@ export interface dtoFactory {
      */
     createRequestDocumentLineFabricationDetail(): RequestDocumentLineFabricationDetail;
 
+    /**
+     * Erstellt einen neue Instanz von RequestDocumentLineShippingCostDetail
+     * 
+     * @return {RequestDocumentLineShippingCostDetail} Neue Instanz von RequestDocumentLineShippingCostDetail
+     */
+    createRequestDocumentLineShippingCostDetail(): RequestDocumentLineShippingCostDetail;
+
     /**
      * Erstellt einen neue Instanz von RequestDocumentPriceModifier
      *