PUT
/
invoice-position-items
/
{id}
curl -X PUT \
 /invoice-position-items/{id} \
 --header "Content-Type: application/json" \
 --header "Authorization: Bearer <token>" \
 --data '{
    "id": "12345678-1234-1234-1234-123456789012",
    "position": "1",
    "description": "This is a product.",
    "quantity": "1",
    "currencyCode": "EUR",
    "taxGroupId": "12345678-1234-1234-1234-123456789012",
    "serviceDateFrom": "2021-01-01",
    "serviceDateTo": "2021-01-31",
    "unitPriceInterval": "monthly",
    "subscriptionItem": "12345678-1234-1234-1234-123456789012",
    "product": "Product A",
    "children": [
        []
    ]
}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "customer": {
    "id": "00000000-0000-0000-0000-000000000000",
    "customerNumber": "CUSTOMER-000",
    "timeZone": "Europe/Berlin",
    "firstName": "John",
    "lastName": "Doe",
    "currencyCode": "EUR",
    "companyName": "Acme Inc.",
    "datevId": "123456789",
    "status": "STATUS_ACTIVE"
  },
  "paymentMethod": {
    "id": "<string>",
    "gatewayName": "wallet",
    "type": "sepa_debit",
    "referenceId": "<string>",
    "default": true,
    "status": "active",
    "source": "api",
    "enabled": true,
    "name": "<string>",
    "data": [
      "<string>"
    ],
    "creationDate": "2023-11-07T05:31:56Z",
    "expirationDate": "2023-11-07T05:31:56Z",
    "sepaMandate": {},
    "card": {
      "brand": "Visa",
      "last4": "4242",
      "expMonth": 12,
      "expYear": 2022,
      "cardHolder": "Max Mustermann"
    },
    "sepaDebit": {
      "iban": "DE8937*********3232",
      "bic": "COBADEFFXXX",
      "mandateReference": "MNDT-2021-123456",
      "signingDate": "2021-01-01T00:00:00+00:00"
    },
    "paypal": {
      "email": "max@mustermann.de",
      "billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
    }
  },
  "referencedInvoice": {
    "id": "00000000-0000-0000-0000-000000000000",
    "customer": {
      "id": "00000000-0000-0000-0000-000000000000",
      "customerNumber": "CUSTOMER-000",
      "timeZone": "Europe/Berlin",
      "firstName": "John",
      "lastName": "Doe",
      "currencyCode": "EUR",
      "companyName": "Acme Inc.",
      "datevId": "123456789",
      "status": "STATUS_ACTIVE"
    },
    "paymentMethod": {
      "id": "<string>",
      "gatewayName": "wallet",
      "type": "sepa_debit",
      "referenceId": "<string>",
      "default": true,
      "status": "active",
      "source": "api",
      "enabled": true,
      "name": "<string>",
      "data": [
        "<string>"
      ],
      "creationDate": "2023-11-07T05:31:56Z",
      "expirationDate": "2023-11-07T05:31:56Z",
      "sepaMandate": {},
      "card": {
        "brand": "Visa",
        "last4": "4242",
        "expMonth": 12,
        "expYear": 2022,
        "cardHolder": "Max Mustermann"
      },
      "sepaDebit": {
        "iban": "DE8937*********3232",
        "bic": "COBADEFFXXX",
        "mandateReference": "MNDT-2021-123456",
        "signingDate": "2021-01-01T00:00:00+00:00"
      },
      "paypal": {
        "email": "max@mustermann.de",
        "billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
      }
    },
    "referencedInvoice": {},
    "type": "TYPE_INVOICE",
    "currencyCode": "EUR",
    "number": "RE-0000000001",
    "status": "STATUS_DRAFT",
    "creationDate": "2023-11-07T05:31:56Z",
    "finalizationDate": "2023-11-07T05:31:56Z",
    "dueDate": "2023-11-07T05:31:56Z",
    "lastReminderDate": "2023-11-07T05:31:56Z",
    "lastSentAt": "2023-11-07T05:31:56Z",
    "dunningLevel": 123,
    "dunningStatus": "none",
    "payDate": "2023-11-07T05:31:56Z",
    "invoiceAddress": "<any>",
    "internalNote": "This invoice is with a special discount.",
    "title": "<string>",
    "introduction": "<string>",
    "closing": "<string>",
    "netAmount": {},
    "grossAmount": {},
    "taxAmount": {},
    "discountAmount": {},
    "file": {
      "id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
      "isPrivate": true,
      "mimeType": "image/jpeg",
      "fileExtension": "jpg",
      "fileName": "invoice.jpg",
      "storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
      "createdAt": "2021-01-01T00:00:00+00:00"
    },
    "xmlFile": {
      "id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
      "isPrivate": true,
      "mimeType": "image/jpeg",
      "fileExtension": "jpg",
      "fileName": "invoice.jpg",
      "storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
      "createdAt": "2021-01-01T00:00:00+00:00"
    },
    "positions": [
      {
        "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"
      }
    ],
    "applicatedExchangeRates": [
      {
        "sourceCurrencyCode": "EUR",
        "destinationCurrencyCode": "CHF",
        "exchangeRate": "1.135",
        "exchangeRateDate": "2023-11-07T05:31:56Z"
      }
    ],
    "eInvoiceType": "<any>",
    "leitwegId": "1234567890123",
    "customFields": {
      "field1": "value1",
      "field2": "value2"
    },
    "serviceDateFrom": "2023-11-07T05:31:56Z",
    "serviceDateTo": "2023-11-07T05:31:56Z",
    "unpaidAmount": {},
    "usageBreakdownUrl": "<string>",
    "cancellationDocument": {
      "number": "R2021-0001",
      "id": "8d6b0f9e-5b9a-4e1a-9f0a-5e8e1a0b1b1e"
    },
    "dunningDisabled": true,
    "paymentProviderFeeCents": {},
    "sourceType": "<any>",
    "creditNotes": [
      {}
    ]
  },
  "type": "TYPE_INVOICE",
  "currencyCode": "EUR",
  "number": "RE-0000000001",
  "status": "STATUS_DRAFT",
  "creationDate": "2023-11-07T05:31:56Z",
  "finalizationDate": "2023-11-07T05:31:56Z",
  "dueDate": "2023-11-07T05:31:56Z",
  "lastReminderDate": "2023-11-07T05:31:56Z",
  "lastSentAt": "2023-11-07T05:31:56Z",
  "dunningLevel": 123,
  "dunningStatus": "none",
  "payDate": "2023-11-07T05:31:56Z",
  "invoiceAddress": "<any>",
  "internalNote": "This invoice is with a special discount.",
  "title": "<string>",
  "introduction": "<string>",
  "closing": "<string>",
  "netAmount": {},
  "grossAmount": {},
  "taxAmount": {},
  "discountAmount": {},
  "file": {
    "id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
    "isPrivate": true,
    "mimeType": "image/jpeg",
    "fileExtension": "jpg",
    "fileName": "invoice.jpg",
    "storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
    "createdAt": "2021-01-01T00:00:00+00:00"
  },
  "xmlFile": {
    "id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
    "isPrivate": true,
    "mimeType": "image/jpeg",
    "fileExtension": "jpg",
    "fileName": "invoice.jpg",
    "storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
    "createdAt": "2021-01-01T00:00:00+00:00"
  },
  "positions": [
    {
      "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"
    }
  ],
  "applicatedExchangeRates": [
    {
      "sourceCurrencyCode": "EUR",
      "destinationCurrencyCode": "CHF",
      "exchangeRate": "1.135",
      "exchangeRateDate": "2023-11-07T05:31:56Z"
    }
  ],
  "eInvoiceType": "<any>",
  "leitwegId": "1234567890123",
  "customFields": {
    "field1": "value1",
    "field2": "value2"
  },
  "serviceDateFrom": "2023-11-07T05:31:56Z",
  "serviceDateTo": "2023-11-07T05:31:56Z",
  "unpaidAmount": {},
  "usageBreakdownUrl": "<string>",
  "cancellationDocument": {
    "number": "R2021-0001",
    "id": "8d6b0f9e-5b9a-4e1a-9f0a-5e8e1a0b1b1e"
  },
  "dunningDisabled": true,
  "paymentProviderFeeCents": {},
  "sourceType": "<any>",
  "creditNotes": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "customer": {
        "id": "00000000-0000-0000-0000-000000000000",
        "customerNumber": "CUSTOMER-000",
        "timeZone": "Europe/Berlin",
        "firstName": "John",
        "lastName": "Doe",
        "currencyCode": "EUR",
        "companyName": "Acme Inc.",
        "datevId": "123456789",
        "status": "STATUS_ACTIVE"
      },
      "paymentMethod": {
        "id": "<string>",
        "gatewayName": "wallet",
        "type": "sepa_debit",
        "referenceId": "<string>",
        "default": true,
        "status": "active",
        "source": "api",
        "enabled": true,
        "name": "<string>",
        "data": [
          "<string>"
        ],
        "creationDate": "2023-11-07T05:31:56Z",
        "expirationDate": "2023-11-07T05:31:56Z",
        "sepaMandate": {},
        "card": {
          "brand": "Visa",
          "last4": "4242",
          "expMonth": 12,
          "expYear": 2022,
          "cardHolder": "Max Mustermann"
        },
        "sepaDebit": {
          "iban": "DE8937*********3232",
          "bic": "COBADEFFXXX",
          "mandateReference": "MNDT-2021-123456",
          "signingDate": "2021-01-01T00:00:00+00:00"
        },
        "paypal": {
          "email": "max@mustermann.de",
          "billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
        }
      },
      "referencedInvoice": {},
      "type": "TYPE_INVOICE",
      "currencyCode": "EUR",
      "number": "RE-0000000001",
      "status": "STATUS_DRAFT",
      "creationDate": "2023-11-07T05:31:56Z",
      "finalizationDate": "2023-11-07T05:31:56Z",
      "dueDate": "2023-11-07T05:31:56Z",
      "lastReminderDate": "2023-11-07T05:31:56Z",
      "lastSentAt": "2023-11-07T05:31:56Z",
      "dunningLevel": 123,
      "dunningStatus": "none",
      "payDate": "2023-11-07T05:31:56Z",
      "invoiceAddress": "<any>",
      "internalNote": "This invoice is with a special discount.",
      "title": "<string>",
      "introduction": "<string>",
      "closing": "<string>",
      "netAmount": {},
      "grossAmount": {},
      "taxAmount": {},
      "discountAmount": {},
      "file": {
        "id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
        "isPrivate": true,
        "mimeType": "image/jpeg",
        "fileExtension": "jpg",
        "fileName": "invoice.jpg",
        "storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
        "createdAt": "2021-01-01T00:00:00+00:00"
      },
      "xmlFile": {
        "id": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ",
        "isPrivate": true,
        "mimeType": "image/jpeg",
        "fileExtension": "jpg",
        "fileName": "invoice.jpg",
        "storageFileName": "01F9Z3ZJXZQZJZJZJZJZJZJZJZ.jpg",
        "createdAt": "2021-01-01T00:00:00+00:00"
      },
      "positions": [
        {
          "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"
        }
      ],
      "applicatedExchangeRates": [
        {
          "sourceCurrencyCode": "EUR",
          "destinationCurrencyCode": "CHF",
          "exchangeRate": "1.135",
          "exchangeRateDate": "2023-11-07T05:31:56Z"
        }
      ],
      "eInvoiceType": "<any>",
      "leitwegId": "1234567890123",
      "customFields": {
        "field1": "value1",
        "field2": "value2"
      },
      "serviceDateFrom": "2023-11-07T05:31:56Z",
      "serviceDateTo": "2023-11-07T05:31:56Z",
      "unpaidAmount": {},
      "usageBreakdownUrl": "<string>",
      "cancellationDocument": {
        "number": "R2021-0001",
        "id": "8d6b0f9e-5b9a-4e1a-9f0a-5e8e1a0b1b1e"
      },
      "dunningDisabled": true,
      "paymentProviderFeeCents": {},
      "sourceType": "<any>",
      "creditNotes": [
        {}
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

Value for the Authorization header parameter.

Path Parameters

id
string
required

InvoicePositionItem identifier

Body

The updated InvoicePositionItem resource

Response

200
application/json

InvoicePositionItem resource updated