Samband mellan ID:n i SDK, AS4/XHE och kvittenser

Teknisk beskrivning av identifierare, referenser och korrelationspunkter i ett exempel på meddelandeflöde inom SDK.

1. Syfte och tillämpning

Detta dokument anger hur identifierare i ett SDK-flöde ska tolkas och relateras till varandra när ett meddelande transporteras mellan meddelandetjänster och accesspunkter, samt när transportkvittenser och applikationskvittenser genereras.

Dokumentet utgår från ett konkret exempel och beskriver identifierare på verksamhetsnivå respektive transportnivå. Avsikten är att minska risken för sammanblandning mellan dessa nivåer vid integration, support och felsökning.

De XML-paths som anges nedan återger de relevanta fälten så nära de visade exemplen som möjligt, inklusive de prefix som förekommer i skärmbilderna.

2. Grundläggande principer

  • Med XHE-ID avses värdet i /ns5:XHE/ns3:Header/ID. I det visade exemplet återfinns samma värde även i payloadens messageId och conversationId samt motsvaras av AS4 ConversationId. XHE-ID utgör därmed meddelandets end-to-end-identitet.
  • Identifieraren för det ursprungliga SDK-meddelandet återfinns i det visade exemplet med samma värde i XHE-headern, payloadens messageId och payloadens conversationId.
  • AS4 MessageId ska betraktas som ett rent transport-ID. Ett sådant ID är unikt per transportmeddelande och ska inte användas som end-to-end-identitet för SDK-meddelandet.
  • AS4 ConversationId ska användas för att bära SDK-meddelandets identifierare genom transportkedjan.
  • AS4-signalmeddelandets RefToMessageId ska användas för att referera till det transportmeddelande som kvitteras.
  • Applikationskvittensens DocumentReference/ID ska användas för att referera till det ursprungliga SDK-meddelandet.

3. Identifierare i respektive meddelande

3.1 Ursprungligt meddelande från avsändande meddelandetjänst till avsändande accesspunkt

I det ursprungliga meddelandet sammanfaller meddelandets identitet, representerad av XHE-ID, i tre olika fält. Dessa fält ska i detta exempel betraktas som samma identitet.

This XML file does not appear to have any style information associated with it. The document tree is shown below.<ns5:XHE xmlns="http://docs.oasis-open.org/bdxr/ns/XHE/1/BasicComponents"         xmlns:ns2="http://docs.oasis-open.org/bdxr/ns/XHE/1/ExtensionComponents"         xmlns:ns3="http://docs.oasis-open.org/bdxr/ns/XHE/1/AggregateComponents"         xmlns:ns4="http://www.w3.org/2000/09/xmldsig#"         xmlns:ns5="http://docs.oasis-open.org/bdxr/ns/XHE/1/ExchangeHeaderEnvelope"         xmlns:ns6="urn:riv:infrastructure:messaging:MessageWithAttachments:3">      <XHEVersionID>1.0</XHEVersionID>      <CustomizationID>urn:fdc:digg.se:edelivery:xhe:1</CustomizationID>      <ns3:Header>              <ID>7240b203-2046-423f-84eb-6646f0269cbe</ID>              <CreationDateTime>2026-01-07T13:57:40.009Z</CreationDateTime>              <ns3:BusinessScope>…</ns3:BusinessScope>              <ns3:FromParty>…</ns3:FromParty>              <ns3:ToParty>…</ns3:ToParty>       </ns3:Header>       <ns3:Payloads>               <ns3:Payload>                        <DocumentTypeCode>Q{urn:riv:infrastructure:messaging:MessageWithAttachments:3}messagePayload</DocumentTypeCode>                        <ContentTypeCode>application/xml</ContentTypeCode>                        <HandlingServiceID>sdk-testclient.0203:sdk-testclient.sandbox-open-test.digg.se</HandlingServiceID>                        <InstanceEncryptionIndicator>true</InstanceEncryptionIndicator>                        <ns3:PayloadContent>      <ns6:messagePayload>               <ns6:message>                        <ns6:messageHeader>      <ns6:creationDateTime>2026-01-07T13:57:33.896Z</ns6:creationDateTime>                                <ns6:messageId>7240b203-2046-423f-84eb-6646f0269cbe</ns6:messageId>                                <ns6:conversationId>7240b203-2046-423f-84eb-6646f0269cbe</ns6:conversationId>                                <ns6:label>Testar</ns6:label>                                <ns6:confidentiality>false</ns6:confidentiality>                                <ns6:generatingSystem>…</ns6:generatingSystem>                                <ns6:recipient>…</ns6:recipient>                                <ns6:sender>…</ns6:sender>                       </ns6:messageHeader>                        <ns6:messageBody>…</ns6:messageBody>                </ns6:message>       </ns6:messagePayload></ns3:PayloadContent>              </ns3:Payload>        </ns3:Payloads>        <dsig:Signature xmlns:dsig="http://www.w3.org/2000/09/xmldsig#">…</dsig:Signature></ns5:XHE>


