XRechnung API
    • invoices
      • List stored invoices for the current API key
        GET
      • Queue invoice generation by default
        POST
      • Validate invoice JSON, raw XML, or raw ZUGFeRD PDF
        POST
      • Retrieve a previously generated invoice by ID
        GET
      • Download the stored invoice PDF artifact
        GET
    • system
      • Public liveness probe
      • Check runtime readiness for invoice validation
    • Schemas
      • InvoicePayload
      • SellerParty
      • InvoiceAllowance
      • PrecedingInvoiceReference
      • BuyerParty
      • InvoiceBranding
      • ValidationError
      • InvoiceLine
      • ValidationResult
      • GenerateQueuedResponse
      • GenerateSyncResponse
      • ValidateJsonResponse
      • ValidatePdfRequest
      • ValidateXmlRequest
      • ValidateXmlResponse
      • ValidatePdfResponse
      • GetInvoicePendingResponse
      • GetInvoiceTerminalResponse
      • GetInvoiceResponse
      • ListInvoiceSummary
      • PaginationMeta
      • ListInvoicesResponse
      • ReadinessResponse
      • UnauthorizedError
      • PaymentRequiredError
      • TooManyRequestsError
      • RequestValidationError
      • NotFoundError

    GetInvoiceResponse

    {
        "status": "queued",
        "invoice_id": "f4c4edb8-11e0-4b33-bcc1-482dc59ebb32",
        "invoice_number": "string",
        "processing_mode": "async",
        "document_format": "xrechnung_ubl",
        "document_profile": "string",
        "request_payload": {
            "document_format": "xrechnung_ubl",
            "document_profile": "EN16931",
            "print_seller_address": false,
            "invoice_number": "RE-2026-001",
            "issue_date": 1775520000,
            "due_date": 1776729600,
            "delivery_date": 1775520000,
            "buyer_reference": "04011000-12345-03",
            "invoice_note": "Projektphase April 2026",
            "tax_category": "AE",
            "tax_exemption_reason": "Steuerschuldnerschaft des Leistungsempfängers",
            "tax_exemption_reason_code": "VATEX-EU-AE",
            "order_reference": "PO-2026-001",
            "payment_means_code": "58",
            "payment_terms_note": "Zahlbar bis 2026-04-21 ohne Abzug.",
            "currency": "EUR",
            "invoice_type_code": "384",
            "preceding_invoice_references": [
                {
                    "invoice_number": "RE-2026-001",
                    "issue_date": 1775520000
                }
            ],
            "seller": {},
            "buyer": {
                "name": "Kunde GmbH",
                "company_supplement": "z. Hd. Einkauf",
                "vat_id": "DE987654321",
                "street": "Hauptstr. 5",
                "postal_code": "54321",
                "city": "Hamburg",
                "country_code": "DE",
                "email": "buyer@example.com",
                "electronic_address_scheme": "EM",
                "contact_name": "Einkauf"
            },
            "branding": {
                "logo_url": "https://customer.example/logo.png",
                "letterhead_pdf_url": "https://customer.example/letterhead.pdf",
                "letterhead_pdf_base64": "string",
                "letterhead_margins": {
                    "top": 63,
                    "right": 15,
                    "bottom": 30,
                    "left": 25
                }
            },
            "items": [
                {
                    "name": "Webentwicklung",
                    "description": "Implementierung und Review",
                    "quantity": 10,
                    "unit_code": "HUR",
                    "price": 100,
                    "tax_rate": 19,
                    "service_period_start": 1775001600,
                    "service_period_end": 1777507200
                }
            ],
            "allowances": [
                {
                    "reason": "Nachlass",
                    "reason_code": "95",
                    "amount": 100,
                    "tax_rate": 19,
                    "base_amount": 1000,
                    "percentage": 10
                }
            ],
            "prepaid_amount": 500
        },
        "validation": null,
        "xml": null,
        "pdf_base64": null,
        "queued_at": "2019-08-24T14:15:22.123Z",
        "started_at": "2019-08-24T14:15:22.123Z",
        "finished_at": "2019-08-24T14:15:22.123Z",
        "processing_error": "string",
        "next_poll_after_seconds": 2
    }
    Built with