company Metadaten Methoden

Last modified: 30. Juni 2025

Übersicht
API Dokumentation
API Methoden - Bereich products und metadaten
company Metadaten Methoden

Unterpunkte

Herstellerliste (Metadaten)

Die API bietet Methoden zum Zugriff auf Hersteller Metadaten an.

manufacturer/company.xml: die Liste aller Hersteller im XML Format
manufacturer/company.json: die Liste aller Hersteller im JSON Format

z.B.
https://api.itscope.com/2.1/company/manufacturer/company.xml
oder
https://api.itscope.com/2.1/company/manufacturer/company.json

Lieferantenliste (Metadaten)

Die API bietet Methoden zum Zugriff auf Lieferanten Metadaten an.

Die Supplier->ID ist die in ITscope eindeutige Nummer des Distributors.

Liste aller Lieferanten

company/distributor/company.xml: die Liste aller Lieferanten im XML Format,
company/distributor/company.json: die Liste aller Lieferanten im JSON Format,

z.B.
https://api.itscope.com/2.1/company/distributor/company.xml
oder
https://api.itscope.com/2.1/company/distributor/company.json

Beispiel im XML-Format:

<companies>
  ...  
  <company>
    <name>ALSO Belgium BV</name>
    <street>Schaliënhoevedreef 20e</street>
    <zip>2800 </zip>
    <city>Mechelen</city>
    <country>BEL</country>
    <supplier>
      <id>10000940</id>
      <name>ALSO Belgique</name>
      <deeplink>https://www.itscope.com/red/app#companies/page/aeivP1_IThamCfPL7jrpgA/-</deeplink>
      <customerAccountNumber>1234</customerAccountNumber>
      <weeeRegNo>DE 1234</weeeRegNo>
    </supplier>
  </company>
 ...
</companies>

Liste aller Lieferanten mit zusätzlich verfügbaren eServices, den jeweiligen eService Features und der Bestellkonditionen

Über den Endpoint company/distributor/eservices kann eine Liste aller Distributoren mit zusätzlichen Informationen zu den verfügbaren/eingerichteten eServices und Bestellkonditionen abgefragt werden. Das Ergebnis kann sowohl als XML wie als JSON abgefragt werden, z.B. https://api.itscope.com/2.1/company/distributor/eservices.xml

Übersicht der Bestellkonditionen

Bei den Bestellkonditionen werden, sofern meine eigene Firma die Vorgaben des Lieferanten überschrieben hat, diese auch ausgegeben. Hat meine Firma keine Standardwerte des Lieferanten überschrieben, werden diese ausgegeben.

Name	Datentyp	Beschreibung
partialDeliveryAvailable	Boolean	Bietet der Lieferant eine Teillieferung an
partialDeliveryConfigured	Boolean	Ist eine Teillieferung von meiner Firma für den Lieferanten aktiviert worden
ownDeliveryNoteAvailable	Boolean	Bietet der Lieferant einen Versand mit eigenen Lieferschein an
ownDeliveryNoteConfigured	Boolean	Ist der Versand mit eigenem Lieferschen von meiner Firma für den Lieferanten aktiviert worden
orderOnlyValidItemIds	Boolean	Dürfen nur Artikel bestellt werden, die in ITscope vorhanden sind, oder sind auch Artikelnummern erlaubt, die ITscope nicht kennt
absoluteShippingCosts	Double	Absolute Versandkosten – Die Netto Versandkosten (ohne gewichts-/größenabhängige Zuschläge), die beim Standardversand anfallen.
relativeShippingCosts	Double	Prozentuale Versandkosten – Prozentualer Wert von der netto Bestellsumme für die Versandkosten.
freightFreeLimit	Double	Frachtfreigrenze – Nettobetrag, ab dem keine Versandkosten anfallen. Sonstige Versicherungen und Pauschalen sind nicht davon betroffen.
lowQuantitySurcharge	Double	Mindermengenzuschlag – Zusatzkosten, falls die Mindermengenschwelle nicht erreicht wird.
lowQuantitySurchargeThreshold	Double	Mindermengengrenze – Betrag, bis zu dem ein Mindermengenzuschlag berechnet wird.
ownDeliveryNoteCosts	Double	Kosten für Versand mit eigenem Lieferschein
absoluteTransportInsurance	Double	Absolute Transportversicherung
relativeTransportInsurance	Double	Prozentuale Transportversicherung von der netto Bestellsumme
environmentalFee	Double	Umweltpauschale für jede Bestellung
tollCharges	Double	Mautgebühren für jede Bestellung
packagingFee	Double	Verpackungspauschale für jede Bestellung

