business/documents Methode

Last modified: 5. Dezember 2024

Mit dieser Methode können zu bereits vorhandenen Deals (Bestellungen, Aufträge) und Quotes (Angebote) die OpenTrans 2.1 Dokumente abgerufen werden. Die entsprechenden TransaktionIds können über die jeweiligen business/deals oder business/quotes API Methoden erhalten werden.

Opentrans 2.1 ORDER Download

Abrufen eines OpenTrans 2.1 ORDER (Bestellung, Auftrag) Dokuments eines bereits angelegten oder abgeschickten Bestellung anhand der TransaktionId acb-sxf-sswa-1241541

Bsp: https://api.itscope.com/2.0/business/documents/acb-sxf-sswa-1241541/ORDER.xml

Opentrans 2.1 ORDERRESPONSE Download

Abrufen eines OpenTrans 2.1 ORDERRESPONSE (Bestellbestätigung, Bestellantwort) Dokuments eines bereits abgeschickten Bestellung anhand der TransaktionId acb-sxf-bbaaa-35461541

Bsp: https://api.itscope.com/2.0/business/documents/acb-sxf-bbaaa-35461541/ORDERRESPONSE.xml

Opentrans 2.1 DISPATCHNOTIFICATION Download

Abrufen eines OpenTrans 2.1 DISPATCHNOTIFICATION (LieferAvis, Lieferschein) Dokuments eines bereits abgeschickten Bestellung anhand der TransaktionId bdh-aur-bbey-887523435

Bsp: https://api.itscope.com/2.0/business/documents/bdh-aur-bbey-887523435/DISPATCHNOTIFICATION.xml

Opentrans 2.1 INVOICE Download

Abrufen eines OpenTrans 2.1 INVOICE (Rechnung) Dokuments eines bereits abgeschickten Bestellung anhand der TransaktionId buik-oikje-uiohd-98792874

Bsp: https://api.itscope.com/2.0/business/documents/buik-oikje-uiohd-98792874/INVOICE.xml

ZUGFerd, E-Rechnung, XRechnung PDF Download

Abrufen eines ZUGFerd, XRechnung oder E-Rechnung Pdf Dokuments einer bereits abgeschickten Bestellung anhand der TransaktionId buik-oikje-uiohd-98792874. Die Formate ZUGFerd, XRechnung oder E-Rechnung werden nur von bestimmten Lieferanten angeboten.

Im Standardfall werden anhand der XML Rechnungsdaten der LIeferanten nur Proforma Rechnungen als PDF erstellt. Die originale Rechnungen werden vom Lieferant über die Standardwege (z.B. Email) übermittelt.

Bsp: https://api.itscope.com/2.0/business/documents/buik-oikje-uiohd-98792874/INVOICE.pdf

Opentrans 2.1 QUOTATION Download

Abrufen eines OpenTrans 2.1 QUOTATION (Angebot) Dokuments eines bereits angelegten oder verschickten Angebots aus dem ITscope Portal anhand der TransaktionId 123-agfa-1254-579a653bd

Bsp: https://api.itscope.com/2.0/business/documents/123-agfa-1254-579a653bd/QUOTATION.xml

Semantische Validierung der OpenTrans 2.1 Bestell und Bestellantwortdokumente gegen das OpenTrans XSD Schema

Hiermit könne alle Bestell und Antwortdokumente im Format OpenTrans 2.1 während der Entwicklung bzw. auch vor dem Senden über unsere API validiert werden. Hier findet nur eine Semantische Validierung gebenüber dem OpenTrans 2.1 XSD Schema.

Das Betrifft folgende Dokumente

  • OpenTrans 2.1 ORDER Dokument im XML Format
  • OpenTrans 2.1 ORDERRESPONSE Dokument im XML Format
  • OpenTrans 2.1 DISPATCHNOTIFICATION Dokument im XML Format
  • OpenTrans 2.1 INVOICE Dokument im XML Format
  • Im Falle eines fehlerhaften Dokuments sind in den Fehlerausgaben Zeilen und Spaltennummer aufgeführt, die zu einem invaliden Ergebnis geführt haben

Bsp: https://api.itscope.com/2.0/business/documents/validateschema

Semantische und Inhaltliche Validierung des Bestelldokuments OpenTrans 2.1 ORDER vor dem Absenden einer Bestellung zu einem Lieferanten

Über diese Methode kann ausschliesslich das OpenTrans 2.1 ORDER Dokument, also die Bestellung via API validiert werden.

Diese Methode benötigt zwingend eine korrektes Bestelldokument das an einen bei ITscope gelisteten Lieferanten addressiert ist. Zum einen findet eine Semantische Validierung gebenüber dem OpenTrans 2.1 XSD Schema statt, aber auch zusätzlich eine Inhaltliche Prüfung des Dokuments im Bezugs auf bestimmte Einstellungen des Lieferanten bei dem bestellt werden soll. (z.B. Artikelnummern, Preise, Adressen, und auch ob die nötigen Services zu dem Lieferanten bei ITscope alle korrekt eingerichtet sind.

Wir empfehlen diese Methode nur zu Nutzen, wenn vor dem Abschicken einer echten LIVE Bestellung zu einem Lieferanten, nochmals sicher gestellt werden soll, das die Bestellung auch ohne Fehler durchlaufen soll.

Im Falle eines fehlerhaften Dokuments sind in den Fehlerausgaben Zeilen und Spaltennummer aufgeführt, die zu einem invaliden Ergebnis geführt haben

Bsp: https://api.itscope.com/2.0/business/documents/validate

Was this article helpful?
Dislike 0
Views: 1034