Skip to content

EUDR Information System - Operator API Reference

SD Samples

📥 Download as PDF

SD Sample XML Requests & Responses¶

Sample SOAP requests and responses for the EUDRSimplifiedDeclarationServiceV3.

Note

Replace {{wsse_*}} placeholders with your WS-Security credentials.

Environment	Endpoint
Production	`https://eudr.webcloud.ec.europa.eu/tracesnt/ws/EUDRSimplifiedDeclarationServiceV3`
Acceptance	`https://acceptance.eudr.webcloud.ec.europa.eu/tracesnt/ws/EUDRSimplifiedDeclarationServiceV3`

submitSd¶

Request¶

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:v4="http://ec.europa.eu/sanco/tracesnt/base/v4"
                  xmlns:sd="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3"
                  xmlns:eudrCommon="http://ec.europa.eu/tracesnt/certificate/eudr/common/v3">
    <soapenv:Header>
        <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">
            <wsu:Timestamp wsu:Id="TS-1">
                <wsu:Created>{{wsse_created}}</wsu:Created>
                <wsu:Expires>{{wsse_expires}}</wsu:Expires>
            </wsu:Timestamp>
            <wsse:UsernameToken wsu:Id="UT-1">
                <wsse:Username>{{wsse_username}}</wsse:Username>
                <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">{{wsse_passwordDigest}}</wsse:Password>
                <wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">{{wsse_nonce}}</wsse:Nonce>
                <wsu:Created>{{wsse_created}}</wsu:Created>
            </wsse:UsernameToken>
        </wsse:Security>
        <v4:WebServiceClientId>YOUR_CLIENT_ID</v4:WebServiceClientId>
    </soapenv:Header>
    <soapenv:Body>
        <sd:SubmitSdRequest>
            <sd:operatorRole>MICRO_OPERATOR</sd:operatorRole>
            <sd:statement>
                <sd:internalReferenceNumber></sd:internalReferenceNumber>
                <sd:activityType>IMPORT</sd:activityType>
                <sd:countryOfActivity>BE</sd:countryOfActivity>
                <sd:borderCrossCountry>BE</sd:borderCrossCountry>
                <sd:commodities>
                    <sd:position>1</sd:position>
                    <sd:descriptors>
                        <eudrCommon:descriptionOfGoods>Test cocoa product</eudrCommon:descriptionOfGoods>
                        <eudrCommon:goodsMeasure>
                            <eudrCommon:netWeight>200</eudrCommon:netWeight>
                            <eudrCommon:supplementaryUnit>20</eudrCommon:supplementaryUnit>
                            <eudrCommon:supplementaryUnitQualifier>MTQ</eudrCommon:supplementaryUnitQualifier>
                        </eudrCommon:goodsMeasure>
                    </sd:descriptors>
                    <sd:hsHeading>4410</sd:hsHeading>
                    <!-- Producer with GeoJSON location -->
                    <sd:producers>
                        <sd:producerPosition>1</sd:producerPosition>
                        <sd:producerCountry>BE</sd:producerCountry>
                        <sd:producerName>Producer with geojson</sd:producerName>
                        <sd:producerLocation>
                            <sd:geometryGeojson>BASE64_ENCODED_GEOJSON</sd:geometryGeojson>
                        </sd:producerLocation>
                    </sd:producers>
                    <!-- Producer with postal address location -->
                    <sd:producers>
                        <sd:producerPosition>2</sd:producerPosition>
                        <sd:producerCountry>BE</sd:producerCountry>
                        <sd:producerName>Producer with address</sd:producerName>
                        <sd:producerLocation>
                            <sd:postalAddress>
                                <sd:producerStreet>Rue De Geneve 4</sd:producerStreet>
                                <sd:producerPostalCode>1140</sd:producerPostalCode>
                                <sd:producerCity>Brussels</sd:producerCity>
                            </sd:postalAddress>
                        </sd:producerLocation>
                    </sd:producers>
                    <!-- Producer with cadastral identifier -->
                    <sd:producers>
                        <sd:producerPosition>3</sd:producerPosition>
                        <sd:producerCountry>BE</sd:producerCountry>
                        <sd:producerName>Producer with cadastral</sd:producerName>
                        <sd:producerLocation>
                            <sd:cadastralIdentifier>BE-BRU-2024-PARCEL-001</sd:cadastralIdentifier>
                        </sd:producerLocation>
                    </sd:producers>
                </sd:commodities>
                <sd:geoLocationConfidential>false</sd:geoLocationConfidential>
            </sd:statement>
        </sd:SubmitSdRequest>
    </soapenv:Body>
</soapenv:Envelope>

Response¶

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Header>
        <ns2:Security xmlns:ns1="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
                      xmlns:ns2="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <ns1:Timestamp>
                <ns1:Created>2026-05-20T12:17:41.575+02:00</ns1:Created>
                <ns1:Expires>2026-05-20T12:17:46.576+02:00</ns1:Expires>
            </ns1:Timestamp>
        </ns2:Security>
    </S:Header>
    <S:Body>
        <ns5:SubmitSdResponse xmlns:ns5="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3">
            <ns5:sdIdentifier>e3b3206d-6625-47a0-b2ef-b8a7b9da1217</ns5:sdIdentifier>
        </ns5:SubmitSdResponse>
    </S:Body>
