Connection details

Dit screenshot bevestigt dat er voor NL100005780 / Sway-it B.V. logistieke afspraken geregistreerd zijn in de pre-productie/testomgeving.
Wat ik hieruit lees:
| Veld | Waarde / betekenis |
|---|---|
| Geadresseerde ID | NL100005780 |
| Geadresseerde | 00.05 Sway-it B.V. / 00.04 Sway-it B.V. / 00.20 Sway-it B.V. |
| Berichtstroom | DMS, DMSZIP, VERVOER, EMCS |
| Kanaal | SMTP |
| Elektronisch adres | htg24000200@msa.preprod.htpoort.nl |
| Berichtformaat | XML of ZIP |
| Ingangsdatum | 05-12-2024 11:00 |
Wat betekent dit praktisch?
Je bent dus niet alleen “algemeen geregistreerd”; er zijn concrete logistieke afspraken ingericht voor berichtenverkeer via SMTP naar het MSA preprod-adres:
htg24000200@msa.preprod.htpoort.nl
Dat betekent praktisch dat jouw systeem in de pre-productieomgeving berichten kan uitwisselen via e-mail/SMTP met de Douane/HT-poort/MSA-keten, mits de berichten technisch correct zijn opgebouwd.
Voor DMS betekent dit
Je hebt twee relevante berichtstromen:
DMS – XML
- Voor gewone DMS-berichten in XML-formaat.
- Je software maakt een XML-bericht conform de DMS-specificatie.
- Dat bericht wordt via SMTP aangeboden.
DMSZIP – ZIP
- Voor ZIP-berichten.
- Dit is waarschijnlijk relevant wanneer berichten of bijlagen gebundeld/gecomprimeerd moeten worden.
- Het screenshot toont expliciet dat
DMSZIPals aparte berichtstroom met formaatZIPis ingericht.
De basisflow is dan waarschijnlijk als volgt
Je applicatie genereert een DMS XML-bericht
- Bijvoorbeeld een invoer-/uitvoeraangifte of ander DMS-berichttype.
- Het bericht moet voldoen aan de juiste XSD/MIG-specificatie.
Je applicatie verstuurt het bericht via SMTP
- Naar het elektronische adres dat in de logistieke afspraak staat:
htg24000200@msa.preprod.htpoort.nl
- Naar het elektronische adres dat in de logistieke afspraak staat:
De berichtstroom en het berichttype moeten herkenbaar zijn
- In de logistieke afspraak staat alleen de berichtstroom.
- In het daadwerkelijke bericht of de envelop/header moet waarschijnlijk duidelijk zijn welk berichttype het betreft.
- Dit moet exact volgens de MSA/HT-poort/DMS-specificatie.
Je ontvangt retourberichten
- Bijvoorbeeld technische ontvangstbevestiging.
- Validatiefouten.
- Functionele response.
- Statusupdates.
- Eventueel MRN/status vrijgave/controle, afhankelijk van het type aangifte.
Je software moet die retourberichten verwerken
- Niet alleen verzenden, maar ook mailbox uitlezen.
- Correlatie leggen met je eigen referentie/LRN.
- Foutcodes en statusberichten tonen aan de gebruiker.
Belangrijke nuance: dit is preprod
Het adres bevat:
msa.preprod.htpoort.nl
Dat betekent dat dit de pre-productieomgeving is. Je kunt hiermee testen, maar dit is niet per se productie. Voor productie zou je normaal gesproken een ander elektronisch adres/omgeving verwachten, zonder preprod.
Dus:
- Ja, dit bevestigt dat je praktisch via MSA/SMTP DMS-berichten kunt testen.
- Nee, dit is nog geen bewijs dat je productieaangiften bij de Douane indient.
- Voor productie moet er een aparte productie-logistieke afspraak/aansluiting zijn.
Wat moet je nu concreet doen om een DMS-testaangifte te sturen?
1. Bepaal de juiste berichtstroom
Voor DMS-aangiften gebruik je waarschijnlijk:
DMSvoor losse XML-berichten;DMSZIPals de specificatie vereist dat je een ZIP-bestand stuurt.
Begin met DMS/XML tenzij de documentatie expliciet zegt dat jouw scenario via ZIP moet.
2. Zoek de DMS berichtspecificatie op
Je hebt nodig:
- het juiste berichttype;
- XML schema/XSD;
- envelopspecificatie;
- naamgevingsconventies;
- SMTP-eisen;
- subjectregel/e-mailheaders;
- attachmentregels;
- retourberichtspecificaties.
Zonder die specificatie zou ik niet zomaar een e-mail met XML bijlage sturen, want de HT-poort verwacht vaak een zeer specifieke envelop/structuur.
3. Bouw een minimaal geldig testbericht
Gebruik een testcase uit de Douane/MSA-community of DMS testset. Een “zelfbedachte” aangifte faalt vaak op codes, vergunningen, goederencodes, locaties, vertegenwoordiging of testdata.
4. Verstuur via SMTP
Je verzendt naar:
texthtg24000200@msa.preprod.htpoort.nlcontent_copyCopy code
Afhankelijk van de specificatie kan het bericht:
- als body worden verstuurd;
- als XML-bijlage;
- als ZIP-bijlage;
- met specifieke bestandsnaam;
- met specifieke subjectregel;
- met aanvullende SMTP headers.
5. Lees de retourmailbox uit
De logistieke afspraak toont het adres waar berichten naartoe gaan, maar je moet ook weten via welk adres jij retourberichten ontvangt. In veel setups is er een retouradres/mailbox of MSA-account waar replies/statussen terechtkomen.
Je software moet dus minimaal:
- mail kunnen verzenden;
- mail kunnen ontvangen;
- XML/ZIP retourberichten kunnen parsen;
- foutmeldingen kunnen tonen;
- correlatie kunnen leggen met de verzonden aangifte.
Wat ik uit je screenshot zou concluderen
Je aansluiting lijkt technisch ingericht voor:
textDMS XML via SMTP DMS ZIP via SMTP VERVOER XML via SMTP EMCS XML via SMTPcontent_copyCopy code
Voor jouw vraag “kan ik bijvoorbeeld DMS-aangiften insturen?” is het antwoord:
Ja, in pre-productie lijkt je organisatie ingericht om DMS-berichten te kunnen uitwisselen via SMTP. Praktisch moet je nu de juiste DMS XML/ZIP specificatie volgen, testberichten opbouwen, via SMTP naar het preprod MSA-adres sturen en retourberichten verwerken.
Let op met productie
Als je echte aangiften wilt indienen, controleer dan of je ook een productieafspraak hebt. Die zou waarschijnlijk niet naar msa.preprod.htpoort.nl wijzen. Als je alleen dit screenshot hebt, dan praat je nu over testen, niet over live aangiften.
Kort stappenplan
- Open de MSA/NHD softwareontwikkelaarsdocumentatie.
- Pak de DMS XML/XSD/MIG en SMTP-envelopspecificatie.
- Gebruik een officiële testset/testcase.
- Genereer een geldig DMS XML-bericht.
- Verstuur via SMTP naar
htg24000200@msa.preprod.htpoort.nl. - Ontvang en verwerk de response.
- Los technische en functionele foutmeldingen op.
- Vraag daarna pas productie-aansluiting/logistieke afspraken aan of controleer of die al bestaan.
No Comments