Introductie
Softwarepartners hebben verschillende opties voor het aansluiten op de infrastructuur van SBR Nexus via Mijn Data, Mijn Business. In dit document worden de stappen op een rij gezet om softwarepartners te helpen bij de voorbereiding om de aansluiting zo eenvoudig mogelijk te maken.
We onderscheiden twee stappen die hiervoor genomen moeten worden: XBRL creatie en XBRL verzending.
1. Aanvraag eHerkenningsmiddel
Je hebt een eHerkenningsmiddel nodig om als gebruiker in te loggen op Mijn Data Mijn Business. Het eHerkenningsmiddel wordt uitgegeven op organisatieniveau. De uitgifte van het eHerkenningsmiddel wordt uitgevoerd door een erkende eHerkenningsleverancier. Meer informatie vindt je hier. Voor het testen van je software kun je eventueel een testmiddel aanvragen bij SBR Nexus om toegang te krijgen tot de acceptatieomgeving.
2. Gebruik MDMB
MDMB ondersteunt zowel handmatige als system-to-system communicatie. Zodra je beschikt over een geldig eHerkenningmiddel kan je inloggen op MDMB. Via de gebruikersinterface ben je in staat om een SBR-rapportage handmatig (in XBRL-formaat) te verzenden naar de juiste ontvangende partij. Klik daarvoor op de tegel 'SBR Jaarrekening'.
Wil je liever system-to-system aanleveren in SBR? Dan dien je te beschikken over een API token waarmee jouw software kan aanleveren aan de ontvangende partij. Je leest hier meer over de MDMB API.
3. Genereer API token
Voor het insturen van SBR berichten heb je eenmalig een API token nodig. Deze genereer je eenvoudig in het MDMB portaal. Deze kan je vervolgens in je software gebruiken om met de MDMB API te communiceren.
Wil je liever via automatisch API tokens uitwisselen? Volg dan deze link naar onze OAuth-koppeling documentatie.
4. Maak een XBRL-bestand
De data vanuit een softwarepakket dient omgezet te worden naar het XBRL-formaat, aangezien dit het enige formaat is dat via de infrastructuur van SBR Nexus naar de ontvangende partijen verzonden kan worden. De XBRL-specificaties worden internationaal, in talloze sectoren toegepast en zijn dus niet specifiek voor SBR Nexus, de specificaties zijn gepubliceerd op https://www.xbrl.org/.
De opties voor xbrl creatie zijn:
- Eigen ontwikkeling van tooling
- Gebruikmaken van tooling van derden, bijvoorbeeld:
- Accept (website: https://www.acc.nl)
- Batavia (website: https://www.batavia-xbrl.com)
- Semansys (website: https://semansys.com)
- ParsePort (website: https://parseport.com/nl/)
Beschik je over een ander bestandsformaat dan XBRL? Dan kan je mogelijk gebruikmaken van de converter. Converteer eenvoudig je huidige bestandsformaat zoals XML naar het juiste XBRL-formaat. Hiervoor kun je gebruik maken van de converter (API).
Ondersteuning van Financieren Taxonomie of Vastgoedtaxonomie
Een softwarepakket dient een actuele versie van de Financieren Taxonomie of Vastgoedtaxonomie te ondersteunen. De actuele versie van de taxonomieën en bijhorende documentatie zijn hier te vinden.
Voldoen aan het Bancair Kwaliteitsraamwerk voor de SBR Jaarrekeningen (Kredietrapportages)
In het Bancair Kwaliteitsraamwerk voor Kredietrapportages zijn de kwaliteitsnormen en standaarden voor de SBR Jaarrekeningen (Kredietrapportages) vastgelegd.
SBR Nexus testbeleid XBRL
SBR Nexus publiceert diverse datastandaarden in de vorm van dataproducten voor zakelijk gebruik in Nederland. Ieder jaar worden nieuwe versies van deze producten gepubliceerd.
Dit document beschrijft het beleid voor de ketentest (end to end test) van deze producten in de aanleverketen. In dit beleid staat het testen centraal, omdat zorgvuldig testen cruciaal is voor het waarborgen van de datakwaliteit in de gehele keten.
5. Stuur het XBRL-rapport naar de bank
De opties voor de verzending van een XBRL bestand naar de ontvangende partijen zijn:
- Aansluiten op de REST API van Mijn Data, Mijn Business door zelf een koppeling te ontwikkelen.
- Hiervoor kun je gebruik maken van deze API documentatie
- Of van de beschikbaar Swagger documentatie (Acceptatie omgeving)
- Handmatige upload van een XBRL bestand op Mijn Data, Mijn Business (Acceptatie omgeving)
6. Status- en foutcodes
MDMB stuurt het XBRL-bestand naar de BIV. De BIV is de Bancaire Infrastructurele Voorziening van SBR Nexus en draagt zorg voor de validaties van de berichten en routering aan de juiste ontvanger. Indien het bericht niet voldoet aan de eisen, zal de BIV dit afkeuren.
In de technische documentatie BIV vind je de fout- en statusmeldingen die door de BIV kunnen worden teruggestuurd aan partijen die gebruik maken van de BIV services (ook via MDMB). Deze zijn de vinden in de Appendix "A. Status and fault codes".
Bij de totstandkoming van nieuwe services en nieuwe verwerkingsprocessen binnen deze koppelvlakken kunnen nieuwe fout- en statusmeldingen worden gedefinieerd. De technische documentatie bevat deze meldingen voor het koppelvlak BIV: WUS 2.0 voor Bedrijven versie 1.2.
Elke foutcode heeft een drieletterige prefix. Deze prefix geeft weer voor welke service de fout is opgetreden.
De volgende prefixen worden gehanteerd (tussen haakjes de service die de fout genereert):
- ALS (Aanleverservice): fouten tijdens de aanlevering van de informatie
- AFS (Afleverservice): fouten tijdens de aflevering van de informatie
Een aanlevering via MDMB volgt het onderstaande proces, waarin de volgende calls te onderscheiden zijn:
- Call #1: Software roept API converter aan (/api/converter) --> Software ontvangt in de respons het xbrl bestand
- Call #2: ophalen beschikbare ontvangers / messagetypes (/api/messagetypes)
- Call #3: Verstuur xbrl bestand naar MDMB (/api/reports)
- Call #4: Update Kvk Nummer in de rapportage (/api/reports/{GUID}
- Call #5: verstuur xbrl bericht naar de bank (api/filings)
- Call #6: ophalen status van de aanlevering (api/filing)
7. Testen op MDMB Acceptatie
Inloggen op de Productie omgeving van MDMB gebeurt d.m.v. eHerkenning, op de Acceptatie omgeving van MDMB gebeurt dat echter d.m.v. gebruikersnaam en wachtwoord. Na het inloggen is het mogelijk om hier een koppelcode (API-token) aan te maken
- Voor het aanmaken van een gebruikersnaam en wachtwoord hebben wij de volgende gegevens nodig, deze kunnen gestuurd worden naar support@mijndatamijnbusiness.nl:
- Voornaam + achternaam
- E-mailadres
- Bedrijfsnaam
- KVK-nummer
De testparameters
- Omgeving: BTBA (Acceptatie)
- Berichtsoort: Huurlijst (of andere berichtsoorten i.e. jaarrekening, KYC enz.)
zie onderstaand voorbeeld uit de berichtsoortenservice API)
- Entrypoint: VT15 Huurinformatie (zie onderstaand voorbeeld uit de berichtsoortenservice API)
- Uitvragende partij: Voor testaanleveringen welke beoordeeld dienen te worden door SBR Nexus: “SBR Nexus” (ID-ontvanger: 00000003111111190000, zie onderstaand voorbeeld uit de berichtsoortenservice API)
Voor testaanleveringen welke niet beoordeeld dienen te worden door SBR Nexus (deze kan SBR Nexus niet inzien): “Test bank” (ID-ontvanger: 00000000123456780000)
De testscenario’s
Om na te gaan of de XBRL voldoet aan de kwaliteitsstandaarden is het raadzaam om verschillende scenario's te testen. Zo voorkom je dat berichten ongewenst worden afgekeurd wanneer het in gebruik is. Je kan de acceptatieomgeving van MDMB gebruiken voor de testwerkzaamheden. In het kopje hieronder 'XBRL verzending' wordt nader toegelicht hoe deze XBRL verzonden kan worden.
Graag ontvangen wij na het aanleveren van de testscenario het volgende per e-mail:
- Per scenario het BIV-kenmerk (deze ziet er bijvoorbeeld als volgt uit: BTA-220805-0000007)
Dit kan worden gemaild naar laurens.klomp@sbrnexus.nl