German e-invoicing infrastructure for developers

Generate and validate compliant German e-invoices with one API. XRechnung, ZUGFeRD, and EN 16931 support built in — so your team never has to maintain e-invoice compliance in-house.

Start FreeRead the docs

50 free trial credits — no credit card required.

One POST. One compliant German e-invoice.

POST/v1/invoice/xrechnungReal output
Request — application/json
{
  "invoice": {
    "invoiceNumber": "INV-DEMO-001",
    "issueDate": "2025-07-01",
    "invoiceTypeCode": "380",
    "currencyCode": "EUR",
    "buyerReference": "991-12345-67",
    "seller": {
      "name": "Acme GmbH",
      "legalRegistrationIdentifier": "HRB98765",
      "vatIdentifier": "DE123456789",
      "electronicAddress": "DE123456789",
      "electronicAddressSchemeId": "9930",
      "postalAddress": {
        "addressLine1": "Musterstr. 1",
        "city": "Berlin",
        "postcode": "10115",
        "countryCode": "DE"
      },
      "contact": {
        "contactPoint": "Max Mustermann",
        "telephone": "+49 30 12345678",
        "email": "billing@acme.de"
      }
    },
    "buyer": {
      "name": "Example Corp",
      "electronicAddress": "FR12345678901",
      "electronicAddressSchemeId": "9930",
      "postalAddress": {
        "addressLine1": "12 Rue de Rivoli",
        "city": "Paris",
        "postcode": "75001",
        "countryCode": "FR"
      }
    },
    "deliveryInformation": {
      "actualDeliveryDate": "2025-07-01"
    },
    "paymentInstructions": {
      "meansCode": "30",
      "creditTransfer": {
        "accountIdentifier": "DE89370400440532013000"
      }
    },
    "documentTotals": {},
    "vatBreakdowns": [
      {
        "vatCategoryCode": "S",
        "vatCategoryRate": 19
      }
    ],
    "invoiceLines": [
      {
        "lineIdentifier": "1",
        "quantity": 10,
        "unitCode": "C62",
        "priceDetails": {
          "netPrice": 150
        },
        "lineVatInformation": {
          "vatCategoryCode": "S",
          "vatRate": 19
        },
        "itemInformation": {
          "name": "Consulting Services"
        }
      }
    ]
  },
  "config": {
    "spec": "xrechnung",
    "syntax": "cii",
    "version": "3.0.2"
  }
}
Response — application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rsm:CrossIndustryInvoice xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100" xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:100">
    <rsm:ExchangedDocumentContext>
        <ram:BusinessProcessSpecifiedDocumentContextParameter>
            <ram:ID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</ram:ID>
        </ram:BusinessProcessSpecifiedDocumentContextParameter>
        <ram:GuidelineSpecifiedDocumentContextParameter>
            <ram:ID>urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0</ram:ID>
        </ram:GuidelineSpecifiedDocumentContextParameter>
    </rsm:ExchangedDocumentContext>
    <rsm:ExchangedDocument>
        <ram:ID>INV-DEMO-001</ram:ID>
        <ram:TypeCode>380</ram:TypeCode>
        <ram:IssueDateTime>
            <udt:DateTimeString format="102">20250701</udt:DateTimeString>
        </ram:IssueDateTime>
    </rsm:ExchangedDocument>
    <rsm:SupplyChainTradeTransaction>
        <ram:IncludedSupplyChainTradeLineItem>
            <ram:AssociatedDocumentLineDocument>
                <ram:LineID>1</ram:LineID>
            </ram:AssociatedDocumentLineDocument>
            <ram:SpecifiedTradeProduct>
                <ram:Name>Consulting Services</ram:Name>
            </ram:SpecifiedTradeProduct>
            <ram:SpecifiedLineTradeAgreement>
                <ram:NetPriceProductTradePrice>
                    <ram:ChargeAmount>150.0</ram:ChargeAmount>
                    <ram:BasisQuantity>1</ram:BasisQuantity>
                </ram:NetPriceProductTradePrice>
            </ram:SpecifiedLineTradeAgreement>
            <ram:SpecifiedLineTradeDelivery>
                <ram:BilledQuantity unitCode="C62">10</ram:BilledQuantity>
            </ram:SpecifiedLineTradeDelivery>
            <ram:SpecifiedLineTradeSettlement>
                <ram:ApplicableTradeTax>
                    <ram:TypeCode>VAT</ram:TypeCode>
                    <ram:CategoryCode>S</ram:CategoryCode>
                    <ram:RateApplicablePercent>19</ram:RateApplicablePercent>
                </ram:ApplicableTradeTax>
                <ram:SpecifiedTradeSettlementLineMonetarySummation>
                    <ram:LineTotalAmount>1500.00</ram:LineTotalAmount>
                </ram:SpecifiedTradeSettlementLineMonetarySummation>
            </ram:SpecifiedLineTradeSettlement>
        </ram:IncludedSupplyChainTradeLineItem>
        <ram:ApplicableHeaderTradeAgreement>
            <ram:BuyerReference>991-12345-67</ram:BuyerReference>
            <ram:SellerTradeParty>
                <ram:Name>Acme GmbH</ram:Name>
                <ram:SpecifiedLegalOrganization>
                    <ram:ID>HRB98765</ram:ID>
                </ram:SpecifiedLegalOrganization>
                <ram:DefinedTradeContact>
                    <ram:PersonName>Max Mustermann</ram:PersonName>
                    <ram:TelephoneUniversalCommunication>
                        <ram:CompleteNumber>+49 30 12345678</ram:CompleteNumber>
                    </ram:TelephoneUniversalCommunication>
                    <ram:EmailURIUniversalCommunication>
                        <ram:URIID>billing@acme.de</ram:URIID>
                    </ram:EmailURIUniversalCommunication>
                </ram:DefinedTradeContact>
                <ram:PostalTradeAddress>
                    <ram:PostcodeCode>10115</ram:PostcodeCode>
                    <ram:LineOne>Musterstr. 1</ram:LineOne>
                    <ram:CityName>Berlin</ram:CityName>
                    <ram:CountryID>DE</ram:CountryID>
                </ram:PostalTradeAddress>
                <ram:URIUniversalCommunication>
                    <ram:URIID schemeID="9930">DE123456789</ram:URIID>
                </ram:URIUniversalCommunication>
                <ram:SpecifiedTaxRegistration>
                    <ram:ID schemeID="VA">DE123456789</ram:ID>
                </ram:SpecifiedTaxRegistration>
            </ram:SellerTradeParty>
            <ram:BuyerTradeParty>
                <ram:Name>Example Corp</ram:Name>
                <ram:PostalTradeAddress>
                    <ram:PostcodeCode>75001</ram:PostcodeCode>
                    <ram:LineOne>12 Rue de Rivoli</ram:LineOne>
                    <ram:CityName>Paris</ram:CityName>
                    <ram:CountryID>FR</ram:CountryID>
                </ram:PostalTradeAddress>
                <ram:URIUniversalCommunication>
                    <ram:URIID schemeID="9930">FR12345678901</ram:URIID>
                </ram:URIUniversalCommunication>
            </ram:BuyerTradeParty>
        </ram:ApplicableHeaderTradeAgreement>
        <ram:ApplicableHeaderTradeDelivery>
            <ram:ActualDeliverySupplyChainEvent>
                <ram:OccurrenceDateTime>
                    <udt:DateTimeString format="102">20250701</udt:DateTimeString>
                </ram:OccurrenceDateTime>
            </ram:ActualDeliverySupplyChainEvent>
        </ram:ApplicableHeaderTradeDelivery>
        <ram:ApplicableHeaderTradeSettlement>
            <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>
            <ram:SpecifiedTradeSettlementPaymentMeans>
                <ram:TypeCode>30</ram:TypeCode>
                <ram:PayeePartyCreditorFinancialAccount>
                    <ram:IBANID>DE89370400440532013000</ram:IBANID>
                </ram:PayeePartyCreditorFinancialAccount>
            </ram:SpecifiedTradeSettlementPaymentMeans>
            <ram:ApplicableTradeTax>
                <ram:CalculatedAmount>285.00</ram:CalculatedAmount>
                <ram:TypeCode>VAT</ram:TypeCode>
                <ram:BasisAmount>1500.00</ram:BasisAmount>
                <ram:CategoryCode>S</ram:CategoryCode>
                <ram:RateApplicablePercent>19</ram:RateApplicablePercent>
            </ram:ApplicableTradeTax>
            <ram:SpecifiedTradePaymentTerms>
                <ram:Description>Payment due</ram:Description>
            </ram:SpecifiedTradePaymentTerms>
            <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
                <ram:LineTotalAmount>1500.00</ram:LineTotalAmount>
                <ram:TaxBasisTotalAmount>1500.00</ram:TaxBasisTotalAmount>
                <ram:TaxTotalAmount currencyID="EUR">285.00</ram:TaxTotalAmount>
                <ram:GrandTotalAmount>1785.00</ram:GrandTotalAmount>
                <ram:DuePayableAmount>1785.00</ram:DuePayableAmount>
            </ram:SpecifiedTradeSettlementHeaderMonetarySummation>
        </ram:ApplicableHeaderTradeSettlement>
    </rsm:SupplyChainTradeTransaction>
