fetchStockCount

Navigation:  WebService Calls > Options for Growth >

fetchStockCount

 Previous pageReturn to chapter overviewNext page

Texte ein-/ausblenden

Beschreibung

Dieser Call kann dazu benutzt werden, um die in Speed4Trade CONNECT vorhandenen Bestandsdaten mit denen im eigenen System zu vergleichen und bei Abweichungen eine Bestandsaktualisierung mit Speed4Trade CONNECT über den Call UpdateStockCount durchzuführen.

Beispiel Request

Code

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

   <filter>

      <mandator_id filter_method="=" filter_value="1" />

      <last_changed from_date="2000-01-01T00:00:00.000+01:00" to_date="2020-01-01T00:00:00.000+01:00"/>

      <item_id filter_method="IN" >

         <filter_values>

            <filter_value>123</filter_value>

            <filter_value>456</filter_value>

            <filter_value>999</filter_value>

         </filter_values>

      </item_id>

      <internal_item_number filter_method="IN" >

         <filter_values>

            <filter_value>S4T-00001</filter_value>

            <filter_value>S4T-00002</filter_value>

            <filter_value>S4T-00003</filter_value>

         </filter_values>

      </internal_item_number>

      <vendor_item_number filter_method="IN" >

         <filter_values>

            <filter_value>TD-00001</filter_value>

            <filter_value>TD-00002</filter_value>

            <filter_value>TD-00003</filter_value>

         </filter_values>

      </vendor_item_number>

      <match_code filter_method="IN" >

         <filter_values>

            <filter_value>TD-00001</filter_value>

            <filter_value>TD-00002</filter_value>

            <filter_value>TD-00003</filter_value>

         </filter_values>

      </match_code>

      <warehouse_id filter_method="IN">

         <filter_values>

            <filter_value>133</filter_value>

            <filter_value>134</filter_value>

            <filter_value>135</filter_value>

         </filter_values>

      </warehouse_id>

      <warehouse_code filter_method="IN">

         <filter_values>

            <filter_value>Standard</filter_value>

            <filter_value>EXTERN</filter_value>

            <filter_value>LAGER2</filter_value>

         </filter_values>

      </warehouse_code>

   </filter>

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

„fetchStockCount“

version

Attribut von request. Legt die Version der Anfrage fest.

1

string

Fester Wert:

„1.0.0“

filter

Legt Parameter fest nach denen die Ergebnismenge eingeschränkt wird. Mehrere Filter werden als ODER-Verknüpfung behandelt.

1..N

Element

mandator_id

Schränkt die Ergebnismenge der Abfrage auf Angebote eines bestimmten Mandanten ein.

1

Element

filter_method

Attribut von mandator_id. Legt das Verhalten des Mandanten-Filters fest.

1

string

Fester Wert: "="

filter_value

Attribut von mandator_id. Legt den Filterwert des Mandanten-Filters fest.

1

integer

last_changed

Schränkt die Ergebnismenge der Abfrage nach dem Datum der letzten Änderung des Bestandes ein.

0..1

Element

from_date

Attribut von last_changed. Selektiert alle Bestände deren Änderungsdatum aktueller oder gleich dem angegebenen Datum ist.

0..1

dateTime

to_date

Attribut von last_changed. Selektiert alle Bestände deren Änderungsdatum älter oder gleich dem angegebenen Datum ist.

0..1

dateTime

item_id

Schränkt die Ergebnismenge auf Bestände von bestimmten Artikel-IDs ein.

0..1

Element

filter_method

Attribut von item_id. Legt die Arbeitsweise des Filters fest.

1

string

Fester Wert: "IN"

filter_values

Element von item_id. Fasst einen oder mehrere Filterwerte zusammen.

1

Element

filter_value

Element von filter_values. Legt einen Filterwert für Artikel-ID fest.

1..N

integer

internal_item_number

Filtert die Ergebnismenge nach der internen Artikelnummer.

0..1

Element

filter_method

Attribut von internal_item_number. Legt die Arbeitsweise des Filters fest.

1

string

Fester Wert: "IN"

filter_values

Element von internal_item_number. Fasst einen oder mehrere Filterwerte zusammen.

1

Element

filter_value

Element von filter_values. Legt einen Filterwert für interne Artikelnummern fest.

1..N

string

vendor_item_number

