Verzendingskanalen

Beschikbare kanalen

De gegevens zullen kunnen worden verzonden via een web service (API), via een batchkanaal of via een webtoepassing aangeboden op de portaalsite van de sociale zekerheid.

Via de web service en het batchkanaal kunnen grote volumes worden verzonden. Deze twee kanalen zijn gericht op grote verzenders, zoals bijvoorbeeld sociale secretariaten, dienstverleners en grote werkgevers.

De webtoepassing daarentegen is niet ontworpen voor de verwerking van dergelijke grote volumes en is eerder gericht op kleine werkgevers.

Alle kanalen (de web service, het batchkanaal en de webtoepassing) laten toe om de volgende types berichten te verzenden:

Een origineel bericht waarmee een loonberekening voor de eerste maal wordt aangegeven.
Een wijzigend bericht waarmee eerder ingediende gegevens worden aangepast.
Een annulerend bericht waarmee eerder ingediende gegevens worden verwijderd.

Het gebruik van het ene kanaal sluit het gebruik van het andere kanaal niet uit. Berichten verzonden via het ene kanaal kunnen worden gewijzigd of verwijderd via de twee andere kanalen. Bijvoorbeeld, een origineel bericht verzonden via de web service kan worden gewijzigd of verwijderd via de webtoepassing of via het batchkanaal.

Web service en batchkanaal

De wijzigingen gebeuren volgens het principe 'annuleren en vervangen'. Als een situatie wijzigt, dan moet de volledige nieuwe situatie, inclusief de eventuele ongewijzigde elementen, worden aangegeven en niet enkel het verschil tussen de oude situatie en de nieuwe situatie.

Een te wijzigen of te annuleren situatie wordt gedefinieerd door de combinatie

identificatie van de onderneming
INSZ van de natuurlijke persoon
identificatiesleutel van de berekening.

Web service (API)

De web service wordt beschreven in een swagger-bestand in YAML-formaat. Dit bestand is beschikbaar via https://egov.socialsecurity.be.

Bijkomende praktische informatie volgt op een later tijdstip.

Batchkanaal

De berichten verzonden via het batchkanaal worden opgesteld in JSON-formaat (JavaScript Object Notation) en niet in het XML-formaat. De structuur en de inhoud van de gegevens verzonden via het batchkanaal kan worden geconsulteerd in het swagger-bestand van de web service (zie hiervoor).

Het schema is beschikbaar via https://egov.socialsecurity.be.

Bijkomende praktische informatie (bijv. verbinden met de server, uitwisselingsmappen, bestandsnamen, …) volgt op een later tijdstip.

Webtoepassing

Op de portaalsite van de sociale zekerheid (https://www.socialsecurity.be) zal een webtoepassing worden voorzien om de LTDS-berichten te beheren.

Deze toepassing zal toelaten om originele berichten te verzenden, eerder ingediende berichten te wijzigen en eerder ingediende berichten te verwijderen.

Meer informatie over deze webtoepassing volgt op een later tijdstip.