{{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
Updated From (lastUpdateFrom) DATETIME LastUpdate from date, filter contacts that were updated after a specific date, e.g. 18.12.2012 16:00 No
Updated To (lastUpdateTo) DATETIME LastUpdate to date, filter contacts that were updated before a specific date e.g. 20.12.2012 16:00. Leave empty to filter until now. No
Created From (createdAtFrom) DATETIME Filter contacts that were created after a specific date e.g. 18.12.2012 16:00 No
Created To (createdAtTo) DATETIME Filter contacts that were created before a specific date e.g. 20.12.2012 16:00. Leave empty to filter until now. No
Last Order From (lastOrderFrom) DATETIME Filter last order date to contacts whose last order was created after date, e.g. 18.12.2012 16:00 No
Last Order To (lastOrderTo) DATETIME Filter last order date to contacts whose last order was created before date, e.g. 20.12.2012 16:00. Leave empty to filter until now. No
Contact ID (customerID) STRING Plentymarkets customer ID No
Plenty ID (plentyID) STRING Plentymarkets store ID of customers No
E-mail address (email) STRING The customer's e-mail address. No
Zip Code (zip) STRING The customer's ZIP code No
Customer type (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 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
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
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
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
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
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
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
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
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
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
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.
fetch Reports
PlentyGetManufacturers (ext. Version: REST 1.0 )
PlentyGetManufacturers (ext. Version: REST 1.0 )
REST 1.0 Get a list of all manufacturers from plentymarkets
fetch Product data
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
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
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
PlentyGetListings (ext. Version: REST 1.0 )
PlentyGetListings (ext. Version: REST 1.0 )
REST 1.0 Gets a listings from plentymarkets Shop.
fetch Product data
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
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
PlentySetAttributes (ext. Version: REST 1.0 )
PlentySetAttributes (ext. Version: REST 1.0 )
REST 1.0 Updates attributes in plentymarkets
set or update Product data
PlentyAddVariationToBundle (ext. Version: REST 1.0 )
PlentyAddVariationToBundle (ext. Version: REST 1.0 )
REST 1.0 Adds a variation to a bundle variation as a bundle component.
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
PlentyRESTAuthenticate (ext. Version: REST 1.0 )
PlentyRESTAuthenticate (ext. Version: REST 1.0 )
REST 1.0 Authenticates with account and returns new token
Messages
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
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
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
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
PlentyGetVariationProperties (ext. Version: REST 1.0 )
PlentyGetVariationProperties (ext. Version: REST 1.0 )
REST 1.0 Gets a list of variation properties from plentymarkets.
fetch Product 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
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.
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
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
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
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
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
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
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
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
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
PlentySearchOrders (ext. Version: REST 1.0 )
PlentySearchOrders (ext. Version: REST 1.0 )
REST 1.0 Get Orders from a plentymarkets System.
fetch Order 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
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
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
PlentyGetOrderShippingReturns (ext. Version: REST 1.0 )
PlentyGetOrderShippingReturns (ext. Version: REST 1.0 )
REST 1.0 Gets a list of order shipping returns by OrderID.
fetch Order data
PlentyGetReorders (ext. Version: REST 1.0 )
PlentyGetReorders (ext. Version: REST 1.0 )
REST 1.0 Get Reorders from a plentymarkets System.
fetch Order data
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
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.
fetch Product data