IntraSell API

Die IntraSell API bietet diverse Möglichkeiten IntraSell zu automatisieren.

Folgendes ist möglich:

1. Rechnungen auflisten
2. PDF Dokumente holen. Siehe auch PDFExport
3. Artikel Importieren

IntraSell API Docs

Anleitung

Die API verwendet MQTT Nachrichten für den Datenaustausch. MQTT Kommunikation kann mit jedem beliebigen Tool realisiert werden. Wir empfehlen jedoch den MQTTX Client für Tests.

 Kommunikation erfolgt über MQTT (Websockets). 
Server: <strong>www.griton.net</strong>, Port: <strong>1883</strong> 
Datenprotokoll: JSON 
Test Client: MQTTX (Link: https://mqttx.app/) 
        

Rechnungen für Kunde auflisten

Die Rechnungen für einen Kunden sind erst verfügbar wenn ein Office Mitarbeiter die Rechnung von einem Auftrag erstellt (oder manuell eine Rechnung anlegt). Siehe PDFExport

Der Request spezifiziert die Kunden Emailadresse, im System werden alle Rechnungen der letzten Kunden mit der Emailadresse aufgelistet.

Im Block Eigenschaften sind die Paketnummer zu finden (können 0 oder mehrere sein).

Die Paketnummer kann ggf. eine Url sein für Tracking. das hängt von der Implementierung ab.

Die Rechnungen enthalten alle Informationen, jedoch die PDF ist mit dem nachfolgenden Request ($mandant/dokument) zu holen.

Request:

       Topic: $mandant/rechnungen
       

       Request:

{"KundenEmail": "office@mandant.at"}

Response:

       Topic: $mandant/rechnungen/list

       

       Response:

 
            [{
        "Nummer": 2025031060,
        "Typ": "AR",
        "KundNr": 468165,
        "Kunde": {
            "Idnr": 468165,
            "LandNr": 43,
            "Land": null,
            "Name": "TONKOV",
            "Vorname": "Grigor",
            "Firma": "",
            "Adresse": "Riedmarkstr. 14",
            "PLZ": "4209",
            "Ort": "Engerwitzdorf",
            "Tel": "06766063036",
            "Mobil": null,
            "Email": "gt@griton.net",
            "Settings": []
        },
        "KundNr2": 5670,
        "Lieferadresse": null,
        "MitarbeiterNr": 2,
        "Mitarbeiter": null,
        "Summe": 0.00,
        "SummeBrutto": 0.00,
        "SummeMWST": 0.00,
        "Positionen": [{
                "Id": 3102341,
                "Nummer": 2025031060,
                "Typ": "AR",
                "ArtNr": 1653,
                "Artikel": null,
                "Stk": 1.00,
                "Preis_Netto": 0.0000,
                "Preis_Brutto": 0.0000,
                "MWST": 0.0000,
                "Bezeichnung": "Versandkostenpauschale DE",
                "Beschreibung": null,
                "MWSTSatz": 0
            }, {
                "Id": 3102342,
                "Nummer": 2025031060,
                "Typ": "AR",
                "ArtNr": 328,
                "Artikel": null,
                "Stk": 1.00,
                "Preis_Netto": 0.0000,
                "Preis_Brutto": 0.0000,
                "MWST": 0.0000,
                "Bezeichnung": "TEST",
                "Beschreibung": null,
                "MWSTSatz": 0
            }, {
                "Id": 3102343,
                "Nummer": 2025031060,
                "Typ": "AR",
                "ArtNr": 10007,
                "Artikel": null,
                "Stk": 2.00,
                "Preis_Netto": 0.0000,
                "Preis_Brutto": 0.0000,
                "MWST": 0.0000,
                "Bezeichnung": "Pros Pro BLACKOUT 200 m 1.24",
                "Beschreibung": null,
                "MWSTSatz": 0
            }
        ],
        "Datum": "2025-08-12T11:01:16",
        "Eigenschaften": null,
        "Zustellzeit": null,
        "ZustellzeitBestaetigt": null,
        "ZahlungsMethode": "paypal@arfaian.com",
        "ZahlungsBedingung": "PayPal",
        "TransportMethode": "Versand mit GLS",
        "Abgeschlossen": true,
        "Ausgedruckt": true,
        "Bezahlt": false,
        "Notiz": "TEST Rechnung - Nicht löschen bitte!",
        "Woher": "AU2024031342",
        "Wohin": null,
        "ExterneReferenz": null,
        "Dokumente": [{
                "Id": 6,
                "DokumenteName": "Z:\\IntraSell_PDF_AR\\Vorgang_AR2025031060.pdf",
                "TabelleName": "buchVorgang",
                "FilterString": "AR-2025031060",
                "ErstelltAm": null
            }
        ],
            "Eigenschaften": [
      {
        "Id": 6127,
        "Name": "Paketnummerr",
        "Value": "1123234234"
      },
      {
        "Id": 6128,
        "Name": "Paketnummerr",
        "Value": "12312312312"
      },
      {
        "Id": 6129,
        "Name": "Paketnummerr",
        "Value": "01234567894"
      }
    ]
    }
]

        

Dokument Base64 (PDF) holen

Nicht jeder Rechnung hat PDF Dokument. Damit die Kunden eine PDF erhalten ist notwendig in IntraSell die Rechnung als PDF zu speichern und im Vorgang als Dokument abzulegen.

Request:

       Topic: $mandant/dokument
       

       Request:

{"DokumentName": "p:/test.pdf"}

Response:

       Topic: $mandant/dokument/content

       

       Response:

 {"DokumentName":"p:/test.pdf", "DokumentBase64" : "ABCD...."} 

PDF Rechnung in IntraSell ersrtellen