stepBillbee Skip to content

BillbeeAddProducts

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
InvoiceTextMAPde=Text;en=TextJa
ManufacturerSINGLENein
IdSINGLENein
TitleSINGLEde=Text;en=TextNein
DescriptionSINGLEde=Text;en=TextNein
ShortDescriptionSINGLENein
BasicAttributesSINGLENein
Images_IdSINGLElist of Ids Id;Id;Id Nein
Images_UrlSINGLEAssign the values to the previously set Ids Id=Url;Id=UrlNein
Images_ThumbPathExtSINGLEAssign the values to the previously set Ids Id=Path;Id=PathNein
Images_ThumbUrlSINGLEAssign the values to the previously set Ids Id=Url;Id=UrlNein
Images_PositionSINGLENein
Images_IsDefaultSINGLEAssign tre or false to the previously set Ids Id=true;Id=falseNein
Images_ArticleIdSINGLEAssign the articles to the previously set Ids Id=ArticleId;Id=ArticleIdNein
VatIndexSINGLEJa
PriceSINGLEJa
CostPriceSINGLENein
Vat1RateSINGLEJa
Vat2RateSINGLEJa
StockDesiredSINGLENein
StockCurrentSINGLENein
StockWarningSINGLENein
SKUSINGLENein
EANSINGLENein
MaterialsSINGLEde=Text,en=TextNein
TagsSINGLEde=Text,en=TextNein
WeightSINGLENein
WeightNetSINGLENein
LowStockSINGLENeinfalse
StockCodeSINGLENein
StockReduceItemsPerSaleSINGLENein
Stocks_StockIdSINGLEList of stock IDs Id;IdNein
Stocks_NameSINGLEAssign the values to the previously set Ids Id=Text;Id=TextNein
Stocks_StockCurrentSINGLEAssign the values to the previously set Ids Id=Number;Id=NumberNein
Stocks_StockWarningSINGLEAssign the values to the previously set Ids Id=Number;Id=NumberNein
Stocks_StockCodeSINGLEAssign the values to the previously set Ids Id=Text;Id=TextNein
Stocks_UnfulfilledAmountSINGLEAssign the values to the previously set Ids Id=Number;Id=NumberNein
Stocks_StockDesiredSINGLEAssign the values to the previously set Ids Id=Number;Id=NumberNein
Category1_NameSINGLENein
Category1_IdSINGLENein
Category2_NameSINGLENein
Category2_IdSINGLENein
Category3_NameSINGLENein
Category3_IdSINGLENein
TypeSINGLEJa
UnitSINGLENein
UnitsPerItemSINGLENein
SoldAmountSINGLENein
SoldSumGrossSINGLENein
SoldSumNetSINGLENein
SoldSumNetLast30DaysSINGLENein
SoldSumGrossLast30DaysSINGLENein
SoldAmountLast30DaysSINGLENein
ShippingProductIdSINGLENein
IsDigitalSINGLEJafalse
IsCustomizableSINGLEJafalse
DeliveryTimeSINGLENein
RecipientSINGLENein
OccasionSINGLENein
CountryOfOriginSINGLENein
ExportDescriptionSINGLENein
ExportDescriptionMultiLanguageSINGLEde=Text;en=TextNein
TaricNumberSINGLENein
ConditionSINGLENein
WidthCmSINGLENein
LengthCmSINGLENein
HeightCmSINGLENein
BillOfMaterial_ArticleIdSINGLEList of article IDs Id;IdNein
BillOfMaterial_AmountSINGLEAssign the values to the previously set Ids Id=Number;Id=NumberNein
BillOfMaterial_SKUSINGLEAssign the values to the previously set Ids Id=Text;Id=TextNein
IsDeactivatedSINGLENeinfalse

Outputs

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

Name Datentyp Beschreibung Pflichtfeld Werte
successfulCreatedProducts SPREADSHEET Ja
Folgende Felder sind im Output enthalten:

Feld Datentyp Beschreibung Pflichtfeld Standardwert
source_IdSINGLENein
source_SKUSINGLENein
source_EANSINGLENein
source_TitleSINGLENein
statusCodeSINGLENein
statusMessageSINGLENein
BillbeeIdSINGLENein
invalid rows SPREADSHEET Ja
Folgende Felder sind im Output enthalten:

Feld Datentyp Beschreibung Pflichtfeld Standardwert
InvoiceTextSINGLENein
ManufacturerSINGLENein
IdSINGLENein
TitleSINGLENein
DescriptionSINGLENein
ShortDescriptionSINGLENein
BasicAttributesSINGLENein
Images_IdSINGLENein
Images_UrlSINGLENein
Images_ThumbPathExtSINGLENein
Images_ThumbUrlSINGLENein
Images_PositionSINGLENein
Images_IsDefaultSINGLENein
Images_ArticleIdSINGLENein
VatIndexSINGLENein
PriceSINGLENein
CostPriceSINGLENein
Vat1RateSINGLENein
Vat2RateSINGLENein
StockDesiredSINGLENein
StockCurrentSINGLENein
StockWarningSINGLENein
SKUSINGLENein
EANSINGLENein
MaterialsSINGLENein
TagsSINGLENein
WeightSINGLENein
WeightNetSINGLENein
LowStockSINGLENein
StockCodeSINGLENein
StockReduceItemsPerSaleSINGLENein
Stocks_StockIdSINGLENein
Stocks_NameSINGLENein
Stocks_StockCurrentSINGLENein
Stocks_StockWarningSINGLENein
Stocks_StockCodeSINGLENein
Stocks_UnfulfilledAmountSINGLENein
Stocks_StockDesiredSINGLENein
Category1_NameSINGLENein
Category1_IdSINGLENein
Category2_NameSINGLENein
Category2_IdSINGLENein
Category3_NameSINGLENein
Category3_IdSINGLENein
TypeSINGLENein
UnitSINGLENein
UnitsPerItemSINGLENein
SoldAmountSINGLENein
SoldSumGrossSINGLENein
SoldSumNetSINGLENein
SoldSumNetLast30DaysSINGLENein
SoldSumGrossLast30DaysSINGLENein
SoldAmountLast30DaysSINGLENein
ShippingProductIdSINGLENein
IsDigitalSINGLENein
IsCustomizableSINGLENein
DeliveryTimeSINGLENein
RecipientSINGLENein
OccasionSINGLENein
CountryOfOriginSINGLENein
ExportDescriptionSINGLENein
ExportDescriptionMultiLanguageSINGLENein
TaricNumberSINGLENein
ConditionSINGLENein
WidthCmSINGLENein
LengthCmSINGLENein
HeightCmSINGLENein
BillOfMaterial_ArticleIdSINGLENein
BillOfMaterial_AmountSINGLENein
BillOfMaterial_SKUSINGLENein
IsDeactivatedSINGLENein