Overslaan en naar hoofdcontent gaan

Hoe sluit ik aan op Aanleveren Portaal?

Support medewerker
  • Bijgewerkt

Introductie

Softwarepartners hebben verschillende opties voor het aansluiten op de infrastructuur van SBR Nexus via het Aanleveren Portaal (voorheen 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 Aanleveren Portaal. 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 Aanleveren Portaal

Aanleveren Portaal ondersteunt zowel handmatige als system-to-system communicatie. Zodra je beschikt over een geldig eHerkenningmiddel kan je inloggen op het portaal. 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 Aanleveren Portaal API. 

3. Genereer API token

Voor het insturen van SBR berichten heb je eenmalig een API token nodig. Deze genereer je eenvoudig in het portaal. Deze kan je vervolgens in je software gebruiken om met de Aanleveren Portaal 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:

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 Aanleveren Portaal 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 Aanleveren Portaal acceptatie (Acceptatie omgeving)

6. Status- en foutcodes 

Aanleveren portaal 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 Aanleveren Portaal). 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 Aanleveren portaal 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 aanleveren portaal(/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)

MDMB_API_flow.png

7. Testen op Aanleveren Portaal Acceptatie 

Inloggen op de Productie omgeving van Aanleveren Portaal gebeurt d.m.v. eHerkenning, op de Acceptatie omgeving van Aanleveren Portaal 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@sbrnexus.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)

1.png

  • Entrypoint:                         VT15 Huurinformatie (zie onderstaand voorbeeld uit de berichtsoortenservice API)

2.png

  • Uitvragende partij:         Voor testaanleveringen welke beoordeeld dienen te worden door SBR Nexus: “SBR Nexus” (ID-ontvanger: 00000003111111190000, zie onderstaand voorbeeld uit de berichtsoortenservice API)

3.png

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 Aanleveren Portaal 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

 

Was dit artikel nuttig?
Aantal gebruikers dat dit nuttig vond: 0 van 0