Werte des „features“ Feld bei den EServices

Unter dem Feld supplier -> eservices -> features werden die unterstützen Features des Distributor aufgeführt. Jedes Feature ist einem Typ zugeordnet

general
- EDI Der Distributor ist per elektronischer Bestellschnittstelle angebunden
- TRACKINGID Der Distributor liefert Sendeverfolgungsinformationen in seinen Lieferscheinen
- SERIALNUMBER Der Distributor liefert Seriennummern in seinen Lieferscheinen
shippingMethod
- Werte hierfür können standard, express, express8, express10, express12, pickup, consignment, expressSaturday10, expressSaturday12 sein. Diese Werte können um diese Versandart zu wählen im OpenTrans Dokument als Attribute „type“ des ORDER Elements angegeben werden.
deliveryDateType
- Beide Werte können bei der OpenTrans ORDER Bestellung beim DELIVERY_DATE einer Bestellposition als Typ angegeben werden.
  - fixed Der Distributor unterstützt die Lieferung zu einem Fixlieferdatum.
  - optional Der Distributor unterstützt Wunschlieferdatum.

Beispiel des eService Outputs im JSON-Format

...  
   {
      "name": "ALSO Deutschland GmbH",
      "street": "Lange Wende 43",
      "zip": "59494",
      "city": "Soest",
      "country": "DEU",
      "manufacturer": {
        "id": "13910",
        "name": "ALSO Deutschland GmbH",
        "shortName": "ALSO Deutschland",
        "deeplink": "https://www.itscope.com/red/app#companies/page/NFLZPv_UEeC4CQAbIT6RAg/-"
      },
      "supplier": {
        "id": "10000142",
        "name": "ALSO Deutschland",
        "deeplink": "https://www.itscope.com/red/app#companies/page/NFLZPv_UEeC4CQAbIT6RAg/-",
        "customerAccountNumber": "10374599",
        "partialDeliveryAvailable": "true",
        "partialDeliveryConfigured": "true",
        "ownDeliveryNoteAvailable": "true",
        "ownDeliveryNoteConfigured": "false",
        "orderOnlyValidItemIds": "false",
        "absoluteShippingCosts": "8.4",
        "relativeShippingCosts": "0.0",
        "freightFreeLimit": "0.0",
        "lowQuantitySurcharge": "0.0",
        "lowQuantitySurchargeThreshold": "0.0",
        "ownDeliveryNoteCosts": "0.0",
        "absoluteTransportInsurance": "50.0",
        "relativeTransportInsurance": "1.0",
        "environmentalFee": "2.0",
        "tollCharges": "0.0",
        "packagingFee": "15.0",
        "eservices": [
          ...
          {
            "id": "16",
            "name": "Bestellung",
            "status": "ACTIVE",
            "lastVerificationDate": "2019-04-26T13:36:17+02:00",
            "lastVerificationInfo": "Der Abruf der Daten war erfolgreich.",
            "features": [
                {
                   "name": "express10",
                   "type": "shippingMethod"
                },
                {
                   "name": "express12",
                   "type": "shippingMethod"
                },
                {
                   "name": "expressSaturday12",
                   "type": "shippingMethod"
                },
                {
                   "name": "optional",
                   "type": "deliveryDateType"
                },
                {
                   "name": "TRACKINGID",
                   "type": "general"
                },
                {
                   "name": "SERIALNUMBER",
                   "type": "general"
                },
                {
                    "name": "EDI",
                    "type": "general"
                } 
             ]
          },
          ...
        ]
      }
    },
...

Was this article helpful?

Like 2 Dislike 0