Rechnungen

Die Endpunkte dieser Endpunktberechtigung finden Sie im Controller "AccountancyInvoiceReceipt".

Um Eingangsrechnungen erfassen oder abrufen zu können, muss die Endpunktberechtigung "Belegsystem Eingangsrechnung erfassen" aktiviert werden.

Die Endpunkte der Version 1.2 sind momentan in der Entwicklung und können noch Änderungen erfahren.

Hinweise zur Funktion

Informationen zu Rechnungen können ebenfalls im Abschnitt "Belegsystem" und im "Auftragswesen" gefunden werden. Aufgrund der sehr individuellen Buchungsarten und Konten-Strukturen sollte die Art der Rechnungsübermittlung immer vorher mit dem Kunden besprochen werden. Die Datenstruktur der Rechnung orientiert sich am Aufbau einer XRechnung. Bitte beachten Sie zudem, dass noch nicht für alle Zusatzkontierungen Endpunkte verfügbar sind. Zusatzkontierungen ohne existierende Endpunkte werden derzeit nur eingeschränkt unterstützt. Die Zuordnung von Zusatzkontierungen ist zudem nur möglich, wenn der vollständige Kontenrahmen und die Buchungsvorschriften bekannt sind.

Rechnungen lesen

Eingangsrechnungen abfragen

Version 1.2

Zusätzlicher Endpunkt aus "Belegsystem"/"Bewegungsdaten" (bitte beachten Sie die abweichenden API-Endpunkt-Berechtigungen):

Zusätzliche Endpunkte aus "Auftragswesen" (bitte beachten Sie die abweichenden API-Endpunkt-Berechtigungen):

Zahlaufträge

Version 1.2

Zusätzlicher Endpunkt aus "Belegsystem"/"Bewegungsdaten" (bitte beachten Sie die abweichenden API-Endpunkt-Berechtigungen):

Rechnungen erfassen

Hinweise zur Funktion

Die Daten zum "PaymentMeansCode" wurden dem XRechnung-Format entnommen. Eine Tabelle der gültigen Codes finden Sie unten auf der Seite.

Die Beträge in der Node "Lines" sind ausschließlich Nettobeträge. Hierbei gilt:

BaseAmount ./. LineDiscountAmount ./. LineWitholdAmount = LineExtensionsAmount

Die API prüft, ob alle Beträge in Summe übereinstimmen. Hierbei wird auch ein Abgleich zwischen Brutto- und Nettowerten vorgenommen.

Bitte beachten Sie, dass die API bereits in der Lage ist, mehr als zwei unterschiedliche Steuer-IDs im "Lines" Knoten zu berücksichtigen. WOWIPORT erlaubt derzeit allerdings nur zwei unterschiedliche Steuer-IDs.

Wenn Sie nur einen Steuersatz "U0" oder "V0" im Knoten "Line" übermitteln, dürfen Sie den Knoten "TaxTotal" nicht mitsenden, da keine Steuer anfällt.

Die Übergabe eines Auftragsbezuges erfolgt, anders als die übrigen Entitätzsbezüge, nicht in dern "References". Die Zuordnung erfolgt hier über die OrderReference (jeweils pro Rechnungszeile oder für die gesamte Rechnung).

Wenn Sie eine "OrderReference" übermitteln, brauchen Sie die "Line" nicht mitzusenden. Diese werden aus dem Auftrag entnommen, wenn Sie "OrderReferencesAllLines" = "true" setzen. Bitte beachten Sie, dass der Auftragswert exakt mit dem Rechnungswert übereinstimmen muss.

Die "InvoiceDocumentIId" darf nur verwendet werden, wenn das WOWIPORT DMS (d.velop) aktiv ist. Hier wird die Dokumenten ID aus d.velop eingetragen. Eine fehlerhafte Verwendung des Feldes kann zu Folgefehlern in der Rechnungsverarbeitung führen.

Eingangsrechnung im Status "Erfassung"

Version 1.2

