Search Invoices
SearchInvoices
This method returns information about invoices based on the filter provided to the method. Paging is controlled using the StartIndex and EndIndex fields, while the search is refined with the filter and sorting structures.
Input
SearchInvoicesRequest
Field | R | Type | Description |
---|---|---|---|
StartIndex | * | Integer | Index of the first result. |
EndIndex | * | Integer | Index of the last result. |
SearchInvoiceFilter | * | SearchInvoiceFilter | Filter for narrowing down the search result. |
SearchInvoiceSorting | * | SearchInvoiceSorting | Specifies how to sort the data. |
Output
SearchInvoicesResponse
Field | R | Type | Description |
---|---|---|---|
InvoiceListItems | * | Array of InvoiceListItem | Invoices that matched the search criteria. |
ResultCount | * | Integer | Number of invoices that matched the search criteria. |
Structures
InvoiceListItem
Field | U | R | Type | Description |
---|---|---|---|---|
ClientId | * | * | Long(7) | ID that identifies a client in the Svea Payments system. |
InvoiceId | * | * | Long(10) | Reference to an Invoice. |
NationalIdNumber | - | - | String(12) | Unique identifier for customers (e.g., Personnummer & organisationsnummer in Sweden). For some countries, birthdate is returned instead. Not returned for Finnish clients. |
InvoiceDate | - | - | DateTime | Date when the invoice is created in the Svea Payments system. |
DueDate | - | - | DateTime | Due date for the invoice; when Svea Payments requires the invoice to be paid. |
PaidToClientDate | - | - | Nullable of DateTime | Date when Svea Payments paid (or will pay) the client for the invoice. |
Amount | - | - | Decimal(15,2) | Invoice amount. |
CreditedAmount | - | - | Decimal(15,2) | Amount that has been credited for the invoice. |
SveaHasBought | - | - | Boolean | True if Svea Payments bought the invoice, otherwise false. |
CustomerName | - | - | String(40) | Name of the customer to whom the invoice is sent. |
SveaOrderId | * | - | Long(10) | Unique ID for the created order. Used for any further order webservice requests. |
ClientOrderId | - | - | String(30) | Order number from the client’s ordersystem. |
Status | - | - | (String) InvoicePaymentStatus | See InvoicePaymentStatus. |
Type | - | - | InvoiceType | See InvoiceType. |
CustomerType | - | - | CustomerType | See CustomerType. |
CustomerCountryCode | - | - | String(2) | A country code that defines where the customer is residing. |
SearchInvoiceFilter
Field | R | Type | Description |
---|---|---|---|
AcceptedPaymentStatus | - | List of InvoicePaymentStatus | See InvoicePaymentStatus. |
TextMatch | - | String | Free text match on invoice ID, nationalIdNumber, etc. |
StartDate | - | DateTime | The earliest creation date/time of the invoice to search for. |
EndDate | - | DateTime | The latest creation date/time of the invoice to search for. |
TextMatchType | - | TextMatchType | Property to use for the free text search. If not provided, AllFields will be searched. |
SearchInvoiceSorting
Field | R | Type | Description |
---|---|---|---|
SortDirection | - | SortDirection | Which way to sort (Ascending/Descending). |
SortOrderProperty | - | SortOrderProperty | Which field to sort on. |
Enumerations
InvoicePaymentStatus
Value | Description |
---|---|
PendingApproval | - |
Sent | - |
Paid | - |
Overdue | - |
Reminded | - |
DebtCollection | - |
Cancelled | - |
PartlyPaid | - |
Credited | - |
CreditLoss | - |
Refund | - |
TextMatchType
Value | Description |
---|---|
AllFields | - |
SveaOrderId | - |
ClientOrderNumber | - |
NationalIdNumber | - |
ClientInvoiceId | - |
InvoiceType
Value | Description |
---|---|
Debit | - |
Credit | - |
CustomerType
Value | Description |
---|---|
Individual | - |
Company | - |