updateStockCount

Navigation:  WebService Calls > Options for Growth >

updateStockCount

 Previous pageReturn to chapter overviewNext page

Texte ein-/ausblenden

Beschreibung

Ändern der Artikelbestände in Speed4Trade CONNECT.

Beispiel Request

Code

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

   <item significant_key="internal_item_number" reference_id="4711">

      <mandator_id>1</mandator_id>

      <internal_item_number>it11111</internal_item_number>

      <!-- <item_id>11111</item_id> -->

      <stock_items>

         <stock_item>

            <mandator_id>1</mandator_id>

            <warehouse_id>22222</warehouse_id>

            <!-- <warehouse_code>wh22222</warehouse_code> -->

            <stock_count>10</stock_count>

            <absolute>false</absolute>

         </stock_item>

      </stock_items>

   </item>

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

„updateStockCount“

version

Attribut von request. Legt die Version der Anfrage fest.

1

integer

Fester Wert: „1.0.0“

item

Wrapper-Element, das die Daten des Artikels zusammenfasst

0..N

Element

 

 

significant_key

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

1

string

Feste Werte:

„item_id“ |

„internal_item_number“

reference_id

Optionales Attribut des Elements "item". 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

Hinweis

item_id

Artikel-ID

1

integer

Bitte Hinweise beachten.

mandator_id

Mandanten-ID

1

integer

internal_item_number

interne Artikelnummer

1

string

Länge:

0-50 Zeichen

Bitte Hinweise beachten.

stock_items

Wrapper-Element, das die Daten der Lagerbestände zusammenfasst.

0..1

Element

stock_item

Wrapper-Element, das die Daten des Lagerbestands zusammenfasst.

1..N

Element

mandator_id

Mandanten-ID

1

integer

warehouse_id

Identifiziert das Lager anhand der ID.

1

integer

Bitte Hinweise beachten.

warehouse_code

Identifiziert das Lager anhand des Lagercodes.

1

string

Bitte Hinweise beachten.

stock_count

Lagerbestand

1

integer

absolute

Gibt an ob der Lagerbestand absolut oder relativ verbucht wird.

1

boolean

Beispiel Response

Code

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

   <report action="update" return_code="0" reference_id="4711">

      <item>

         <item_id>11111</item_id>

         <mandator_id>1</mandator_id>

         <internal_item_number>it11111</internal_item_number>

         <ean_code/>

         <stock_count>25</stock_count>

      </item>

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

„updateStockCount“

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 Category-Element aus dem Request wird ein Report zurückgegeben.

0..N

Element

action

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

1

string

Feste Werte:

insert | update

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 item-Block des Requests angegebene reference_id falls diese angegeben wurde.

0..1

string

Hinweis

error_description

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

0..1

string

item

Wrapper-Element, das die Daten der Artikel zusammenfasst

1

Element

item_id

Artikel-ID

1

integer

mandator_id

Mandanten-ID

1

integer

internal_item_number

Interne Artikelnummer

1

string

Länge:

0 – 50 Zeichen

ean_code

EAN-Code des Artikels

1

string

stock_count

Summe der Lagerbestände

0..1

integer

Hinweise

•Es muss entweder das Element internal_item_number oder item_id  genutzt werden. Die Angabe beider Elemente, oder keines der Elemente ist nicht zulässig.

•Es muss entweder das Element warehouse_id oder warehouse_code  genutzt werden. Die Angabe beider Elemente, oder keines der Elemente ist nicht zulässig.

•Die reference_id wird nicht in Speed4Trade CONNECT gespeichert und ist damit auch nicht fest an den betroffenen Artikel gebunden. Die selbe ID kann daher in unterschiedlichen Calls problemlos wiederverwendet werden. Sie dient lediglich zur schnellen Zuordnung eines Reports in den Response-Daten zu einem item-Block aus den Request-Daten. Dies ist insbesondere dann nützlich wenn es bei der Verarbeitung eines oder mehrerer der übergebenen Artikel zu Fehlern kommt und noch keine Artikel-IDs für eine Zuordnung vorhanden sind. So kann dennoch die Fehlermeldung zu einem Request-Bestandteil zugeordnet werden.

•Bei Set- und Variantenhauptartikeln können die Bestände nur gesetzt werden, wenn im Mandanten die entsprechende Option zum direkten Setzen der Hauptartikelbestände aktiviert ist. In allen anderen Fällen wird der Bestand anhand der Bestände der Unterartikel von Speed4Trade CONNECT berechnet.

 

Änderungsübersicht

Version

Änderungsbeschreibung

3.2.9.75

Redaktionelle Überarbeitung