Eingangsrechnung im Status "Kontierung"

Version 1.2

Eingangsrechnung im Status "Gebucht"

Version 1.2

Enumerationen für "PaymentMeansCode"

Code

Name

10 und 20

Cash

Transfer

DirectDebit

Enumerationen für "Withhold"/"Type"

Name Englisch

Name Deutsch

SecurityWithhold

Sicherheitseinbehalt

WarrantyWithhold

Gewährleistungseinbehalt

PreviousProjekte NextUmlagenabrechnung

Last updated 19 days ago

Rechnungen erfassen

Hinweise zur Funktion

Die Daten zum "PaymentMeansCode" wurden dem XRechnung-Format entnommen. Eine Tabelle der gültigen Codes finden Sie unten auf der Seite.

Die Beträge in der Node "Lines" sind ausschließlich Nettobeträge. Hierbei gilt:

BaseAmount ./. LineDiscountAmount ./. LineWitholdAmount = LineExtensionsAmount

Die API prüft, ob alle Beträge in Summe übereinstimmen. Hierbei wird auch ein Abgleich zwischen Brutto- und Nettowerten vorgenommen.

Wenn Sie nur einen Steuersatz "U0" oder "V0" im Knoten "Line" übermitteln, dürfen Sie den Knoten "TaxTotal" nicht mitsenden, da keine Steuer anfällt.

