Skip to content

PlentySetAddress - PlentyONE

Version: REST 1.0

← PlentyONE Add-On Übersicht

Mit diesem Step können Adressdaten (Kunden-, Rechnungs- und Lieferadressen) in Plentymarkets aktualisiert werden.

Benötigte Plentymarkets REST API  Berechtigungen:

Section titled “Benötigte Plentymarkets REST API  Berechtigungen:”
  • Firma - Kontakt - Kontaktadresse - Kontaktadresse aktualisieren

  • Aufträge - Auftragsadressen - Auftragsadressen aktualisieren

Zielspalten > siehe Step-Hilfe 

Für das Update von Adressen muss zusätzlich zu den Pflichtspalten ID, City und CountryID mindestens eine Zielspalten

  • Company, FirstName oder Surname

und

  • StreetHouseNumber oder AdditionalAddress3

befüllt werden.


Inputs

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

Name Datentyp Beschreibung Pflichtfeld Werte
account ACCOUNT Ihre PlentyONE Verbindung Ja
limit STRING Beschränken Sie die Anzahl der Adressen, die aktualisiert werden sollen. Leer lassen für unbegrenzt. Nein
inputSpreadsheet SPREADSHEET Ein Spreadsheet mit Adressen, die in PlentyONE aktualisiert werden sollen. Ja
mappingdefinition STRING Die Mapping-Definition JSON-String Nein
Folgende Felder sind zu konfigurieren :

Feld Datentyp Beschreibung Pflichtfeld Standardwert
ID SINGLE ID of Address for update. Leave empty to create a new address (CustomerID required). Nein
CustomerID SINGLE The ID of contact. Nein
TypeID SINGLE TypeID can only be used for new addresses ('ID' column is empty) Nein
Gender SINGLE The gender Nein
Company SINGLE The name 1 field (defaults to: company name). Nein
FirstName SINGLE The name 2 field (defaults to: first name). Nein
Surname SINGLE The name 3 field (defaults to: last name). Nein
AdditionalName SINGLE The name 4 field (defaults to: c/o). Nein
Street SINGLE The address 1 field (defaults to: street, 'PACKSTATION' or 'POSTFILIALE') Nein
HouseNumber SINGLE The address 2 field (defaults to: houseNumber, packstationNo) Nein
AdditionalAddress3 SINGLE The address 3 field (defaults to: additional) Nein
AdditionalAddress4 SINGLE The address 4 field is currently undefined and can be freely used. Nein
ZIP SINGLE The postcode. Nein
City SINGLE The town. Ja
CountryID SINGLE The ID of the country. Ja
StateID SINGLE The ID of the state. Nein
ContactPerson SINGLE The contact person option (alias for option with typeId 12). Nein
VATNumber SINGLE The tax id number (VAT number) option (alias for option with typeId 1). Nein
ExternalAddressID SINGLE The external ID option (alias for option with typeId 2). Nein
EntryCertificate SINGLE The entry certificate (bool) option (alias for option with typeId 3). Nein
Telephone SINGLE The phone number option (alias for option with typeId 4). Nein
Email SINGLE The email option (alias for option with typeId 5). Nein
Postnumber SINGLE The post number option (alias for option with typeId 6). Nein
PersonalID SINGLE The personal ID option (alias for option with typeId 7). Nein
BBFC SINGLE The BBFC/FSK option (alias for option with typeId 8). Nein
Birthday SINGLE The birthday option (alias for option with typeId 9). Nein
Title SINGLE The title/salutation (alias for option with typeId 11). Nein
IsPrimary SINGLE Flag that indicates if the address is the primary address. CustomerID (id of contact) must be set to change primary address of contacts. Nein

Outputs

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

Name Datentyp Beschreibung Pflichtfeld Werte
results SPREADSHEET Ein Spreadsheet, dass die Ergebnisse der Aktualisierung enthält. Ja
Folgende Felder sind im Output enthalten :

Feld Datentyp Beschreibung Pflichtfeld Standardwert
ID SINGLE ID of Address for update. Leave empty to create a new address (CustomerID required). Nein
TypeID SINGLE TypeID can only be used for new addresses ('ID' column is empty) Nein
Gender SINGLE The gender Nein
Company SINGLE The name 1 field (defaults to: company name). Nein
FirstName SINGLE The name 2 field (defaults to: first name). Nein
Surname SINGLE The name 3 field (defaults to: last name). Nein
AdditionalName SINGLE The name 4 field (defaults to: c/o). Nein
Street SINGLE The address 1 field (defaults to: street, 'PACKSTATION' or 'POSTFILIALE') Nein
HouseNumber SINGLE The address 2 field (defaults to: houseNumber, packstationNo) Nein
AdditionalAddress3 SINGLE The address 3 field (defaults to: additional) Nein
AdditionalAddress4 SINGLE The address 4 field is currently undefined and can be freely used. Nein
ZIP SINGLE The postcode. Nein
City SINGLE The town. Ja
CountryID SINGLE The ID of the country. Ja
StateID SINGLE The ID of the state. Nein
ReadOnly SINGLE Flag that indicates if the data record is read only. Nein
ContactPerson SINGLE The contact person option (alias for option with typeId 12). Nein
VATNumber SINGLE The tax id number (VAT number) option (alias for option with typeId 1). Nein
ExternalAddressID SINGLE The external ID option (alias for option with typeId 2). Nein
EntryCertificate SINGLE The entry certificate (bool) option (alias for option with typeId 3). Nein
Telephone SINGLE The phone number option (alias for option with typeId 4). Nein
Email SINGLE The email option (alias for option with typeId 5). Nein
Postnumber SINGLE The post number option (alias for option with typeId 6). Nein
PersonalID SINGLE The personal ID option (alias for option with typeId 7). Nein
BBFC SINGLE The BBFC/FSK option (alias for option with typeId 8). Nein
Birthday SINGLE The birthday option (alias for option with typeId 9). Nein
SessionID SINGLE The frontend session ID (alias for option with typeId 10). Nein
Title SINGLE The title/salutation (alias for option with typeId 11). Nein
CheckedAt SINGLE The time the address was checked. Nein
CreatedAt SINGLE The time the address was created. Nein
UpdatedAt SINGLE The time the address was updated. Nein