Kunden erstellen
Sie können diesen Endpunkt verwenden, um einen neuen Kunden zu erstellen.
Request
POST /api/v1/customers
curl --request POST \
--url 'https://www.zep-online.de/zepinstanz/next/api/v1/customers' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{
"customer_number": "12345",
"name": "Acme Corporation",
"additional_name": "ACME Corp",
"website": "www.acme-corp.com",
"email": "info@acme-corp.com",
"phone": "+1-555-0123",
"fax": "+1-555-0124",
"currency": "EUR",
"comments": "Wichtiger Kunde - mit Sorgfalt behandeln",
"industry": "Technologie",
"vat": "19.0000",
"tax_number": "DE123456789",
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"payment_target": 30,
"payment_target_discount": 2,
"billing_procedure": true,
"automated_invoicing": true,
"department_id": 1
}'
Response
{
"data": {
"customer_number": "12345",
"name": "Acme Corporation",
"additional_name": "ACME Corp",
"website": "www.acme-corp.com",
"email": "info@acme-corp.com",
"phone": "+1-555-0123",
"fax": "+1-555-0124",
"currency": "EUR",
"comments": "Wichtiger Kunde - mit Sorgfalt behandeln",
"industry": "Technologie",
"vat": "19.0000",
"tax_number": "DE123456789",
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"payment_target": 30,
"payment_target_discount": 2,
"status": {
"id": 1,
"name": "Aktiv"
},
"created": "2024-09-12T10:30:00.000000Z",
"modified": "2024-09-12T10:30:00.000000Z",
"billing_procedure": true,
"automated_invoicing": true,
"debit_payment": null,
"department_id": 1,
"addresses": [],
"managers": [],
"categories": [],
"dynamicAttributes": [],
"priceTables": []
}
}
Erforderliche Parameter
- Name
customer_number
- Type
- string
- Description
Die eindeutige Kundennummer.
- Name
name
- Type
- string
- Description
Der Name des Kunden.
Optionale Parameter
- Name
additional_name
- Type
- string
- Description
Zusätzlicher Name oder Kurzbeschreibung des Kunden.
- Name
website
- Type
- string
- Description
Website-URL des Kunden.
- Name
email
- Type
- string
- Description
E-Mail-Adresse des Kunden.
- Name
phone
- Type
- string
- Description
Telefonnummer des Kunden.
- Name
fax
- Type
- string
- Description
Faxnummer des Kunden.
- Name
currency
- Type
- string
- Description
Währung des Kunden (z. B. "EUR", "USD").
- Name
comments
- Type
- string
- Description
Kommentare oder Notizen zum Kunden.
- Name
industry
- Type
- string
- Description
Branche des Kunden.
- Name
vat
- Type
- string
- Description
Mehrwertsteuersatz.
- Name
tax_number
- Type
- string
- Description
Steuernummer des Kunden.
- Name
iban
- Type
- string
- Description
IBAN des Kunden.
- Name
bic
- Type
- string
- Description
BIC des Kunden.
- Name
payment_target
- Type
- integer
- Description
Zahlungsziel in Tagen.
- Name
payment_target_discount
- Type
- integer
- Description
Skonto-Prozentsatz.
- Name
billing_procedure
- Type
- boolean
- Description
Gibt an, ob Rechnungsstellung aktiviert ist.
- Name
automated_invoicing
- Type
- boolean
- Description
Gibt an, ob automatische Rechnungsstellung aktiviert ist.
- Name
department_id
- Type
- integer
- Description
ID der zugehörigen Abteilung.