</S:Envelope>

updateSd¶

Request¶

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:v4="http://ec.europa.eu/sanco/tracesnt/base/v4"
                  xmlns:sd="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3"
                  xmlns:eudrCommon="http://ec.europa.eu/tracesnt/certificate/eudr/common/v3">
    <!-- SOAP Header with WS-Security (same as submitSd) -->
    <soapenv:Body>
        <sd:UpdateSdRequest>
            <sd:sdIdentifier>e3b3206d-6625-47a0-b2ef-b8a7b9da1217</sd:sdIdentifier>
            <sd:statement>
                <sd:internalReferenceNumber>26BEDWNW9JD1TN</sd:internalReferenceNumber>
                <sd:activityType>IMPORT</sd:activityType>
                <sd:countryOfActivity>BE</sd:countryOfActivity>
                <sd:borderCrossCountry>BE</sd:borderCrossCountry>
                <sd:commodities>
                    <sd:position>1</sd:position>
                    <sd:descriptors>
                        <eudrCommon:descriptionOfGoods>Test cocoa product amended</eudrCommon:descriptionOfGoods>
                        <eudrCommon:goodsMeasure>
                            <eudrCommon:netWeight>300</eudrCommon:netWeight>
                            <eudrCommon:supplementaryUnit>30</eudrCommon:supplementaryUnit>
                            <eudrCommon:supplementaryUnitQualifier>MTQ</eudrCommon:supplementaryUnitQualifier>
                        </eudrCommon:goodsMeasure>
                    </sd:descriptors>
                    <sd:hsHeading>4410</sd:hsHeading>
                    <sd:producers>
                        <sd:producerPosition>1</sd:producerPosition>
                        <sd:producerCountry>BE</sd:producerCountry>
                        <sd:producerName>Producer Name amended</sd:producerName>
                        <sd:producerLocation>
                            <sd:geometryGeojson>BASE64_ENCODED_GEOJSON</sd:geometryGeojson>
                        </sd:producerLocation>
                    </sd:producers>
                </sd:commodities>
                <sd:geoLocationConfidential>false</sd:geoLocationConfidential>
            </sd:statement>
        </sd:UpdateSdRequest>
    </soapenv:Body>
</soapenv:Envelope>

Response¶

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <!-- Response Header (same structure as submitSd response) -->
    <S:Body>
        <ns5:UpdateSdResponse xmlns:ns5="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3"
                              xmlns:ns3="http://ec.europa.eu/tracesnt/certificate/eudr/common/v3">
            <ns5:uuid>e3b3206d-6625-47a0-b2ef-b8a7b9da1217</ns5:uuid>
            <ns5:version>2</ns5:version>
            <ns5:status>AVAILABLE</ns5:status>
        </ns5:UpdateSdResponse>
    </S:Body>
</S:Envelope>

withdrawSd¶

Request¶

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:v4="http://ec.europa.eu/sanco/tracesnt/base/v4"
                  xmlns:sd="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3">
    <!-- SOAP Header with WS-Security (same as submitSd) -->
    <soapenv:Body>
        <sd:WithdrawSdRequest>
            <sd:sdIdentifier>e3b3206d-6625-47a0-b2ef-b8a7b9da1217</sd:sdIdentifier>
        </sd:WithdrawSdRequest>
    </soapenv:Body>
</soapenv:Envelope>

Response¶

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <!-- Response Header (same structure as submitSd response) -->
    <S:Body>
        <ns5:WithdrawSdResponse xmlns:ns5="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3"
                                xmlns:ns3="http://ec.europa.eu/tracesnt/certificate/eudr/common/v3">
            <ns5:uuid>e3b3206d-6625-47a0-b2ef-b8a7b9da1217</ns5:uuid>
            <ns5:status>WITHDRAWN</ns5:status>
        </ns5:WithdrawSdResponse>
    </S:Body>
</S:Envelope>

getSd¶

Request¶

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:v4="http://ec.europa.eu/sanco/tracesnt/base/v4"
                  xmlns:sd="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3"
                  xmlns:eudrCommon="http://ec.europa.eu/tracesnt/certificate/eudr/common/v3">
    <!-- SOAP Header with WS-Security (same as submitSd) -->
    <soapenv:Body>
        <sd:GetSdRequest>
            <sd:uuidAndVersionNumberList>
                <eudrCommon:uuid>e3b3206d-6625-47a0-b2ef-b8a7b9da1217</eudrCommon:uuid>
            </sd:uuidAndVersionNumberList>
        </sd:GetSdRequest>
    </soapenv:Body>
</soapenv:Envelope>

