info@selectline.de | +49 391 5555-080 | SelectLine - suits every company
Deutsch
English
POST
/Customers
Description

Creates a new client. The properties of the new client must be transferred in the body of the request.

  • The right ‘Anlegen’ is required for the data ‘Kunde’.

Request

URI Parameters

None.

Body Parameters

Das Model enthält sämtliche Eigenschaften des Kunden. Bleiben diese leer, wird dennoch ein Kunde angelegt. Die Kundennummer wird dann automatisch vergeben.

Model: Customer
Payment
CustomerDetailPayment
Payment data of the customer.
Document
CustomerDetailDocument
The customer´s document data.
EBillEMail
string
E-Mail Adresse für E-Rechnung
[DEBITORENDETAILS].[EMail]
ETypId
integer
Typ der E-Rechnung
|| 0 - Keine elektronische Rechnung |
1 - PDF E-Mail |
2 - Postfinance |
3 - ZUGFeRD-PDF E-Mail
IsPrivatePerson
boolean
Gibt an, ob der Kunde eine Privatperson ist
BuyerReferenceIdentifier
string
[DEBITORENDETAILS].[LeitwegID]
DefaultContactPersonId
integer
Das Kürzel für die Standardkontaktperson der BusinessPerson.
Kunde = [DEBITOREN.StandardAnsprechpartner = CRM_ADRESSEN.Id]
Interessent = [WAWIINTERESS.StandardAnsprechpartner = CRM_ADRESSEN.Id]
Lieferant = [KREDITOREN.StandardAnsprechpartner = CRM_ADRESSEN.Id]
DefaultContactPersonLabel
string
Nur lesen
The designation for the standard contact person of BusinessPerson.
GroupNumber
string
Länge: einschließlich zwischen 0 und 6
Die Nummer für die Gruppe der BusinessPerson.
Kunde = [DEBITOREN.Gruppe = GRUPPEN.Nummer (KG)]
Interessent = [WAWIINTERESS.Gruppe = GRUPPEN.Nummer (LG)]
Lieferant = [KREDITOREN.Gruppe = GRUPPEN.Nummer (LG)]
GroupLabel
string
Nur lesen
The designation for the group of BusinessPerson.
InternationalLocationNumber
string
Länge: einschließlich zwischen 0 und 35
The Global Location Number (GLN) is used to uniquely identify companies worldwide. It used to be called the International Location Number (ILN).
EmployeeNumber
string
Länge: einschließlich zwischen 0 und 6
Das Kürzel für den Mitarbeiter der BusinessPerson.
Kunde = [DEBITOREN.Mitarbeiter = MITARBW.Nr]
Interessent = [WAWIINTERESS.Mitarbeiter = MITARBW.Nr]
Lieferant = [KREDITOREN.Mitarbeiter = MITARBW.Nr]
EmployeeLabel
string
Nur lesen
The designation for the employee of BusinessPerson.
SalesmanNumber
string
Länge: einschließlich zwischen 0 und 6
Das Kürzel für den Vertreter der BusinessPerson.
Kunde = [DEBITOREN.Vertreter = MITARBW.Nr]
Interessent = [WAWIINTERESS.Vertreter = MITARBW.Nr]
Lieferant = [KREDITOREN.Vertreter = MITARBW.Nr]
SalesmanLabel
string
Nur lesen
The designation for the representatives of BusinessPerson.
OwnNumber
string
Länge: einschließlich zwischen 0 und 15
Die eigene Liefer-oder Kundennummer.
Kunde = [DEBITOREN.EigeneNummer]
Interessent = [WAWIINTERESS.EigeneNummer]
Lieferant = [KREDITOREN.EigeneNummer]
AccountGroupNumber
string
Länge: einschließlich zwischen 0 und 6
Das Kürzel für die Kontengruppe der BusinessPerson.
Kunde = [DEBITOREN.Kontengruppe = GRUPPEN.Nummer AND Gruppen.Id = 'CK]
Interessent = [WAWIINTERESS.Kontengruppe = GRUPPEN.Nummer AND Gruppen.Id = 'CK'/'CL']
Lieferant = [KREDITOREN.Kontengruppe = GRUPPEN.Nummer AND Gruppen.Id = 'CL']
AccountGroupLabel
string
Nur lesen
The designation for the account group of BusinessPerson.
IsInactive
boolean
Gibt an, ob die BusinessPerson inaktiv ist.
[DEBITOREN.Inaktiv]
LanguageId
string
Länge: einschließlich zwischen 0 und 6
Das Kürzel für die Sprache der BusinessPerson.
[DEBITOREN.Sprache = SL_Daten.DGRUPPEN.Nummer (SP)]
LanguageLabel
string
Nur lesen
The designation for the language of BusinessPerson.
IsFavorite
boolean
Nur lesen
Indicates whether BusinessPerson is a favorite.
CountryOfEurope
string
Gibt das EU-Land an
Number
string
Länge: einschließlich zwischen 0 und 13
The number of the record.
Salutation
string
Länge: einschließlich zwischen 0 und 30
The salutation of business partner.[CRM-Addresses.Salutation]
LetterSalutation
string
Länge: einschließlich zwischen 0 und 50
The salutation of business partner.[CRM_Addresses.LetterSalutation]
Title
string
Länge: einschließlich zwischen 0 und 30
The title of the business partner.[CRM_Addresses.Title]
FirstName
string
Länge: einschließlich zwischen 0 und 40
The first name of the business partner.[CRM_Addresses.FirstName]
LastName
string
Länge: einschließlich zwischen 0 und 80
The surname of the business partner. [CRM_Addresses.Name]
Company
string
Länge: einschließlich zwischen 0 und 80
The firm name of the business partner.[CRM_Addresses.Firm]
Department
string
Länge: einschließlich zwischen 0 und 80
The department of the business partner. [CRM_Addresss.Department]
Function
string
Länge: einschließlich zwischen 0 und 80
The function of the business partner.[CRM_Addresses.Function]
BirthDay
date
The birthday of the business partner. [CRM_Adressen.Birthday]
TrafficRouteKind
string
The type of transport mode of the customer.
TrafficRouteKindLabel
string
The name of the customer´s mode of transport.
Address
PersonDetailAddress
The address data of business partner.
PostOfficeBox
PersonDetailPostOfficeBox
The mailbox data of business partners.
Contact
PersonDetailContact
The contact data of business partners.
CustomField
PersonDetailCustomField
The 'free fields' of customers.
MetaData
ModelMetaData
Creation / processing data of the business partner
Request Formats
application/json
Example:
    {
  "Payment": {
    "CreditLimitAmount": 1.1,
    "IsReminderLock": true,
    "IsPaymentLock": true,
    "SpecialDiscountPercent": 4.1,
    "MinimumOrderAmount": 5.1,
    "FinancialAccountId": "sample string 6",
    "FinancialAccountLabel": "sample string 7",
    "PaymentConditionId": "sample string 8",
    "PaymentConditionsLabel": "sample string 9",
    "AutomaticPaymentFlag": "sample string 10",
    "AutomaticPaymentLabel": "sample string 11",
    "CostCentreNumber": "sample string 12",
    "CostCentreLabel": "sample string 13",
    "CurrencyCode": "sample string 14",
    "CurrencyLabel": "sample string 15",
    "TaxNumber": "sample string 16",
    "TaxIdentifierNumber": "sample string 17",
    "PriceGroupNumber": "sample string 18",
    "PriceGroupLabel": "sample string 19",
    "PriceTypeFlag": "sample string 20",
    "DiscountGroupNumber": "sample string 21",
    "DiscountGroupLabel": "sample string 22",
    "InvoiceRecipientCustomerNumber": "sample string 23",
    "InvoiceRecipientCustomerLabel": "sample string 24",
    "PriceReferenceCustomerNumber": "sample string 25",
    "PriceReferenceCustomerLabel": "sample string 26"
  },
  "Document": {
    "IsDocumentLock": true,
    "DefaultDeliveryAddressId": 1,
    "DefaultDeliveryAddressLabel": "sample string 2",
    "WarehouseLocationId": "sample string 3",
    "WarehouseLocationLabel": "sample string 4",
    "WarehouseId": "sample string 5",
    "WarehouseLabel": "sample string 6",
    "DeliveryConditionId": "sample string 7",
    "DeliveryConditionLabel": "sample string 8",
    "DocumentChargeArticleId": "sample string 9",
    "DocumentChargeArticleLabel": "sample string 10"
  },
  "EBillEMail": "sample string 1",
  "ETypId": 2,
  "IsPrivatePerson": true,
  "BuyerReferenceIdentifier": "sample string 4",
  "DefaultContactPersonId": 1,
  "DefaultContactPersonLabel": "sample string 5",
  "GroupNumber": "sample string 6",
  "GroupLabel": "sample string 7",
  "InternationalLocationNumber": "sample string 8",
  "EmployeeNumber": "sample string 9",
  "EmployeeLabel": "sample string 10",
  "SalesmanNumber": "sample string 11",
  "SalesmanLabel": "sample string 12",
  "OwnNumber": "sample string 13",
  "AccountGroupNumber": "sample string 14",
  "AccountGroupLabel": "sample string 15",
  "IsInactive": true,
  "LanguageId": "sample string 17",
  "LanguageLabel": "sample string 18",
  "IsFavorite": true,
  "CountryOfEurope": "sample string 20",
  "Number": "sample string 21",
  "Salutation": "sample string 22",
  "LetterSalutation": "sample string 23",
  "Title": "sample string 24",
  "FirstName": "sample string 25",
  "LastName": "sample string 26",
  "Company": "sample string 27",
  "Department": "sample string 28",
  "Function": "sample string 29",
  "BirthDay": "2024-12-26T20:49:51.3530549+01:00",
  "TrafficRouteKind": "sample string 30",
  "TrafficRouteKindLabel": "sample string 31",
  "Address": {
    "Street": "sample string 1",
    "City": "sample string 2",
    "ZipCode": "sample string 3",
    "CountryId": "sample string 4",
    "AdditionalInformation1": "sample string 5",
    "AdditionalInformation2": "sample string 6",
    "AdditionalInformation3": "sample string 7",
    "MetaData": {
      "CreationDate": "2024-12-26T20:49:51.3530549+01:00",
      "CreationUserToken": "sample string 1",
      "ModificationDate": "2024-12-26T20:49:51.3530549+01:00",
      "ModificationUserToken": "sample string 2"
    }
  },
  "PostOfficeBox": {
    "Number": "sample string 1",
    "ZipCode": "sample string 2",
    "City": "sample string 3",
    "CountryId": "sample string 4"
  },
  "Contact": {
    "FaxNumber": "sample string 1",
    "TelephoneNumber1": "sample string 2",
    "TelephoneNumber2": "sample string 3",
    "TelephoneNumber3": "sample string 4",
    "TelephoneNumber4": "sample string 5",
    "EMail1": "sample string 6",
    "EMail2": "sample string 7",
    "HomePageUrl": "sample string 8"
  },
  "CustomField": {
    "Text1": "sample string 1",
    "Text2": "sample string 2",
    "Number1": 1.1,
    "Number2": 1.1,
    "Number3": 1,
    "Number4": 1,
    "Date1": "2024-12-26T20:49:51.3530549+01:00",
    "Date2": "2024-12-26T20:49:51.3530549+01:00",
    "Flag1": true,
    "Flag2": true,
    "Flag3": true,
    "Flag4": true
  },
  "MetaData": {
    "CreationDate": "2024-12-26T20:49:51.3530549+01:00",
    "CreationUserToken": "sample string 1",
    "ModificationDate": "2024-12-26T20:49:51.3530549+01:00",
    "ModificationUserToken": "sample string 2"
  }
}

Response

Resource Description

Ein HTTP Status Code 201 (Created) bestätigt das erfolgreiche Anlegen. Der Response Location Header enthält die Url des angelegten Kunden. Es wird kein Content geliefert.

Model: CustomerCreated
CustomerNumber
string
Customer number
Response Formats
application/json

No example available.