GetAdvisedInvoiceRecipientId

This API is used to retrieve RecipientId that is advised to use for sending documents.  The RecipientId is selected based on the fact that the RecipientId is published for recieving the specific documents in the PEPPOL network.

Header fields
Fieldname Description
SOAPAction [Mandatory] http://api.everbinding.nl/v3_1/GetAdvisedInvoiceRecipientId
Request fields
Fieldname Description
ReferenceIdSet List of RecipientId‘s. A RecipientId is a identifier prefixed with a ISO6523 number or a schemeID label. Every identifier type can only occure one time.
Response fields
Fieldname Description
ReferenceId The ReferenceId  that can be used for sending documents to the party. This is the identifier prefix with schemeID.
The ISO6523 number prefix is not returned.
If none of the identifiers can be used nothing (null) is returned.

Request body

<?xml version="1.0" ?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"><S:Header><h:Authentication xmlns="http://api.everbinding.nl/v3_1/" xmlns:h="http://api.everbinding.nl/v3_1/"><SecurityToken>o2S1qTusL29hp3IgMKWsn2I5CFV2AmMxAGt3AGL1ZmL2BGHmZmx0MGLlATL2MwDlATZ1VvkiLKI0nS9ho25wMG0vAQD2AGVmZQR2VvkiLKI0nS90nJ1yp3EuoKN9VwR1ZQxmAmLjZGVvYT9uqKEbK3AcM25uqUIlMI9gMKEbo2D9VxuADHZgH0uOZFVfo2S1qTusqzIlp2yiow0vZF4jVvkiLKI0nS90o2gyow0vIz85AzMMp1uiJKy2FSqmIR9FAGOErT9MoQx5IwIeGQNvYT9uqKEbK3AcM25uqUIlMG0vMmqmJJjkpaqDZGR1rHy2LIqBIFHlEaD3ZzMCnmtyZ0Dv</SecurityToken></h:Authentication></S:Header><S:Body xmlns="http://api.everbinding.nl/v3_1/">
    <GetAdvisedInvoiceRecipientId xmlns="http://api.everbinding.nl/v3_1/">
        <ReferenceIdSet>
            <string>NL:VAT:NL851306469B01</string>
            <string>9915:test</string>
        </ReferenceIdSet>
</GetAdvisedInvoiceRecipientId></S:Body></S:Envelope>

Response 200

<?xml version="1.0" encoding="utf-8"?><SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/"><SOAP:Body><GetAdvisedInvoiceRecipientIdResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.everbinding.nl/v3_1/">
    <ReferenceId>NL:VAT:NL851306469B01</ReferenceId>
</GetAdvisedInvoiceRecipientIdResponse></SOAP:Body></SOAP:Envelope>

Response 500

Duplicate id agencies requested (10/18/2017 12:38:24 PM +00:00~00000000-0000-0000-611c-0080010000f6) [LOOKUP01]

Tip for java

A ArrayOfString is used for sending the ReferenceIdSet. In JAX-WS filling with setString is not available. The following code can be used.

class MyArrayOfString extends ArrayOfString {
    private MyArrayOfString() {
        super();            
    }
    
    void setString(List<String> strings) {
        this.string = strings; 
    }
}

 

Was this article helpful?