Ändringar i XML-scheman för web service-tjänsten för direkt meddelandedeklarering

MEDDELANDETRAFIK Tullstyrelsen Direkt meddelandedeklarering 4.12.2010 Ändringar i XML-scheman för web service-tjänsten för direkt meddelandedeklarering v.1.5 ändring 4.12.2010

INNEHÅLLSFÖRTECKNING lähdettä ei lähdettä ei 2 (7) lähdettä ei lähdettä ei 1 Inledning... 3 2 Tidtabell och kompatibilitet... 3 3 Distributionspaketets filer... 3 4 CustomsCorporateService.wsdl... 4 4.1 Location... 4 5 ApplicationMessageTypes.xsd... 5 5.1 Reference... 5 5.2 ContentFormat... 5 5.2.1 ApplicationRequest... 6 5.2.2 ApplicationResponse... 6

lähdettä ei lähdettä ei 3 (7) lähdettä ei lähdettä ei 1 Inledning I detta dokument beskrivs de i version 1.5 genomförda ändringarna i XML-schemana för web service-tjänsten för direkt meddelandedeklarering. Ifrågavarande XML-scheman används av de meddelandetrafikkunder som tillämpar web service-tjänsten för direkt meddelandedeklarering. Ändringarna gäller restriktioner av meddelandets kontrollreferens samt XML-element som beskriver typen av meddelandets datainnehåll. Kunden måste ta i bruk de nya XML-schemana, om kunden har planer på att börja inlämna exportdeklarationer i ELEX-systemet via Tullens web service-tjänst för direkt meddelandedeklarering. 2 Tidtabell och kompatibilitet De i version 1.5 beskrivna ändringarna i Tullens system gällande XML-scheman för web service-tjänsten för direkt meddelandedeklarering togs i bruk den 4 december 2010. För kunderna har det från detta datum framåt varit möjligt att enligt egen tidtabell ta i bruk de nya funktioner som implementerats i samband med ändringarna. De ändringar som gjorts i denna uppdatering är kompatibla bakåt. Stödet för den tidigare schemaversionen (1.1) fortsätter tills vidare. De kunder som inte behöver någon av de nya funktionerna som implementerats i samband med ändringarna, behöver inte ta i bruk de uppdaterade XML-schemana i detta skede. 3 Distributionspaketets filer XML-schemana för web service-tjänsten för direkt meddelandedeklarering finns tillgängliga som distributionspaket på Tullens webbplats: http://www.tulli.fi/sv/foretag/e_tjanster/meddelandetrafik/direkt_meddelandedeklarer ing/index.jsp Distributionspaketet innehåller följande filer: ApplicationMessageTypes.xsd ApplicationRequest.xsd ApplicationResponse.xsd CustomsCorporateService.wsdl EchoContent.xsd WsdlTypes.xsd

lähdettä ei lähdettä ei 4 (7) lähdettä ei lähdettä ei xmldsig-core-schema.xsd Detta distributionspaket ersätter samtliga filer i det tidigare distributionspaketet. Av kompatibilitetsskäl har alla filer i distributionspaketet uppdaterats på så sätt att minorversionsuppgiftens attribut är version="v1_5". I det tidigare distributionspaketets filer var minor-versionsuppgiftens attribut version="v1_1". Major-versionerna för all namnrymderna förblir oförändrade, värdet är alltså fortsättningsvis v1. Det är endast i filerna CustomsCorporateService.wsdl och ApplicationMessageTypes.xsd som man också gjort andra ändringar än sådana som gäller kommentarerna och versionsuppgifterna. Ändringarna beskrivs nedan. 4 CustomsCorporateService.wsdl 4.1 Location I filen CustomsCorporateService.wsdl har en ändring gjorts. Den beskrivs nedan. I WSDL-specifikationen för direkt meddelandedeklarering har man för XML-elementets adressattribut Location som nytt värde ställt kundtestmiljöns adress: <soap:address location="https://ws-customertest.tulli.fi/services/directmessageexchange" /> Bakom ändringen ligger de fall där kunderna i testningsskedet i misstag har försökt koppla sig till produktionsmiljöns adress. Produktionsmiljöns adress ingår fortfarande i WSDL-specifikationen: <!-- <soap:address location="https://ws.tulli.fi/services/directmessageexchange" />--> Övergången från kundtestmiljön till produktionsmiljön kan ske på flera olika sätt. Innan kunden övergår till produktionsmiljön kan denne genom att redigera WSDLfilen ta bort kommentartecknen runt produktionsmiljöns adress och ta ur bruk kundtestmiljöns adress. Eventuellt kan kundens program förutsätta att även andra åtgärder vidtas innan adressändringen träder i kraft. Ett mer rekommendabelt alternativ är att adressen för Tullens tjänst görs till en konfigurerbar parameter i kundens program. Kunden kan då redigera den adress för Tullens tjänst som programmet använder utan att behöva redigera WSDL-filen.

