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
- 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
Get an invoice position item
Get an invoice position item.
Required permissions:invoice:readcurl -X GET \
/invoice-position-items/{id} \
--header "Authorization: Bearer <token>"{
"id": {},
"position": 123,
"quantity": 1,
"unit": {
"id": {},
"name": "Stück"
},
"unitPrice": {},
"netAmount": {},
"grossAmount": {},
"taxAmount": {},
"discountAmount": {},
"discountPercentage": 10,
"name": "My subscription product",
"description": "* my subscription product",
"taxGroup": {
"id": "00000000-0000-0000-0000-000000000000",
"internalDescription": "19%",
"reverseChargeType": "REVERSE_CHARGE",
"type": "standard"
},
"tax": {
"id": "00000000-0000-0000-0000-000000000000",
"description": "19%",
"code": "19",
"rate": 19
},
"type": "product",
"parent": {},
"group": {
"id": "ad8a3b9e-5b0a-4e1a-9c1a-0b9b2b8b0b0b",
"ranking": 1,
"name": "Subscription #12345"
},
"createdAt": "2020-01-01T00:00:00+00:00",
"product": {
"id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
"name": "Basic",
"description": "For small teams.",
"type": "product",
"invoiceVisibility": "always",
"customFields": {
"field1": "value1",
"field2": "value2"
}
},
"subscriptionItem": {
"id": "01F9ZQZJZJQZJZJZJZJZJZJZJZ",
"name": "Fitness M",
"description": "Everything included",
"furtherInformation": "Additional agreements: The contract includes a free drink flatrate.",
"status": "active",
"subscriptionId": "<string>"
},
"serviceDateFrom": "2020-01-01T00:00:00+00:00",
"serviceDateTo": "2020-01-01T00:00:00+00:00",
"isCreditable": true,
"isFullyCredited": true,
"creditableQuantity": 1
}Authorizations
Value for the Authorization header parameter.
Path Parameters
InvoicePositionItem identifier
Response
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 unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The 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 fixed applied discount amount of the invoice position item.
The description of the invoice position item.
The description of the invoice position item.
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 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 unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The 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 fixed applied discount amount of the invoice position item.
The description of the invoice position item.
The description of the invoice position item.
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 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 unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The 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 fixed applied discount amount of the invoice position item.
The description of the invoice position item.
The description of the invoice position item.
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 tax of the invoice position item, calculated based on the tax group.
The type of the invoice position item.
product, discount, setup, dunning_fee, invoice 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 unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The 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 fixed applied discount amount of the invoice position item.
The description of the invoice position item.
The description of the invoice position item.
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 tax of the invoice position item, calculated based on the tax group.
The type of the invoice position item.
product, discount, setup, dunning_fee, invoice 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 unit of the invoice position item.
The unit price of the invoice position item.
The net amount of the invoice position item, before discount.
The gross amount of the invoice position item, after discount.
The tax amount of the invoice position item, after discount.
The 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 fixed applied discount amount of the invoice position item.
The description of the invoice position item.
The description of the invoice position item.
The tax group of the invoice position item. Based on the customer and tax group, the correct tax rate will be calculated.
The tax of the invoice position item, calculated based on the tax group.
The type of the invoice position item.
product, discount, setup, dunning_fee, invoice The parent invoice position item. Positions can be defined in a tree, with a maximum depth of two.
The invoice position item group. Positions can be grouped together with a headline, which is shown on the invoice.
The creation date of the invoice position item.
The service date from of the invoice position item.
The service date to of the invoice position item.
If the position can be credited.
If the whole position is credited.
The quantity that can be credited.
The creation date of the invoice position item.
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 The unique identifier of the product.
The name of the product based on the current tenant language. This will be displayed on customer communication.
The description of the product based on the current tenant language.
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 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 name of the item which will be used in the invoice. The name is translated based on the customer's locale.
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 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 service date from of the invoice position item.
The service date to of the invoice position item.
If the position can be credited.
If the whole position is credited.
The quantity that can be credited.
The creation date of the invoice position item.
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 The unique identifier of the product.
The name of the product based on the current tenant language. This will be displayed on customer communication.
The description of the product based on the current tenant language.
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 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 name of the item which will be used in the invoice. The name is translated based on the customer's locale.
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 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 service date from of the invoice position item.
The service date to of the invoice position item.
If the position can be credited.
If the whole position is credited.
The quantity that can be credited.
The creation date of the invoice position item.
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 The unique identifier of the product.
The name of the product based on the current tenant language. This will be displayed on customer communication.
The description of the product based on the current tenant language.
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 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 name of the item which will be used in the invoice. The name is translated based on the customer's locale.
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 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 service date from of the invoice position item.
The service date to of the invoice position item.
If the position can be credited.
If the whole position is credited.
The quantity that can be credited.
The creation date of the invoice position item.
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 The unique identifier of the product.
The name of the product based on the current tenant language. This will be displayed on customer communication.
The description of the product based on the current tenant language.
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 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 name of the item which will be used in the invoice. The name is translated based on the customer's locale.
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 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 service date from of the invoice position item.
The service date to of the invoice position item.
If the position can be credited.
If the whole position is credited.
The quantity that can be credited.
Was this page helpful?
curl -X GET \
/invoice-position-items/{id} \
--header "Authorization: Bearer <token>"{
"id": {},
"position": 123,
"quantity": 1,
"unit": {
"id": {},
"name": "Stück"
},
"unitPrice": {},
"netAmount": {},
"grossAmount": {},
"taxAmount": {},
"discountAmount": {},
"discountPercentage": 10,
"name": "My subscription product",
"description": "* my subscription product",
"taxGroup": {
"id": "00000000-0000-0000-0000-000000000000",
"internalDescription": "19%",
"reverseChargeType": "REVERSE_CHARGE",
"type": "standard"
},
"tax": {
"id": "00000000-0000-0000-0000-000000000000",
"description": "19%",
"code": "19",
"rate": 19
},
"type": "product",
"parent": {},
"group": {
"id": "ad8a3b9e-5b0a-4e1a-9c1a-0b9b2b8b0b0b",
"ranking": 1,
"name": "Subscription #12345"
},
"createdAt": "2020-01-01T00:00:00+00:00",
"product": {
"id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
"name": "Basic",
"description": "For small teams.",
"type": "product",
"invoiceVisibility": "always",
"customFields": {
"field1": "value1",
"field2": "value2"
}
},
"subscriptionItem": {
"id": "01F9ZQZJZJQZJZJZJZJZJZJZJZ",
"name": "Fitness M",
"description": "Everything included",
"furtherInformation": "Additional agreements: The contract includes a free drink flatrate.",
"status": "active",
"subscriptionId": "<string>"
},
"serviceDateFrom": "2020-01-01T00:00:00+00:00",
"serviceDateTo": "2020-01-01T00:00:00+00:00",
"isCreditable": true,
"isFullyCredited": true,
"creditableQuantity": 1
}