{{item.notificationType}}:

PlentyGetCustomers

fetch Customer data

ext. Version: REST 1.0

Gets a list of customers/contacts from plentymarkets Shop.

View manual

Why Synesty?

  • Central middleware for all integrations, connectors and automation of business processes
  • No coding required - just Drag&Drop and configuration
  • Professional support with quick responses
Sign up for FREE Request a demo

Why Synesty?

  • Central middleware for all integrations, connectors and automation of business processes
  • No coding required - just Drag&Drop and configuration
  • Professional support with quick responses
Sign up for FREE Request a demo

Inputs

Name Type Description Required Values
account ACCOUNT Your account Yes
limitItems STRING Limit the number of fetched customers. No Default: 25
lastUpdateFrom DATETIME LastUpdateFrom date to filter the orders, e.g. 18.12.2012 16:00 No
lastUpdateTo DATETIME Filter to Date, e.g. 20.12.2012 16:00. Leave empty to filter until now. No
createdAtFrom DATETIME Filter creation date from, e.g. 18.12.2012 16:00 No
createdAtTo DATETIME Filter to Date of creation, e.g. 20.12.2012 16:00. Leave empty to filter until now. No
customerID STRING Plentymarkets customer ID No
plentyID STRING Plentymarkets store ID of customers No
email STRING The customer's e-mail address. No
zip STRING The customer's ZIP code No
customerType STRING The Customer type No
  • All
  • Customer
  • Interested party
  • Sales representative
  • Supplier
  • Manufacturers
  • Partners
  • CustomId
Enable contact notes (enableCustomerNotes) BOOLEAN If option is enabled the customer notes will be returned. No
  • Enable
  • Disabled (Default)
Enable bank data (enableBankData) BOOLEAN If option is enabled the first contact bank accoount be returned. No
  • Enable
  • Disabled (Default)

Outputs

Name Type Description
customers SPREADSHEET A spreadsheet object containing the customer data.
The following fields are contained in the output:

Field Description Type Required Default-Value
CustomerID Integer
ExternalCustomerID Text
CustomerNumber Text
Type Integer
FirstName Text
Surname Text
FullName Text
Email Text
SecondaryEmail Text
Gender Text
FormOfAddress Text
Newsletter Text
CustomerClass Integer
IsBlocked Integer
CustomerRating Integer
DebitorAccount Text
Language Text
ReferrerID Decimal
PlentyID Integer
ResponsibleID Integer
DateOfBirth Text
LastLogin Text
LastSalesOrder Text
CreatedAt Text
UpdatedAt Text
Telephone Text
Fax Text
Mobile Text
EbayName Text
PaypalEmail Text
PaypalPayerId Text
KlarnaPersonalId Text
Postident Text
ForumUsername Text
ForumGroupId Text
SingleAccess Text
ContactPerson Text
MarketplacePartner Text
InvoiceAllowed Decimal
DebitAllowed Decimal
AllowedMethodsOfPayment Semicolon separated list of all allowed payment method IDs List (Delimiter ; )
VAT_ID Text
BillingAddress_ID ID of Address for update. Leave empty to create a new address (CustomerID required). Integer
BillingAddress_TypeID TypeID can only be used for new addresses ('ID' column is empty)
Show allowed values
  • Invoice address (1)
  • Delivery address (2)
Integer
BillingAddress_Gender
Show allowed values
  • male
  • female
  • diverse
