eProcurement.MercuriusService-01.00 (Simpl.ePRIOR)
Situering
Dit document beschrijft de (nieuwe) ePRIOR-service die aangeboden wordt door de Mercurius-backend: Simpl-ePRIOR. Mercurius werd ontworpen om een hele waaier aan eDocument-formaten binnen het e-procurement landschap (bvb orders, bestellingen, crediet notas, facturen, bevestigingen en dergelijke) uit te kunnen wisselen op een gestandaardiseerde manier. Hiervoor wordt PEPPOL ( peppol.eu ) gebruikt. PEPPOL BIS V3 voldoet aan de nieuwe Europese Norm EN 16931 voor elektronische facturatie.
De beschrijving van de verschillende soorten eDocumenten valt buiten de scope van dit document
De lezers van dit document zijn de consumenten van de Mercurius-diensten die via MAGDA VSB wensen aan te sluiten, dwz IT-teams van de Vlaamse publieke sector, die verantwoordelijk zijn voor de integratie van hun software voor de verwerking van eDocumenten binnen het e-procurement landschap.
Verwante diensten
Deze diensten vormen een verbeterde versie van de eProcurement.CustomerService-01.00 (e-Invoicing via webservice).
Gegevensbronnen
Opmerking:
Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens.Â
MAGDA ontsluit deze diensten voor de MAGDA afnemers (die via de PEP (= Datapower)) tot op onze VSB zullen komen.
Aan bron-kant bevindt zich de FSB (Federale Service Bus) – die beheerd wordt door BOSA – en die de vragen en antwoorden op zijn beurt door routeert naar de Federale Mercurius diensten.
Gebruiksvoorwaarden
Om gebruik te kunnen maken van deze dienst dient men geen specifieke machtiging te hebben om toegang te krijgen tot deze gegevens. Alle Vlaamse instellingen kunnen aansluiten. Er dient wel een toelatingsprocedure te worden doorlopen om aan te sluiten op één of meerdere Magda-diensten. De organisatie moet wel als aanbestedende overheid opgenomen zijn in de KBO.
Informatie:
Meer informatie over het aansluitingsproces is terug te vinden op deze webpagina.
Batch
Deze webservice is niet beschikbaar in een MAGDA batch-variant.
Functionaliteiten
Binnen deze dienst worden er 4 operaties aangeboden om documenten uit te wisselen en te beheren:
submitInboxRequest:Â de lijst met de te behandelen documenten ophalen
retrieveDocument: een document op te halen (= document en bijlage worden gedownload)Â
markDocument: een document te markeren (= verwijderen uit de te behandelen documenten)
submitDocument: een document te verzenden naar een bepaalde ontvanger
Werking
Aandachtspunten
Header
In elke vraag naar de VSB dient er een specifieke HEADER meegestuurd te worden.
In elk antwoord vanuit de VSB zal er een specifieke HEADER mee teruggestuurd te worden.
Zie VSB Header voor meer informatie met betrekking tot de VSB headers uit VRAAG en ANTWOORD.
Vereisten
Vooraleer een afnemer MAGDA diensten kan gebruiken moet die de MAGDA Toelatingsprocedure doorlopen. Deze procedure zorgt ervoor dat de afnemer wordt geregistreerd als gerechtigd gebruiker van één of meerdere MAGDA diensten. De afnemer krijgt daarbij de nodige codes en richtlijnen voor het aanroepen van de diensten, waaronder een URI (unieke identificatie van de afnemer) en hoedanigheidscode (identificeert in welke context de afnemer een dienst wenst te gebruiken).
De VSB valideert of de afnemer van de dienst gemachtigd is om de operatie uit te voeren in naam van een bepaald KBO: verzenden van berichten, ophalen van berichten, markeren van berichten of bekijken van berichten.
Let op. De string achter receiverId en senderId kan verschillende vormen aannemen: vb. '0123456789' (KBOnummer) of '8800000123456' (GLNnummer)
Hiervoor worden de KBO's die opgezet zijn voor de Afnemer URI (uit SyncHeader>Consumer>ApplicationID) vergeleken met 1 van de volgende elementen – afhankelijk van welke operatie opgeroepen wordt:
submitInboxRequest:Â submitInboxRequest>receiverId
retrieveDocument:Â retrieveDocument>receiverId
markDocument:Â markDocument>receiverId
submitDocument: KBO found inÂ
submitDocument>document/*/AccountingSupplierParty/Party/PartyIdentification/ID, or
submitDocument>document/*/AccountingSupplierParty/Party/EndpointID, or
submitDocument>document/*/AccountingSupplierParty/Party/PartyTaxScheme/CompanyID, or
submitDocument>document/*/AccountingSupplierParty/Party/PartyLegalEntity/CompanyID,
submitDocument>document/*/SellerSupplierParty/Party/PartyIdentification/ID, or
submitDocument>document/*/SellerSupplierParty/Party/EndpointID
submitDocument>document/*/SenderParty/PartyIdentification/ID, or
submitDocument>document/*/SenderParty /EndpointID
submitDocument>document/*/BuyerCustomerParty/Party/PartyIdentification/ID, or
submitDocument>document/*/BuyerCustomerParty/Party/EndpointID, or
submitDocument>document/*/BuyerCustomerParty/Party/PartyTaxScheme/CompanyID, or
submitDocument>document/*/BuyerCustomerParty/Party/PartyLegalEntity/CompanyID
Indien er voor de betrokken Afzender een passend KBO gevonden in 1 van de bovenstaande paden, wordt de operatie toegestaan.
Indien deze validatie faalt, wordt er een VSB-1005 UITZONDERING terug gegeven.
Responsetijden & Beschikbaarheid
Opmerking:
De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd.Â
Logging
Elke oproep brengt een log record met zich mee waarin enkele parameters uit de header weggeschreven worden. Daardoor kan het MAGDA team nakijken welke afnemer welke operatie opriep en wanneer deze oproep uitgevoerd werd.
Ondersteunde talen
Deze worden bepaald door het Mercurius team:Â A. Mercurius-webservice / simpl.ePRIOR
Op deze pagina
Binnen deze handleiding
Omgevingsinformatie
Domein | N/A |
---|---|
Classificatie | Persoonsgegevens |
Verwante diensten
Â
Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren
De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid
uitgegeven door Digitaal Vlaanderen