updateManufacturers

Navigation:  WebService Calls > Options for Growth >

updateManufacturers

 Previous pageReturn to chapter overviewNext page

Texte ein-/ausblenden

Beschreibung

Aktualisierung von Herstellerdaten.

Beispiel Request

Code

<request method="updateManufacturers" version="1.0.0">

   <manufacturer significant_key="manufacturer_id">      

      <mandator_id>1</mandator_id>

      <!-- <manufacturer_id>[ID]</manufacturer_id> -->

      <identifier>Speed4Trade</identifier>

      <external_mfr_number>manu_1111</external_mfr_number>

      <homepage>https://www.speed4trade.com</homepage>

      <logo>

         <image_url>https://www.speed4trade.com/image.png</image_url>

         <!-- <local_image_path>\\Server\Imagepool\manufacturerlogo.png</local_image_path> --> <!-- Alternative 2 UNC -->

         <!-- <local_image_path>C:\User\Admin\Desktop\PIC\PDC11027.png</local_image_path> --> <!-- Alternative 3 lokales Laufwerk-->

         <image_type>png</image_type>

         <is_local>false</is_local>

      </logo>

   </manufacturer>

</request>

Feldliste Request

Name

Beschreibung

Anz.

Typ

Sonstiges

request

Root-Element der Anfrage

1

Element

method

Attribut von request. Name der Webservice-Methode.

1

string

Fester Wert:

„updateManufactuers“

version

Attribut von request. Legt die Version der Anfrage fest.

1

integer

Fester Wert:

„1.0.0“

manufacturer

Wrapper-Element, das die Daten des Herstellers zusammenfasst.

0..N

Element

significant_key

Gibt an welches Feld zur Identifikation des Herstellers beim Update genutzt wird.

1

string

Feste Werte:

„manufacturer_id“ | „external_

mfr_number“

reference_id

Optionales Attribut des Elements "manufacturer". In diesem Feld kann eine beliebige ID angegeben werden die später im zugehörigen Report-Block der Response-Daten wieder erscheint.

0..1

string

manufacturer_id

ID des Herstellers.

0..1

integer

mandator_id

ID des Mandanten dem der Hersteller zugeordnet ist.

1

integer

identifier

Bezeichner des Herstellers.

0..1

string

Länge:

0-50 Zeichen
Hinweis

homepage

Homepage des Herstellers.

0..1

string

Länge:

0-50 Zeichen

external_mfr_number

Externe Herstellernummer die dem Hersteller zugeordnet ist.

0..1

string

Länge:

0-50 Zeichen

logo

Wrapper-Element, das die Daten des Logobildes zusammenfasst

0..1

Element

image_url

URL eines im Web verfügbaren Bildes

0..1

string

Länge:

0 – 200 Zeichen

image_type

Dateiendung des Bildes

1

string

local_image_path

Lokaler Pfad auf dem Server zur abgelegten Bilddatei.

0..1

string

base64_image_data

Base64-Codierte Daten des Bildes

0..1

string

is_local

Legt fest ob die lokale Datei oder die URL genutzt wird.

1

boolean

Beispiel Response

Code

<response method="updateManufacturers" version="1.0.0">

   <report action="insert" return_code="0">

       <error_description>No error</error_description>

       <total_number_of_pages>0</total_number_of_pages>

       <total_number_of_entries>0</total_number_of_entries>

      <manufacturer>

         <manufacturer_id>1680096</manufacturer_id>

         <mandator_id>1</mandator_id>

         <identifier>Speed4Trade</identifier>

         <homepage>https://www.speed4trade.com</homepage>

         <logo>1680096.png</logo>

         <external_mfr_number>manu_1111</external_mfr_number>

      </manufacturer>

   </report>

</response>

Feldliste Response

Name

Beschreibung

Anz.

Typ

Sonstiges

response

Root-Element der Antwort

1

Element

method

Attribut von response. Name der Webservice-Methode.

1

string

Fester Wert:

„updateManufacturers“

version

Attribut von response. Legt die Version der Anfrage fest.

1

integer

Fester Wert:

„1.0.0“

report

Information über die ausgeführte Operation. Für jedes Hersteller-Element aus dem Request wird ein Report zurückgegeben.

1..N

Element

action

Attribut von report. Gibt an welche Operation mit dem Datensatz durchgeführt wurde.

0..1

string

Feste Werte:

insert |

update | delete

return_code

Attribut von report. Gibt an ob in der durchgeführten Operation Fehler aufgetreten sind.

1

integer

0 = OK.

< 0 = Fehler

reference_id

Optionales Attribut von report. Enthält die im zugehörigen order-Block des Requests angegebene reference_id falls diese angegeben wurde.

0..1

string

error_description

Falls bei der Durchführung der Operation Fehler aufgetreten sind wird in error_description eine Fehlerbeschreibung zurück geliefert

0..1

string

total_number_of_pages

Gibt an, wie viele Seiten es insgesamt gibt.

0..1

integer

total_number_of_entries

Gibt an, wie viele Einträge es insgesamt zurückgegeben werden.

0..1

integer

manufacturer

Wrapper-Element, das die Daten des Herstellers zusammenfasst

1

Element

manufacturer_id

Hersteller-ID

1

integer

mandator_id

Mandanten-ID

1

integer

identifier

Bezeichnung des Herstellers

0..1

string

homepage

Homepagelink

0..1

string

logo

Logo

0..1

string

external_mfr_number

externe Herstellernummer

0..1

string

Hinweise:

•Im der Oberfläche von Speed4Trade CONNECT können einem Hersteller nur lokale Bilder als Logo zugewiesen werden. Die Möglichkeit ein Logo per URL bzw. Base64 zuzuweisen existiert nur über die Webservice-API von Speed4Trade CONNECT.

•Der identifier kann bei Aktualisierung der Herstellerdaten weggelassen werden. Allerdings müssen Hersteller in der Software eine Bezeichnung haben, um verwendet werden zu können.

Änderungsübersicht

Version

Änderungsbeschreibung

3.2.9.75

Redaktionelle Überarbeitung

3.5.37

Response-Feldliste vervollständigt