billbeeAddProducts - Billbee

← Billbee Add-On Übersicht

Der BillbeeAddProducts Step übermittelt Ihre Produktdaten an Ihr Billbee-System. Genauere Informationen sind auf der Addonseite des BillbeeAddProducts Steps zu finden.

Dieser Step ermöglicht es, mehrsprachige Produkteigenschaften anzulegen. Außerdem sind eingie Spalten vorhanden, welche einander bedingen. Im Folgenden wird auf diese Spezialfälle eingegangen.

Hinweise

Zur Anlage mehrsprachiger Produkt- und Artikelbeschreibungen werden die ISO Codes nach ISO-639-1 benötigt.

Wichtig!

Die Spalten, welche die Möglichkeit bieten mehrsprachige Daten anzugeben, müssen grundsätzlich als Schlüssel-Wert-Paar angegeben werden, wie z.B.:

Schlüssel="isocode1=Wert1;isocode2=Wert2"

oder

isocode1="Wert1";isocode2="Wert2"

Es müssen hier, im Unterschied zu den “normalen” Spalten immer in Anführungszeichen gesetzt werden. Alle Werte ohne Anführungszeichen werden bei der Erstellung des API-Calls verworfen.

Beispiele für die ISO-Codes sind:

de; en; fr etc...

Mehrsprachige Felder

Folgende Spalten erlauben bzw. benötigen für die ein- oder mehrsprachige Anlage Werte als Schlüssel-Wert-Paar:

• InvoiceText
• Title
• Description
• Materials
• Tags
• ExportDescriptionMultiLanguage

Bilder, Lagerzuweisungen und Stücklisten

Sollen Bilder (Images_), Lagerzuweisungen (Stocks_) oder Stücklisten (BillOfMaterial_) angelegt werden, müssen ein paar Besonderheiten beachtet werden.

Es können hier mehrere Bilder/Lager/Stücklisten mitgegeben werden.

Referenzspalten sind:

• Images_Id (Ids der Bilder)
• Stocks_StockId (Ids der Lager)
• BillOfMaterial_ArticleId (Artikel Ids)

In diesen Spalten werden Semikolon separierte Listen von Ids festgelegt.

Alle weiteren Felder werden in Abhängigkeit der eben festgelegten Ids zugeordnet.

Beispiel Stücklisten (BillOfMaterial_*)

Name	Beispiel
BillOfMaterial_ArticleId	1;2;3;4
BillOfMaterial_Amount	1=5;2=4;3=6;4=1
BillOfMaterial_SKU	1=1234567;2=9875532;3=4578424;4=4798411

Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name	Datentyp	Beschreibung	Pflichtfeld	Werte
account	ACCOUNT		Ja
products	SPREADSHEET		Ja
mappingdefinition	STRING	The mapping definition JSON String	Ja
	Folgende Felder sind zu konfigurieren: Feld Datentyp Beschreibung Pflichtfeld Standardwert InvoiceText MAP de=Text;en=Text Ja Manufacturer SINGLE Nein Id SINGLE Nein Title SINGLE de=Text;en=Text Nein Description MAP Beispiel: de=Text;en=Text Nein ShortDescription MAP Beispiel: de=Text;en=Text Nein BasicAttributes SINGLE Nein Images_Id SINGLE list of Ids Id;Id;Id Nein Images_Url SINGLE Assign the values to the previously set Ids Id=Url;Id=Url Nein Images_ThumbPathExt SINGLE Assign the values to the previously set Ids Id=Path;Id=Path Nein Images_ThumbUrl SINGLE Assign the values to the previously set Ids Id=Url;Id=Url Nein Images_Position SINGLE Nein Images_IsDefault SINGLE Assign tre or false to the previously set Ids Id=true;Id=false Nein Images_ArticleId SINGLE Assign the articles to the previously set Ids Id=ArticleId;Id=ArticleId Nein VatIndex SINGLE Ja Price SINGLE Ja CostPrice SINGLE Nein Vat1Rate SINGLE Ja Vat2Rate SINGLE Ja StockDesired SINGLE Nein StockCurrent SINGLE Nein StockWarning SINGLE Nein SKU SINGLE Nein EAN SINGLE Nein Materials SINGLE de=Text,en=Text Nein Tags SINGLE de=Text,en=Text Nein Weight SINGLE Nein WeightNet SINGLE Nein LowStock SINGLE Nein false StockCode SINGLE Nein StockReduceItemsPerSale SINGLE Nein Stocks_StockId SINGLE List of stock IDs Id;Id Nein Stocks_Name SINGLE Assign the values to the previously set Ids Id=Text;Id=Text Nein Stocks_StockCurrent SINGLE Assign the values to the previously set Ids Id=Number;Id=Number Nein Stocks_StockWarning SINGLE Assign the values to the previously set Ids Id=Number;Id=Number Nein Stocks_StockCode SINGLE Assign the values to the previously set Ids Id=Text;Id=Text Nein Stocks_UnfulfilledAmount SINGLE Assign the values to the previously set Ids Id=Number;Id=Number Nein Stocks_StockDesired SINGLE Assign the values to the previously set Ids Id=Number;Id=Number Nein Category1_Name SINGLE Nein Category1_Id SINGLE Nein Category2_Name SINGLE Nein Category2_Id SINGLE Nein Category3_Name SINGLE Nein Category3_Id SINGLE Nein Type SINGLE Ja Unit SINGLE Nein UnitsPerItem SINGLE Nein SoldAmount SINGLE Nein SoldSumGross SINGLE Nein SoldSumNet SINGLE Nein SoldSumNetLast30Days SINGLE Nein SoldSumGrossLast30Days SINGLE Nein SoldAmountLast30Days SINGLE Nein ShippingProductId SINGLE Nein IsDigital SINGLE Ja false IsCustomizable SINGLE Ja false DeliveryTime SINGLE Nein Recipient SINGLE Nein Occasion SINGLE Nein CountryOfOrigin SINGLE Nein ExportDescription SINGLE Nein ExportDescriptionMultiLanguage SINGLE de=Text;en=Text Nein TaricNumber SINGLE Nein Condition SINGLE Nein WidthCm SINGLE Nein LengthCm SINGLE Nein HeightCm SINGLE Nein BillOfMaterial_ArticleId SINGLE List of article IDs Id;Id Nein BillOfMaterial_Amount SINGLE Assign the values to the previously set Ids Id=Number;Id=Number Nein BillOfMaterial_SKU SINGLE Assign the values to the previously set Ids Id=Text;Id=Text Nein IsDeactivated SINGLE Nein false CustomFields MAP List of semicolon separated key value pairs enclosed in double quotes: "FieldName1"="My first Field";"FieldName2"="My second Field" Nein

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name	Datentyp	Beschreibung	Werte
successfulCreatedProducts	SPREADSHEET
invalid rows	SPREADSHEET