Skip to main content
GET
/
invoices
Rechnungen auflisten
curl --request GET \
  --url https://api.comstruct.com/v1/invoices \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": "123",
      "external_id": "EXT-123",
      "invoice_number": "INV-2024-001",
      "invoice_date": "2024-01-15",
      "due_date": "2024-02-15",
      "receipt_date": "2023-11-07T05:31:56Z",
      "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "project_number": "PRJ-2024-001",
      "supplier_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "supplier_name": "ABC Supplies Ltd.",
      "supplier_tax_id": "<string>",
      "supplier_iban": "<string>",
      "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "currency": "EUR",
      "net_amount": 1000,
      "total_tax_amount": 190,
      "total_amount": 1190,
      "tax_rate": 123,
      "status": "NEW",
      "document_type": "INVOICE",
      "electronic_invoice_type": "ZUGFERD",
      "down_payment_number": 123,
      "payment_reference": "RF18539007547034",
      "reference_type": "QRR",
      "payment_term": {
        "number": "<string>",
        "title": "<string>"
      },
      "region_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "legal_entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "project_region": {
        "id": "<string>",
        "title": "<string>",
        "number": "<string>"
      },
      "legal_entity": {
        "id": "<string>",
        "title": "<string>",
        "number": "<string>"
      },
      "supplier": {
        "id": "<string>",
        "title": "<string>",
        "external_id": "<string>",
        "legal_uid": "<string>"
      },
      "project": {
        "id": "<string>",
        "title": "<string>",
        "project_number": "<string>",
        "description": "<string>",
        "project_region": {
          "number": "<string>",
          "title": "<string>"
        },
        "legal_entity": {
          "number": "<string>",
          "title": "<string>"
        }
      },
      "invoice_accounts": [
        {
          "net_amount": 1000,
          "gross_amount": 1190,
          "tax_amount": 190,
          "account_type": "DEBIT",
          "comment": "<string>",
          "quantity": 10,
          "unit": "Stück",
          "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "project": {
            "id": "<string>",
            "title": "<string>",
            "project_number": "<string>"
          },
          "account": {
            "id": "<string>",
            "number": "<string>",
            "title": "<string>"
          },
          "tax_code": {
            "id": "<string>",
            "number": "<string>",
            "title": "<string>"
          }
        }
      ],
      "document": {
        "id": "<string>",
        "title": "<string>"
      },
      "comment": "<string>",
      "payment_terms": "<string>",
      "payment_term_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "discount_rate": 123,
      "discount_date": "2023-12-25",
      "items": [
        {
          "id": 123,
          "product_number": "<string>",
          "title": "<string>",
          "description": "<string>",
          "type": "REMOVAL",
          "quantity": 123,
          "unit": "<string>",
          "unit_net_price": 123,
          "net_price": 123,
          "delivery_number": "<string>",
          "delivery_date": "2023-12-25",
          "item_position": 123,
          "matched_delivery_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "matched_product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "matched_price": true,
          "matched_quantity": true,
          "discount": 123,
          "special_discount": 123,
          "comment": "<string>"
        }
      ],
      "file_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2024-01-15T10:00:00Z",
      "assignee_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "total": 150,
  "limit": 25,
  "offset": 0,
  "hasNext": true,
  "hasPrevious": false,
  "totalPages": 6,
  "currentPage": 0
}
Gibt eine paginierte Liste von Rechnungen zurück, sortiert nach Erstellungsdatum (neueste zuerst). Enthält Kontierungen (invoice_accounts), aber keine Rechnungspositionen oder Verlaufshistorie.

Authorizations

​
X-API-Key
string
header
required

API-Schlüssel zur Authentifizierung. Kontaktieren Sie Ihren Customer Success Manager, um einen API-Schlüssel zu erhalten.

Erforderliche Berechtigungen:

  • deliveries:read - Lieferdaten lesen
  • deliveries:write - Lieferungen erstellen und ändern
  • invoices:read - Rechnungsdaten lesen
  • invoices:write - Rechnungen erstellen und ändern
  • projects:read - Projektdaten lesen
  • projects:write - Projekte erstellen und ändern
  • project_regions:read - Projektregionsdaten lesen
  • project_regions:write - Projektregionen erstellen und ändern
  • accounts:read - Kontodaten lesen
  • accounts:write - Konten erstellen und ändern
  • payment_terms:read - Zahlungsbedingungsdaten lesen
  • payment_terms:write - Zahlungsbedingungen erstellen und ändern
  • tax_codes:read - Steuercodedaten lesen
  • tax_codes:write - Steuercodes erstellen und ändern
  • users:read - Benutzerdaten lesen (erforderlich für Projekt-Benutzerverwaltung)
  • roles:read - Rollendaten lesen (erforderlich für Projekt-Rollenzuweisung)
  • tenant_settings:read - Mandanteneinstellungen lesen (erforderlich für Projekterstellung)
  • suppliers:write - Lieferanten erstellen und ändern
  • purchase_orders:write - Bestellungen erstellen

Query Parameters

​
limit
integer
default:25

Anzahl der Einträge pro Seite (max. 500, Standard 25)

Required range: 1 <= x <= 500
Example:

25

​
offset
integer
default:0

Anzahl der zu überspringenden Einträge für die Paginierung

Required range: x >= 0
Example:

0

​
status
enum<string>

Nach Rechnungsstatus filtern

Available options:
NEW,
PROCESSING,
FACTUAL_CHECKING,
PRICE_CHECKING,
CHECKED,
CANCELLED,
ERROR,
OPEN

Response

Erfolgreich

​
data
object[]

Array von Rechnungen

​
total
integer

Gesamtanzahl der Rechnungen

Example:

150

​
limit
integer | null

Anzahl der Einträge pro Seite

Example:

25

​
offset
integer

Anzahl der übersprungenen Einträge

Example:

0

​
hasNext
boolean

Ob weitere Seiten verfügbar sind

Example:

true

​
hasPrevious
boolean

Ob vorherige Seiten verfügbar sind

Example:

false

​
totalPages
integer

Gesamtanzahl der Seiten

Example:

6

​
currentPage
integer

Aktuelle Seitennummer (0-basiert)

Example:

0