Text
BillingAddress_Company Text
BillingAddress_FirstName Text
BillingAddress_Surname Text
BillingAddress_AdditionalName Text
BillingAddress_Street Text
BillingAddress_HouseNumber Text
BillingAddress_AdditionalAddress3 Text
BillingAddress_AdditionalAddress4 Text
BillingAddress_ZIP Text
BillingAddress_City Text Yes
BillingAddress_CountryID Integer Yes
BillingAddress_StateID Integer
BillingAddress_ReadOnly Decimal
BillingAddress_ContactPerson Text
BillingAddress_VATNumber Text
BillingAddress_ExternalAddressID Text
BillingAddress_EntryCertificate Text
BillingAddress_Telephone Text
BillingAddress_Email Text
BillingAddress_Postnumber Text
BillingAddress_PersonalID Text
BillingAddress_BBFC Text
BillingAddress_Birthday Text
BillingAddress_SessionID Text
BillingAddress_Title Text
BillingAddress_CheckedAt Text
BillingAddress_CreatedAt Text
BillingAddress_UpdatedAt Text
DeliveryAddress_ID ID of Address for update. Leave empty to create a new address (CustomerID required). Integer
DeliveryAddress_TypeID TypeID can only be used for new addresses ('ID' column is empty)
Show allowed values
  • Invoice address (1)
  • Delivery address (2)
Integer
DeliveryAddress_Gender
Show allowed values
  • male
  • female
  • diverse
Text
DeliveryAddress_Company Text
DeliveryAddress_FirstName Text
DeliveryAddress_Surname Text
DeliveryAddress_AdditionalName Text
DeliveryAddress_Street Text
DeliveryAddress_HouseNumber Text
DeliveryAddress_AdditionalAddress3 Text
DeliveryAddress_AdditionalAddress4 Text
DeliveryAddress_ZIP Text
DeliveryAddress_City Text Yes
DeliveryAddress_CountryID Integer Yes
DeliveryAddress_StateID Integer
DeliveryAddress_ReadOnly Decimal
DeliveryAddress_ContactPerson Text
DeliveryAddress_VATNumber Text
DeliveryAddress_ExternalAddressID Text
DeliveryAddress_EntryCertificate Text
DeliveryAddress_Telephone Text
DeliveryAddress_Email Text
DeliveryAddress_Postnumber Text
DeliveryAddress_PersonalID Text
DeliveryAddress_BBFC Text
DeliveryAddress_Birthday Text
DeliveryAddress_SessionID Text
DeliveryAddress_Title Text
DeliveryAddress_CheckedAt Text
DeliveryAddress_CreatedAt Text
DeliveryAddress_UpdatedAt Text
Account_Id Integer
Account_Number Text
Account_CompanyName Text
Account_TaxIdNumber Text
Account_Valuta Integer
Account_DiscountDays Integer
Account_DiscountPercent Decimal
Account_TimeForPaymentAllowedDays Integer
Account_SalesRepresentativeContactId Integer
Account_UserId Integer
Account_DeliveryTime Integer
Account_DealerMinOrderValue Text
Account_CreatedAt Text
Account_UpdatedAt Text
BankAccount_AccountOwner Text
BankAccount_IBAN Text
BankAccount_BIC Text
BankAccount_DirectDebitMandateAvailable Text
BankAccount_DirectDebitMandateAt Text
BankAccount_DirectDebitMethod Text
BankAccount_DirectDebitType Text
CustomerNotes Key-Value Pair

Need help or project support?

If you need help during setup of this step or a project then reach out to our certified partners. Find Partners

More steps steps in Plentymarkets Schnittstelle


