@vario-software/types 2026.27.1 → 2026.28.0

package/scripting/services.d.ts

@@ -12,7 +12,7 @@ import {
     CrmReminder, CrmState, CrmSubType, CrmTask, CrmTaskParticipant, 
     CrmTypedDocumentRef, CrmTypedDocumentRefList, CurrencyReference, Customer, 
     DangerousGoodInformation, DealNotificationEventConfig, DeliveryMethod, 
-    DeliveryTerm, Document, DocumentAdditionalInfo, 
+    DeliveryTerm, DmsOutputStream, Document, DocumentAdditionalInfo, 
     DocumentAdditionalInfo$IncomingGoodsTarget, 
     DocumentAdditionalInfo$IncomingGoodsTargetOfLine, 
     DocumentAdditionalInfo$OrderIntoPickingConvertResult, 
@@ -28,34 +28,36 @@ import {
     DocumentTransferToStateRequest, DocumentTransferToTypeRequest, 
     DocumentType, DocumentTypeFollowUp, DocumentTypeLabel, DocumentTypeState, 
     DummySerialNumberStockTransferApi, ECrmPriorityType, 
-    ECrmSpecialDocumentRefType, ECrmType, EScriptingAuthenticationType, 
-    EShelfDocumentDeletionState, FabricationComponentForProduction, 
-    FabricationDefectiveRequest, FabricationProduceRequest, 
-    FabricationRemainingComponent, FabricationRevertRequest, 
-    FabricationSerialNumber, Group, OpenItem, PaymentMethod, PaymentTerm, 
-    PaymentTermRef, PickTrolley, PickTrolleyBox, Picklist, PicklistLine, 
-    PicklistLineBooking, PicklistLineComponent, PicklistTemplate, 
-    PicklistTemplate$DateRange, PicklistTemplate$OrderSelectionOptions, 
+    ECrmSpecialDocumentRefType, ECrmType, ELinebreakType, 
+    EScriptingAuthenticationType, EShelfDocumentDeletionState, 
+    FabricationComponentForProduction, FabricationDefectiveRequest, 
+    FabricationProduceRequest, FabricationRemainingComponent, 
+    FabricationRevertRequest, FabricationSerialNumber, Group, OpenItem, 
+    PaymentMethod, PaymentTerm, PaymentTermRef, PickTrolley, PickTrolleyBox, 
+    Picklist, PicklistLine, PicklistLineBooking, PicklistLineComponent, 
+    PicklistTemplate, PicklistTemplate$DateRange, 
+    PicklistTemplate$OrderSelectionOptions, 
     PicklistTemplate$PicklistCreationOptions, 
     PicklistTemplate$PicklistProcessingOptions, 
-    PicklistTemplate$PicklistScript, PriceSelectionCriteria, Product, 
-    ProductArticleRef, ProductDiscount, ProductGroup, ProductMainGroup, 
-    ProductPrice, RecommendedRetailPrice, RequestDocument, RequestDocumentLine, 
-    RequestDocumentLineBooking, RequestDocumentLineCommission, 
-    RequestDocumentLineFabricationDetail, 
+    PicklistTemplate$PicklistScript, PlainScriptingWriter, 
+    PriceSelectionCriteria, Product, ProductArticleRef, ProductDiscount, 
+    ProductGroup, ProductMainGroup, ProductPrice, RecommendedRetailPrice, 
+    RequestDocument, RequestDocumentLine, RequestDocumentLineBooking, 
+    RequestDocumentLineCommission, RequestDocumentLineFabricationDetail, 
     RequestDocumentLineShippingCostDetail, RequestDocumentPriceModifier, 
     RequestDocumentText, RevenueCalculation, SalesAgent, Scenario, 
     ScenarioActualValue, ScenarioDimension, ScenarioDimensionValue, 
-    ScriptOutputRequest, ScriptingDate, ScriptingDateTime, SecureHttpClient, 
+    ScriptOutputRequest, ScriptingDate, ScriptingDateTime, 
+    ScriptingOutputStream, ScriptingXmlWriter, SecureHttpClient, 
     SequencerConfiguration, SequencerConfigurationDetail, 
     SerialNumberWithQuantityApi, ShelfDocument, ShelfDocumentAttribution, 
     ShelfDocumentType, ShelfFile, ShelfFileMetaData, ShelfShare, 
     ShelfTranslatableText, Stock, StockMovementManualApi, StockTransferApi, 
-    StockTransferResult, StorageBinRef, SubFileInfo, Supplier, TagDto, 
-    TaxIdForeignCountry, TextEnumCreate, TextEnumGet, TssSignature, 
-    UnitTypeReference, UpdateDocumentRequest, User, VariantAttribute, 
-    VariantAttributeListing, VariantDescription, VariantSchema, VariantValue, 
-    VariantValueListing, VariantValueReference
+    StockTransferResult, StorageBinRef, StringCollectorOutputStream, 
+    SubFileInfo, Supplier, TagDto, TaxIdForeignCountry, TextEnumCreate, 
+    TextEnumGet, TssSignature, UnitTypeReference, UpdateDocumentRequest, User, 
+    VariantAttribute, VariantAttributeListing, VariantDescription, 
+    VariantSchema, VariantValue, VariantValueListing, VariantValueReference
 } from "./types"
 
 /**
@@ -550,27 +552,27 @@ export interface ArticleScriptingService {
      * 
      * @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;
 
     /**
      * 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, 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;
 
     /**
      * Persistiert einen Artikel. Die Texte werden zur Sprache {@code languageCode} gespeichert
@@ -703,21 +705,21 @@ Die Texte werden zur Sprache der eigenen Adresse gespeichert.
     readById(id: number, languageCode: string): Article;
 
     /**
-     * Liest einen Artikel über die Artikelnummer mit Texten zur Sprache der eigenen Adresse
+     * Liest einen Artikel über die Artikelnummer mit Texten zur Sprache {@code languageCode}
      * 
      * @param {string} articleNumber - Eine Artikelnummer
+     * @param {string} languageCode - Zu verwendende Sprache
      * @return {Article} Der gelesene Artikel
      */
-    readByNumber(articleNumber: string): Article;
+    readByNumber(articleNumber: string, languageCode: string): Article;
 
     /**
-     * Liest einen Artikel über die Artikelnummer mit Texten zur Sprache {@code languageCode}
+     * Liest einen Artikel über die Artikelnummer mit Texten zur Sprache der eigenen Adresse
      * 
      * @param {string} articleNumber - Eine Artikelnummer
-     * @param {string} languageCode - Zu verwendende Sprache
      * @return {Article} Der gelesene Artikel
      */
-    readByNumber(articleNumber: string, languageCode: string): Article;
+    readByNumber(articleNumber: string): Article;
 
     /**
      * Persistiert einen Artikel. Die Texte werden zur Sprache {@code languageCode} gespeichert
@@ -1798,18 +1800,18 @@ 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)
@@ -1929,16 +1931,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
@@ -2799,6 +2801,46 @@ export interface ScriptOutputHelperService {
     createOutputRequest(): ScriptOutputRequest;
 }
 
+/**
+ * Factory zum Erzeugen von Writern und OutputStreams
+ */
+export interface ScriptingIOFactory {
+
+    /**
+     * Erzeugt einen Writer für einfache Texte ohne besondere Formatierungs- oder Syntax-Unterstützung mit Standard-Zeilenumbruch (Windows).
+     * 
+     * @param {ScriptingOutputStream} destination - Ziel-Stream, in den geschrieben wird
+     * @return {PlainScriptingWriter} Der erzeugte Writer
+     */
+    createPlainWriter(destination: ScriptingOutputStream): PlainScriptingWriter;
+
+    /**
+     * Wie createPlainWriter(ScriptingOutputStream), aber mit einstellbarer Zeichenfolge für Zeilenumbrüche
+     * 
+     * @param {ScriptingOutputStream} destination - Ziel-Stream, in den geschrieben wird
+     * @param {ELinebreakType} linebreakType - Zeichenfolge für einen Zeilenumbruch
+     * @return {PlainScriptingWriter} Der erzeugte Writer
+     */
+    createPlainWriter(destination: ScriptingOutputStream, linebreakType: ELinebreakType): PlainScriptingWriter;
+
+    /**
+     * Erzeugt einen StringCollector, der geschriebene Daten als String sammelt.
+     * 
+     * @return {StringCollectorOutputStream} Der erzeugte StringCollector
+     */
+    createStringCollector(): StringCollectorOutputStream;
+
+    /**
+     * Erzeugt einen XmlWriter, der in den übergebenen Stream schreibt.
+     * 
+     * @param {ScriptingOutputStream} destination - Ziel-Stream, in den geschrieben wird
+     * @param {string} encoding - Encoding (z.B. UTF-8)
+     * @param {boolean} prettyPrint - besser leserlich formatieren?
+     * @return {ScriptingXmlWriter} Der erzeugte XmlWriter
+     */
+    createXmlWriter(destination: ScriptingOutputStream, encoding: string, prettyPrint: boolean): ScriptingXmlWriter;
+}
+
 /**
  * Services
  */
@@ -2820,14 +2862,14 @@ export interface ScriptingServiceList {
     crmTaskService: CrmTaskScriptingService;
 
     /**
-     * Service zur Verarbeitung von Accounts
+     * Service zur Verarbeitung von Shelf-Documents
      */
-    accountService: AccountScriptingService;
+    shelfDocumentService: ShelfDocumentScriptingService;
 
     /**
-     * Service zur Verarbeitung von Shelf-Documents
+     * Service zur Verarbeitung von Accounts
      */
-    shelfDocumentService: ShelfDocumentScriptingService;
+    accountService: AccountScriptingService;
 
     /**
      * Logging im Scripting
@@ -2874,6 +2916,11 @@ export interface ScriptingServiceList {
      */
     dtoFactory: dtoFactory;
 
+    /**
+     * Factory zum Erzeugen von Writern und OutputStreams
+     */
+    ioFactory: ScriptingIOFactory;
+
     /**
      * Service zur Verarbeitung von Produktpreisen in Skripten
      */
@@ -3079,6 +3126,15 @@ export interface ScriptingUtilities {
  */
 export interface ShelfDocumentScriptingService {
 
+    /**
+     * Legt ein Dokument an. Der Inhalt muss noch separat hochgeladen werden.
+     * 
+     * @param {string} fileName - Dateiname
+     * @param {string} documentTypeKey - Schlüssel des Dokumenttypen
+     * @return {ShelfDocument} Das angelegte Dokument
+     */
+    create(fileName: string, documentTypeKey: string): ShelfDocument;
+
     /**
      * Erstellt eine neue Verknüpfung zwischen einem DMS-Dokument und einem Geschäftsobjekt
      * 
@@ -3087,6 +3143,15 @@ export interface ShelfDocumentScriptingService {
      */
     createAttribution(attribution: ShelfDocumentAttribution): ShelfDocumentAttribution;
 
+    /**
+     * Erzeugt einen OutputStream, der geschriebene Daten als Datei ins DMS lädt.
+     * 
+     * @param {number} shelfDocumentId - ID des Dokuments
+     * @param {string} fileName - Dateiname
+     * @return {DmsOutputStream} Der erzeugte OutputStream
+     */
+    createDmsOutputStream(shelfDocumentId: number, fileName: string): DmsOutputStream;
+
     /**
      * Löscht eine DMS-Verknüpfung
      * 
@@ -3095,24 +3160,24 @@ export interface ShelfDocumentScriptingService {
     deleteAttribution(attributionId: number): void;
 
     /**
-     * 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;
 
     /**
-     * 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;
 
     /**
      * Findet ein Dokumentenart über ihren Schlüssel