- addInvoices
Description:
Creates an invoice that is to be displayed in the online bank
5003 - One of efakturaReference,efakturaIdentifier or socialSecurityNumber is required
Operation type:
Request-response. The endpoint receives a message, and sends a correlated message.
SOAP action:
https://efaktura-services.nets.no/invoicing-nets-submitter/v1/addInvoices
Input:
addInvoices type AddInvoices To get status for the invoices and consignments use the getInvoiceStatus and
getConsignmentStatus call.
Possible validation error codes from operation
5009 - User must supply service provider id
5010 - User not allowed to supply service provider id
Output:
addInvoicesResponse (soap:body, use = literal)
Source codeaddInvoicesResponse type AddInvoicesResponse Fault:
validationFault type ValidationFault Indicates that the client has sent an invalid request.
Fault:
serverFault type ServerFault Indicates an internal server error.
- cancelInvoice
Description:
Cancel an invoice by an unique id
Operation type:
Request-response. The endpoint receives a message, and sends a correlated message.
SOAP action:
https://efaktura-services.nets.no/efaktura-submitter-service/v1/cancelInvoice
Input:
cancelInvoice type CancelInvoice Possible validation error codes from operation
5004 - Unable to find invoice
5005 - Cancellation on paid invoice
5006 - Invoice already cancelled
5008 - Authorization failed
Output:
cancelInvoiceResponse (soap:body, use = literal)
Source codecancelInvoiceResponse type CancelInvoiceResponse Fault:
validationFault type ValidationFault Indicates that the client has sent an invalid request.
Fault:
serverFault type ServerFault Indicates an internal server error.
- getCancellableInvoice
Description:
Find cancellable invoice using mandatory and optional parameters
Operation type:
Request-response. The endpoint receives a message, and sends a correlated message.
SOAP action:
https://efaktura-services.nets.no/efaktura-submitter-service/v1/getCancellableInvoice
Input:
cancellableInvoice (soap:body, use = literal)
Source codecancellableInvoice type CancellableInvoiceSearchCriteria Possible validation error codes from operation
5004 - Unable to find invoice
5005 - Cancellation on paid invoice
5006 - Invoice already cancelled
5007 - Multiple invoices found
- auditInformation type AuditInformationType
Information used for auditing and logging messages
- issuer type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
- kid - optional; type KidType - type string with restriction maxLength(25) minLength(2) pattern(\d*)
KID
- dueDate type date
- amount type SimpleAmountType - type decimal with restriction fractionDigits(2) minInclusive(0.00)
The amount represented as a number with two decimals. Must not be negative
- minimumAmount - optional; type SimpleAmountType - type decimal with restriction fractionDigits(2) minInclusive(0.00)
The amount represented as a number with two decimals. Must not be negative
- accountNumber type BillingAccountNumberType - type string with restriction length(11)
Must be a Norwegian account number with 11 digits
- documentType type documentType - type string with restriction - enum { 'EFAKTURA', 'AVTALEGIRO' }
Output:
cancellableInvoiceResponse (soap:body, use = literal)
Source codecancellableInvoiceResponse type CancellableInvoiceResponse Fault:
validationFault type ValidationFault Indicates that the client has sent an invalid request.
Fault:
serverFault type ServerFault Indicates an internal server error.
- getConsignmentStatus
Description:
Get status on consignment
Operation type:
Request-response. The endpoint receives a message, and sends a correlated message.
SOAP action:
https://efaktura-services.nets.no/invoicing-nets-submitter/v1/getConsignmentStatus
Input:
getConsignmentStatus (soap:body, use = literal)
Source codegetConsignmentStatus type GetConsignmentStatus Possible validation error codes from operation
5001 - Unable to find consignment
5002 - Multiple consignments found for id
5009 - User must supply service provider id
5010 - User not allowed to supply service provider id
Output:
getConsignmentStatusResponse (soap:body, use = literal)
Source codegetConsignmentStatusResponse type GetConsignmentStatusResponse - messageIdentifier type MessageIdentifierType - type string with restriction minLength(5) maxLength(50)
A unique identifier for a request/response message pair used for logging
- status type ConsignmentStatusType - type string with restriction - enum { 'IN_PROGRESS', 'PROCESSED', 'REJECTED', 'STOPPED' }
- rejectedReason - optional; type RejectReasonType - type string with restriction maxLength(2000) minLength(1)
The reason the invoice or consignment was rejected.
- acceptedInvoiceCount type long
- rejectedInvoiceCount type long
- rejectedInvoices - optional; type RejectedInvoicesType
- rejectedInvoice - optional; type RejectedInvoiceType
List of rejected invoices.
Fault:
validationFault type ValidationFault Indicates that the client has sent an invalid request.
Fault:
serverFault type ServerFault Indicates an internal server error.
- getEfakturaIdentifiers
Description:
Returns efakturaIdentifier and auto accept agreement if the receiver is found by
efaktura identifier, personalnumber, organization number, phone, email, name, or address.
Operation type:
Request-response. The endpoint receives a message, and sends a correlated message.
SOAP action:
https://efaktura-services.nets.no/invoicing-nets-submitter/v1/getEfakturaIdentifiers
Input:
getEfakturaIdentifiers (soap:body, use = literal)
Source codegetEfakturaIdentifiers type GetEfakturaIdentifiers Output:
getEfakturaIdentifiersResponse (soap:body, use = literal)
Source codegetEfakturaIdentifiersResponse type GetEfakturaIdentifiersResponse Fault:
validationFault type ValidationFault Indicates that the client has sent an invalid request.
Fault:
serverFault type ServerFault Indicates an internal server error.
- getInvoiceStatus
Description:
Gets an already created invoice
Operation type:
Request-response. The endpoint receives a message, and sends a correlated message.
SOAP action:
https://efaktura-services.nets.no/invoicing-nets-submitter/v1/getInvoiceStatus
Input:
getInvoiceStatus type GetInvoiceStatus Possible validation error codes from operation
5009 - User must supply service provider id
5010 - User not allowed to supply service provider id
Output:
getInvoiceStatusResponse (soap:body, use = literal)
Source codegetInvoiceStatusResponse type GetInvoiceStatusResponse - messageIdentifier type MessageIdentifierType - type string with restriction minLength(5) maxLength(50)
A unique identifier for a request/response message pair used for logging
- invoiceStatusResponses type InvoiceStatusResponsesType
List of invoices, with status
- invoiceStatusResponse type InvoiceStatusResponseType
- issuer type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
- invoiceNumber type InvoiceNumberType - type string with restriction maxLength(100) minLength(1)
Unique reference to the invoice for the issuer.
- status type InvoiceStatusType - type string with restriction - enum { 'PROCESSED', 'REJECTED', 'IN_PROGRESS', 'DUPLICATE', 'NOT_FOUND', 'CANCELLED' }
- rejectReason - optional; type RejectReasonType - type string with restriction maxLength(2000) minLength(1)
The reason the invoice or consignment was rejected.
- distributed - optional; type Text20 - type string with restriction maxLength(20)
Outbound channel for invoices (B2C, PRINT, EMAIL)
Fault:
validationFault type ValidationFault Indicates that the client has sent an invalid request.
Fault:
serverFault type ServerFault Indicates an internal server error.