Name Version Description Use-Case
PlentySetVariationSKUs (ext. Version: REST 1.0 )
PlentySetVariationSKUs (ext. Version: REST 1.0 )
REST 1.0 Updates or creates a variation SKUs.
set or update Product data
PlentyGetStorageLocations (ext. Version: REST 1.0 )
PlentyGetStorageLocations (ext. Version: REST 1.0 )
REST 1.0 Lists storage locations that belong to a warehouse.
fetch Stock data
PlentyGetOrderSerialNumbers (ext. Version: REST 1.0 )
PlentyGetOrderSerialNumbers (ext. Version: REST 1.0 )
REST 1.0 Gets a list of order serial numbers by order id or order id and order item id
fetch Order data
PlentySetItemTexts (ext. Version: REST 1.0 )
PlentySetItemTexts (ext. Version: REST 1.0 )
REST 1.0 Updates text of plentymarkets items
set or update Product data
PlentyAddVariationImageLink (ext. Version: REST 1.0 )
PlentyAddVariationImageLink (ext. Version: REST 1.0 )
REST 1.0 Creates a link between an image and a variation.
set or update Images
PlentyGetOrderShippingPackage (ext. Version: REST 1.0 )
PlentyGetOrderShippingPackage (ext. Version: REST 1.0 )
REST 1.0 Gets a list of order documents by OrderID.
fetch Order data , fetch Order tracking / shipping data
PlentyAddItems (ext. Version: REST 1.0 )
PlentyAddItems (ext. Version: REST 1.0 )
REST 1.0 Adds Items and primary variations to a Plentymarkets shop.
set or update Product data
PlentyAddItemCrossSelling (ext. Version: REST 1.0 )
PlentyAddItemCrossSelling (ext. Version: REST 1.0 )
REST 1.0 Adds cross-selling link to other items.
set or update Product data
PlentyGetItemImages (ext. Version: REST 1.0 )
PlentyGetItemImages (ext. Version: REST 1.0 )
REST 1.0 Gets a list of item images.
fetch Images
PlentyGetDeleteLog (ext. Version: REST 1.0 )
PlentyGetDeleteLog (ext. Version: REST 1.0 )
REST 1.0 Gets a list of deleted records documented in the delete log.
PlentyGetManufacturers (ext. Version: REST 1.0 )
PlentyGetManufacturers (ext. Version: REST 1.0 )
REST 1.0 Get a list of all manufacturers from plentymarkets
PlentyGetVariationMarketIdentNumbers (ext. Version: REST 1.0 )
PlentyGetVariationMarketIdentNumbers (ext. Version: REST 1.0 )
REST 1.0 Gets a list of variations MarketIdentNumbers of specified variant ids.
fetch Product data
PlentySetTicket (ext. Version: REST 1.0 )
PlentySetTicket (ext. Version: REST 1.0 )
REST 1.0 Create or updates Ticket and add messages to ticket in plentymarkets
send Messages
PlentyAddVariations (ext. Version: REST 1.0 )
PlentyAddVariations (ext. Version: REST 1.0 )
REST 1.0 Add variations to items in your plentymarkets shop.
set or update Product data
PlentySetVariationDefaultCategories (ext. Version: REST 1.0 )
PlentySetVariationDefaultCategories (ext. Version: REST 1.0 )
REST 1.0 Add or remove default category links to variations
set or update Product data
PlentyGetTickets (ext. Version: REST 1.0 )
PlentyGetTickets (ext. Version: REST 1.0 )
REST 1.0 Gets a list of tickets from plentymarkets Shop.
receive Messages
PlentySetOrdersHead (ext. Version: REST 1.0 )
PlentySetOrdersHead (ext. Version: REST 1.0 )
REST 1.0 Updates the order head of plentymarkets orders
set or update Order data
PlentySetAttributes (ext. Version: REST 1.0 )
PlentySetAttributes (ext. Version: REST 1.0 )
REST 1.0 Updates attributes in plentymarkets
set or update Product data
PlentyRESTAuthenticate (ext. Version: REST 1.0 )
PlentyRESTAuthenticate (ext. Version: REST 1.0 )
REST 1.0 Authenticates with account and returns new token
PlentySetBookOutgoingItems (ext. Version: REST 1.0 )
PlentySetBookOutgoingItems (ext. Version: REST 1.0 )
REST 1.0 Book of outgoing items for plentymarkets orders.
set or update Stock data
PlentySetVariationMarketItemNumber (ext. Version: REST 1.0 )
PlentySetVariationMarketItemNumber (ext. Version: REST 1.0 )
REST 1.0 Updates or creates a variation identnumbers.
set or update Product data
PlentyGetWarehouses (ext. Version: REST 1.0 )
PlentyGetWarehouses (ext. Version: REST 1.0 )
REST 1.0 Get a list of all warehouses and settings
fetch Reports
PlentyAddOrders (ext. Version: REST 1.0 )
PlentyAddOrders (ext. Version: REST 1.0 )
REST 1.0 Push order data to a plentymarkets Shop to create orders.
set or update Order data
PlentyGetProperties (ext. Version: REST 1.0 )
PlentyGetProperties (ext. Version: REST 1.0 )
REST 1.0 Gets a list of properties from plentymarkets.
fetch Product data
PlentyGetVariationsSalesPrices (ext. Version: REST 1.0 )
PlentyGetVariationsSalesPrices (ext. Version: REST 1.0 )
REST 1.0 Gets a list of all sales price values of variations.
set or update Price data
PlentySetTransferStocks (ext. Version: REST 1.0 )
PlentySetTransferStocks (ext. Version: REST 1.0 )
REST 1.0 Moves quantity of stock to a new warehouse/location.
set or update Stock data
PlentyAddItemImages (ext. Version: REST 1.0 )
PlentyAddItemImages (ext. Version: REST 1.0 )
REST 1.0 Adds one or more images to items and link to variants.
set or update Images
PlentyGetCategories (ext. Version: REST 1.0 )
PlentyGetCategories (ext. Version: REST 1.0 )
REST 1.0 Gets a list of categories from plentymarkets.
fetch Product data
PlentyGetVariationsSalesPriceUpdate (ext. Version: REST 1.0 )
PlentyGetVariationsSalesPriceUpdate (ext. Version: REST 1.0 )
REST 1.0 Gets a list of all sales price values of variations filtered by date.
fetch Price data
PlentyAddOrderDocument (ext. Version: REST 1.0 )
PlentyAddOrderDocument (ext. Version: REST 1.0 )
REST 1.0 This Steps adds an Document to your Order.
set or update Order data , set or update Order tracking / shipping data
PlentySetProperties (ext. Version: REST 1.0 )
PlentySetProperties (ext. Version: REST 1.0 )
REST 1.0 Updates or creates a properties.
set or update Product data
PlentyGetSalesPriceSettings (ext. Version: REST 1.0 )
PlentyGetSalesPriceSettings (ext. Version: REST 1.0 )
REST 1.0 Gets a list of all sales price settings from your plentymarkets shop
fetch Price data
PlentyGetOrderDocuments (ext. Version: REST 1.0 )
PlentyGetOrderDocuments (ext. Version: REST 1.0 )
REST 1.0 Gets a list of order documents by OrderID.
fetch Order data
PlentyAddStorageLocation (ext. Version: REST 1.0 )
PlentyAddStorageLocation (ext. Version: REST 1.0 )
REST 1.0 Creates a new storage location in warehouse. The id of the rack and the id of the shelf must be specified.
set or update Stock data
PlentySetCustomers (ext. Version: REST 1.0 )
PlentySetCustomers (ext. Version: REST 1.0 )
REST 1.0 Updates or inserts customer / contacs to Plentymarkets shops.
set or update Customer data
PlentyGetVariationWarehouses (ext. Version: REST 1.0 )
PlentyGetVariationWarehouses (ext. Version: REST 1.0 )
REST 1.0 Lists the warehouses linked to a variation.
fetch Product data
PlentyGetStockMovements (ext. Version: REST 1.0 )
PlentyGetStockMovements (ext. Version: REST 1.0 )
REST 1.0 Gets a list of stock movements for specified variant ids.
fetch Stock data
PlentyUpdateImages (ext. Version: REST 1.0 )
PlentyUpdateImages (ext. Version: REST 1.0 )
REST 1.0 Updates images from Plentymarkets shops.
set or update Images
PlentyGetCustomers (ext. Version: REST 1.0 )
PlentyGetCustomers (ext. Version: REST 1.0 )
REST 1.0 Gets a list of customers/contacts from plentymarkets Shop.
fetch Customer data
PlentySetCurrentStocks (ext. Version: REST 1.0 )
PlentySetCurrentStocks (ext. Version: REST 1.0 )
REST 1.0 Update the physical stock on products in a plentymarkets store.
set or update Stock data
PlentySetVariationsPrices (ext. Version: REST 1.0 )
PlentySetVariationsPrices (ext. Version: REST 1.0 )
REST 1.0 Updates one of the price fields of variations in a plentymarkets store.
set or update Price data
PlentySetAttributeValues (ext. Version: REST 1.0 )
PlentySetAttributeValues (ext. Version: REST 1.0 )
REST 1.0 Creates or updates attribute values in plentymarkets
set or update Product data
PlentyGetAddresses (ext. Version: REST 1.0 )
PlentyGetAddresses (ext. Version: REST 1.0 )
REST 1.0 Gets a list of Addresses from plentymarkets Shop.
fetch Order data
PlentySetVariationProperties (ext. Version: REST 1.0 )
PlentySetVariationProperties (ext. Version: REST 1.0 )
REST 1.0 Adds properties and property values to variations
set or update Product data
PlentyElasticExport (ext. Version: REST 1.0 )
PlentyElasticExport (ext. Version: REST 1.0 )
REST 1.0 Get a spreadsheet from elastic export
fetch Order data , fetch Product data
PlentyGetVariationSKUs (ext. Version: REST 1.0 )
PlentyGetVariationSKUs (ext. Version: REST 1.0 )
REST 1.0 Gets a list of variations skus of specified variant ids.
fetch Product data
PlentyUpdateItems (ext. Version: REST 1.0 )
PlentyUpdateItems (ext. Version: REST 1.0 )
REST 1.0 Updates Items in a Plentymarkets system.
set or update Product data
PlentySetItemsShippingProfiles (ext. Version: REST 1.0 )
PlentySetItemsShippingProfiles (ext. Version: REST 1.0 )
REST 1.0 Adds shipping profiles to items in a Plentymarkets system.
set or update Product data
PlentyGetVariations (ext. Version: REST 1.0 )
PlentyGetVariations (ext. Version: REST 1.0 )
REST 1.0 Gets a list of variations from plentymarkets.
fetch Product data , fetch Stock data , fetch Price data
PlentyGetItemBundles (ext. Version: REST 1.0 )
PlentyGetItemBundles (ext. Version: REST 1.0 )
REST 1.0 Gets a list of bundle components from plentymarkets.
fetch Product data
PlentyGetListings (ext. Version: REST 1.0 )
PlentyGetListings (ext. Version: REST 1.0 )
REST 1.0 Gets a listings from plentymarkets Shop.
fetch Product data
PlentySetVariationCategories (ext. Version: REST 1.0 )
PlentySetVariationCategories (ext. Version: REST 1.0 )
REST 1.0 Adds and remove category links to variations
set or update Product data
PlentyUpdateVariations (ext. Version: REST 1.0 )
PlentyUpdateVariations (ext. Version: REST 1.0 )
REST 1.0 Update variations in your plentymarkets shop.
set or update Product data , set or update Price data
PlentyAddPropertyToItem (ext. Version: REST 1.0 )
PlentyAddPropertyToItem (ext. Version: REST 1.0 )
REST 1.0 Adds properties and property values to Items
set or update Product data
PlentyAddOrdersPackage (ext. Version: REST 1.0 )
PlentyAddOrdersPackage (ext. Version: REST 1.0 )
REST 1.0 Adds package (package number) to order.
set or update Order tracking / shipping data
PlentyGetAttributes (ext. Version: REST 1.0 )
PlentyGetAttributes (ext. Version: REST 1.0 )
REST 1.0 Gets a list of attributes from plentymarkets.
fetch Product data
PlentyAddCategories (ext. Version: REST 1.0 )
PlentyAddCategories (ext. Version: REST 1.0 )
REST 1.0 Creates new Plentymarkets Categories
set or update Product data
PlentyGetVariationProperties (ext. Version: REST 1.0 )
PlentyGetVariationProperties (ext. Version: REST 1.0 )
REST 1.0 Gets a list of variation properties from plentymarkets.
PlentyGetCurrentStocks (ext. Version: REST 1.0 )
PlentyGetCurrentStocks (ext. Version: REST 1.0 )
REST 1.0 Gets stocks of one ore multiple plentymarktes warehouses.
fetch Stock data
PlentySetVariationBarcodes (ext. Version: REST 1.0 )
PlentySetVariationBarcodes (ext. Version: REST 1.0 )
REST 1.0 Updates or creates a variation Barcode.
set or update Product data
PlentyGetVariationAdditionalSKUs (ext. Version: REST 1.0 )
PlentyGetVariationAdditionalSKUs (ext. Version: REST 1.0 )
REST 1.0 Gets a list of variations additional skus of specified variant ids.
PlentySetOrderItems (ext. Version: REST 1.0 )
PlentySetOrderItems (ext. Version: REST 1.0 )
REST 1.0 Updates items of plentymarkets orders
set or update Order data
PlentyGetItemsSuppliers (ext. Version: REST 1.0 )
PlentyGetItemsSuppliers (ext. Version: REST 1.0 )
REST 1.0 Gets a list of supplier items of specified variant ids.
fetch Product data
PlentySetAddress (ext. Version: REST 1.0 )
PlentySetAddress (ext. Version: REST 1.0 )
REST 1.0 Updates or inserts address to Plentymarkets shops.
set or update Customer data
PlentyGetOrderStatusHistory (ext. Version: REST 1.0 )
PlentyGetOrderStatusHistory (ext. Version: REST 1.0 )
REST 1.0 Returns status history for orders.
fetch Order data
PlentySetVariationSuppliers (ext. Version: REST 1.0 )
PlentySetVariationSuppliers (ext. Version: REST 1.0 )
REST 1.0 Updates an existing supplier Item or creates an new one.
set or update Product data
PlentyGetListingTexts (ext. Version: REST 1.0 )
PlentyGetListingTexts (ext. Version: REST 1.0 )
REST 1.0 Gets a list of listing texts from plentymarkets.
fetch Product data
PlentySetIncomingStocks (ext. Version: REST 1.0 )
PlentySetIncomingStocks (ext. Version: REST 1.0 )
REST 1.0 Adds quantity of stock column to physical stock on products in a plentymarkets store.
set or update Stock data
PlentySearchOrders (ext. Version: REST 1.0 )
PlentySearchOrders (ext. Version: REST 1.0 )
REST 1.0 Get Orders from a plentymarkets System.
fetch Order data
PlentySetVariationWarehouse (ext. Version: REST 1.0 )
PlentySetVariationWarehouse (ext. Version: REST 1.0 )
REST 1.0 Updates or creates a variation warehouse settings.
set or update Product data
PlentyGetOrderShippingReturns (ext. Version: REST 1.0 )
PlentyGetOrderShippingReturns (ext. Version: REST 1.0 )
REST 1.0 Gets a list of order shipping returns by OrderID.
PlentyGetReorders (ext. Version: REST 1.0 )
PlentyGetReorders (ext. Version: REST 1.0 )
REST 1.0 Get Reorders from a plentymarkets System.
PlentyGetItemCrossSellingLinks (ext. Version: REST 1.0 )
PlentyGetItemCrossSellingLinks (ext. Version: REST 1.0 )
REST 1.0 Gets a lists all cross-selling items linked to an item from plentymarkets.
fetch Product data
PlentyGetListingHistory (ext. Version: REST 1.0 )
PlentyGetListingHistory (ext. Version: REST 1.0 )
REST 1.0 Gets active listings from plentymarkets Shop.