/Customers
Beschreibung
Legt einen neuen Kunden an. Die Eigenschaften des neuen Kunden müssen im Body des Requestes übertragen werden.
- Es wird das Recht "Anlegen" für die Daten "Kunde" benötigt.
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.
Payment
Die Zahlungsdaten des Kunden.
Document
Die Belegdaten des Kunden.
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
Die Bezeichnung für die Standardkontaktperson der 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
Die Bezeichnung für die Gruppe der BusinessPerson.
InternationalLocationNumber
string
Länge: einschließlich zwischen 0 und 35
Die Global Location Number (GLN) dient zur weltweit eindeutigen Identifikation von Unternehmen. Früher wurde sie International Location Number (ILN) genannt.
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
Die Bezeichnung für den Mitarbeiter der 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
Die Bezeichnung für den Vertreter der 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
Die Bezeichnung für die Kontengruppe der 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
Die Bezeichnung für die Sprache der BusinessPerson.
IsFavorite
boolean
Nur lesen
Gibt an, ob die BusinessPerson ein Favorit ist.
CountryOfEurope
string
Gibt das EU-Land an
Number
string
Länge: einschließlich zwischen 0 und 13
Die Nummer des Datensatzes.
Salutation
string
Länge: einschließlich zwischen 0 und 30
Die Anrede des Geschäftspartners. [CRM_Adressen.Anrede]
LetterSalutation
string
Länge: einschließlich zwischen 0 und 50
Die Anrede des Geschäftspartners. [CRM_Adressen.Briefanrede]
Title
string
Länge: einschließlich zwischen 0 und 30
Der Titel des Geschäftspartners. [CRM_Adressen.Titel]
FirstName
string
Länge: einschließlich zwischen 0 und 40
Der Vorname des Geschäftspartners. [CRM_Adressen.Vorname]
LastName
string
Länge: einschließlich zwischen 0 und 80
Der Nachname des Geschäftspartners. [CRM_Adressen.Name]
Company
string
Länge: einschließlich zwischen 0 und 80
Der Firmenname des Geschäftspartners. [CRM_Adressen.Firma]
Department
string
Länge: einschließlich zwischen 0 und 80
Die Abteilung des Geschäftspartners. [CRM_Adressen.Abteilung]
Function
string
Länge: einschließlich zwischen 0 und 80
Die Funktion des Geschäftspartners. [CRM_Adressen.Funktion]
BirthDay
date
Der Geburtstag des Geschäftspartners. [CRM_Adressen.Geburtstag]
TrafficRouteKind
string
Die Art des Verkehrszweigs des Kunden.
TrafficRouteKindLabel
string
Die Bezeichnung des Verkehrszweigs des Kunden.
Address
Die Adressdaten des Geschäftspartners.
PostOfficeBox
Das Postfachdaten des Geschäftspartners.
Contact
Die Kontaktdaten des Geschäftspartners.
CustomField
Der 'Freien Felder' des Kunden.
MetaData
Erstellungs-/Bearbeitungsdaten des Geschäftspartners
Request Formats
application/json
Beispiel:
{
"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-11-24T20:07:21.8273569+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-11-24T20:07:21.8273569+01:00",
"CreationUserToken": "sample string 1",
"ModificationDate": "2024-11-24T20:07:21.8273569+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-11-24T20:07:21.8273569+01:00",
"Date2": "2024-11-24T20:07:21.8273569+01:00",
"Flag1": true,
"Flag2": true,
"Flag3": true,
"Flag4": true
},
"MetaData": {
"CreationDate": "2024-11-24T20:07:21.8273569+01:00",
"CreationUserToken": "sample string 1",
"ModificationDate": "2024-11-24T20:07:21.8273569+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.
CustomerNumber
string
Kundennummer
Response Formats
application/json
Kein Beispiel verfügbar.