Begrepp

Exakt XML-path

Värde

XHE Header ID

/ns5:XHE/ns3:Header/ns3:ID

7240b203-2046-423f-84eb-6646f0269cbe

Payload messageId

/ns5:XHE/ns3:Payloads/ns3:Payload/ns3:PayloadContent/ns6:messagePayload/ns6:message/ns6:messageHeader/ns6:messageId

7240b203-2046-423f-84eb-6646f0269cbe

Payload conversationId

/ns5:XHE/ns3:Payloads/ns3:Payload/ns3:PayloadContent/ns6:messagePayload/ns6:message/ns6:messageHeader/ns6:conversationId

7240b203-2046-423f-84eb-6646f0269cbe

Slutsats: Meddelandets identifierare är 7240b203-2046-423f-84eb-6646f0269cbe.

3.2 AS4-användarmeddelande från avsändande accesspunkt till mottagande accesspunkt

När accesspunkten skapar ett AS4-meddelande genereras ett nytt transport-ID. SDK-meddelandets identitet bärs därefter vidare i AS4 ConversationId.

This XML file does not appear to have any style information associated with it. The document tree is shown below.<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope">                           <env:Header>                                   <eb:Messaging xmlns:eb="http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/ns/core/200704/"                                                                    xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"                                                                    env:mustUnderstand="true"                                                                    wsu:Id="_11f7edba0c05885df9c100c52d97fd5dcb7e5042a2e0a2e50920589f4f8399c30">                                           <eb:UserMessage mpc="http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/ns/core/200704/defaultMPC">                                                <eb:MessageInfo>                                                          <eb:Timestamp>2026-01-07T13:57:40.000Z</eb:Timestamp>                                                          <eb:MessageId>d4b9da2c-ebd0-11f0-aa9c-0a580a810632@sdk-testclient.open-test</eb:MessageId>                                                 </eb:MessageInfo>                                                 <eb:PartyInfo>                                                         <eb:From>                                                                <eb:PartyId type="urn:fdc:digg.se:edelivery:transportprofile:as4:partytype:ap">AP0001-OPEN-TEST</eb:PartyId>                                                                <eb:Role>http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/ns/core/200704/initiator</eb:Role>                                                          </eb:From>                                                          <eb:To>                                                                 <eb:PartyId type="urn:fdc:digg.se:edelivery:transportprofile:as4:partytype:ap">SANDBOX-OPEN-TEST</eb:PartyId>                                                                 <eb:Role>http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/ns/core/200704/responder</eb:Role>                                                           </eb:To>                                                   </eb:PartyInfo>                                                   <eb:CollaborationInfo>                                                            <eb:Service type="urn:fdc:digg.se:edelivery:process">bdx:noprocess</eb:Service>                                                            <eb:Action>busdox-docid-qns::urn:riv:infrastructure:messaging:MessageWithAttachments:3::messagePayload##3.0::tm-base-ext-sigenc</eb:Action>                                                            <eb:ConversationId>7240b203-2046-423f-84eb-6646f0269cbe</eb:ConversationId>                                                     </eb:CollaborationInfo>                                                      <eb:MessageProperties>…</eb:MessageProperties>                                                                                                                                                                                              <eb:PayloadInfo>…</eb:PayloadInfo>                                                                                                                                                                                      </eb:UserMessage>                                    </eb:Messaging>                                    <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"                                                                     xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"                                                                     env:mustUnderstand="true">…</wsse:Security>                           </env:Header>                           <env:Body xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"                                     wsu:Id="_21f7edba0c05885df9c100c52d97fd5dcb7e5042a2e0a2e50920589f4f8399c30"/></env:Envelope>

 

Begrepp

Exakt XML-path

Värde

AS4 MessageId

/env:Envelope/env:Header/eb:Messaging/eb:UserMessage/eb:MessageInfo/eb:MessageId

d4b9da2c-ebd0-11f0-aa9c-0a580a810632

AS4 ConversationId

/env:Envelope/env:Header/eb:Messaging/eb:UserMessage/eb:CollaborationInfo/eb:ConversationId

7240b203-2046-423f-84eb-6646f0269cbe

