Docs  /  App  /  NAVAX Wiederkehrende Verträge Interface  /  Arbeiten mit der App

 Verfügbare Operationen

2026/04/13 • 5 Min. Lesedauer

In diesem Thema

• CreateContract
• CreateContractLine
• CreateContractLine - Bundles
• ScheduledPriceQtyChange
• CancelContract
• CancelContractLine
• UpdateCustomer
• ExtendLine
• IndexingContractLine

Mehr anzeigen

Weniger anzeigen

Dieser Abschnitt beschreibt alle verfügbaren Operationen des NAVAX Recurring Contracts Interface Webservice. Jede Operation wird über den Endpunkt CallWebservice aufgerufen, indem der Operationsname im Parameter Operation und die erforderlichen Felder als JSON-Objekt im Parameter Payload übergeben werden. Die Pflichtfelder jeder Operation können auch zur Laufzeit über den Endpunkt ReadMe abgefragt werden.

CreateContract

Erstellt einen neuen Vertragskopf in Business Central. Pflichtfelder: Beispiel-Payload:

{
    "Description": "Wartungsvertrag 2026",
    "Starting Date": "2026-01-01",
    "Ending Date": "2026-12-31",
    "Source Type": "Customer",
    "Source No.": "10000",
    "Billing Type": "Monthly",
    "Day of Period Start": "1"
}

CreateContractLine

Fügt eine neue Vertragszeile zu einem bestehenden Vertrag hinzu. Pflichtfelder: Beispiel-Payload:

{
    "Contract No.": "KONT-00001",
    "Bundle Type": " ",
    "Type": "Item",
    "No.": "1000",
    "Quantity": "2",
    "Unit Price": "49"
}

CreateContractLine - Bundles

Um Bundles anzulegen, kann die Operation CreateContractLine verwendet werden. Zuerst muss der Bundle-Kopf angelegt werden, indem das Feld Bundle Type mit Bundle befüllt wird und der Type mit einem Leerzeichen befüllt wird ( ). Für die Komponenten des Bundles muss dann erneut die Operation CreateContractLine aufgerufen werden, wobei das Feld Bundle Type mit Component befüllt wird und zusätzlich im Feld Assigned To Bundle die Zeilennummer der Bundle-Kopfzeile übergeben wird (Diese kann aus dem Response entnommen werden).

ScheduledPriceQtyChange

Plant eine Preis- oder Mengenänderung für eine bestehende Vertragszeile zu einem definierten Datum. Pflichtfelder: Beispiel-Payload:

{
    "Contract No.": "KONT-00001",
    "Contract Line No.": "10000",
    "New Price": "59",
    "New Quantity": "",
    "Date For Change": "2026-04-01",
    "Posting Date": "2026-04-01",
    "Combine Periods": "false"
}

CancelContract

Storniert einen bestehenden Vertrag. Pflichtfelder: Beispiel-Payload:

{
    "Contract No.": "KONT-00001",
    "Cancel Reason": "Kundenwunsch",
    "Cancellation Received At": "2026-03-01",
    "Cancellation Date": "2026-06-30"
}

CancelContractLine

Storniert eine einzelne Zeile eines bestehenden Vertrags. Pflichtfelder: Beispiel-Payload:

{
    "Contract No.": "KONT-00001",
    "Contract Line No.": "10000",
    "Cancel Reason": "Artikelwechsel",
    "Cancellation Received At": "2026-03-01",
    "Cancellation Date": "2026-06-30"
}

UpdateCustomer

Aktualisiert die Adress- und Stammdaten eines Kunden und überträgt die Änderungen auf alle zugehörigen Verträge. Pflichtfelder: Beispiel-Payload:

{
    "Customer No.": "10000",
    "Name": "Adatum Corporation New",
    "Address": "Musterstraße 1",
    "City": "Wien",
    "Post Code": "1010"
}

ExtendLine

Verlängert eine bestehende Vertragszeile. Pflichtfelder: Beispiel-Payload:

{
    "Contract No.": "KONT-00001",
    "Contract Line No.": "10000"
}

IndexingContractLine

Führt die Indexierungslogik für eine Vertragszeile aus. Pflichtfelder: Beispiel-Payload:

{
    "Contract No.": "KONT-00001",
    "Contract Line No.": "10000",
    "Document Date": "2026-04-01",
    "Posting Date": "2026-04-01",
    "Combine Periods": "false"
}