Documentation

Get USP credentials for e-invoicing to the Austrian government

To let Nori file invoices directly with the Austrian federal government, you need a dedicated webservice account from the Unternehmensserviceportal (USP). This guide takes you from USP registration to a successful connection test in Nori.

Invoices to Austrian federal agencies have to arrive as structured data. Nori handles that automatically through the e-Rechnung.gv.at webservice operated by BRZ – nothing gets uploaded by hand. What it needs from you is a dedicated USP webservice account. That is deliberately not your regular USP login but a technical account used only by machines. You create it once and then store it in Nori.

Before you start: your company must be registered with the USP and you need the USP administrator role there. Only administrators can create accounts and assign rights. If that is not you, ask whoever holds the role to run steps 1 to 4.

Six steps to filing with the federal government

  1. 1 Register with the USP
    Registering with the Unternehmensserviceportal is a one-off and free. You can do it with existing FinanzOnline credentials (via the FinanzOnline supervisor or as a sole trader), with ID Austria or a citizen card (via a legal representative with sole signing authority, or as a sole trader), or in person at your tax office’s Infocenter. Skip this step if your company is already registered. The USP Service Center answers questions on 050 233 733.
  2. 2 Assign the “e-Rechnung” procedure right
    In the USP click “Administration aufrufen”, then “Verfahrensrechte verwalten”. Pick the user account under “Kontoauswahl”, tick the “Einbringer” checkbox for the “e-Rechnung” procedure under “Verfügbare Verfahrensrechte” and confirm. Note that the right takes around 30 minutes to become available and only applies from the next sign-in.
  3. 3 Create the webservice account
    Open “Administration aufrufen” again, go to “Webservicekonten verwalten” (labelled “Webservice-Benutzer verwalten” in some USP views) and choose “Neues Konto anlegen”. Enter an email address, click “Anlegen” and then “Zugangsdaten anzeigen”. That screen shows the two values Nori needs: the account identification starting with “s” (for example s000123456) and the PIN. Note both down somewhere safe.
  4. 4 Assign the “Einbringer” webservice right
    Click “Webservicerechte verwalten”, select the account you just created under “Kontoauswahl”, then tick “Einbringer” under “E-RECHNUNG.GV.AT Webservice” in the “Verfügbare Webservicerechte” list and confirm with “Zuordnen”. If the menu entry is missing, sign out of the USP and back in. These rights also take a few minutes and apply from the next sign-in.
  5. 5 Store the credentials in Nori
    In Nori go to Settings → Billing (app.noridocs.com/settings/billing) and open the “E-Rechnung an den Bund (USP credentials)” section. Put the s-identification from step 3 into “Webservice account identification” and the PIN into “Webservice user password”, leave test mode on for now and save. The PIN is stored encrypted and never shown in clear text again.
  6. 6 Test the connection
    Click “Test connection” in the same section. Nori sends a minimal probe carrying the SOAP test flag to whichever endpoint your test-mode toggle currently selects. BRZ never processes or delivers it – it only checks whether the login works. Once Nori reports “BRZ accepted the USP credentials”, you are ready to file.

Mixed-up credentials are by far the most common cause of failure. BRZ expects the technical account identification of the webservice account (the s-prefixed value such as s000123456) together with its PIN. Not your regular USP login and password, and not the display name you gave the account (something like “USPAdmin01”). If the check comes back with “BRZ rejected the credentials”, one of those three values has almost always ended up in the field.

Test mode and production

The test-mode toggle decides which BRZ endpoint Nori submits to. On means at.gv.bmf.erb.test/V2, off means at.gv.bmf.erb/V2. Test invoices run through exactly the same technical validation as real ones, but are never processed or paid afterwards. That is the point: confirm your format and mandatory fields once before an invoice actually reaches the federal government.

One thing to watch: test and production access are two separate permissions. For the test endpoint, the webservice account additionally needs the “e-Rechnung.gv.at Webservice (T)” right. If that entry does not appear in the USP, a short email to support-erb@brz.gv.at asking for it to be enabled is enough. So an account can work in production and still fail in test – or the other way round.

Only switch test mode off after a successful test run. From then on every submission goes to the real federal government and is picked up for payment there.

What Nori needs on each invoice

The credentials open the channel; the content is checked separately. For an invoice to pass both the technical and the content review, these details have to be in place:

  • An order reference on the invoice. It is mandatory and comes from the agency that placed the order.

  • An order position on every invoice line where the order requires one.

  • The recipient’s VAT ID, which the ebInterface 6.1 schema requires.

  • Your company email address and IBAN in the team settings. BRZ sends processing notifications to that address.

  • The supplier number on the client record, if the agency assigned you one. Without it, payment can be delayed by manual matching.

If anything is missing, Nori blocks the submission and lists the missing fields right on the invoice. See Set up company details for the master data, and Create and file an e-invoice for the sending flow.

When the check fails

If BRZ rejects the login, work through these four questions in order. Is the s-identification really in the username field rather than the display name? Is the webservice account’s PIN stored rather than the USP password? Does the account carry the “Einbringer” right under “E-RECHNUNG.GV.AT Webservice” – plus the (T) variant for testing? And has anyone signed in to the USP again since the rights were assigned? New rights only take effect after that.

The full procedure is documented in the official BRZ Leitfaden Rechnungsstellung und -einbringung. The technical description of the webservice lives at erechnung.gv.at. If you are still stuck, support@noridocs.com will help.

Cancel anytime Hosted in the EU GDPR-compliant No credit card required