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​
Field | Occurs | nullable | Max | Type | Description |
---|---|---|---|---|---|
Password | 1 | false | 50 | string | The password used to authorize the request. |
Username | 1 | false | 50 | string | The username used to authorize the request. |
CorrelationId | 1 | true | 50 | string | CorrelationID is sent back in the response. |
CountryCode | 1 | false | 2 | string | The country code (ISO 3166-1 alpha-2) for the country. |
CustomerNo | 1 | true | 50 | string | If the e-store wants to search for a customer by their own customer id, this field can be used to specify that number. |
IntegrationId | 1 | true | 128 | string | The integration ID can be assigned to customers in order to uniquely identify customers (instead of using Civic reg no). |
RegNo | 1 | true | 12 | string | The customer civic registration number. |
StoreId | 1 | false | 50 | int | The StoreId used for identification of store. |
Response Parameters​
Field | Occurs | nullable | Max | Type | Description |
---|---|---|---|---|---|
CorrelationId | 1 | true | 50 | string | CorrelationID from the request if any. |
Accounts | 1 | true | 50 | Accounts[] | A list of the accounts for the customer associated with the given request. See below for more information. |
Accounts​
Field | Occurs | nullable | Max | Type | Description |
---|---|---|---|---|---|
InvoiceBalance | 1 | false | 6,2 | decimal | The current balance of the invoice. |
InvoiceStatus | 1 | false | - | string | The current status of the invoice. |
InvoiceType | 1 | false | - | string | The invoice type |
LatestInvoiceNo | 1 | true | 50 | string | The invoice number of the invoice. |
MovedToPaymentRef | 1 | true | - | string | If 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. |
NotificationStopped | 1 | false | - | string | Returns true if the current invoice is stopped for notifications. Returns false if it is not stopped. |
PaymentReference | 1 | true | 50 | string | The 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 |
- Request
- Response
<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>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<GetAccountsResponse xmlns="http://schemas.ecommerce.collector.se/v30/InformationService">
<Accounts xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Account>
<InvoiceBalance>230.00</InvoiceBalance>
<InvoiceStatus>Activated</InvoiceStatus>
<InvoiceType>Direct Invoice Account</InvoiceType>
<LatestInvoiceNo>73237549</LatestInvoiceNo>
<MovedToPaymentRef i:nil="true"/>
<NotificationStopped>false</NotificationStopped>
<PaymentReference>100002695034855</PaymentReference>
</Account>
<Account>
<InvoiceBalance>6750.00</InvoiceBalance>
<InvoiceStatus>Activated</InvoiceStatus>
<InvoiceType>Pending Credit Account</InvoiceType>
<LatestInvoiceNo>72787668</LatestInvoiceNo>
<MovedToPaymentRef i:nil="true"/>
<NotificationStopped>false</NotificationStopped>
<PaymentReference/>
</Account>
<Account>
<InvoiceBalance>6896.00</InvoiceBalance>
<InvoiceStatus>Activated</InvoiceStatus>
<InvoiceType>Interest Free Account</InvoiceType>
<LatestInvoiceNo>72787676</LatestInvoiceNo>
<MovedToPaymentRef i:nil="true"/>
<NotificationStopped>false</NotificationStopped>
<PaymentReference>100002676362358</PaymentReference>
</Account>
<Account>
<InvoiceBalance>0.00</InvoiceBalance>
<InvoiceStatus>Moved</InvoiceStatus>
<InvoiceType>Direct Invoice Account</InvoiceType>
<LatestInvoiceNo>73281523</LatestInvoiceNo>
<MovedToPaymentRef>140000269632661</MovedToPaymentRef>
<NotificationStopped>false</NotificationStopped>
<PaymentReference>140000269632658</PaymentReference>
</Account>
</Accounts>
<CorrelationId i:nil="true"
xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
</GetAccountsResponse>
</s:Body>
</s:Envelope>
Error Codes​
Fault Code | Description |
---|---|
AUTHORIZATION_FAILED | Could not authorize the request, check your login credentials. Please contact Collector for more help. |
ACCOUNT_NOT_FOUND | No 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