Über diese Operation kann ein neues Angebot angefordert werden

Request

POST https://api.mittwald.de/v1/offers

Request-Body

The request body takes a complete OfferRequest resource, containing the following writable properties:

{
    "articles": {
        "additional": [
            {
                "articleNumber": "number"
            }
        ],
        "main": {
            "articleNumber": "number"
        }
    },
    "isTechnicalAdminForRecipient": "boolean",
    "recipient": {
        "city": "string",
        "company": "string",
        "country": "string",
        "emailAddress": "email",
        "firstName": "string",
        "houseNumber": "string",
        "lastName": "string",
        "phone": "string",
        "salutation": "string",
        "street": "string",
        "title": "string",
        "zip": "string"
    }
}

Properties

Name Typ Beschreibung Weiteres
articles object OfferRequestArticles
articles.additional[] array Optional
articles.additional[].articleNumber number
articles.main object OfferRequestArticle
articles.main.articleNumber number
isTechnicalAdminForRecipient boolean Optional
recipient object OfferRequestRecipient
recipient.city string
recipient.company string Optional
recipient.country string

iso country short code (ISO 3166-1 alpha-2)

recipient.emailAddress email
recipient.firstName string
recipient.houseNumber string
recipient.lastName string
recipient.phone string
recipient.salutation string

Mögliche Werte sind:

  • Herr
  • Frau
  • Mr.
  • Ms.
recipient.street string
recipient.title string Optional
recipient.zip string of integer

Response

Diese Operation kann mit den folgenden HTTP-Statuscodes antworten:

Statuscode Beschreibung Ressource
202 Accepted

Die Anfrage wurde zur Bearbeitung angenommen

400 Bad Request

Ungültige Anfrage. Dies kann beispielsweise geschehen, wenn die Anfrage ungültig codierte Inhalte enthält oder der Inhalt semantisch inkorrekt ist.

Error
403 Forbidden

Zugriff verweigert

Error
500 Internal Server Error

Bei der Verarbeitung der Anfrage ist ein Fehler aufgetreten.

Error

Explore this API

offerRequest

Die Angebotsanfrage; diese enthält Daten zu den angefragten Artikeln sowie notwendige Kundenstammdaten

Request Content-Type
Response Content-Type
Try it out!