Artikeldaten in einer Bestellung
Mit Hilfe der Artikeldaten werden die einzelnen Positionen der Bestellung an den Partner übermittelt.
Das übergeordnete Element trägt den Namen product-lineitems.
In diesem Container können 1-n product-line-item Elemente enthalten sein,
wobei jedes Unterelement eine Bestellposition repräsentiert.
<product-line-item>
<position>1</position>
<partner-product-no>1565107</partner-product-no>
<Size>XL</Size>
<EAN>1234567891234</EAN>
<product-name>Handtuch</product-name>
<product-short-description>Handtuch</product-short-description>
<quantity>1</quantity>
<unit>Stk</unit>
<single-base-price>5.99</single-base-price>
<single-price>5.99</single-price>
<gross-price>5.99</gross-price>
</product-line-item>
Methods summary
public
|
#
__construct( string $tag = null, string $value = '', null|Alvine\Xml\AttributeMap $attributes = null )
Erstellt ein neues ProductLineItem-Objekt
Erstellt ein neues ProductLineItem-Objekt
Parameters
- $tag
- Tag
- $value
- Wert
- $attributes
- Atributes
|
public
integer
|
#
getPartnerProductNo( )
Artikelnummer des Partners
Artikelnummer des Partners
Datentyp: String
Restriktionen: Minimale Länge: 1 / Maximale Länge: 20
Minimalanforderungen: Pflichtfeld
Maximalanforderungen: -
<partner-product-no>1234567890</partner-product-no>
Durch die partner-product-no wird dem Partner mitgeteilt, welches seiner Produkte bestellt worden ist.
Sie stellt (wenn nötig mit der Produktgröße) den eindeutigen Schlüssel für den Partnerartikel dar.
Returns
integer Artikelnummer des Partners
|
public
integer
|
#
getPosition( )
Positionsnummer
Datentyp: integer
Restriktionen: nicht negativ
Minimalanforderungen: Pflichtfeld
Maximalanforderungen: -
<position>1</position>
Mit Hilfe des Feldes position kann jede Bestellposition innerhalb einer Bestellung eindeutig identifiziert werden.
Sie wird in einer Bestellung fortlaufend vergeben.
Returns
integer Positionsnummer
|
public
Alvine\Merchant\Otto\Element\ProductLineItem
|
#
setPosition( integer $position )
Setzt die Positionsnummer
Setzt die Positionsnummer
Parameters
- $position
- Positionsnummer
Returns
|
public
decimal
|
#
getQuantity( )
Menge
Datentyp: decimal
Restriktionen: -
Minimalanforderungen: Pflichtfeld
Maximalanforderungen: -
<quantity>1</quantity>
Mit dem Feld quantity wird die bestellte Menge dieser Bestellposition beziffert.
Returns
decimal Menge
|
public
Alvine\Merchant\Otto\Element\ProductLineItem
|
#
setQuantity( string $quantity )
Setzt die Menge
Parameters
Returns
|
public
string
|
#
getSize( )
Artikelgröße
Datentyp: String
Restriktionen: Minimale Länge: 1 / Maximale Länge: 15
Minimalanforderungen: Pflichtfeld
Maximalanforderungen: -
<Size>34</Size>
Wenn ein Partnerartikel nicht eindeutig mit Hilfe der Artikelnummer identifiziert werden kann,
muss die Eindeutigkeit über die Angabe der Artikelgröße hergestellt werden.
Wenn der bestellte Artikel keine Größenbezeichnung hat (also ein Leerzeichen oder „none“ in den Stammdaten angegeben wurde),
wird ein leeres Tag geschickt. Der übermittelte Wert „none“ wird nicht zurückgegeben.
Returns
string Artikelgröße
|
public
string
|
#
getEAN( )
EAN
Liefert die EAN der Position zurück
Returns
string EAN
|
public
string
|
#
getProductName( )
Produktname
Datentyp: String
Restriktionen: Minimale Länge: 1 / Maximale Länge: 4000
Minimalanforderungen: Pflichtfeld
Maximalanforderungen: -
<product-name>T-Shirt "neckles"</product-name>
Das Feld product-name bezeichnet den Artikelnamen der bestellten Ware.
Achtung: Der Produktname wird HTML-codiert übermittelt.
Returns
string Produktname
|
public
string
|
#
getProductShortDescription( )
Produktkurzbeschreibung
Datentyp: String
Restriktionen: Minimale Länge: 1 / Maximale Länge: 4000
Minimalanforderungen: Pflichtfeld
Maximalanforderungen: -
<product-short-description>Poloshirt, H.I.S.</product-short-description>
Dieses Feld beinhaltet die Kurzbeschreibung des bestellten Artikels.
Returns
string Produktkurzbeschreibung
|
public
string
|
#
getUnit( )
Mengeneinheit
Datentyp: String
Restriktionen: Minimale Länge: 1 / Maximale Länge: 256
Pflichtfeld / optional: Optional
Minimalanforderungen: Keine
Maximalanforderungen: -
<unit>PCE</unit>
In dem Feld unit wird die Mengeneinheit dieser Bestellposition spezifiziert.
Hier wird der Wert zurückgegeben, den der Partner bei der Artikelerrichtung angegeben hat.
Momentan sind die Werte PCE (=Stück), MTR (=Meter) sowie MTK (=Quadratmeter) möglich.
Returns
string Produktkurzbeschreibung
|
public
string
|
#
getSingleBasePrice( )
Bruttolistenpreis der entsprechenden Bestellposition
Bruttolistenpreis der entsprechenden Bestellposition
Datentyp: decimal
Restriktionen: 2 Nachkommastellen
Pflichtfeld / optional: Pflichtfeld
Minimalanforderungen: Pflichtfeld
Maximalanforderungen: -
<single-base-price>9.9</single-base-price>
Der single-base-price gibt den Bruttolistenpreis der entsprechenden Bestellposition pro Einheit an,
ohne dabei Rabatte zu berücksichtigen.
Returns
string Produktkurzbeschreibung
|
public
string
|
#
getSinglePrice( )
Bruttopreis, nach Rabattabzug
Bruttopreis, nach Rabattabzug
Datentyp: decimal
Restriktionen: 2 Nachkommastellen
Pflichtfeld / optional: Pflichtfeld
Minimalanforderungen: Pflichtfeld
Maximalanforderungen: -
<single-price>9.9</single-price>
Der single-price gibt den Bruttopreis, nach Rabattabzug an.
Returns
string Bruttopreis, nach Rabattabzug
|
public
string
|
#
getGrossPrice( )
gesamten Bruttopreis der Bestellposition
gesamten Bruttopreis der Bestellposition
Datentyp: decimal
Restriktionen: 2 Nachkommastellen
Pflichtfeld / optional: Pflichtfeld
Minimalanforderungen: Pflichtfeld
Maximalanforderungen: -
<gross-price>9.9</gross-price>
Der gross-price beinhaltet den gesamten Bruttopreis der Bestellposition (d.h. single price x Menge).
Returns
string gesamten Bruttopreis der Bestellposition
|
public
Alvine\Merchant\Otto\Element\ProductLineItem
|
#
setModificationDate( Alvine\Date\DateTime $dateTime )
Setzt den Zeitstempel bei der Erstellung des Bestellstatus
Setzt den Zeitstempel bei der Erstellung des Bestellstatus
Datentyp: decimal
Restriktionen: 2 Nachkommastellen
Pflichtfeld / optional: Pflichtfeld
Minimalanforderungen: Pflichtfeld
Maximalanforderungen: -
<ModificationDate>2005-07-25T18:45:13 </ModificationDate>
Der Zeitstempel gibt mit Hilfe einer sekundengenauen Uhrzeit an,
wann sich der jeweilige Bestellstatus geändert hat.
Sollten bei OTTO mehrere Statusmeldungen zu einer Position vorliegen, so wird der aktuellste Status anhand des Zeitstempels gesetzt
Parameters
Returns
|
public
Alvine\Date\DateTime
|
#
getModificationDate( )
Liefert den Zeitstempel der letzten änderung zurück
Liefert den Zeitstempel der letzten änderung zurück
Returns
Alvine\Date\DateTime Zeitstempel
|
public
integer
|
#
getOrderStatus( )
Liefert den Status der Position zurück
Liefert den Status der Position zurück
Returns
integer Status
|
public
Alvine\Merchant\Otto\Element\ProductLineItem
|
#
setOrderStatus( $state )
Setzt den Status der Position
Setzt den Status der Position
Returns
Throws
|
public
Alvine\Merchant\Otto\Element\ShipToAddress
|
#
getShipToAddress( )
Liefert die Lieferadresse dieser Position zurück
Liefert die Lieferadresse dieser Position zurück
Soll die komplette Bestellung oder eine einzelne Bestellposition an eine von der Rechnungsadresse abweichende Anschrift geliefert werden,
so wird diese Anschrift in dem XML-Element ship-to-address übergeben.
Das Element kann sowohl auf Bestellungs- sowie auf Bestellpositionsebene übergeben werden.
Je nachdem, ob die ganze Bestellung oder nur eine Bestellposition an die Lieferadresse gesendet werden soll.
Returns
|
public
string
|
#
getReferencenumber( )
Liefert die Referenznummer zurück
Liefert die Referenznummer zurück
Returns
string | \null Referenznummer
|
public
Alvine\Merchant\Otto\Element\ProductLineItem
|
#
setReferencenumber( string $referencenumber )
Setzt die Referenznummer
Parameters
- $referencenumber
- Referenznummer
Returns
|