PUT
/
accounting
/
bills
/
{billId}
cURL
curl --request PUT \
  --url https://api.maesn.dev/accounting/bills/{billId} \
  --header 'Content-Type: application/json' \
  --header 'X-ACCOUNT-KEY: <x-account-key>' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
  "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
  "addresses": [
    {
      "addressLine1": "Main street 45",
      "addressLine2": "2nd floor",
      "city": "Berlin",
      "countryCode": "DE",
      "postalCode": "10243",
      "type": "BILLING"
    }
  ],
  "billDate": "2021-01-01T00:00:00Z",
  "billNumber": "1020",
  "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
  "currency": "EUR",
  "deliveryDate": "2021-01-01T00:00:00Z",
  "dueDate": "2021-02-01T00:00:00Z",
  "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
  "journalCode": "30",
  "lineItems": [
    {
      "id": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
      "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
      "accountNumber": "200",
      "description": "SEOUL Guest Chair, red",
      "dimensions": [
        {
          "name": "C1",
          "categoryName": "CostCenter"
        }
      ],
      "itemId": "4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
      "itemName": "RED CHAIR",
      "quantity": 1,
      "taxCode": "03",
      "taxRatePercentage": 19,
      "totalDiscountAmount": 10,
      "totalDiscountPercentage": 10,
      "totalGrossAmount": 109,
      "totalNetAmount": 100,
      "totalTaxAmount": 19,
      "unitAmount": 100,
      "unitDiscountAmount": 10,
      "unitDiscountPercentage": 10,
      "unitName": "PIECE"
    }
  ],
  "name": "Office Supplies",
  "oneLineAddress": "Main street 45, Berlin",
  "paidDate": "2021-01-25T00:00:00Z",
  "paymentDays": 30,
  "paymentStatus": "PENDING",
  "paymentTermId": "d2f3e4b5-6a7b-8c9d-0e1f-2g3h4i5j6k7l",
  "reference": "RCXF197253F",
  "shippingDate": "2021-01-01T00:00:00Z",
  "shippingType": "DELIVERY",
  "status": "DRAFT",
  "taxRule": "NET",
  "taxText": "Tax 19 percent",
  "totalDiscountAmount": 10,
  "totalDiscountPercentage": 10,
  "totalGrossAmount": 109,
  "totalNetAmount": 100,
  "totalTaxAmount": 19
}'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "data": {
    "id": "9714f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
    "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
    "addresses": [
      {
        "addressLine1": "Main street 45",
        "addressLine2": "2nd floor",
        "city": "Berlin",
        "countryCode": "DE",
        "postalCode": "10243",
        "type": "BILLING"
      }
    ],
    "billDate": "2021-01-01T00:00:00Z",
    "billNumber": "1020",
    "contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
    "createdDate": "2021-01-01T00:00:00Z",
    "currency": "EUR",
    "deliveryDate": "2021-01-01T00:00:00Z",
    "dueDate": "2021-02-01T00:00:00Z",
    "fileId": "93c6b8e0-80a4-4c22-a46c-18beebab82d6",
    "journalCode": "30",
    "lineItems": [
      {
        "id": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
        "accountId": "6733a433-9662-4a40-8e36-e38ebda94fe1",
        "accountNumber": "200",
        "createdDate": "2021-01-01T00:00:00Z",
        "description": "SEOUL Guest Chair, red",
        "dimensions": [
          {
            "name": "C1",
            "categoryName": "CostCenter"
          }
        ],
        "itemId": "4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
        "itemName": "RED CHAIR",
        "quantity": 1,
        "taxCode": "03",
        "taxRatePercentage": 19,
        "totalDiscountAmount": 10,
        "totalDiscountPercentage": 10,
        "totalGrossAmount": 109,
        "totalNetAmount": 100,
        "totalTaxAmount": 19,
        "unitAmount": 100,
        "unitDiscountAmount": 10,
        "unitDiscountPercentage": 10,
        "unitName": "PIECE",
        "updatedDate": "2021-01-01T00:00:00Z"
      }
    ],
    "name": "Office Supplies",
    "oneLineAddress": "Main street 45, Berlin",
    "paidDate": "2021-01-25T00:00:00Z",
    "paymentDays": 30,
    "paymentStatus": "PENDING",
    "paymentTermId": "d2f3e4b5-6a7b-8c9d-0e1f-2g3h4i5j6k7l",
    "reference": "RCXF197253F",
    "shippingDate": "2021-01-01T00:00:00Z",
    "shippingType": "DELIVERY",
    "status": "DRAFT",
    "taxRule": "NET",
    "taxText": "Tax 19 percent",
    "totalDiscountAmount": 10,
    "totalDiscountPercentage": 10,
    "totalGrossAmount": 109,
    "totalNetAmount": 100,
    "totalTaxAmount": 19,
    "updatedDate": "2021-01-01T00:00:00Z"
  }
}

​
Field support per integration

Headers

​
X-API-KEY
string
required

API key

​
X-ACCOUNT-KEY
string
required

Account key

Path Parameters

​
billId
string
required

Query Parameters

​
companyId
string
​
environmentName
string

Body

application/json

Response

200 - application/json

The response is of type object.