</rsm:CrossIndustryInvoice>

Real engine output from the request on the left — a complete, KoSIT-validated XRechnung 3.0.2 CII document.

Try it with curl
curl
curl -X POST https://invoice-spec.onrender.com/v1/invoice/xrechnung \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/xml" \
  -d '{"invoice":{"invoiceNumber":"INV-DEMO-001","issueDate":"2025-07-01","invoiceTypeCode":"380","currencyCode":"EUR","buyerReference":"991-12345-67","seller":{"name":"Acme GmbH","legalRegistrationIdentifier":"HRB98765","vatIdentifier":"DE123456789","electronicAddress":"DE123456789","electronicAddressSchemeId":"9930","postalAddress":{"addressLine1":"Musterstr. 1","city":"Berlin","postcode":"10115","countryCode":"DE"},"contact":{"contactPoint":"Max Mustermann","telephone":"+49 30 12345678","email":"billing@acme.de"}},"buyer":{"name":"Example Corp","electronicAddress":"FR12345678901","electronicAddressSchemeId":"9930","postalAddress":{"addressLine1":"12 Rue de Rivoli","city":"Paris","postcode":"75001","countryCode":"FR"}},"deliveryInformation":{"actualDeliveryDate":"2025-07-01"},"paymentInstructions":{"meansCode":"30","creditTransfer":{"accountIdentifier":"DE89370400440532013000"}},"documentTotals":{},"vatBreakdowns":[{"vatCategoryCode":"S","vatCategoryRate":19}],"invoiceLines":[{"lineIdentifier":"1","quantity":10,"unitCode":"C62","priceDetails":{"netPrice":150},"lineVatInformation":{"vatCategoryCode":"S","vatRate":19},"itemInformation":{"name":"Consulting Services"}}]},"config":{"spec":"xrechnung","syntax":"cii","version":"3.0.2"}}'
  • Validated by the official KoSIT validator
  • Built on the EN 16931 semantic model
  • Pin a spec version per validation call
  • Every request traceable via X-Request-Id
  • Zero data retention — invoice content is never stored
  • No AI training on your data