{ "Id": 1, "Number": "text", "CompanyCode": { "Id": 1, "Name": "text", "Code": "text" }, "IssueDate": "2025-04-26", "DueDate": "2025-04-26", "ActualDeliveryDate": "2025-04-26", "MonetaryTotal": { "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "TaxInclusiveLaborCost": 1, "TaxInclusiveMaterialCost": 1, "TaxExclusiveLaborCost": 1, "TaxExclusiveMaterialCost": 1 }, "TaxTotal": { "TaxAmount": 1, "TaxSubtotals": [ { "Net": 1, "Vat": 1, "Tax": { "Id": 1, "Code": "text" } } ] }, "PaymentOrders": [ { "PaymentOrderNumber": "text", "Maturity": "2025-04-26", "TransferDate": "2025-04-26", "PaymentFileStatus": { "Id": 1, "Code": "text" } } ], "ResponsibleOfficial": { "Id": 1, "CodeShort": "text", "PersonId": 1 }, "Department": { "Id": 1, "Name": "text" }, "EconomicUnit": { "Id": 1, "IdNum": "text" }, "Project": { "Id": 1, "Code": "text", "Name": "text" }, "AdditionalFields": [ { "Name": "text", "Content": "text", "Type": "text" } ], "Processing": { "Id": 1, "Code": "text" }, "InvoiceType": { "Id": 1, "Code": "text" }, "CorrectionReason": "text", "CommissioningData": { "CommissionItems": [ { "Id": 1, "Code": "text", "UnitPrice": 1, "GrossAmount": 1, "NetAmount": 1, "Units": 1, "CommissionText": "text", "InternalDescription": "text", "PositionNumber": 1, "IsCanceled": true, "IsSmallRepair": true, "TransferToCraftsmanPortalWithoutCosts": true, "BudgetData": { "Budget": { "Id": 1, "Code": "text" }, "BudgetDetail": { "Id": 1, "BudgetId": 1, "Hierarchy1Value": "text", "Hierarchy2Value": "text", "Hierarchy3Value": "text" } }, "SalesTax": { "Id": 1, "Code": "text" }, "ServiceCatalogue": { "Id": 1, "IdNum": "text", "Description": "text", "QuantityType": { "Id": 1, "Name": "text", "Code": "text", "ArgeCode": "text" } }, "CraftActivity": { "Id": 1, "Code": "text" }, "QuantityType": { "Id": 1, "Name": "text", "Code": "text", "ArgeCode": "text" }, "Component": { "Id": 1, "Name": "text" }, "Facility": { "Id": 1, "Name": "text" }, "ComponentCatalog": { "Id": 1, "Name": "text" }, "FacilityCatalog": { "Id": 1, "Name": "text" }, "ApprovedNetAmount": 1, "Commission": { "Id": 1, "IdNum": "text", "Code": "text", "RecordingDate": "2025-04-26", "ReleaseDate": "2025-04-26", "PlacingDate": "2025-04-26", "AcceptanceDate": "2025-04-26", "CompletionDate": "2025-04-26", "CommissionType": { "Id": 1, "Code": "text" }, "CommissionStatus": { "Id": 1, "Code": "text" } } } ] } }

[ { "Id": 1, "Number": "text", "CompanyCode": { "Id": 1, "Name": "text", "Code": "text" }, "IssueDate": "2025-04-26", "DueDate": "2025-04-26", "ActualDeliveryDate": "2025-04-26", "MonetaryTotal": { "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "TaxInclusiveLaborCost": 1, "TaxInclusiveMaterialCost": 1, "TaxExclusiveLaborCost": 1, "TaxExclusiveMaterialCost": 1 }, "TaxTotal": { "TaxAmount": 1, "TaxSubtotals": [ { "Net": 1, "Vat": 1, "Tax": { "Id": 1, "Code": "text" } } ] }, "PaymentOrders": [ { "PaymentOrderNumber": "text", "Maturity": "2025-04-26", "TransferDate": "2025-04-26", "PaymentFileStatus": { "Id": 1, "Code": "text" } } ], "ResponsibleOfficial": { "Id": 1, "CodeShort": "text", "PersonId": 1 }, "Department": { "Id": 1, "Name": "text" }, "EconomicUnit": { "Id": 1, "IdNum": "text" }, "Project": { "Id": 1, "Code": "text", "Name": "text" }, "AdditionalFields": [ { "Name": "text", "Content": "text", "Type": "text" } ], "Processing": { "Id": 1, "Code": "text" }, "InvoiceType": { "Id": 1, "Code": "text" }, "CorrectionReason": "text", "CommissioningData": { "CommissionItems": [ { "Id": 1, "Code": "text", "UnitPrice": 1, "GrossAmount": 1, "NetAmount": 1, "Units": 1, "CommissionText": "text", "InternalDescription": "text", "PositionNumber": 1, "IsCanceled": true, "IsSmallRepair": true, "TransferToCraftsmanPortalWithoutCosts": true, "BudgetData": { "Budget": { "Id": 1, "Code": "text" }, "BudgetDetail": { "Id": 1, "BudgetId": 1, "Hierarchy1Value": "text", "Hierarchy2Value": "text", "Hierarchy3Value": "text" } }, "SalesTax": { "Id": 1, "Code": "text" }, "ServiceCatalogue": { "Id": 1, "IdNum": "text", "Description": "text", "QuantityType": { "Id": 1, "Name": "text", "Code": "text", "ArgeCode": "text" } }, "CraftActivity": { "Id": 1, "Code": "text" }, "QuantityType": { "Id": 1, "Name": "text", "Code": "text", "ArgeCode": "text" }, "Component": { "Id": 1, "Name": "text" }, "Facility": { "Id": 1, "Name": "text" }, "ComponentCatalog": { "Id": 1, "Name": "text" }, "FacilityCatalog": { "Id": 1, "Name": "text" }, "ApprovedNetAmount": 1, "Commission": { "Id": 1, "IdNum": "text", "Code": "text", "RecordingDate": "2025-04-26", "ReleaseDate": "2025-04-26", "PlacingDate": "2025-04-26", "AcceptanceDate": "2025-04-26", "CompletionDate": "2025-04-26", "CommissionType": { "Id": 1, "Code": "text" }, "CommissionStatus": { "Id": 1, "Code": "text" } } } ] } } ]

[ { "Id": 1, "Number": "text", "CompanyCode": { "Id": 1, "Name": "text", "Code": "text" }, "InvoiceDate": "2025-04-26", "MaturityDate": "2025-04-26", "MonetaryTotal": { "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "TaxInclusiveLaborCost": 1, "TaxInclusiveMaterialCost": 1, "TaxExclusiveLaborCost": 1, "TaxExclusiveMaterialCost": 1 }, "TaxTotal": { "TaxAmount": 1, "TaxSubtotals": [ { "Net": 1, "Vat": 1, "Tax": { "Id": 1, "Code": "text" } } ] }, "PaymentOrders": [ { "PaymentOrderNumber": "text", "Maturity": "2025-04-26", "TransferDate": "2025-04-26", "PaymentFileStatus": { "Id": 1, "Code": "text" } } ], "CommissionItems": [ { "Id": 1, "Code": "text", "UnitPrice": 1, "GrossAmount": 1, "NetAmount": 1, "Units": 1, "CommissionText": "text", "InternalDescription": "text", "PositionNumber": 1, "IsCanceled": true, "IsSmallRepair": true, "TransferToCraftsmanPortalWithoutCosts": true, "BudgetData": { "Budget": { "Id": 1, "Code": "text" }, "BudgetDetail": { "Id": 1, "BudgetId": 1, "Hierarchy1Value": "text", "Hierarchy2Value": "text", "Hierarchy3Value": "text" } }, "SalesTax": { "Id": 1, "Code": "text" }, "ServiceCatalogue": { "Id": 1, "IdNum": "text", "Description": "text", "QuantityType": { "Id": 1, "Name": "text", "Code": "text", "ArgeCode": "text" } }, "CraftActivity": { "Id": 1, "Code": "text" }, "QuantityType": { "Id": 1, "Name": "text", "Code": "text", "ArgeCode": "text" }, "Component": { "Id": 1, "Name": "text" }, "Facility": { "Id": 1, "Name": "text" }, "ComponentCatalog": { "Id": 1, "Name": "text" }, "FacilityCatalog": { "Id": 1, "Name": "text" }, "ApprovedNetAmount": 1, "Commission": { "Id": 1, "IdNum": "text", "Code": "text", "RecordingDate": "2025-04-26", "ReleaseDate": "2025-04-26", "PlacingDate": "2025-04-26", "AcceptanceDate": "2025-04-26", "CompletionDate": "2025-04-26", "CommissionType": { "Id": 1, "Code": "text" }, "CommissionStatus": { "Id": 1, "Code": "text" } } } ], "ResponsibleOfficial": { "Id": 1, "CodeShort": "text", "PersonId": 1 }, "Department": { "Id": 1, "Name": "text" }, "EconomicUnit": { "Id": 1, "IdNum": "text" }, "Project": { "Id": 1, "Code": "text", "Name": "text" }, "InvoiceType": { "Id": 1, "Code": "text" } } ]

[ { "Id": 1, "Number": "text", "CompanyCode": { "Id": 1, "Name": "text", "Code": "text" }, "PaymentOrders": [ { "PaymentOrderNumber": "text", "Maturity": "2025-04-26", "TransferDate": "2025-04-26", "PaymentFileStatus": { "Id": 1, "Code": "text" } } ] } ]

POST /openwowi/v1.2/AccountancyInvoiceReceipt/Recording HTTP/1.1 Host: Content-Type: application/json Accept: */* Content-Length: 1344 { "CompanyCodeId": 1, "InvoiceTypeId": 1, "InvoiceDocumentId": "text", "References": { "PropertyManagementContractId": 1, "EconomicUnitId": 1, "BuildingId": 1, "LandId": 1, "UseUnitId": 1, "LicenseAgreementId": 1, "ResponsibleOfficialId": 1, "ProjectId": 1, "DepartmentId": 1 }, "OrderReferencesAllLines": true, "OrderReferences": [ "text" ], "GeneralAdditionalAccount": [ { "AdditionalAccountTypeId": 1, "Id": 1 } ], "IssueDate": "2025-04-26", "DueDate": "2025-04-26", "ActualDeliveryDate": "2025-04-26", "AccountingSupplierParty": { "CreditorId": 1, "PartnerReference": "text" }, "PaymentMeans": { "PaymentMeansCode": 1, "Iban": "text" }, "MonetaryTotal": { "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "TaxExclusiveLaborCost": 1, "TaxInclusiveLaborCost": 1, "Withhold": { "Type": "SecurityWithhold", "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "Percentage": 1, "DueDate": "2025-04-26", "TaxInclusiveLaborCost": 1 }, "Discount": { "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "Percentage": 1, "TaxInclusiveLaborCost": 1 } }, "TaxTotals": [ { "Net": 1, "Vat": 1, "SalesTaxId": 1 } ], "Lines": [ { "Position": "text", "OrderReference": "text", "OrderLineReference": "text", "Name": "text", "Description": "text", "ServiceCatalogId": 1, "LaborCost": 1, "MasterAccountId": 1, "LineExtensionAmount": 1, "LineWithholdAmount": 1, "LineDiscountAmount": 1, "BaseAmount": 1, "BookingGrossAmount": 1, "SalesTaxId": 1, "AdditionalAccount": [ { "AdditionalAccountTypeId": 1, "Id": 1 } ] } ] }

{ "Id": 1, "NodeId": 1, "InvoiceNumber": "text", "CompanyCode": { "Id": 1, "Name": "text", "Code": "text" }, "Creditor": { "Id": 1, "CreditorNumber": "text" }, "InvoiceType": { "Id": 1, "Code": "text" }, "References": { "PropertyManagementContractId": 1, "EconomicUnitId": 1, "BuildingId": 1, "LandId": 1, "UseUnitId": 1, "LicenseAgreementId": 1, "ResponsibleOfficialId": 1, "ProjectId": 1, "DepartmentId": 1 }, "OrderReferences": [ "text" ], "IssueDate": "2025-04-26", "DueDate": "2025-04-26", "ActualDeliveryDate": "2025-04-26", "BaseTotal": { "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "TaxInclusiveLaborCost": 1, "TaxInclusiveMaterialCost": 1, "TaxExclusiveLaborCost": 1, "TaxExclusiveMaterialCost": 1 }, "InvoiceAdjustments": [ { "Position": 1, "Reason": "IncreaseDueToPriceRise", "Date": "2025-04-26", "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1 } ], "TaxTotal": { "TaxAmount": 1, "TaxSubtotals": [ { "Net": 1, "Vat": 1, "Tax": { "Id": 1, "Code": "text" } } ] }, "VoucherProcesses": [ { "Id": 1, "CompanyCode": { "Id": 1, "Name": "text", "Code": "text" }, "VoucherProcessType": { "Id": 1, "Code": "text" }, "BookingRuleType": { "Id": 1, "Code": "text" }, "Description": "text", "FiscalYearNumber": 1, "BookingPeriodNumber": 1, "BookingDate": "2025-04-26", "ReleaseDate": "2025-04-26", "BookingNumber": "text", "Bookings": [ { "Id": 1, "MasterAccount": { "Id": 1, "Code": "text" }, "SalesTax": { "Id": 1, "Code": "text" }, "DebitCredit": "Debit", "Amount": 1, "Maturity": "2025-04-26", "OptionTaxPercentage": 1, "OriginalGrossAmount": 1, "OriginalOptionAmount": 1, "OptionTaxSource": "text", "AdditionalAccount": [ { "Id": 1, "Value": "text", "Type": { "Id": 1, "Code": "text" } } ] } ] } ], "AdditionalFields": [ { "Name": "text", "Content": "text", "Type": "text" } ] }

POST /openwowi/v1.2/AccountancyInvoiceReceipt/AccountAssignment HTTP/1.1 Host: Content-Type: application/json Accept: */* Content-Length: 1344 { "CompanyCodeId": 1, "InvoiceTypeId": 1, "InvoiceDocumentId": "text", "References": { "PropertyManagementContractId": 1, "EconomicUnitId": 1, "BuildingId": 1, "LandId": 1, "UseUnitId": 1, "LicenseAgreementId": 1, "ResponsibleOfficialId": 1, "ProjectId": 1, "DepartmentId": 1 }, "OrderReferencesAllLines": true, "OrderReferences": [ "text" ], "GeneralAdditionalAccount": [ { "AdditionalAccountTypeId": 1, "Id": 1 } ], "IssueDate": "2025-04-26", "DueDate": "2025-04-26", "ActualDeliveryDate": "2025-04-26", "AccountingSupplierParty": { "CreditorId": 1, "PartnerReference": "text" }, "PaymentMeans": { "PaymentMeansCode": 1, "Iban": "text" }, "MonetaryTotal": { "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "TaxExclusiveLaborCost": 1, "TaxInclusiveLaborCost": 1, "Withhold": { "Type": "SecurityWithhold", "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "Percentage": 1, "DueDate": "2025-04-26", "TaxInclusiveLaborCost": 1 }, "Discount": { "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "Percentage": 1, "TaxInclusiveLaborCost": 1 } }, "TaxTotals": [ { "Net": 1, "Vat": 1, "SalesTaxId": 1 } ], "Lines": [ { "Position": "text", "OrderReference": "text", "OrderLineReference": "text", "Name": "text", "Description": "text", "ServiceCatalogId": 1, "LaborCost": 1, "MasterAccountId": 1, "LineExtensionAmount": 1, "LineWithholdAmount": 1, "LineDiscountAmount": 1, "BaseAmount": 1, "BookingGrossAmount": 1, "SalesTaxId": 1, "AdditionalAccount": [ { "AdditionalAccountTypeId": 1, "Id": 1 } ] } ] }

POST /openwowi/v1.2/AccountancyInvoiceReceipt/Released HTTP/1.1 Host: Content-Type: application/json Accept: */* Content-Length: 1344 { "CompanyCodeId": 1, "InvoiceTypeId": 1, "InvoiceDocumentId": "text", "References": { "PropertyManagementContractId": 1, "EconomicUnitId": 1, "BuildingId": 1, "LandId": 1, "UseUnitId": 1, "LicenseAgreementId": 1, "ResponsibleOfficialId": 1, "ProjectId": 1, "DepartmentId": 1 }, "OrderReferencesAllLines": true, "OrderReferences": [ "text" ], "GeneralAdditionalAccount": [ { "AdditionalAccountTypeId": 1, "Id": 1 } ], "IssueDate": "2025-04-26", "DueDate": "2025-04-26", "ActualDeliveryDate": "2025-04-26", "AccountingSupplierParty": { "CreditorId": 1, "PartnerReference": "text" }, "PaymentMeans": { "PaymentMeansCode": 1, "Iban": "text" }, "MonetaryTotal": { "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "TaxExclusiveLaborCost": 1, "TaxInclusiveLaborCost": 1, "Withhold": { "Type": "SecurityWithhold", "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "Percentage": 1, "DueDate": "2025-04-26", "TaxInclusiveLaborCost": 1 }, "Discount": { "TaxExclusiveAmount": 1, "TaxInclusiveAmount": 1, "Percentage": 1, "TaxInclusiveLaborCost": 1 } }, "TaxTotals": [ { "Net": 1, "Vat": 1, "SalesTaxId": 1 } ], "Lines": [ { "Position": "text", "OrderReference": "text", "OrderLineReference": "text", "Name": "text", "Description": "text", "ServiceCatalogId": 1, "LaborCost": 1, "MasterAccountId": 1, "LineExtensionAmount": 1, "LineWithholdAmount": 1, "LineDiscountAmount": 1, "BaseAmount": 1, "BookingGrossAmount": 1, "SalesTaxId": 1, "AdditionalAccount": [ { "AdditionalAccountTypeId": 1, "Id": 1 } ] } ] }