Skip to main content
Version: API v1

Ansprechpartner ändern

PUT/v1/customers/{customerNumber}/contactperson
API version
v1
Request method
PUT
Operation ID
updateCustomerContactPerson

Über diese Operation lassen sich die Daten des Ansprechpartners eines Kunden ändern. Dabei kann der Ansprechpartner über den Request-Body-Parameter "identicalToDefaultAddress" ebenfalls identisch zum Vertragspartner gesetzt werden.

Request​

  • customerNumberintegerrequired

    Kundennummer

Responses​

Format
application/json
Description

The customer contact person object

  • firstNamestringrequired

    Vorname

  • lastNamestringrequired

    Nachname

  • titlestring

    (Akademischer) grad

  • salutationstringrequired

    Grußformel, z.B. Herr oder Frau

  • companystring

    Firmenname, oder null

  • addressobjectrequired
    • streetstringrequired

      Straße

    • houseNumberstringrequired

      Hausnummer

    • zipstringrequired

      PLZ

    • citystringrequired

      Stadt

    • countryobjectrequired
      • isoShortstringrequired

        2-Zeichen-ISO-Name des Landes (z.B. DE)

      • isoLongstringrequired

        Langer ISO-Name des Landes (z.B. DEU)

      • euMemberbooleanrequired

        true wenn dieses Land EU-Mitglied ist

      • nameobjectrequired
        • destringrequired

          Deutscher Name

        • enstringrequired

          Englischer Name

  • contactobjectrequired
    • telephonestringrequired
    • faxstring
    • emailstring (email)required
Content-Type: application/json

{
  "firstName": "string",
  "lastName": "string",
  "title": "string",
  "salutation": "string",
  "company": "string",
  "address": {
    "street": "string",
    "houseNumber": "string",
    "zip": "string",
    "city": "string",
    "country": {
      "isoShort": "string",
      "isoLong": "string",
      "euMember": true,
      "name": {
        "de": "string",
        "en": "string"
      }
    }
  },
  "contact": {
    "telephone": "string",
    "fax": "string",
    "email": "email@mittwald.example"
  }
}
{
  "title": "CustomerPartner",
  "required": [
    "address",
    "contact",
    "firstName",
    "lastName",
    "salutation"
  ],
  "type": "object",
  "properties": {
    "firstName": {
      "type": "string",
      "description": "Vorname"
    },
    "lastName": {
      "type": "string",
      "description": "Nachname"
    },
    "title": {
      "type": "string",
      "description": "(Akademischer) grad"
    },
    "salutation": {
      "type": "string",
      "description": "Grußformel, z.B. *Herr* oder *Frau*"
    },
    "company": {
      "type": "string",
      "description": "Firmenname, oder `null`"
    },
    "address": {
      "title": "CustomerAddress",
      "required": [
        "city",
        "country",
        "houseNumber",
        "street",
        "zip"
      ],
      "type": "object",
      "properties": {
        "street": {
          "type": "string",
          "description": "Straße"
        },
        "houseNumber": {
          "type": "string",
          "description": "Hausnummer"
        },
        "zip": {
          "type": "string",
          "description": "PLZ"
        },
        "city": {
          "type": "string",
          "description": "Stadt"
        },
        "country": {
          "title": "Country",
          "required": [
            "euMember",
            "isoLong",
            "isoShort",
            "name"
          ],
          "type": "object",
          "properties": {
            "isoShort": {
              "type": "string",
              "description": "2-Zeichen-ISO-Name des Landes (z.B. `DE`)"
            },
            "isoLong": {
              "type": "string",
              "description": "Langer ISO-Name des Landes (z.B. `DEU`)",
              "readOnly": true
            },
            "euMember": {
              "type": "boolean",
              "description": "`true` wenn dieses Land EU-Mitglied ist",
              "readOnly": true
            },
            "name": {
              "required": [
                "de",
                "en"
              ],
              "type": "object",
              "properties": {
                "de": {
                  "type": "string",
                  "description": "Deutscher Name",
                  "readOnly": true
                },
                "en": {
                  "type": "string",
                  "description": "Englischer Name",
                  "readOnly": true
                }
              },
              "readOnly": true
            }
          }
        }
      }
    },
    "contact": {
      "title": "CustomerContactData",
      "required": [
        "email",
        "telephone"
      ],
      "type": "object",
      "properties": {
        "telephone": {
          "type": "string"
        },
        "fax": {
          "type": "string"
        },
        "email": {
          "type": "string",
          "format": "email"
        }
      }
    }
  }
}

Usage examples​

$ curl \
    --fail \
    --location \
    -X PUT \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v1/customers/123/contactperson

On this page