Skip to main content

Get Accounts

The operation returns customer account (order) information of a customer based on customer number, integration number or civic registration number. It will return all accounts found on the current customer; approved, rejected, activated, closed etc. If no customer or account is found for the given request an exception will be returned. The account can be identified either by providing the CustomerNo, the IntegrationId or RegNo in the request, but never more than one of them in one request.

Request Parameters​

FieldOccursnullableMaxTypeDescription
Password1false50stringThe password used to authorize the request.
Username1false50stringThe username used to authorize the request.
CorrelationId1true50stringCorrelationID is sent back in the response.
CountryCode1false2stringThe country code (ISO 3166-1 alpha-2) for the country.
CustomerNo1true50stringIf the e-store wants to search for a customer by their own customer id, this field can be used to specify that number.
IntegrationId1true128stringThe integration ID can be assigned to customers in order to uniquely identify customers (instead of using Civic reg no).
RegNo1true12stringThe customer civic registration number.
StoreId1false50intThe StoreId used for identification of store.

Response Parameters​

FieldOccursnullableMaxTypeDescription
CorrelationId1true50stringCorrelationID from the request if any.
Accounts1true50Accounts[]A list of the accounts for the customer associated with the given request. See below for more information.

Accounts​

FieldOccursnullableMaxTypeDescription
InvoiceBalance1false6,2decimalThe current balance of the invoice.
InvoiceStatus1false-stringThe current status of the invoice.
InvoiceType1false-stringThe invoice type
LatestInvoiceNo1true50stringThe invoice number of the invoice.
MovedToPaymentRef1true-stringIf the invoice has been moved to another account, this is the new accounts payment reference. If the invoice has not been moved, this returns null.
NotificationStopped1false-stringReturns true if the current invoice is stopped for notifications. Returns false if it is not stopped.
PaymentReference1true50stringThe invoices payment reference.

Example Requests​

 Value
Environment:UAT
Service:InformationService
URL:https://ecommercetest.collector.se/v3.0/InformationServiceV2.svc?wsdl
Function:GetAccounts
Description:The operation returns a list of accounts for a specic customer.
Notes:N/A

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:inf="http://schemas.ecommerce.collector.se/v30/InformationService">
<soapenv:Header>
<inf:Username>USERNAME</inf:Username>
<inf:Password>PASSWORD</inf:Password>
</soapenv:Header>
<soapenv:Body>
<inf:GetAccountsRequest>
<inf:CorrelationId xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<inf:CountryCode>SE</inf:CountryCode>
<inf:CustomerNo xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<inf:IntegrationId xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<inf:RegNo>195109212224</inf:RegNo>
<inf:StoreId>1234</inf:StoreId>
</inf:GetAccountsRequest>
</soapenv:Body>
</soapenv:Envelope>

Error Codes​

Fault CodeDescription
AUTHORIZATION_FAILEDCould not authorize the request, check your login credentials. Please contact Collector for more help.
ACCOUNT_NOT_FOUNDNo account found for Invoice Number.

If the error code you are looking for is not in the list above Please see separate page Error Codes