Neue API-Version v7.7.0 wurde veröffentlicht! 🎉
REST Dokumentation
POST Kunden erstellen

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.