Skip to main content
POST
/
accounting
/
bills
/
{billId}
/
lineItems
cURL
curl --request POST \
  --url https://api.maesn.dev/accounting/bills/{billId}/lineItems \
  --header 'Content-Type: application/json' \
  --data '{
  "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"
}'
{
  "meta": {
    "warnings": [
      "Field not used by target system"
    ],
    "pagination": {
      "total": 123,
      "perPage": 123,
      "currentPage": 123,
      "totalPages": 123
    }
  },
  "data": {
    "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"
  }
}

Field support per integration

Please ensure the query parameter companyId is accurately filled with the division code. You can obtain this values by using the GET Companies endpoints available under the Authentication section.
Supported Response Fields:
accountId
string
required
description
string
dimensions
Dimension[]
taxCode
string
taxRatePercentage
number
totalNetAmount
number
The total amount for the item excluding tax.
When the taxCode is provided and is of type INCLUSIVE, then the totalNetAmount will be treated as a gross amount (i.e., including tax).
totalTaxAmount
number

Headers

X-API-KEY
string

API key

X-ACCOUNT-KEY
string

Account key

Path Parameters

billId
string
required

Query Parameters

companyId
string

Body

application/json
accountId
string
Example:

"6733a433-9662-4a40-8e36-e38ebda94fe1"

accountNumber
string
Example:

"200"

description
string
Example:

"SEOUL Guest Chair, red"

dimensions
object[]
itemId
string
Example:

"4f3a2hf4-5b8e-4d1b-8a0c-9f6e7d2f3e4b"

itemName
string
Example:

"RED CHAIR"

quantity
number
Example:

1

taxCode
string
Example:

"03"

taxRatePercentage
number
Example:

19

totalDiscountAmount
number
Example:

10

totalDiscountPercentage
number
Example:

10

totalGrossAmount
number
Example:

109

totalNetAmount
number
Example:

100

totalTaxAmount
number
Example:

19

unitAmount
number
Example:

100

unitDiscountAmount
number
Example:

10

unitDiscountPercentage
number
Example:

10

unitName
string
Example:

"PIECE"

Response

200 - application/json
meta
object
data
object
I