lähdettä ei lähdettä ei 5 (7) lähdettä ei lähdettä ei 5 ApplicationMessageTypes.xsd I filen ApplicationMessageTypes.xsd har två ändringar gjorts. De beskrivs nedan. 5.1 Reference Minimilängden för XML-elementtypen Reference har minskats från 14 tecken till 6 tecken. Efter ändringen gäller följande restriktioner för elementtypen: <xs:restriction base="xs:string"> <xs:maxlength value="14"/> <xs:minlength value="6"/> </xs:restriction> Elementtypen Reference används som meddelandets kontrollreferens. De fem första tecknen i dess datainnehåll består av en namnförkortning, t.ex. FIRMA, som tilldelats av Tullen. Kunden får bestämma över de övriga tecknen; vanligtvis används ett löpande nummer för dessa tecken. Ändringen medför att löpande nummer nu kan anges utan förnollor. 5.2 ContentFormat Restriktionerna för XML-elementtypen ContentFormat har ändrats. Tidigare gällde följande restriktioner för elementtypen: <xs:restriction base="xs:string"> <xs:minlength value="1"/> <xs:maxlength value="8"/> </xs:restriction> Efter ändringen gäller följande restriktioner för elementtypen: <xs:restriction base="xs:string"> <xs:pattern value="application/xml application/pdf application/zip [Xx][Mm][Ll]"/> </xs:restriction> I elementtypen använder man nu som värden MIME-mediatyper som beskriver datainnehållet i XML-elementet Content. Ändringen hänför sig till en ny funktion som medför att Tullen kan bifoga ett ZIP-arkiv till ett XML-meddelande som skickas till kunden. Denna nya funktion utnyttjas av Tullens system som skickar ett ZIP-arkiv innehållande en eller flera komprimerade PDF-filer till kunden.

5.2.1 ApplicationRequest lähdettä ei lähdettä ei 6 (7) lähdettä ei lähdettä ei Det av kunden upprättade UploadRequest-meddelandet innehåller ett ApplicationRequestdokument. Dokumentet innehåller alltid det XML-meddelande som skickas till Tullen. XML-meddelandet är base64-kodat och det ingår i underelementet Content som hör till XML-elementet ApplicationContent: <req:applicationcontent> <mess:content> base64-kodat XML-meddelande</mess:Content> <mess:contentformat>application/xml</mess:contentformat> </req:applicationcontent> I XML-elementet ContentFormat ställs typen på datainnehållet som förmedlas till Tullen. Kunderna kan skicka till Tullen endast sådana applikationsmeddelanden som är i XMLformat. Därför ska kunden alltid ställa application/xml som värde för XML-elementet ContentFormat. Innan ovan beskrivna ändring genomfördes var XML det enda tillåtna värdet för underelementet ContentFormat som hör till XML-elementet ApplicationContent. Det är fortsättningsvis tillåtet för kunderna att använda värdet XML tills vidare. 5.2.2 ApplicationResponse Det av Tullen upprättade DownloadResponse-meddelandet innehåller ett ApplicationResponse-dokument. Dokumentet innehåller alltid det XML-meddelande som Tullen skickar. XML-meddelandet är base64-kodat och det ingår i underelementet Content som hör till XML-elementet ApplicationResponseContent: <resp:applicationresponsecontent> <mess:content> base64-kodat XML-meddelande </mess:content> <mess:contentformat>application/xml</mess:contentformat> </resp:applicationresponsecontent> Om ApplicationResponse innehåller en bilaga ska den vara base64-kodad och ingå i underelementet Content som hör till XML-elementet AttachmentOfApplicationResponseContent: <resp:attachmentofapplicationresponsecontent> <mess:content> base64-kodat ZIP-arkivet </mess:content> <mess:contentformat>application/zip</mess:contentformat> </resp:attachmentofapplicationresponsecontent> Tullen ställer application/xml som MIME-mediatyp för XML-meddelandet och application/zip som MIME-mediatyp för det bifogade ZIP-arkivet

. lähdettä ei lähdettä ei 7 (7) lähdettä ei lähdettä ei