Slutsats: d4b9da2c-ebd0-11f0-aa9c-0a580a810632 identifierar det specifika transportmeddelandet, medan 7240b203-2046-423f-84eb-6646f0269cbe fortsatt identifierar SDK-meddelandet.

3.3 AS4-signalmeddelande (kvittens) från mottagande accesspunkt till avsändande accesspunkt

AS4-kvittensen är ett separat signalmeddelande med eget MessageId. Referensen till det kvitterade transportmeddelandet anges i RefToMessageId.

This XML file does not appear to have any style information associated with it. The document tree is shown below.<S12:Envelope xmlns:S12="http://www.w3.org/2003/05/soap-envelope"              xmlns:ds="http://www.w3.org/2000/09/xmldsig#"              xmlns:eb3="http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/ns/core/200704/"              xmlns:ebbp="http://docs.oasis-open.org/ebxml-bp/ebbp-signals-2.0"              xmlns:ebint="http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/ns/multihop/200902/"              xmlns:wsa="http://www.w3.org/2005/08/addressing"              xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"              xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">                           <S12:Header>                                   <eb3:Messaging S12:mustUnderstand="true"                                                                   id="_ebmessaging_N65541"                                                                   wsu:Id="_11f7edba0c05885df9c100c52d97fd5dcb7e5042a2e0a2e50920589f4f8399c30">                                            <eb3:SignalMessage>                                                      <eb3:MessageInfo>                                                              <eb3:Timestamp>2026-01-07T13:57:41.000Z</eb3:Timestamp>                                                              <eb3:MessageId>d5276936-ebd0-11f0-bfc0-0a580a830792@sdk-testclient.sandbox-open-test</eb3:MessageId>                                                              <eb3:RefToMessageId>d4b9da2c-ebd0-11f0-aa9c-0a580a810632@sdk-testclient.open-test</eb3:RefToMessageId>                                                      </eb3:MessageInfo>                                                      <eb3:Receipt>…</eb3:Receipt>                                              </eb3:SignalMessage>                                     </eb3:Messaging>                                     <wsse:Security S12:mustUnderstand="true">…</wsse:Security>                            </S12:Header>                             <S12:Body wsu:Id="N65677"/></S12:Envelope>


Begrepp

Exakt XML-path

Värde

Signalmeddelandets MessageId

/S12:Envelope/S12:Header/eb3:Messaging/eb3:SignalMessage/eb3:MessageInfo/eb3:MessageId

d5276936-ebd0-11f0-bfc0-0a580a830792

RefToMessageId

/S12:Envelope/S12:Header/eb3:Messaging/eb3:SignalMessage/eb3:MessageInfo/eb3:RefToMessageId

d4b9da2c-ebd0-11f0-aa9c-0a580a810632

Slutsats: transportkorrelationen för AS4-kvittensen sker mellan RefToMessageId och det tidigare AS4 MessageId:t. Kvittensen refererar således till transportnivån, inte direkt till SDK-meddelandets ID.

3.4 Applikationskvittens från mottagande meddelandetjänst

Applikationskvittensen är ett nytt SDK-meddelande med eget ID. Samtidigt innehåller kvittensen en explicit referens till det ursprungliga SDK-meddelandet.

