NAVAX Wiederkehrende Verträge Interface

Handbuch

☰ Inhaltsverzeichnis

Allgemein

• NAVAX Wiederkehrende Verträge Interface
  NAVAX Wiederkehrende Verträge Interface erweitert Microsoft Dynamics 365 Business Central und bietet die Möglichkeit, NAVAX Wiederkehrende Verträge automatisiert via API Endpunkte zu verwalten...

Einrichtung

• Wiederkehrende Verträge Interface Einrichtung
  Zur Einrichtung der NAVAX Wiederkehrende Verträge Interface sind zwei Schritte erforderlich...

Arbeiten mit der App

• Endpunkt Definition
  Der NAVAX Recurring Contracts Interface Webservice stellt zwei Endpunkte zur Verfügung, über die externe Systeme Vertragsoperationen in Business Central ausführen und die verfügbaren Operationen abfragen können...
• Verfügbare Operationen
  Dieser Abschnitt beschreibt alle verfügbaren Operationen des NAVAX Recurring Contracts Interface Webservice...

Anhang

• NAVAX Lizenzverwaltung
  Die Seite NAVAX Lizenzverwaltung (in älteren Versionen NAVAX Lizenzübersicht oder NCEX Lizenzübersicht) zeigt den aktuellen Lizenzstatus der NAVAX-Erweiterungen an...
• Installationshinweise
• Versionshinweise

Docs  /  App  /  NAVAX Wiederkehrende Verträge Interface  /  Allgemein
 NAVAX Wiederkehrende Verträge Interface

Navigation

Wie möchten Sie weiter verfahren

Installationshinweise

Docs  /  App  /  NAVAX Wiederkehrende Verträge Interface  /  Einrichtung
 Wiederkehrende Verträge Interface Einrichtung

Einrichtung in Azure

Microsoft Entra Application

1. Entra-Anwendung in Azure erstellen
   • Hier ist ein Link mit einer detaillierten Beschreibung: How to use Postman to connect with Business Central APIs
2. Nachdem die Entra-Anwendung in Azure erstellt wurde, ist es auch notwendig, die Entra-Anwendung in Business Central zu erstellen. (wird ebenfalls im Link beschrieben)
3. Wichtig: Für NAVAX Wiederkehrende Verträge Interface ist es wichtig, das Berechtigungsset NVXRCI, NVXRC sowie D365 READ hinzuzufügen.

API-Funktion Codeunit zu Web Services hinzufügen

1. Gehe zur Seite Web Services
2. Klicke auf + Neu
3. Verwende die folgenden Einstellungen:
   • Objekttyp: Codeunit
   • Objekt-ID: 70161950
   • Service Name: NVXRCIInterfaceMgt
4. Der Endpunkt wird veröffentlicht, indem das Flag Veröffentlicht aktiviert wird.
5. Der neu erstellte Webservice sollte wie folgt aussehen:

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

Voraussetzungen

Basis-URL

https://api.businesscentral.dynamics.com/v2.0/{{TenantID}}/{{Enviroment}}/ODataV4/InterfaceMgt_{{Endpoint}}?company={{CompanyName}}

• {{TenantID}} – Die Tenant-ID der BC-Umgebung
• {{Environment}} – Der Name der Business Central Umgebung (z. B. Production)
• {{CompanyName}} – Der Name des Business Central Mandanten (aus Mandanten)
• {{Endpoint}} – Der Name des Endpunkts, entweder CallWebservice oder readMe

Endpunkte

CallWebservice

{
    "operation": "CreateContract",
    "payload":'{
        "Description": "Interface Contract",
        "Starting Date": "2026-01-01",
        "Ending Date": "2026-12-31",
        "Source Type": "Customer",
        "Source No.": "10000",
        "Billing Type": "1M",
        "Day of Period Start": "1"
    }'
}

ReadMe

