POST
/
accounting
/
offers
curl --request POST \
  --url https://api.maesn.dev/accounting/offers \
  --header 'Content-Type: application/json' \
  --data '{
  "addresses": [
    {
      "addressLine1": "Street",
      "addressLine2": "Building",
      "city": "City",
      "postalCode": "12345",
      "countryCode": "DE",
      "type": "BILLING"
    }
  ],
  "contactId": "Contact id",
  "currency": "EUR",
  "lineItems": [
    {
      "accountCode": "8400",
      "accountId": "a23cc-334rn-finsd-438m",
      "description": "Description",
      "itemId": "Item id",
      "name": "Item name",
      "quantity": "1",
      "taxCode": "CODE.19",
      "taxRatePercentage": "19",
      "taxType": "type-19",
      "type": "ITEM",
      "totalDiscountAmount": "5",
      "totalDiscountPercentage": "5",
      "totalGrossAmount": "500",
      "totalNetAmount": "100",
      "totalTaxAmount": "19",
      "unitAmount": "100",
      "unitDiscountAmount": "5",
      "unitDiscountPercentage": "5",
      "unitName": "PIECE"
    }
  ],
  "name": "Offer name",
  "offerDate": "2021-01-01T00:00:00Z",
  "offerNumber": "Offer number",
  "reference": "Reference",
  "status": "DRAFT",
  "taxRule": "NET",
  "taxText": "tax description",
  "totalDiscountAmount": "5",
  "totalDiscountPercentage": "19",
  "totalGrossAmount": "500",
  "totalNetAmount": "100",
  "totalTaxAmount": "19"
}'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "data": {
    "id": "Offer id",
    "addresses": [
      {
        "addressLine1": "Street",
        "addressLine2": "Building",
        "city": "City",
        "postalCode": "12345",
        "countryCode": "DE",
        "type": "BILLING"
      }
    ],
    "contactId": "Contact id",
    "createdDate": "2021-01-01T00:00:00Z",
    "currency": "EUR",
    "lineItems": [
      {
        "id": "Offer line item id",
        "accountCode": "8400",
        "accountId": "a23cc-334rn-finsd-438m",
        "createdDate": "2021-01-01T00:00:00Z",
        "description": "Description",
        "itemId": "Item id",
        "name": "Item name",
        "quantity": "1",
        "taxCode": "CODE.19",
        "taxRatePercentage": "19",
        "taxType": "type-19",
        "type": "ITEM",
        "totalDiscountAmount": "5",
        "totalDiscountPercentage": "5",
        "totalGrossAmount": "500",
        "totalNetAmount": "100",
        "totalTaxAmount": "19",
        "unitAmount": "100",
        "unitDiscountAmount": "5",
        "unitDiscountPercentage": "5",
        "unitName": "STÜCK",
        "updatedDate": "2021-01-01T00:00:00Z"
      }
    ],
    "name": "Offer name",
    "offerDate": "2021-01-01T00:00:00Z",
    "offerNumber": "Offer number",
    "reference": "Reference",
    "status": "DRAFT",
    "taxRule": "NET",
    "taxText": "tax description",
    "totalDiscountAmount": "5",
    "totalDiscountPercentage": "19",
    "totalGrossAmount": "500",
    "totalNetAmount": "100",
    "totalTaxAmount": "19",
    "updatedDate": "2021-01-01T00:00:00Z"
  }
}

Field support per integration

Headers

X-API-KEY
string

API key

X-ACCOUNT-KEY
string

Account key

Query Parameters

companyId
string
environmentName
string

Body

application/json

Response

200 - application/json

The response is of type object.