Capabilities

Generation and validation for both German e-invoice formats, plus direct EN 16931 support.

Generate XRechnung

Submit structured invoice data and receive EN 16931-compliant XRechnung XML (UBL 2.1 or CII D16B, v3.0.2).

Validate XRechnung

Check an invoice against the XRechnung 3.0.2 syntax and business rules before you send it.

Generate ZUGFeRD

Produce a ZUGFeRD PDF/A-3 document with embedded EN 16931 CII XML, in BASIC, EN16931, or XRECHNUNG profiles.

Validate ZUGFeRD

Validate an existing ZUGFeRD PDF/A-3, including its embedded XML, against the selected profile.

EN 16931 support

EN 16931 is a first-class capability with its own endpoints — generate and validate against the European semantic model directly.

ZUGFeRD: one file, two readers

A ZUGFeRD invoice is a single PDF/A-3 that carries a human-readable invoice page and the machine-readable EN 16931 CII XML embedded inside it — generated from one canonical JSON so they never diverge. See the real document on the ZUGFeRD API page.

See the ZUGFeRD API
Real generated ZUGFeRD PDF/A-3 invoice — page 1
PDF/A-3with EN 16931 CII XML embedded inside

How it works

From structured invoice data to a standards-compliant document — the engine handles the format mapping and rule checking.

  1. 1

    Send structured data

    POST a canonical JSON invoice to the API. No XML hand-authoring, no PDF layout work.

  2. 2

    Engine maps to the standard

    InvoiceSpec maps your data to the XRechnung / ZUGFeRD / EN 16931 model and applies the format's syntax and business rules.

  3. 3

    Receive a compliant document

    Get back a standards-compliant XML or PDF/A-3 document, or a structured validation result listing any issues.

Start with 50 free trial credits

Generate and validate XRechnung and ZUGFeRD invoices against the real API — no credit card required to get started.

Start FreeView pricing