Response¶

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <!-- Response Header (same structure as submitSd response) -->
    <S:Body>
        <ns5:GetSdResponse xmlns:ns3="http://ec.europa.eu/tracesnt/certificate/eudr/common/v3"
                           xmlns:ns5="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3">
            <ns5:sdOverviewList>
                <ns3:uuid>e3b3206d-6625-47a0-b2ef-b8a7b9da1217</ns3:uuid>
                <ns3:internalReferenceNumber>REF-0001000087</ns3:internalReferenceNumber>
                <ns3:referenceNumber>S26BECB39D2GRX</ns3:referenceNumber>
                <ns3:verificationNumber>H6ORMNTX</ns3:verificationNumber>
                <ns3:status>AVAILABLE</ns3:status>
                <ns3:date>2026-05-20T10:20:01.000Z</ns3:date>
                <ns3:updatedBy>User25 User25</ns3:updatedBy>
            </ns5:sdOverviewList>
        </ns5:GetSdResponse>
    </S:Body>
</S:Envelope>

getSdByInternalReference¶

Request¶

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:v4="http://ec.europa.eu/sanco/tracesnt/base/v4"
                  xmlns:sd="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3">
    <!-- SOAP Header with WS-Security (same as submitSd) -->
    <soapenv:Body>
        <sd:GetSdByInternalReferenceRequest>
            <sd:internalReference>REF-0001000087</sd:internalReference>
        </sd:GetSdByInternalReferenceRequest>
    </soapenv:Body>
</soapenv:Envelope>

Response¶

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <!-- Response Header (same structure as submitSd response) -->
    <S:Body>
        <ns5:GetSdByInternalReferenceResponse xmlns:ns3="http://ec.europa.eu/tracesnt/certificate/eudr/common/v3"
                                              xmlns:ns5="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3">
            <ns5:sdOverviewList>
                <ns3:uuid>e3b3206d-6625-47a0-b2ef-b8a7b9da1217</ns3:uuid>
                <ns3:internalReferenceNumber>REF-0001000087</ns3:internalReferenceNumber>
                <ns3:referenceNumber>S26BECB39D2GRX</ns3:referenceNumber>
                <ns3:verificationNumber>H6ORMNTX</ns3:verificationNumber>
                <ns3:status>AVAILABLE</ns3:status>
                <ns3:date>2026-05-20T10:20:01.000Z</ns3:date>
                <ns3:updatedBy>User25 User25</ns3:updatedBy>
            </ns5:sdOverviewList>
        </ns5:GetSdByInternalReferenceResponse>
    </S:Body>
</S:Envelope>

getSdByIdentifiers¶

Request¶

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:v4="http://ec.europa.eu/sanco/tracesnt/base/v4"
                  xmlns:sd="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3"
                  xmlns:eudrCommon="http://ec.europa.eu/tracesnt/certificate/eudr/common/v3">
    <!-- SOAP Header with WS-Security (same as submitSd) -->
    <soapenv:Body>
        <sd:GetSdByIdentifiersRequest>
            <sd:referenceAndVerificationNumber>
                <eudrCommon:referenceNumber>S26BECB39D2GRX</eudrCommon:referenceNumber>
                <eudrCommon:verificationNumber>H6ORMNTX</eudrCommon:verificationNumber>
            </sd:referenceAndVerificationNumber>
        </sd:GetSdByIdentifiersRequest>
    </soapenv:Body>
</soapenv:Envelope>

Response¶

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <!-- Response Header (same structure as submitSd response) -->
    <S:Body>
        <ns5:GetSdByIdentifiersResponse xmlns:ns3="http://ec.europa.eu/tracesnt/certificate/eudr/common/v3"
                                        xmlns:ns5="http://ec.europa.eu/tracesnt/certificate/eudr/simplified-declaration/v3">
            <ns5:statement>
                <ns5:activityType>IMPORT</ns5:activityType>
                <ns5:representedOperator>
                    <ns3:operatorAddress>
                        <ns3:country>BE</ns3:country>
                    </ns3:operatorAddress>
                    <ns3:operatorName>user3-mspo-operator</ns3:operatorName>
                </ns5:representedOperator>
                <ns5:commodities>
                    <ns5:position>1</ns5:position>
                    <ns5:descriptors>
                        <ns3:descriptionOfGoods>Test cocoa product</ns3:descriptionOfGoods>
                        <ns3:goodsMeasure>
                            <ns3:netWeight>200.000000</ns3:netWeight>
                            <ns3:supplementaryUnit>20.000000</ns3:supplementaryUnit>
                            <ns3:supplementaryUnitQualifier>MTQ</ns3:supplementaryUnitQualifier>
                        </ns3:goodsMeasure>
                    </ns5:descriptors>
                    <ns5:hsHeading>4410</ns5:hsHeading>
                    <ns5:producers>
                        <ns5:producerCountry>BE</ns5:producerCountry>
                        <ns5:producerLocation>
                            <ns5:geometryGeojson>BASE64_ENCODED_GEOJSON</ns5:geometryGeojson>
                        </ns5:producerLocation>
                    </ns5:producers>
                    <ns5:producers>
                        <ns5:producerCountry>BE</ns5:producerCountry>
                    </ns5:producers>
                </ns5:commodities>
                <ns5:geoLocationConfidential>false</ns5:geoLocationConfidential>
            </ns5:statement>
        </ns5:GetSdByIdentifiersResponse>
    </S:Body>
</S:Envelope>