[{
        "CreateContract": {
            "Description": "Required",
            "Starting Date": "Required",
            "Ending Date": "Required",
            "Source Type": "Required",
            "Source No.": "Required",
            "Billing Type": "Required",
            "Day of Period Start": "Required"
        }
    }, {
        "CreateContractLine": {
            "Contract No.": "Required",
            "Bundle Type": "Required",
            "Type": "Required",
            "No.": "Required",
            "Quantity": "Required",
            "Unit Price": "Required"
        }
    }, {
        "ScheduledPriceQtyChange": {
            "Contract No.": "Required",
            "Contract Line No.": "Required",
            "New Price": "Required",
            "New Quantity": "Required",
            "Date For Change": "Required",
            "Posting Date": "Required",
            "Combine Periods": "Required"
        }
    }, {
        "CancelContract": {
            "Contract No.": "Required",
            "Cancel Reason": "Required",
            "Cancellation Received At": "Required",
            "Cancellation Date": "Required"
        }
    }, {
        "CancelContractLine": {
            "Contract No.": "Required",
            "Contract Line No.": "Required",
            "Cancel Reason": "Required",
            "Cancellation Received At": "Required",
            "Cancellation Date": "Required"
        }
    }, {
        "UpdateCustomer": {
            "Customer No.": "Required"
        }
    }, {
        "ExtendContractLine": {
            "Contract No.": "Required",
            "Contract Line No.": "Required"
        }
    }, {
        "IndexingContractLine": {
            "Contract No.": "Required",
            "Contract Line No.": "Required",
            "Document Date": "Required",
            "Posting Date": "Required",
            "Combine Periods": "Required"
        }
    }
]

Fehlerbehandlung

Docs  /  App  /  NAVAX Wiederkehrende Verträge Interface  /  Arbeiten mit der App
 Verfügbare Operationen

CreateContract

{
    "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

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

CreateContractLine - Bundles

ScheduledPriceQtyChange

{
    "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

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

CancelContractLine

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

UpdateCustomer

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

ExtendLine

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

IndexingContractLine

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

Docs  /  App  /  NAVAX Wiederkehrende Verträge Interface  /  Anhang
 NAVAX Lizenzverwaltung

Testversion

Lizenz beantragen

Lizenz aktivieren/aktualisieren

AGB & EULA

https://www.navax.app/EULA.php?L=de

Datenschutz

https://www.navax.app/privacyStatement.php?L=de

Bewertung abgeben

Docs  /  App  /  NAVAX Wiederkehrende Verträge Interface  /  Anhang
 Installationshinweise

Veröffentlichen und Installieren der Erweiterung

[Microsoft Learn] Business Central - Publishing and Installing an Extension

Abhängigkeiten

• NAVAX Extension Base

  ID: 2f4cb42d-6e2a-4708-a5e2-3ec5f32f20e9 Weitere Informationen dazu finden Sie unter [Docs] NAVAX Extension Base

• NAVAX Recurring Contracts

  ID: 2b6334c4-2225-4a1f-9de3-435f3c43acaa Weitere Informationen dazu finden Sie unter [Docs] NAVAX Recurring Contracts

On-Premises

• 70714865 NAVAX Recurring Contracts Interface
• 70714830 NAVAX Recurring Contracts
• 1010860 NAVAX Extension Base

Externe Adressen

• https://www.navax.app

  Für die Lizenzierung, den Aufruf der Onlinehilfe und das Ausführen einiger Aktionen muss der Zugriff auf https://www.navax.app erlaubt sein.
  
  Public IP von www.navax.app für die Freischaltung an der Firewall:
  94.136.22.236, Port: TCP/443
  
  Prüfung der Verbindung zu https://www.navax.app mittels PS:
  Test-NetConnection navax.app -port 443
  (PS muss mit dem M-Tier Service-User ausgeführt werden)
  
  CRL-Server
  Zusätzlich müssen für die Zertifikatsprüfung auch folgende CRL-Server erreichbar sein:
  https://certificates.godaddy.com/*
  http://crl.godaddy.com/*
  oder deren IP: 192.124.249.36

Docs  /  App  /  NAVAX Wiederkehrende Verträge Interface  /  Anhang
 Versionshinweise

Version 27.1.0.1

• Fehlerbehebungen

• • Ein Fehler beim Öffnen der Einrichtung wurde behoben.

Version 27.1.0.0

• Ursprungsversion