Schränkt die Ergebnismenge auf die Herstellerartikelnummer ein.

0..1

Element

filter_method

Attribut von vendor_item_number. Legt die Arbeitsweise des Filters fest.

1

string

Fester Wert: "IN"

filter_values

Element von vendor_item_number. Fasst einen oder mehrere Filterwerte zusammen.

1

Element

filter_value

Element von filter_values. Legt einen Filterwert für Herstellerartikelnummern fest.

1..N

string

match_code

Schränkt die Ergebnismenge auf den Matchcode ein.

0..1

Element

filter_method

Attribut von match_code. Legt die Arbeitsweise des Filters fest.

1

string

Fester Wert: "IN"

filter_values

Element von match_code. Fasst einen oder mehrere Filterwerte zusammen.

1

Element

filter_value

Element von filter_values. Legt einen Filterwert für Matchcodes fest.

1..N

string

warehouse_id

Schränkt die Ergebnismenge auf die Lager ID ein.

0..1

Element

filter_method

Attribut von warehouse_id. Legt die Arbeitsweise des Filters fest.

1

string

Fester Wert: "IN"

filter_values

Element von warehouse_id. Fasst einen oder mehrere Filterwerte zusammen.

1

Element

filter_value

Element von filter_values. Legt einen Filterwert für Lager ID fest.

1..N

integer

warehouse_code

Schränkt die Ergebnismenge auf den Lagercode ein.

0..1

Element

filter_method

Attribut von Lagercode. Legt die Arbeitsweise des Filters fest.

1

string

Fester Wert: "IN"

filter_values

Element von warehouse_code. Fasst einen oder mehrere Filterwerte zusammen.

1

Element

filter_value

Element von filter_values. Legt einen Filterwert für Lagercodes fest.

1..N

string

Beispiel Response

Code

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

    <overall_report return_code="0"/>

    <item>

        <item_id>2466487</item_id>

        <mandator_id>1</mandator_id>

        <internal_item_number>Fetch_Stock_Count_0001</internal_item_number>

        <match_code>Matchcode_123</match_code>

        <vendor_item_number>Herstellerartikelnummer_123</vendor_item_number>

        <stocks>

            <stock>

                <stock_count>155</stock_count>

                <reserved_stock>0</reserved_stock>

                <available_stock>155</available_stock>

            </stock>

        </stocks>

    </item>

</response>

Feldliste Response

Name

Beschreibung

Anz.

Typ

Sonstiges

response

Root-Element der Anfrage

1

Element

method

Attribut von response. Name der Webservice-Methode.

1

string

Fester Wert:

„fetchStockCount“

version

Attribut von response. Legt die Version der Anfrage fest.

1

string

Fester Wert:

„1.0.0“

overall_report

Information über die ausgeführte Operation.

1

Element

return_code

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

1

integer

0 = OK.

< 0 = Fehler

error_description

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

0..1

string

Hinweis

item

Wrapper-Element, das die Daten der Artikel beinhaltet.

0..N

Element

item_id

ID des Artikels

1

integer

mandator_id

ID des Mandanten

1

integer

internal_item_number

Interne Artikelnummer

1

string

match_code

Matchcode

1

string

vendor_item_number

Herstellerartikelnummer

1

string

stocks

Wrapper-Element, das die Bestände aller Läger des Artikels zusammenfasst.

1

Element

stock

Wrapper-Element, das den Bestand eines Lagers des Artikels beinhaltet.

1..N

Element

stock_count

Lagerbestand

1

integer

reserved_stock

Reservierter Bestand für dieses Lager

1

integer

available_stock

Verfügbarer Bestand für dieses Lager

1

integer

•Im Standard ist die Rückgabemenge für den Webservice-Call fetchStockCount auf 1000 Lagerbestände begrenzt. Müssten bei einer Abfrage mehr als 1000 Lagerbestände ausgegeben werden, kommt es zu folgender Meldung im Response: "The limit (1000) of found stocks was exceeded. Please specify more strict filters." Definieren Sie dementsprechend bitte eine striktere Filterung. Müssen Sie regelmäßig eine größere Menge an Beständen abfragen oder wünschen Sie das die Grenze niedriger angesetzt wird, so wenden Sie sich bitte an unseren Support.

Änderungsübersicht

Version

Änderungsbeschreibung

4.7.15

Initiale Erstellung