Get started
Integrations
Use cases
API reference
- Accounting
- Overview
- Accounts
- Async Task
- Bills
- Bill Lines
- Bookings
- Booking Proposals
- Contacts
- Customers
- Dimensions
- Expenses
- Files
- Invoices
- Invoice Lines
- Items
- Journals
- Journal Entries
- Offers
- Offer Lines
- Payments
- Payment Terms
- Projects
- Sales Orders
- Sales Order Lines
- Suppliers
- Tax Rates
- Transactions
- Vendor Credits
- Authentication
- Tenant Management
- User
Patch invoice
curl --request PATCH \
--url https://api.maesn.dev/accounting/invoices/{invoiceId} \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"name": "Invoice name",
"reference": "RCXF197253F",
"currency": "EUR",
"invoiceDate": "2021-01-01T00:00:00Z",
"status": "DRAFT",
"invoiceType": "STANDARD",
"oneLineAddress": "Main street 45, Berlin",
"addresses": [
{
"addressLine1": "Main street 45",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"countryCode": "DE",
"taxRule": "NET",
"taxText": "Tax 19 percent",
"lineItems": [
{
"accountCode": "1890",
"description": "SEOUL Guest Chair, red",
"discountItemPercentage": 10,
"grossAmount": 109,
"itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
"name": "RED CHAIR",
"quantity": 1,
"taxCode": "03",
"TaxRatePercentage": 19,
"taxType": "Tax 19 percent",
"type": "SERVICE",
"unitAmount": 100,
"unitName": "PIECE"
}
],
"discountPercentage": 10,
"shippingType": "SERVICE",
"shippingDate": "2021-01-01T00:00:00Z",
"shippingEndDate": "2021-01-10T00:00:00Z",
"lineAmountTypes": "EXCLUSIVE",
"dueDate": "2021-01-01T00:00:00Z",
"paidDate": "2021-01-01T00:00:00Z",
"paymentTermDuration": 30
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"invoiceId": "9714f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
"addresses": [
{
"addressLine1": "Main street 45",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"discountAmount": 10,
"dueDate": "2021-02-01T00:00:00Z",
"invoiceDate": "2021-01-01T00:00:00Z",
"invoiceNumber": "1020",
"invoiceType": "STANDARD",
"lineAmountType": "EXCLUSIVE",
"lineItems": [
{
"lineItemId": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
"createdDate": "2021-01-01T00:00:00Z",
"description": "SEOUL Guest Chair, red",
"discountItemAmount": 10,
"discountItemPercentage": 10,
"grossAmount": 109,
"itemsAmount": 100,
"itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
"name": "RED CHAIR",
"quantity": 1,
"taxCode": "03",
"taxRatePercentage": 19,
"unitAmount": 100,
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"name": "Office Supplies",
"oneLineAddress": "Main street 45, Berlin",
"paidDate": "2021-01-25T00:00:00Z",
"paymentStatus": "PENDING",
"paymentTermDuration": 30,
"reference": "RCXF197253F",
"shippingDate": "2021-01-01T00:00:00Z",
"status": "DRAFT",
"sumNetAmount": 100,
"taxRule": "NET",
"totalAmount": 109,
"totalTaxAmount": 19,
"updatedDate": "2021-01-01T00:00:00Z"
}
}
Field support per integration
If you’re not using the Interactive Authentication Flow, make sure the query parameters environmentName
and companyId
are correctly populated.
You can obtain these values by using the GET Environments
and GET Companies
endpoints available under the Authentication section.
Supported Request Parameters:
Available options: STANDARD
Available options (3-letter ISO 4217):
AED
, AFN
, ALL
, AMD
, ANG
, AOA
, ARS
, AUD
, AWG
, AZN
, BAM
, BBD
, BDT
, BGN
, BHD
, BIF
, BMD
, BND
, BOB
, BRL
, BSD
, BTN
, BWP
, BYR
, BZD
, CAD
, CDF
, CHF
, CLP
, CNY
, COP
, CRC
, CUC
, CVE
, CZK
, DJF
, DKK
, DOP
, DZD
, EEK
, EGP
, ERN
, ETB
, EUR
, FJD
, FKP
, GBP
, GEL
, GHS
, GIP
, GMD
, GNF
, GQE
, GTQ
, GYD
, HKD
, HNL
, HRK
, HTG
, HUF
, IDR
, ILS
, INR
, IQD
, IRR
, ISK
, JMD
, JOD
, JPY
, KES
, KGS
, KHR
, KMF
, KPW
, KRW
, KWD
, KYD
, KZT
, LAK
, LBP
, LKR
, LRD
, LSL
, LTL
, LVL
, LYD
, MAD
, MDL
, MGA
, MKD
, MMK
, MNT
, MOP
, MRO
, MUR
, MVR
, MWK
, MXN
, MYR
, MZM
, NAD
, NGN
, NIO
, NOK
, NPR
, NZD
, OMR
, PAB
, PEN
, PGK
, PHP
, PKR
, PLN
, PYG
, QAR
, RON
, RSD
, RUB
, SAR
, SBD
, SCR
, SDG
, SEK
, SGD
, SHP
, SLL
, SOS
, SRD
, SYP
, SZL
, THB
, TJS
, TMT
, TND
, TRY
, TTD
, TWD
, TZS
, UAH
, UGX
, USD
, UYU
, UZS
, VEB
, VND
, VUV
, WST
, XAF
, XCD
, XDR
, XOF
, XPF
, YER
, ZAR
, ZMK
, ZWR
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
ISO-8601 date format, e.g., 2024-01-01T00:00:00Z
Available options (ISO 3166-1 alpha-2):
AD
, AE
, AF
, AG
, AI
, AL
, AM
, AO
, AQ
, AR
, AS
, AT
, AU
, AW
, AX
, AZ
, BA
, BB
, BD
, BE
, BF
, BG
, BH
, BI
, BJ
, BL
, BM
, BN
, BO
, BQ
, BR
, BS
, BT
, BV
, BW
, BY
, BZ
, CA
, CC
, CD
, CF
, CG
, CH
, CI
, CK
, CL
, CM
, CN
, CO
, CR
, CU
, CV
, CW
, CX
, CY
, CZ
, DE
, DJ
, DK
, DM
, DO
, DZ
, EC
, EE
, EG
, EH
, ER
, ES
, ET
, FI
, FJ
, FK
, FM
, FO
, FR
, GA
, GB
, GD
, GE
, GF
, GG
, GH
, GI
, GL
, GM
, GN
, GP
, GQ
, GR
, GS
, GT
, GU
, GW
, GY
, HK
, HM
, HN
, HR
, HT
, HU
, ID
, IE
, IL
, IM
, IN
, IO
, IQ
, IR
, IS
, IT
, JE
, JM
, JO
, JP
, KE
, KG
, KH
, KI
, KM
, KN
, KP
, KR
, KW
, KY
, KZ
, LA
, LB
, LC
, LI
, LK
, LR
, LS
, LT
, LU
, LV
, LY
, MA
, MC
, MD
, ME
, MF
, MG
, MH
, MK
, ML
, MM
, MN
, MO
, MP
, MQ
, MR
, MS
, MT
, MU
, MV
, MW
, MX
, MY
, MZ
, NA
, NC
, NE
, NF
, NG
, NI
, NL
, NO
, NP
, NR
, NU
, NZ
, OM
, PA
, PE
, PF
, PG
, PH
, PK
, PL
, PM
, PN
, PR
, PT
, PW
, PY
, QA
, RE
, RO
, RS
, RU
, RW
, SA
, SB
, SC
, SD
, SE
, SG
, SH
, SI
, SJ
, SK
, SL
, SM
, SN
, SO
, SR
, SS
, ST
, SV
, SX
, SY
, SZ
, TC
, TD
, TF
, TG
, TH
, TJ
, TK
, TL
, TM
, TN
, TO
, TR
, TT
, TV
, TW
, TZ
, UA
, UG
, UM
, US
, UY
, UZ
, VA
, VC
, VE
, VG
, VI
, VN
, VU
, WF
, WS
, YE
, YT
, ZA
, ZM
, ZW
Available options: SELLING
, DELIVERY
Path Parameters
Body
Response
The response is of type object
.
Was this page helpful?
curl --request PATCH \
--url https://api.maesn.dev/accounting/invoices/{invoiceId} \
--header 'Content-Type: application/json' \
--header 'X-ACCOUNT-KEY: <x-account-key>' \
--header 'X-API-KEY: <x-api-key>' \
--data '{
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"name": "Invoice name",
"reference": "RCXF197253F",
"currency": "EUR",
"invoiceDate": "2021-01-01T00:00:00Z",
"status": "DRAFT",
"invoiceType": "STANDARD",
"oneLineAddress": "Main street 45, Berlin",
"addresses": [
{
"addressLine1": "Main street 45",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"countryCode": "DE",
"taxRule": "NET",
"taxText": "Tax 19 percent",
"lineItems": [
{
"accountCode": "1890",
"description": "SEOUL Guest Chair, red",
"discountItemPercentage": 10,
"grossAmount": 109,
"itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
"name": "RED CHAIR",
"quantity": 1,
"taxCode": "03",
"TaxRatePercentage": 19,
"taxType": "Tax 19 percent",
"type": "SERVICE",
"unitAmount": 100,
"unitName": "PIECE"
}
],
"discountPercentage": 10,
"shippingType": "SERVICE",
"shippingDate": "2021-01-01T00:00:00Z",
"shippingEndDate": "2021-01-10T00:00:00Z",
"lineAmountTypes": "EXCLUSIVE",
"dueDate": "2021-01-01T00:00:00Z",
"paidDate": "2021-01-01T00:00:00Z",
"paymentTermDuration": 30
}'
{
"meta": {
"warnings": [
"Field not used by target system"
],
"pagination": {
"total": 123,
"perPage": 123,
"currentPage": 123,
"totalPages": 123
}
},
"data": {
"invoiceId": "9714f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
"addresses": [
{
"addressLine1": "Main street 45",
"addressLine2": "2nd floor",
"city": "Berlin",
"countryCode": "DE",
"postalCode": "10243",
"type": "BILLING"
}
],
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"createdDate": "2021-01-01T00:00:00Z",
"currency": "EUR",
"discountAmount": 10,
"dueDate": "2021-02-01T00:00:00Z",
"invoiceDate": "2021-01-01T00:00:00Z",
"invoiceNumber": "1020",
"invoiceType": "STANDARD",
"lineAmountType": "EXCLUSIVE",
"lineItems": [
{
"lineItemId": "987a2b3c-4d5e-6f7g-8h9i-0j1k2l3m4n5o",
"createdDate": "2021-01-01T00:00:00Z",
"description": "SEOUL Guest Chair, red",
"discountItemAmount": 10,
"discountItemPercentage": 10,
"grossAmount": 109,
"itemsAmount": 100,
"itemId": "9fc4f3a2-5b8e-4d1b-8a0c-9f6e7d2f3e4b",
"name": "RED CHAIR",
"quantity": 1,
"taxCode": "03",
"taxRatePercentage": 19,
"unitAmount": 100,
"updatedDate": "2021-01-01T00:00:00Z"
}
],
"name": "Office Supplies",
"oneLineAddress": "Main street 45, Berlin",
"paidDate": "2021-01-25T00:00:00Z",
"paymentStatus": "PENDING",
"paymentTermDuration": 30,
"reference": "RCXF197253F",
"shippingDate": "2021-01-01T00:00:00Z",
"status": "DRAFT",
"sumNetAmount": 100,
"taxRule": "NET",
"totalAmount": 109,
"totalTaxAmount": 19,
"updatedDate": "2021-01-01T00:00:00Z"
}
}