API documentation
User
Tenant
Feature
Entitlement
User & permissions
Settings
- Settings
- Media
- Webhook
- Notification
Payment
- Payment Method
- Transaction
- SEPA XML
- Open Banking
- Bank Account Transaction
Customer
- Customer
- Customer Address
- Customer Email
- Customer Settings
- Customer Otp
Billing
- Invoice
- GETGet invoices
- POSTCreate draft invoice
- GETGet invoice
- PUTUpdate draft invoice
- DELDelete invoice
- POSTCancel invoice
- POSTCredit invoice
- POSTSet invoice customer address
- PUTToggle dunning
- POSTDuplicate invoice
- POSTFinalize invoice
- PUTSet invoice note
- POSTSet invoice payment method
- POSTAdd invoice payment
- POSTAdd invoice position items
- GETGet invoice preview
- PUTResend invoice
- PUTGet invoice download link
- PUTClose invoice
- POSTAdd comment
- GET
- Invoice Position Item
- Billing Run
Dunning
- Dunning Document
- Dunning Rule
Subscription
- Subscription
- Subscription Item
- Subscription Measurement
- Billing Group
Offers
- Offer
- Offer Recipient
- Offer Template
Catalogue
- Unit
- Measurement
- Product
- Product Family
- Price Plan
- Coupon
Checkout
- Checkout Link
- Cart
Accounting
Add invoice position items
Add invoice position items to the invoice. This is only possible if the invoice is in status draft or new. This is available for invoices only.
Required permissions:invoice:writeAuthorizations
Value for the Authorization header parameter.
Path Parameters
Invoice identifier
Body
The name of the position item.
1 - 255The tax group ID of the position item.
The unit ID of the position item.
The unit price as net amount. It is only allowed to use dots as seperator.
The children of the position item.
The name of the position item.
1 - 255The tax group ID of the position item.
The unit ID of the position item.
The unit price as net amount. It is only allowed to use dots as seperator.
The children of the position item.
The name of the position item.
1 - 255The tax group ID of the position item.
The unit ID of the position item.
The unit price as net amount. It is only allowed to use dots as seperator.
The children of the position item.
The name of the position item.
1 - 255The tax group ID of the position item.
The unit ID of the position item.
The unit price as net amount. It is only allowed to use dots as seperator.
The children of the position item.
The name of the position item.
1 - 255The tax group ID of the position item.
The unit ID of the position item.
The unit price as net amount. It is only allowed to use dots as seperator.
The children of the position item.
The currency code of the position item. If not set, the currency code of the invoice will be used.
The description of the position item.
1 - 10000The discount amount as net amount needs to be null or a positive money value. This will be subtracted from the unit price amount of the position item (unit price).
The discount percentage needs to be null or a positive value. This will be subtracted from the unit price amount of the position item (unit price).
0 < x < 100The ID of the position item.
The position of the position item. If not set, it will be set automatically. The position is used to sort the position items in the invoice.
The product of the position item. This is used to have access to statistics also on manual created invoices.
The quantity of the position item. This can be positive or negative.
The service date from of the position item. If not set, it is null and will not be printed.
The service date to of the position item. If not set, it is null and will not be printed.
The subscription item of the position item.
The unit price interval of the position item. If not set, it is null and will not be printed.
The currency code of the position item. If not set, the currency code of the invoice will be used.
The description of the position item.
1 - 10000The discount amount as net amount needs to be null or a positive money value. This will be subtracted from the unit price amount of the position item (unit price).
The discount percentage needs to be null or a positive value. This will be subtracted from the unit price amount of the position item (unit price).
0 < x < 100The ID of the position item.
The position of the position item. If not set, it will be set automatically. The position is used to sort the position items in the invoice.
The product of the position item. This is used to have access to statistics also on manual created invoices.
The quantity of the position item. This can be positive or negative.
The service date from of the position item. If not set, it is null and will not be printed.
The service date to of the position item. If not set, it is null and will not be printed.
The subscription item of the position item.
The unit price interval of the position item. If not set, it is null and will not be printed.
The currency code of the position item. If not set, the currency code of the invoice will be used.
The description of the position item.
1 - 10000The discount amount as net amount needs to be null or a positive money value. This will be subtracted from the unit price amount of the position item (unit price).
The discount percentage needs to be null or a positive value. This will be subtracted from the unit price amount of the position item (unit price).
0 < x < 100The ID of the position item.
The position of the position item. If not set, it will be set automatically. The position is used to sort the position items in the invoice.
The product of the position item. This is used to have access to statistics also on manual created invoices.
The quantity of the position item. This can be positive or negative.
The service date from of the position item. If not set, it is null and will not be printed.
The service date to of the position item. If not set, it is null and will not be printed.
The subscription item of the position item.
The unit price interval of the position item. If not set, it is null and will not be printed.
The currency code of the position item. If not set, the currency code of the invoice will be used.
The description of the position item.
1 - 10000The discount amount as net amount needs to be null or a positive money value. This will be subtracted from the unit price amount of the position item (unit price).
The discount percentage needs to be null or a positive value. This will be subtracted from the unit price amount of the position item (unit price).
0 < x < 100The ID of the position item.
The position of the position item. If not set, it will be set automatically. The position is used to sort the position items in the invoice.
The product of the position item. This is used to have access to statistics also on manual created invoices.
The quantity of the position item. This can be positive or negative.
The service date from of the position item. If not set, it is null and will not be printed.
The service date to of the position item. If not set, it is null and will not be printed.
The subscription item of the position item.
The unit price interval of the position item. If not set, it is null and will not be printed.
The currency code of the position item. If not set, the currency code of the invoice will be used.
The description of the position item.
1 - 10000The discount amount as net amount needs to be null or a positive money value. This will be subtracted from the unit price amount of the position item (unit price).
The discount percentage needs to be null or a positive value. This will be subtracted from the unit price amount of the position item (unit price).
0 < x < 100The ID of the position item.
The position of the position item. If not set, it will be set automatically. The position is used to sort the position items in the invoice.
The product of the position item. This is used to have access to statistics also on manual created invoices.
The quantity of the position item. This can be positive or negative.
The service date from of the position item. If not set, it is null and will not be printed.
The service date to of the position item. If not set, it is null and will not be printed.
The subscription item of the position item.
The unit price interval of the position item. If not set, it is null and will not be printed.
Response
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
The customer of the invoice.
2 - 255Can be empty. In this case the default currency of the tenant is used.
2 - 255The ID of the customer in DATEV
2 - 255Can be empty if the customer is a company.
2 - 255Can be empty if the customer is a company.
2 - 255STATUS_ACTIVE, STATUS_ARCHIVED, STATUS_SUSPENDED Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The total net discount amount of the invoice.
Dunning is disabled for this invoice.
reminder, dunning, none The einvoice generated xml file format.
The date and time when the media was created
The file extension of the media
The original file name of the media
Whether the media is public accessible or not
The mime type of the media
The file name of the media in the storage
The unique identifier of the invoice.
The notice of the invoice.
The invoice address of the invoice.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
The net amount of the invoice.
The document id of the invoice. This will be generated, when the invoice will be finalized.
The payment method which should be used to fullfill the payment of the invoice.
The card data of the payment method, if the type is "card"
The brand of the card
The card holder name
The expiration month of the card
The expiration year of the card
The last 4 digits of the card
wallet, sepa_debit, stripe, fake_provider, paypal, bank_transfer, go_cardless, testing The sepa mandate data of the payment method, if the type is "sepa_debit"
The sepa mandate of the payment method, if the gatewayName is "payment_sepa"
checkout, customerfront, api, add_link active, action_required, expired, revoked, gateway_unconfigured sepa_debit, card, paypal, bank_transfer, wallet, fake_provider The positions of the invoice.
The creation date of the invoice position item.
The description of the invoice position item.
The discount amount of the invoice position item.
The fixed applied discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
The gross amount of the invoice position item, after discount.
The description of the invoice position item.
The net amount of the invoice position item, before discount.
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The creation date of the invoice position item.
The description of the invoice position item.
The discount amount of the invoice position item.
The fixed applied discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
The gross amount of the invoice position item, after discount.
The description of the invoice position item.
The net amount of the invoice position item, before discount.
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The creation date of the invoice position item.
The description of the invoice position item.
The discount amount of the invoice position item.
The fixed applied discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
The gross amount of the invoice position item, after discount.
The description of the invoice position item.
The net amount of the invoice position item, before discount.
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The creation date of the invoice position item.
The description of the invoice position item.
The discount amount of the invoice position item.
The fixed applied discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
The gross amount of the invoice position item, after discount.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The description of the invoice position item.
The net amount of the invoice position item, before discount.
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
The tax of the invoice position item, calculated based on the tax group.
The tax amount of the invoice position item, after discount.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The unit of the invoice position item.
The unit price of the invoice position item.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The quantity of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The tax of the invoice position item, calculated based on the tax group.
The tax amount of the invoice position item, after discount.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The name of the tax group which will be displayed only in the UI
255Defines if reverse charge will be applicated or not
REVERSE_CHARGE_DEACTIVATED, REVERSE_CHARGE, REVERSE_CHARGE_INTRA_EU_SUPPLY standard, reduced The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The unit price of the invoice position item.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The quantity of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The tax of the invoice position item, calculated based on the tax group.
The tax amount of the invoice position item, after discount.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The name of the tax group which will be displayed only in the UI
255Defines if reverse charge will be applicated or not
REVERSE_CHARGE_DEACTIVATED, REVERSE_CHARGE, REVERSE_CHARGE_INTRA_EU_SUPPLY standard, reduced The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The unit price of the invoice position item.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The quantity of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The tax of the invoice position item, calculated based on the tax group.
The tax amount of the invoice position item, after discount.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The name of the tax group which will be displayed only in the UI
255Defines if reverse charge will be applicated or not
REVERSE_CHARGE_DEACTIVATED, REVERSE_CHARGE, REVERSE_CHARGE_INTRA_EU_SUPPLY standard, reduced The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The unit price of the invoice position item.
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The applicated exchange rates of the invoice, fetched from the european central bank.
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
The customer of the invoice.
2 - 255Can be empty. In this case the default currency of the tenant is used.
2 - 255The ID of the customer in DATEV
2 - 255Can be empty if the customer is a company.
2 - 255Can be empty if the customer is a company.
2 - 255STATUS_ACTIVE, STATUS_ARCHIVED, STATUS_SUSPENDED Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The total net discount amount of the invoice.
Dunning is disabled for this invoice.
reminder, dunning, none The einvoice generated xml file format.
The date and time when the media was created
The file extension of the media
The original file name of the media
Whether the media is public accessible or not
The mime type of the media
The file name of the media in the storage
The unique identifier of the invoice.
The notice of the invoice.
The invoice address of the invoice.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
The net amount of the invoice.
The document id of the invoice. This will be generated, when the invoice will be finalized.
The payment method which should be used to fullfill the payment of the invoice.
The card data of the payment method, if the type is "card"
The brand of the card
The card holder name
The expiration month of the card
The expiration year of the card
The last 4 digits of the card
wallet, sepa_debit, stripe, fake_provider, paypal, bank_transfer, go_cardless, testing The sepa mandate data of the payment method, if the type is "sepa_debit"
The bic of the sepa mandate
The iban of the sepa mandate
The mandate reference of the sepa mandate
The signing date of the sepa mandate
The sepa mandate of the payment method, if the gatewayName is "payment_sepa"
checkout, customerfront, api, add_link active, action_required, expired, revoked, gateway_unconfigured sepa_debit, card, paypal, bank_transfer, wallet, fake_provider The positions of the invoice.
The creation date of the invoice position item.
The description of the invoice position item.
The discount amount of the invoice position item.
The fixed applied discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
The gross amount of the invoice position item, after discount.
The description of the invoice position item.
The net amount of the invoice position item, before discount.
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The creation date of the invoice position item.
The description of the invoice position item.
The discount amount of the invoice position item.
The fixed applied discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
The gross amount of the invoice position item, after discount.
The description of the invoice position item.
The net amount of the invoice position item, before discount.
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The creation date of the invoice position item.
The description of the invoice position item.
The discount amount of the invoice position item.
The fixed applied discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
The gross amount of the invoice position item, after discount.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The description of the invoice position item.
The net amount of the invoice position item, before discount.
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
The tax of the invoice position item, calculated based on the tax group.
The tax amount of the invoice position item, after discount.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The unit of the invoice position item.
The unit price of the invoice position item.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The quantity of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The tax of the invoice position item, calculated based on the tax group.
Some internal code
Tax rate in percent
0 < x < 100Some internal description
255The tax amount of the invoice position item, after discount.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The name of the tax group which will be displayed only in the UI
255Defines if reverse charge will be applicated or not
REVERSE_CHARGE_DEACTIVATED, REVERSE_CHARGE, REVERSE_CHARGE_INTRA_EU_SUPPLY standard, reduced The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The unit price of the invoice position item.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The quantity of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The tax of the invoice position item, calculated based on the tax group.
Some internal code
Tax rate in percent
0 < x < 100Some internal description
255The tax amount of the invoice position item, after discount.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The name of the tax group which will be displayed only in the UI
255Defines if reverse charge will be applicated or not
REVERSE_CHARGE_DEACTIVATED, REVERSE_CHARGE, REVERSE_CHARGE_INTRA_EU_SUPPLY standard, reduced The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The unit price of the invoice position item.
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The applicated exchange rates of the invoice, fetched from the european central bank.
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
The customer of the invoice.
2 - 255Can be empty. In this case the default currency of the tenant is used.
2 - 255The ID of the customer in DATEV
2 - 255Can be empty if the customer is a company.
2 - 255Can be empty if the customer is a company.
2 - 255STATUS_ACTIVE, STATUS_ARCHIVED, STATUS_SUSPENDED Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The total net discount amount of the invoice.
Dunning is disabled for this invoice.
reminder, dunning, none The einvoice generated xml file format.
The date and time when the media was created
The file extension of the media
The original file name of the media
Whether the media is public accessible or not
The mime type of the media
The file name of the media in the storage
The unique identifier of the invoice.
The notice of the invoice.
The invoice address of the invoice.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
The net amount of the invoice.
The document id of the invoice. This will be generated, when the invoice will be finalized.
The payment method which should be used to fullfill the payment of the invoice.
The card data of the payment method, if the type is "card"
The brand of the card
The card holder name
The expiration month of the card
The expiration year of the card
The last 4 digits of the card
wallet, sepa_debit, stripe, fake_provider, paypal, bank_transfer, go_cardless, testing The sepa mandate data of the payment method, if the type is "sepa_debit"
The bic of the sepa mandate
The iban of the sepa mandate
The mandate reference of the sepa mandate
The signing date of the sepa mandate
The sepa mandate of the payment method, if the gatewayName is "payment_sepa"
checkout, customerfront, api, add_link active, action_required, expired, revoked, gateway_unconfigured sepa_debit, card, paypal, bank_transfer, wallet, fake_provider The positions of the invoice.
The creation date of the invoice position item.
The description of the invoice position item.
The discount amount of the invoice position item.
The fixed applied discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
The gross amount of the invoice position item, after discount.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The description of the invoice position item.
The net amount of the invoice position item, before discount.
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The creation date of the invoice position item.
The description of the invoice position item.
The discount amount of the invoice position item.
The fixed applied discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
The gross amount of the invoice position item, after discount.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The description of the invoice position item.
The net amount of the invoice position item, before discount.
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
The tax of the invoice position item, calculated based on the tax group.
The tax amount of the invoice position item, after discount.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The unit of the invoice position item.
The unit price of the invoice position item.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The type of the product.
product: recurring billed productcharge: one-time billingplan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.
product, charge, plan Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The description of the product based on the current tenant language.
The unique identifier of the product.
Defines when the product should be displayed in the invoice.
always: The product is always displayed in the invoice.only_if_charged: The product is only displayed in the invoice if it is charged.
always, only_if_charged The name of the product based on the current tenant language. This will be displayed on customer communication.
The quantity of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
The description of the item which will be used in the invoice. The description is translated based on the customer's locale.
Further information defines additional information for the item which will be displayed in the invoice.
The name of the item which will be used in the invoice. The name is translated based on the customer's locale.
The status of the item.
Possible values:
active: The item is active and will be billed.canceled: The item is canceled and will be billed until the end of the contract.pending: The item is pending and will be billed after the contract start.terminated: The item is terminated and will not be billed.
active, canceled, pending, terminated The tax of the invoice position item, calculated based on the tax group.
Some internal code
Tax rate in percent
0 < x < 100Some internal description
255The tax amount of the invoice position item, after discount.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The name of the tax group which will be displayed only in the UI
255Defines if reverse charge will be applicated or not
REVERSE_CHARGE_DEACTIVATED, REVERSE_CHARGE, REVERSE_CHARGE_INTRA_EU_SUPPLY standard, reduced The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The unit price of the invoice position item.
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The applicated exchange rates of the invoice, fetched from the european central bank.
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
The customer of the invoice.
2 - 255Can be empty. In this case the default currency of the tenant is used.
2 - 255The ID of the customer in DATEV
2 - 255Can be empty if the customer is a company.
2 - 255Can be empty if the customer is a company.
2 - 255STATUS_ACTIVE, STATUS_ARCHIVED, STATUS_SUSPENDED Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The total net discount amount of the invoice.
Dunning is disabled for this invoice.
reminder, dunning, none The einvoice generated xml file format.
The date and time when the media was created
The file extension of the media
The original file name of the media
Whether the media is public accessible or not
The mime type of the media
The file name of the media in the storage
The unique identifier of the invoice.
The notice of the invoice.
The invoice address of the invoice.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
The net amount of the invoice.
The document id of the invoice. This will be generated, when the invoice will be finalized.
The payment method which should be used to fullfill the payment of the invoice.
The card data of the payment method, if the type is "card"
wallet, sepa_debit, stripe, fake_provider, paypal, bank_transfer, go_cardless, testing The paypal data of the payment method, if the type is "paypal"
The sepa mandate data of the payment method, if the type is "sepa_debit"
The sepa mandate of the payment method, if the gatewayName is "payment_sepa"
checkout, customerfront, api, add_link active, action_required, expired, revoked, gateway_unconfigured sepa_debit, card, paypal, bank_transfer, wallet, fake_provider The positions of the invoice.
The creation date of the invoice position item.
The description of the invoice position item.
The discount amount of the invoice position item.
The fixed applied discount amount of the invoice position item.
The discount percentage of the invoice position item. You can either define an amount or a percentage.
The gross amount of the invoice position item, after discount.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The description of the invoice position item.
The net amount of the invoice position item, before discount.
The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The position of the invoice position item in the invoice. If 0, the item will be added at the end of the invoice.
The quantity of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
The tax of the invoice position item, calculated based on the tax group.
The tax amount of the invoice position item, after discount.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The unit of the invoice position item.
The unit price of the invoice position item.
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The applicated exchange rates of the invoice, fetched from the european central bank.
The referenced cancellation document.
The currency code of the invoice. If multiple currency codes will be used in the positions, they will be converted to that base currency.
The customer of the invoice.
Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide
The total net discount amount of the invoice.
Dunning is disabled for this invoice.
reminder, dunning, none The einvoice generated xml file format.
The unique identifier of the invoice.
The notice of the invoice.
The invoice address of the invoice.
The leitwegid used for einvoice. This is only set, when the eInvoiceType is not null.
The net amount of the invoice.
The document id of the invoice. This will be generated, when the invoice will be finalized.
The payment method which should be used to fullfill the payment of the invoice.
The positions of the invoice.
The referenced invoice of the invoice. This could be in case of a reminder, refund etc.
The earliest service date of all positions.
The latest service date of all positions.
Where the invoice was created from.
Possible values:
cart: The invoice was created from a cart.subscription: The invoice was created from a subscription billing run.manual: The invoice was created by a user.
STATUS_DRAFT, STATUS_PAID, STATUS_CANCELLED, STATUS_CLOSED, STATUS_REFUNDED, STATUS_REMINDED, STATUS_UNPAID, STATUS_NEW, STATUS_FINALIZING The type of the invoice.
TYPE_INVOICE, TYPE_CREDIT, TYPE_REFUND, TYPE_REMINDER, TYPE_CANCEL, TYPE_DUNNING Public url to view the detailed usage breakdown of this invoice.
The xml representation of the invoice in EN16931 or x-Rechnung format.
The earliest service date of all positions.
The latest service date of all positions.
Where the invoice was created from.
Possible values:
cart: The invoice was created from a cart.subscription: The invoice was created from a subscription billing run.manual: The invoice was created by a user.
STATUS_DRAFT, STATUS_PAID, STATUS_CANCELLED, STATUS_CLOSED, STATUS_REFUNDED, STATUS_REMINDED, STATUS_UNPAID, STATUS_NEW, STATUS_FINALIZING The type of the invoice.
TYPE_INVOICE, TYPE_CREDIT, TYPE_REFUND, TYPE_REMINDER, TYPE_CANCEL, TYPE_DUNNING Public url to view the detailed usage breakdown of this invoice.
The xml representation of the invoice in EN16931 or x-Rechnung format.
The date and time when the media was created
The file extension of the media
The original file name of the media
Whether the media is public accessible or not
The mime type of the media
The file name of the media in the storage
The earliest service date of all positions.
The latest service date of all positions.
Where the invoice was created from.
Possible values:
cart: The invoice was created from a cart.subscription: The invoice was created from a subscription billing run.manual: The invoice was created by a user.
STATUS_DRAFT, STATUS_PAID, STATUS_CANCELLED, STATUS_CLOSED, STATUS_REFUNDED, STATUS_REMINDED, STATUS_UNPAID, STATUS_NEW, STATUS_FINALIZING The type of the invoice.
TYPE_INVOICE, TYPE_CREDIT, TYPE_REFUND, TYPE_REMINDER, TYPE_CANCEL, TYPE_DUNNING Public url to view the detailed usage breakdown of this invoice.
The xml representation of the invoice in EN16931 or x-Rechnung format.
The date and time when the media was created
The file extension of the media
The original file name of the media
Whether the media is public accessible or not
The mime type of the media
The file name of the media in the storage
The earliest service date of all positions.
The latest service date of all positions.
Where the invoice was created from.
Possible values:
cart: The invoice was created from a cart.subscription: The invoice was created from a subscription billing run.manual: The invoice was created by a user.
STATUS_DRAFT, STATUS_PAID, STATUS_CANCELLED, STATUS_CLOSED, STATUS_REFUNDED, STATUS_REMINDED, STATUS_UNPAID, STATUS_NEW, STATUS_FINALIZING The type of the invoice.
TYPE_INVOICE, TYPE_CREDIT, TYPE_REFUND, TYPE_REMINDER, TYPE_CANCEL, TYPE_DUNNING Public url to view the detailed usage breakdown of this invoice.
The xml representation of the invoice in EN16931 or x-Rechnung format.
The date and time when the media was created
The file extension of the media
The original file name of the media
Whether the media is public accessible or not
The mime type of the media
The file name of the media in the storage
The earliest service date of all positions.
The latest service date of all positions.
Where the invoice was created from.
Possible values:
cart: The invoice was created from a cart.subscription: The invoice was created from a subscription billing run.manual: The invoice was created by a user.
STATUS_DRAFT, STATUS_PAID, STATUS_CANCELLED, STATUS_CLOSED, STATUS_REFUNDED, STATUS_REMINDED, STATUS_UNPAID, STATUS_NEW, STATUS_FINALIZING The type of the invoice.
TYPE_INVOICE, TYPE_CREDIT, TYPE_REFUND, TYPE_REMINDER, TYPE_CANCEL, TYPE_DUNNING Public url to view the detailed usage breakdown of this invoice.
The xml representation of the invoice in EN16931 or x-Rechnung format.
The date and time when the media was created
The file extension of the media
The original file name of the media
Whether the media is public accessible or not
The mime type of the media
The file name of the media in the storage
Was this page helpful?