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": "REF-12345",
"currency": "EUR",
"invoiceDate": "2021-01-01T00:00:00Z",
"status": "DRAFT",
"invoiceType": "STANDARD",
"oneLineAddress": "Main street 45, Berlin",
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"countryCode": "DE",
"taxRule": "NET",
"taxText": "tax description",
"lineItems": [
{
"lineItemId": "1",
"itemId": "Item id",
"name": "Line item name",
"quantity": 1,
"type": "SERVICE",
"description": "Line item description",
"unitName": "Unit name",
"unitAmount": 100,
"grossAmount": 119,
"taxCode": "tax code",
"TaxRatePercentage": 19,
"taxType": "Tax type",
"accountCode": "Account code",
"discountItemPercentage": 10
}
],
"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": "ABC123",
"invoiceNumber": "1",
"name": "Invoice name",
"reference": "REF-12345",
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"currency": "EUR",
"status": "DRAFT",
"invoiceType": "STANDARD",
"updatedDate": "2021-01-01T00:00:00Z",
"invoiceDate": "2021-01-01T00:00:00Z",
"dueDate": "2021-01-01T00:00:00Z",
"paidDate": "2021-01-01T00:00:00Z",
"shippingDate": "2021-01-01T00:00:00Z",
"createdDate": "2021-01-01T00:00:00Z",
"paymentTermDuration": 30,
"oneLineAddress": "Main street 45, Berlin",
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"discountAmount": 10,
"totalTaxAmount": 19,
"sumNetAmount": 100,
"totalAmount": 109,
"paymentStatus": "PENDING",
"taxRule": "NET",
"lineAmountType": "EXCLUSIVE",
"lineItems": [
{
"lineItemId": "1",
"itemId": "item id",
"name": "Line item name",
"updatedDate": "2021-01-01T00:00:00Z",
"createdDate": "2021-01-01T00:00:00Z",
"quantity": 1,
"taxRatePercentage": 19,
"unitAmount": 100,
"grossAmount": 119,
"taxCode": "tax code",
"itemsAmount": 100,
"discountItemAmount": 10,
"discountItemPercentage": 10,
"description": "Line item description"
}
]
}
}
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": "REF-12345",
"currency": "EUR",
"invoiceDate": "2021-01-01T00:00:00Z",
"status": "DRAFT",
"invoiceType": "STANDARD",
"oneLineAddress": "Main street 45, Berlin",
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"countryCode": "DE",
"taxRule": "NET",
"taxText": "tax description",
"lineItems": [
{
"lineItemId": "1",
"itemId": "Item id",
"name": "Line item name",
"quantity": 1,
"type": "SERVICE",
"description": "Line item description",
"unitName": "Unit name",
"unitAmount": 100,
"grossAmount": 119,
"taxCode": "tax code",
"TaxRatePercentage": 19,
"taxType": "Tax type",
"accountCode": "Account code",
"discountItemPercentage": 10
}
],
"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": "ABC123",
"invoiceNumber": "1",
"name": "Invoice name",
"reference": "REF-12345",
"contactId": "eaa28f49-6028-4b6e-bb12-d8f6278073fc",
"currency": "EUR",
"status": "DRAFT",
"invoiceType": "STANDARD",
"updatedDate": "2021-01-01T00:00:00Z",
"invoiceDate": "2021-01-01T00:00:00Z",
"dueDate": "2021-01-01T00:00:00Z",
"paidDate": "2021-01-01T00:00:00Z",
"shippingDate": "2021-01-01T00:00:00Z",
"createdDate": "2021-01-01T00:00:00Z",
"paymentTermDuration": 30,
"oneLineAddress": "Main street 45, Berlin",
"addresses": [
{
"addressLine1": "Street",
"addressLine2": "Building",
"city": "City",
"postalCode": "12345",
"countryCode": "DE",
"type": "BILLING"
}
],
"discountAmount": 10,
"totalTaxAmount": 19,
"sumNetAmount": 100,
"totalAmount": 109,
"paymentStatus": "PENDING",
"taxRule": "NET",
"lineAmountType": "EXCLUSIVE",
"lineItems": [
{
"lineItemId": "1",
"itemId": "item id",
"name": "Line item name",
"updatedDate": "2021-01-01T00:00:00Z",
"createdDate": "2021-01-01T00:00:00Z",
"quantity": 1,
"taxRatePercentage": 19,
"unitAmount": 100,
"grossAmount": 119,
"taxCode": "tax code",
"itemsAmount": 100,
"discountItemAmount": 10,
"discountItemPercentage": 10,
"description": "Line item description"
}
]
}
}