This XML file does not appear to have any style information associated with it. The document tree is shown below.<ns5:XHE xmlns:ns5="http://docs.oasis-open.org/bdxr/ns/XHE/1/ExchangeHeaderEnvelope"         xmlns="http://docs.oasis-open.org/bdxr/ns/XHE/1/BasicComponents"         xmlns:ns2="http://docs.oasis-open.org/bdxr/ns/XHE/1/ExtensionComponents"         xmlns:ns3="http://docs.oasis-open.org/bdxr/ns/XHE/1/AggregateComponents"         xmlns:ns4="http://www.w3.org/2000/09/xmldsig#"         xmlns:ns6="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"         xmlns:ns7="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"         xmlns:ns8="urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2">                           <XHEVersionID>1.0</XHEVersionID>                           <CustomizationID>urn:fdc:digg.se:edelivery:xhe:1</CustomizationID>                           <ns3:Header>                                    <ID>df5771db-73f3-4668-8940-154d81c92fbb</ID>                                     <CreationDateTime>2026-01-07T13:58:00.008Z</CreationDateTime>                                     <ns3:BusinessScope>…</ns3:BusinessScope>                                     <ns3:FromParty>…</ns3:FromParty>                                     <ns3:ToParty>…</ns3:ToParty>                           </ns3:Header>                           <ns3:Payloads>                                   <ns3:Payload>                                           <DocumentTypeCode>Q{urn:oasis:names:specification:ubl:schema:xsd:ApplicationResponse-2}ApplicationResponse</DocumentTypeCode>                                           <ContentTypeCode>application/xml</ContentTypeCode>                                           <HandlingServiceID>sdk-testclient.0203:sdk-testclient.open-test.digg.se</HandlingServiceID>                                           <InstanceEncryptionIndicator>false</InstanceEncryptionIndicator>                                           <ns3:PayloadContent>                                                   <ns8:ApplicationResponse>                                                            <ns6:CustomizationID>urn:fdc:digg.se:edelivery:messagetype:response:1</ns6:CustomizationID>                                                            <ns6:ProfileID>bdx:noprocess</ns6:ProfileID>                                                            <ns6:ID>df5771db-73f3-4668-8940-154d81c92fbb</ns6:ID>                                                            <ns6:IssueDate>2026-01-07Z</ns6:IssueDate>                                                            <ns6:IssueTime>13:58:00.007Z</ns6:IssueTime>                                                            <ns7:SenderParty>…</ns7:SenderParty>                                                            <ns7:ReceiverParty>…</ns7:ReceiverParty>                                                            <ns7:DocumentResponse>                                                                    <ns7:Response>                                                                            <ns6:ResponseCode>ACCEPTED</ns6:ResponseCode>                                                                    </ns7:Response>                                                                     <ns7:DocumentReference>                                                                             <ns6:ID>7240b203-2046-423f-84eb-6646f0269cbe</ns6:ID>                                                                     </ns7:DocumentReference>                                                           </ns7:DocumentResponse>                                                      </ns8:ApplicationResponse>                                            </ns3:PayloadContent>                                       </ns3:Payload>                           </ns3:Payloads>                           <dsig:Signature xmlns:dsig="http://www.w3.org/2000/09/xmldsig#">…</dsig:Signature></ns5:XHE>


Begrepp

Exakt XML-path

Värde

XHE Header ID

/ns5:XHE/ns3:Header/ns3:ID

df5771db-73f3-4668-8940-154d81c92f1bb

Payload messageId

/ns5:XHE/ns3:Payloads/ns3:Payload/ns3:PayloadContent/ns8:ApplicationResponse/ns6:ID

df5771db-73f3-4668-8940-154d81c92f1bb

DocumentReference/ID

/ns5:XHE/ns3:Payloads/ns3:Payload/ns3:PayloadContent/ns8:ApplicationResponse/ns7:DocumentResponse/ns7:DocumentReference/ns6:ID

7240b203-2046-423f-84eb-6646f0269cbe

Slutsats: applikationskvittensen har ett eget meddelande-ID men pekar tillbaka på det ursprungliga meddelandet genom DocumentReference/ID.

4. Tolkning och rekommendationer

4.1 Verksamhetsnivå

För spårning av vilket SDK-meddelande som avses bör identifieraren 7240b203-2046-423f-84eb-6646f0269cbe användas. I det visade exemplet återfinns detta värde i XHE Header ID, payloadens messageId, payloadens conversationId, AS4 ConversationId samt som referens i applikationskvittensen.

4.2 Transportnivå

För analys av en specifik AS4-överföring bör AS4 MessageId användas. I exemplet är d4b9da2c-ebd0-11f0-aa9c-0a580a810632 identifieraren för AS4-användarmeddelandet och d5276936-ebd0-11f0-bfc0-0a580a830792 identifieraren för AS4-signalmeddelandet.

4.3 Kvittenser

AS4-kvittenser och applikationskvittenser verkar på olika nivåer. RefToMessageId i AS4-signalmeddelandet avser transportmeddelandet. DocumentReference/ID i applikationskvittensen avser det ursprungliga meddelandet. Dessa referenser ska därför inte tolkas som utbytbara.

5. Sammanfattande regelverk


 

Frågeställningar

Identifierare som bör användas

Vilket SDK-meddelande avses?

Använd meddelandeidentifieraren 7240b203-2046-423f-84eb-6646f0269cbe såsom den förekommer i XHE Header ID, payloadens conversationId och AS4 ConversationId.

Vilket AS4-meddelande kvitteras?

Jämför AS4-signalmeddelandets RefToMessageId med det tidigare AS4 MessageId:t.

Vilket ursprungligt meddelande avser applikationskvittensen?

Jämför DocumentReference/ID med det ursprungliga meddelande-ID:t.

Vilket ID bör inte användas som end-to-end-identitet?

AS4 MessageId bör inte användas som end-to-end-identitet.

Hjälpte denna information dig?

Ditt svar hjälper oss att förbättra sidan

Senast uppdaterad:

Säker digital kommunikation är en underwebbplats på digg.se, som förvaltas av Digg – Myndigheten för digital förvaltning