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>

      <email>info@speed4trade.com</email>

      <phone_number>0960294440</phone_number>

      <street>An den Gärten</street>

      <house_number>8</house_number>

      <street_addition>Hinterhaus</street_addition>

      <zip_code>92665</zip_code>

      <city>Altenstadt</city>

      <country_code_iso>DE</country_code_iso>

      <responsible_name>Max Mustermann</responsible_name>

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

      <responsible_email>info@speed4trade.com</responsible_email>

      <responsible_phone_number>0960294440</responsible_phone_number>

      <responsible_street>An den Gärten</responsible_street>

      <responsible_house_number>8</responsible_house_number>

      <responsible_street_addition>Hinterhaus</responsible_street_addition>

      <responsible_zip_code>92665</responsible_zip_code>

      <responsible_city>Altenstadt</responsible_city>

      <responsible_country_code_iso>DE</responsible_country_code_iso>

   </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

email

Kontakt-E-Mailadresse des Herstellers.

0..1

string

phone_number

Telefonnummer des Herstellers.

0..1

string

street

Straße der Herstelleranschrift.

0..1

string

house_number

Hausnummer der Herstelleranschrift.

0..1

string

street_addition

Straßenzusatz der Herstelleranschrift.

0..1

string

zip_code

Postleitzahl der Herstelleranschrift.

0..1

string

city

Stadt der Herstelleranschrift.

0..1

string

country_code_iso

Ländercode der Herstelleranschrift.

0..1

string

ISO 3166 ALPHA-2 Codes (z.B. „DE“)

responsible_name

Name der produktverantwortlichen Person.

0..1

string

responsible_website

Website des Herstellers mit Kontaktmöglichkeiten.

0..1

string

responsible_email

E-Mailadresse der produktverantwortlichen Person.

0..1

string

responsible_phone_number

Telefonnummer der produktverantwortlichen Person.

0..1

string

responsible_street

Straße der produktverantwortlichen Person.

0..1

string

responsible_house_number

Hausnummer der produktverantwortlichen Person.

0..1

string

responsible_street_addition

Straßenzusatz der produktverantwortlichen Person.

0..1

string

responsible_zip_code

Postleitzahl der produktverantwortlichen Person.

0..1

string

responsible_city

Ort der produktverantwortlichen Person.

0..1

string

responsible_country_code_iso

Ländercode der produktverantwortlichen Person.

0..1

string

ISO 3166 ALPHA-2 Codes (z.B. „DE“)

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>

         <email>info@speed4trade.com</email>

         <phone_number>0960294440</phone_number>

         <street>An den Gärten</street>

         <house_number>8</house_number>

         <street_addition>Hinterhaus</street_addition>

         <zip_code>92665</zip_code>

         <city>Altenstadt</city>

         <country_code_iso>DE</country_code_iso>

         <responsible_name>Max Mustermann</responsible_name>

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

         <responsible_email>info@speed4trade.com</responsible_email>

         <responsible_phone_number>0960294440</responsible_phone_number>

         <responsible_street>An den Gärten</responsible_street>

         <responsible_house_number>8</responsible_house_number>

         <responsible_street_addition>Hinterhaus</responsible_street_addition>

         <responsible_zip_code>92665</responsible_zip_code>

         <responsible_city>Altenstadt</responsible_city>

         <responsible_country_code_iso>DE</responsible_country_code_iso>

      </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

email

Kontakt-E-Mailadresse des Herstellers.

0..1

string

phone_number

Telefonnummer des Herstellers.

0..1

string

street

Straße der Herstelleranschrift.

0..1

string

house_number

Hausnummer der Herstelleranschrift.

0..1

string

street_addition

Straßenzusatz der Herstelleranschrift.

0..1

string

zip_code

Postleitzahl der Herstelleranschrift.

0..1

string

city

Stadt der Herstelleranschrift.

0..1

string

country_code_iso

Ländercode

0..1

string

ISO 3166 ALPHA-2 Codes (z.B. „DE“)

responsible_name

Name der produktverantwortlichen Person.

0..1

string

responsible_website

Website des Herstellers mit Kontaktmöglichkeiten.

0..1

string

responsible_email

E-Mailadresse der produktverantwortlichen Person.

0..1

string

responsible_phone_number

Telefonnummer der produktverantwortlichen Person.

0..1

string

responsible_street

Straße der produktverantwortlichen Person.

0..1

string

responsible_house_number

Hausnummer der produktverantwortlichen Person.

0..1

string

responsible_street_addition

Straßenzusatz der produktverantwortlichen Person.

0..1

string

responsible_zip_code

Postleitzahl der produktverantwortlichen Person.

0..1

string

responsible_city

Ort der produktverantwortlichen Person.

0..1

string

responsible_country_code_iso

Ländercode der produktverantwortlichen Person.

0..1

string

ISO 3166 ALPHA-2 Codes (z.B. „DE“)

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.

•Werden Hersteller per UpdateManufacturers abgeändert, so werden zugehörige Angebote, bei denen der Hersteller hinterlegt ist, entsprechend zum Aktualisieren vorgemerkt.

Änderungsübersicht

Version

Änderungsbeschreibung

3.2.9.75

Redaktionelle Überarbeitung

3.5.37

Response-Feldliste vervollständigt

4.14.37

Für Hersteller können die GPSR-relevanten Daten hinterlegt werden.

4.14.42

Erweiterung der Herstellerdaten um die produktverantwortliche Person.