Web Service: submitter-service
Target Namespace:
https://efaktura-services.nets.no/efaktura-submitter-service/v1/
Port submitter-service-port Port typeSource code
Location:
https://efaktura-services.nets.no/efaktura-submitter-service/v1/
Protocol:
SOAP
Default style:
document
Transport protocol:
SOAP over HTTP
Operations:
- addInvoicesDetailSource code
- cancelConsignmentDetailSource code
- cancelInvoiceDetailSource code
- cancelSingleInvoiceDetailSource code
- getAddedInvoiceValidationDetailSource code
- getBlackListDetailSource code
- getConsignmentStatusDetailSource code
- getEfakturaIdentifiersDetailSource code
- getInvoiceStatusDetailSource code
- getJwkDetailSource code
- validateSecuritySignatureDetailSource code
- validateSecurityTokenDetailSource code
Operations
- addInvoicesDescription:Creates an invoice that is to be displayed in the online bankOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-submitter-service/v1/addInvoicesInput:addInvoices (soap:body, use = literal)Source codeaddInvoices type AddInvoicesTo get a status for the consignment and invoices use the getConsignmentStatus and getInvoiceStatus
calls.
Possible validation error codes from operation:
209 - Duplicate consignmentId (Sender has used this consignmentId before)- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
- senderInfo type SenderInfoType
- consignmentId - optional; type consignmentIdType - type string with restriction maxLength(11) minLength(9) pattern([0-9]{9,11})consignmetId is optional for single invoice shipments
- commissionId - optional; type commissionIdType - type string with restriction maxLength(12) minLength(12) pattern([0-9]{12})commissionId is optional and are generated automatically if not set.
This value serves no use for external parties and can safely be omitted. - contentProviderId type providerIdType - type string with restriction minLength(9) maxLength(9) pattern([0-9]{9})Id of the issuer
- batchReference - optional; type batchReferenceType - type string with restriction minLength(0) maxLength(255)Free format text used to identify the original inbound consignment in case of forwarding
- consignmentId - optional; type consignmentIdType - type string with restriction maxLength(11) minLength(9) pattern([0-9]{9,11})
- invoices type InvoicesTypeRepresents an invoice. Allows up to a 1000 invoices per consignment.
- invoice type InvoiceType
- invoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)Unique character invoice reference
- A choice of one of the following elements:
- efakturaIdentifier type efakturaIdentifierType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})The efakturaIdentifier of the receiver - a unique identifier for the receiver
- socialSecurityNumber type socialSecurityNumberType - type string with restriction maxLength(11) minLength(11) pattern([0-9]{11})The social security number of the receiver.
- eFakturaReference type eFakturaReferenceType - type string with restriction maxLength(32)The customer agreement reference (eFakturareferanse) of the receiver,
used in the agreement between invoice issuer and receiver (JTTB) - 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 accountNumberType - type string with restriction minLength(11) maxLength(11) pattern([0-9]{11})The account the amount should be payed to
- brandName type brandNameType - type string with restriction maxLength(150)Name that is shown to the receiver of the invoice
- invoiceUrl type invoiceUrlType - type string with restriction maxLength(255) minLength(1)URL to where the invoice is located
- documentType type documentType - type string with restriction - enum { 'EFAKTURA', 'AVTALEGIRO' }
- invoiceDocumentType - optional; type invoiceDocumentType - type string with restriction - enum { 'INVOICE', 'REMINDER', 'CREDIT_NOTE', 'COLLECTION_NOTICE', 'DUNNING', 'PAYMENT_REQUEST', 'ENFORCEMENT_WARNING' }
- invoiceNumber - optional; type invoiceNumberType - type string with restriction maxLength(255)The issuer invoice-number, ERP-/accounting-system generated sequence.
- invoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)
- invoice type InvoiceType
Output:addInvoicesResponse (soap:body, use = literal)Source codeaddInvoicesResponse type AddInvoicesResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- noOfInvoices type invoiceCountType - type int with restrictionThe number of invoices received
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- cancelConsignmentDescription:Cancel all invoices in a consignmentOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-submitter-service/v1/cancelConsignmentInput:cancelConsignment (soap:body, use = literal)Source codecancelConsignment type CancelConsignmentPossible validation error codes from operation:
201 - Unable to find consignment.
202 - Multiple consignments found for id
205 - Consignment already cancelled- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
- consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(9) pattern([0-9]{9,11})Unique 11 digit consignment reference (classic b2c)
Output:cancelConsignmentResponse (soap:body, use = literal)Source codecancelConsignmentResponse type CancelConsignmentResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- cancelInvoiceDescription:Cancel spesific invoices in a consignmentOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-submitter-service/v1/cancelInvoiceInput:cancelInvoice (soap:body, use = literal)Source codecancelInvoice type CancelInvoicePossible validation error codes from operation
203 - Multiple invoices found for id
204 - Unable to find invoice
206 - Invoice already cancelled- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
- consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(9) pattern([0-9]{9,11})Unique 11 digit consignment reference (classic b2c)
- invoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)Unique character invoice reference
Output:cancelInvoiceResponse (soap:body, use = literal)Source codecancelInvoiceResponse type CancelInvoiceResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- cancelSingleInvoiceDescription:Cancel a single consignment independent invoice.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/cancelSingleInvoiceInput:cancelSingleInvoice (soap:body, use = literal)Source codecancelSingleInvoice type CancelSingleInvoicePossible validation error codes from operation
203 - Multiple invoices found for issuer id
204 - Unable to find invoice
206 - Invoice already cancelled- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
- contentproviderOrgnumber type providerIdType - type string with restriction minLength(9) maxLength(9) pattern([0-9]{9})Id of the issuer
- contentproviderInvoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)Unique character invoice reference
Output:cancelInvoiceResponse (soap:body, use = literal)Source codecancelInvoiceResponse type CancelInvoiceResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- getAddedInvoiceValidationDescription:Check processing status for one posted invoice, returns the full document rejection if so.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/getAddedInvoiceValidationInput:invoiceLogicalIdentity (soap:body, use = literal)Source codeinvoiceLogicalIdentity type InvoiceLogicalIdentityTypeMPS internal for now. To identift a single one invoice added, identified uniqly by invoiceNumber and serviceProvider (consignmentId for compatibility and use with backend system).
- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
- serviceProvider type providerIdType - type string with restriction minLength(9) maxLength(9) pattern([0-9]{9})Id of the issuer
- consignmentId - optional; type consignmentIdType - type string with restriction maxLength(11) minLength(9) pattern([0-9]{9,11})Unique 11 digit consignment reference (classic b2c)
- invoiceNumber type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)Unique character invoice reference
Output:getAddedInvoiceValidationResponse (soap:body, use = literal)Source codegetAddedInvoiceValidationResponse type GetAddedInvoiceValidationResponseMPS internal for now. Contains status for a single invoice added. Reject attribute populated when status is REJECTED only.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- invoiceStatus type invoiceStatusType - type string with restriction - enum { 'ACCEPTED', 'REJECTED', 'NOT_FOUND', 'CANCELLED' }
- invoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)Unique character invoice reference
- rejectionDetails type string
- rejectReasonCode type rejectReasonCodeType - type string with restriction maxLength(3)The status code for the rejected invoice. Only filled out for rejected invoices
- rejectReason type rejectReasonType - type string with restriction maxLength(40)The reason the invoice was rejected. Only filled out for rejected invoices
- rejectedAttribute type rejectedAttributeType - type string with restriction maxLength(50)The named attribute causing the invoice rejection. Only filled out for rejected invoices
- rejectedAttributeValue type rejectedAttributeValueType - type string with restriction maxLength(250)The named attributes value causing the invoice rejection. Only filled out for rejected invoices
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- getBlackListDescription:get BlackListed invoice issuersOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-submitter-service/v1/getBlackListInput:getBlackList (soap:body, use = literal)Source codegetBlackList type GetBlackListRequest a list of black listed issuers
- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
Output:getBlackListResponse (soap:body, use = literal)Source codegetBlackListResponse type GetBlackListResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- blackListResponses type BlackListResponsesType
- blackListResponseType - optional; type BlackListResponseType
- identifier type string
- identifierType type string
- status type string
- activationDate type date
- deActivationDate - optional; type date
- blackListType type string
List of BlackListed invoice issuers - blackListResponseType - optional; type BlackListResponseType
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- getConsignmentStatusDescription:Get status on consignmentOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-submitter-service/v1/getConsignmentStatusInput:getConsignmentStatus (soap:body, use = literal)Source codegetConsignmentStatus type GetConsignmentStatusPossible validation error codes from operation
201 - Unable to find consignment
202 - Multiple consignments found for id- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
- consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(9) pattern([0-9]{9,11})Unique 11 digit consignment reference (classic b2c)
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', 'DONE', 'STOPPED' }
- acceptedInvoiceCount type long
- rejectedInvoiceCount type long
- cancelledInvoiceCount type long
- rejectedInvoices - optional; type RejectedInvoicesType
- rejectedInvoice - optional; type RejectedInvoiceType
- invoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)Unique character invoice reference
- rejectReason type rejectReasonType - type string with restriction maxLength(40)The reason the invoice was rejected. Only filled out for rejected invoices
- rejectReasonCode type rejectReasonCodeType - type string with restriction maxLength(3)The status code for the rejected invoice. Only filled out for rejected invoices
- rejectedAttribute - optional; type rejectedAttributeType - type string with restriction maxLength(50)The named attribute causing the invoice rejection. Only filled out for rejected invoices
- rejectedAttributeValue - optional; type rejectedAttributeValueType - type string with restriction maxLength(250)The named attributes value causing the invoice rejection. Only filled out for rejected invoices
- invoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)
List of rejected invoices. - rejectedInvoice - optional; type RejectedInvoiceType
- cancelledInvoices - optional; type CancelledInvoicesType
- cancelledInvoice - optional; type CancelledInvoiceType
- invoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)Unique character invoice reference
- invoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)
List of cancelled invoices. - cancelledInvoice - optional; type CancelledInvoiceType
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- getEfakturaIdentifiersDescription: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/efaktura-submitter-service/v1/getEfakturaIdentifiersInput:getEfakturaIdentifiers (soap:body, use = literal)Source codegetEfakturaIdentifiers type GetEfakturaIdentifiers
- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
- getEfakturaIdentifiersKey type EfakturaIdentifiersKeyTypeContains a set of keys used to search for unique receivers to get the efaktura identifier. Allows for search up to a 1000 receivers.
- efakturaIdentifierKey type EfakturaIdentifierKeyTypeContains the keys used to search for a unique receiver to get the efaktura identifier.
The following rules apply:
1. Search can be made on social security number, organization number, efaktura identifier or eFakturaReferenceAndContentProvider as single key.
2. If email alias or phone alias or date of birth is provided at least two of them must match
3. If only one of date of birth, email alias or phone alias is provided, one of either name, address or
postal code must match.
4. If none of date of birth, email alias or phone alias is given all of name, address and postal code must match.
5. For name and address it is allowed for search where the text is a part of the given field
6. First and last name is also to be switched, meaning a first name search will also try to search in the last
name column- id - optional; type long
- efakturaIdentifier - optional; type efakturaIdentifierType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})The efakturaIdentifier of the receiver - a unique identifier for the receiver
- A choice of one of the following elements:
- socialSecurityNumber type socialSecurityNumberType - type string with restriction maxLength(11) minLength(11) pattern([0-9]{11})The social security number of the receiver.
- organizationNumber type organizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})Organization number of the sender, issuer or receiver
- telephoneAlias - optional; type telephoneAliasType - type string with restriction minLength(6) maxLength(16) pattern(\+\d+)A valid phone number, prefixed with country code (i.e. +4799999999), used for alias
- emailAlias - optional; type emailAliasType - type string with restriction minLength(5) maxLength(100) pattern([^@]+@[^\.]+\..+)A valid email address, used for alias
- name - optional; type FullNameTypeThe name used to search for receiver to get efaktura identifier.
Both elements must match those registered on the receiver- firstName - optional; type nameType - type string with restriction maxLength(50) minLength(1)Name of the receiver, first name or last name
- lastName type nameType - type string with restriction maxLength(50) minLength(1)Name of the receiver, first name or last name
- firstName - optional; type nameType - type string with restriction maxLength(50) minLength(1)
- address - optional; type AddressTypeThe address used to search for receiver to get efaktura identifier.
All elements must match those registered on the receiver- addressLine1 - optional; type addressLineType - type string with restriction maxLength(50)Street, postal or other address
- addressLine2 - optional; type addressLineType - type string with restriction maxLength(50)Street, postal or other address
- postalCode - optional; type postalCodeType - type string with restriction maxLength(10) minLength(4)
- city - optional; type cityType - type string with restriction maxLength(30) minLength(1)
- countryCode - optional; type countryCodeType - type string with restriction maxLength(2) minLength(2)Country code according to ISO-3166
- addressLine1 - optional; type addressLineType - type string with restriction maxLength(50)
- invoiceIssuer - optional; type organizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})Organization number of the sender, issuer or receiver
- dateOfBirth - optional; type date
- eFakturaReferenceAndContentProvider - optional; type eFakturaReferenceAndContentProviderType
- eFakturaReference type eFakturaReferenceType - type string with restriction maxLength(32)The customer agreement reference (eFakturareferanse) of the receiver,
used in the agreement between invoice issuer and receiver (JTTB) - contentProviderId type providerIdType - type string with restriction minLength(9) maxLength(9) pattern([0-9]{9})Id of the issuer
- eFakturaReference type eFakturaReferenceType - type string with restriction maxLength(32)
- efakturaIdentifierKey type EfakturaIdentifierKeyType
- returnOnlyMatchingKeyParams - optional; type boolean
Output:getEfakturaIdentifiersResponse (soap:body, use = literal)Source codegetEfakturaIdentifiersResponse type GetEfakturaIdentifiersResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- getEfakturaIdentifiersResponse type EfakturaIdentifiersResponseTypeList with efaktura identifier keys and efaktura identifier if found
- efakturaIdentifierResponse type EfakturaIdentifierResponseTypeResult of efaktura identifier lookup. The lookup-key is also returned
to pair the efaktura identifier with the correct receiver.- responseResult type efakturaIdentifierResultType - type string with restriction - enum { 'UNIQUE_RECEIVER_FOUND', 'RECEIVER_NOT_FOUND', 'LOOKUP_KEY_MISSING_DATA', 'MULTIPLE_RECEIVERS' }
- hasAutoAcceptAgreements - optional; type boolean
- efakturaIdentifier - optional; type efakturaIdentifierType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})The efakturaIdentifier of the receiver - a unique identifier for the receiver
- efakturaIdentifierKey type EfakturaIdentifierKeyTypeContains the keys used to search for a unique receiver to get the efaktura identifier.
The following rules apply:
1. Search can be made on social security number, organization number, efaktura identifier or eFakturaReferenceAndContentProvider as single key.
2. If email alias or phone alias or date of birth is provided at least two of them must match
3. If only one of date of birth, email alias or phone alias is provided, one of either name, address or
postal code must match.
4. If none of date of birth, email alias or phone alias is given all of name, address and postal code must match.
5. For name and address it is allowed for search where the text is a part of the given field
6. First and last name is also to be switched, meaning a first name search will also try to search in the last
name column- id - optional; type long
- efakturaIdentifier - optional; type efakturaIdentifierType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})The efakturaIdentifier of the receiver - a unique identifier for the receiver
- A choice of one of the following elements:
- socialSecurityNumber type socialSecurityNumberType - type string with restriction maxLength(11) minLength(11) pattern([0-9]{11})The social security number of the receiver.
- organizationNumber type organizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})Organization number of the sender, issuer or receiver
- telephoneAlias - optional; type telephoneAliasType - type string with restriction minLength(6) maxLength(16) pattern(\+\d+)A valid phone number, prefixed with country code (i.e. +4799999999), used for alias
- emailAlias - optional; type emailAliasType - type string with restriction minLength(5) maxLength(100) pattern([^@]+@[^\.]+\..+)A valid email address, used for alias
- name - optional; type FullNameTypeThe name used to search for receiver to get efaktura identifier.
Both elements must match those registered on the receiver- firstName - optional; type nameType - type string with restriction maxLength(50) minLength(1)Name of the receiver, first name or last name
- lastName type nameType - type string with restriction maxLength(50) minLength(1)Name of the receiver, first name or last name
- firstName - optional; type nameType - type string with restriction maxLength(50) minLength(1)
- address - optional; type AddressTypeThe address used to search for receiver to get efaktura identifier.
All elements must match those registered on the receiver- addressLine1 - optional; type addressLineType - type string with restriction maxLength(50)Street, postal or other address
- addressLine2 - optional; type addressLineType - type string with restriction maxLength(50)Street, postal or other address
- postalCode - optional; type postalCodeType - type string with restriction maxLength(10) minLength(4)
- city - optional; type cityType - type string with restriction maxLength(30) minLength(1)
- countryCode - optional; type countryCodeType - type string with restriction maxLength(2) minLength(2)Country code according to ISO-3166
- addressLine1 - optional; type addressLineType - type string with restriction maxLength(50)
- invoiceIssuer - optional; type organizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})Organization number of the sender, issuer or receiver
- dateOfBirth - optional; type date
- eFakturaReferenceAndContentProvider - optional; type eFakturaReferenceAndContentProviderType
- eFakturaReference type eFakturaReferenceType - type string with restriction maxLength(32)The customer agreement reference (eFakturareferanse) of the receiver,
used in the agreement between invoice issuer and receiver (JTTB) - contentProviderId type providerIdType - type string with restriction minLength(9) maxLength(9) pattern([0-9]{9})Id of the issuer
- eFakturaReference type eFakturaReferenceType - type string with restriction maxLength(32)
- issuerResponse - optional; type InvoiceIssuerResponseTypeThe result of issuer lookup in the getEfakturaIdentifier call. It returns if
issuer is blocked by receiver, issuer has efaktura agreement with receiver,
and if found a valid efaktura-referanse is returned- blockedByReceiver type boolean
- hasEfakturaAgreement type boolean
- efakturaReferences - optional, unbounded; type eFakturaReferenceType - type string with restriction maxLength(32)The customer agreement reference (eFakturareferanse) of the receiver,
used in the agreement between invoice issuer and receiver (JTTB)
- efakturaIdentifierResponse type EfakturaIdentifierResponseType
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- getInvoiceStatusDescription:Gets an already created invoiceOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-submitter-service/v1/getInvoiceStatusInput:getInvoiceStatus (soap:body, use = literal)Source codegetInvoiceStatus type GetInvoiceStatus
- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
- getInvoiceStatuses type GetInvoiceStatusesType
- getInvoiceStatus type GetInvoiceStatusType
- consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(9) pattern([0-9]{9,11})Unique 11 digit consignment reference (classic b2c)
- invoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)Unique character invoice reference
- consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(9) pattern([0-9]{9,11})
List of invoices, to get status for - getInvoiceStatus type GetInvoiceStatusType
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
- invoiceStatusResponse type InvoiceStatusResponseType
- contentProviderId - optional; type providerIdType - type string with restriction minLength(9) maxLength(9) pattern([0-9]{9})Id of the issuer
- consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(9) pattern([0-9]{9,11})Unique 11 digit consignment reference (classic b2c)
- invoiceId type invoiceReferenceType - type string with restriction maxLength(100) minLength(1) pattern([.-_a-zA-Z0-9\-:{}]+)Unique character invoice reference
- status type invoiceStatusType - type string with restriction - enum { 'ACCEPTED', 'REJECTED', 'NOT_FOUND', 'CANCELLED' }
- rejectReason - optional; type rejectReasonType - type string with restriction maxLength(40)The reason the invoice was rejected. Only filled out for rejected invoices
- rejectReasonCode - optional; type rejectReasonCodeType - type string with restriction maxLength(3)The status code for the rejected invoice. Only filled out for rejected invoices
- rejectedAttribute - optional; type rejectedAttributeType - type string with restriction maxLength(50)The named attribute causing the invoice rejection. Only filled out for rejected invoices
- rejectedAttributeValue - optional; type rejectedAttributeValueType - type string with restriction maxLength(250)The named attributes value causing the invoice rejection. Only filled out for rejected invoices
- contentProviderId - optional; type providerIdType - type string with restriction minLength(9) maxLength(9) pattern([0-9]{9})
List of invoices, with status - invoiceStatusResponse type InvoiceStatusResponseType
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- getJwkDescription:Get JSON Web Key. Used for validating token in the signed commercial invoice URL.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/getJwkInput:getJwk (soap:body, use = literal)Source codegetJwk type GetJwkGet a list of JSON Web Keys used to verify the jwt signature.
- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
Output:getJwkResponse (soap:body, use = literal)Source codegetJwkResponse type GetJwkResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- jwtResponses type JwkResponsesTypeList of Json Web Keys
- jwkResponseType - optional; type JwkResponseTypeRSA public key in X.509 format.
- alg type stringThe specific cryptographic algorithm used with the key.
- kid type stringThe unique identifier for the key.
- use type stringHow the key was meant to be used. Where sig represents signature usage.
- n type stringModulus, the RSA key length.
- e type stringThe public key exponent.
- kty type stringThe family of cryptographic algorithms used with the key.
- alg type string
- jwkResponseType - optional; type JwkResponseType
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- validateSecuritySignatureDescription:Validates the given security signature and returns the decrypted value.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/validateSecuritySignatureInput:validateSecuritySignature (soap:body, use = literal)Source codevalidateSecuritySignature type ValidateSecuritySignaturePossible validation error codes from operation:
207 - The signature has timed out (is too old).
208 - The signature is not valid or manipulated.- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
- encryptedSignature type encryptedSignatureType - type string with restriction pattern(%3CMSG.*%3E)An encrypted signature
Output:validateSecuritySignatureResponse (soap:body, use = literal)Source codevalidateSecuritySignatureResponse type ValidateSecuritySignatureResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- decryptedSignature type decryptedSignatureType - type string with restrictionA decrypted signature
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
- validateSecurityTokenDescription:Validates the given security signature and returns the decrypted value.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/validateSecurityTokenInput:validateSecurityToken (soap:body, use = literal)Source codevalidateSecurityToken type ValidateSecurityTokenPossible validation error codes from operation:
212 - Different algorithm used for encryption.
213 - Issuer/Content using to verify is not matching.
214 - The token is expired.
215 - The token is Invalid.- auditInformation type AuditInformationTypeInformation used for auditing and logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)
- invoiceUrl type invoiceUrlType - type string with restriction maxLength(255) minLength(1)URL to where the invoice is located
- encryptedToken type encryptedTokenType - type string with restrictionAn encrypted token
Output:validateSecurityTokenResponse (soap:body, use = literal)Source codevalidateSecurityTokenResponse type ValidateSecurityTokenResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- invoiceUrl type invoiceUrlType - type string with restriction maxLength(255) minLength(1)URL to where the invoice is located
Fault:validationFault (soap:fault, use = literal)Source codevalidationFault type ValidationFaultIndicates that the client has sent an invalid request.- errorCode type errorCodeType - type int with restriction minInclusive(200) maxExclusive(299)
- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
Fault:serverFault (soap:fault, use = literal)Source codeserverFault type ServerFaultIndicates an internal server error.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- auditInformation type AuditInformationType
Port type submitter-service-port-typeSource code
WSDL source code
<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="wsdl-viewer.xsl" ?>
<wsdl:definitions name="efaktura-submitter-service" targetNamespace="https://efaktura-services.nets.no/efaktura-submitter-service/v1/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
xmlns:tns="https://efaktura-services.nets.no/efaktura-submitter-service/v1/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"
><wsdl:types>
<xsd:schema targetNamespace="https://efaktura-services.nets.no/efaktura-submitter-service/v1/">
</wsdl:types><xsd:simpleType name="messageIdentifierType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>A unique identifier for a request/response message pair used for logging
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="errorCodeType"></xsd:simpleType>
<xsd:simpleType name="rejectReasonType">
<xsd:annotation>
<xsd:documentation>The reason the invoice was rejected. Only filled out for rejected invoices
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="rejectReasonCodeType">
<xsd:annotation>
<xsd:documentation>The status code for the rejected invoice. Only filled out for rejected invoices
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="rejectedAttributeType">
<xsd:annotation>
<xsd:documentation>The named attribute causing the invoice rejection. Only filled out for rejected invoices
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="rejectedAttributeValueType">
<xsd:annotation>
<xsd:documentation>The named attributes value causing the invoice rejection. Only filled out for rejected invoices
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="nameType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>Name of the receiver, first name or last name
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="socialSecurityNumberType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>The social security number of the receiver.
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="efakturaIdentifierType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>The efakturaIdentifier of the receiver - a unique identifier for the receiver
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="addressLineType">
<xsd:annotation>
<xsd:documentation>Street, postal or other address
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="postalCodeType"></xsd:simpleType>
<xsd:simpleType name="cityType"></xsd:simpleType>
<xsd:simpleType name="countryCodeType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>Country code according to ISO-3166
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="emailAliasType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>A valid email address, used for alias
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="telephoneAliasType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>A valid phone number, prefixed with country code (i.e. +4799999999), used for alias
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="eFakturaReferenceType">
<xsd:annotation>
<xsd:documentation>The customer agreement reference (eFakturareferanse) of the receiver,
used in the agreement between invoice issuer and receiver (JTTB)
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="kidType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>KID
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="brandNameType">
<xsd:annotation>
<xsd:documentation>Name that is shown to the receiver of the invoice
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="invoiceCountType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>The number of invoices received
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="providerIdType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>Id of the issuer</xsd:documentation>
</xsd:annotation><xsd:simpleType name="batchReferenceType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>Free format text used to identify the original inbound consignment in case of forwarding</xsd:documentation>
</xsd:annotation><xsd:simpleType name="providerFileDateType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>File date on the format DDMMYYYY</xsd:documentation>
</xsd:annotation><xsd:simpleType name="consignmentIdType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>Unique 11 digit consignment reference (classic b2c)
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="commissionIdType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>Unique 12 digit commission reference
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="consignmentStatusType">
<xsd:restriction base="xsd:string">
</xsd:simpleType><xsd:enumeration value="IN_PROGRESS">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>Processing of the consignment is in progress
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="DONE">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>Processing of the consignment is finished
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="STOPPED">
</xsd:restriction><xsd:annotation>
</xsd:enumeration><xsd:documentation>Consignment is stopped by operator
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="documentType">
<xsd:restriction base="xsd:string">
</xsd:simpleType><xsd:enumeration value="EFAKTURA">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>document Type of efaktura</xsd:documentation>
</xsd:annotation><xsd:enumeration value="AVTALEGIRO">
</xsd:restriction><xsd:annotation>
</xsd:enumeration><xsd:documentation>document Type of AvtaleGiro</xsd:documentation>
</xsd:annotation><xsd:simpleType name="invoiceDocumentType">
<xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="invoiceReferenceType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>Unique character invoice reference
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="invoiceStatusType">
<xsd:restriction base="xsd:string">
</xsd:simpleType><xsd:enumeration value="ACCEPTED">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>The invoice has been delete by the receiver
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="REJECTED">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>The invoice is unprocessed by the receiver
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="NOT_FOUND">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>The invoice is not found in the database
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="CANCELLED">
</xsd:restriction><xsd:annotation>
</xsd:enumeration><xsd:documentation>The invoice is cancelled by the provider
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="invoiceUrlType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>URL to where the invoice is located
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="invoiceNumberType">
<xsd:annotation>
<xsd:documentation>The issuer invoice-number, ERP-/accounting-system generated sequence.
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="organizationNumberType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>Organization number of the sender, issuer or receiver
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="simpleAmountType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>The amount represented as a number with two decimals. Must not be negative
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="accountNumberType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>The account the amount should be payed to
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="encryptedSignatureType">
<xsd:annotation>
<xsd:documentation>An encrypted signature
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="encryptedTokenType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>An encrypted token
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="decryptedSignatureType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>A decrypted signature
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="efakturaIdentifierResultType">
<xsd:restriction base="xsd:string">
</xsd:simpleType><xsd:enumeration value="UNIQUE_RECEIVER_FOUND">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>The invoice receiver is found in the receiver register
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="RECEIVER_NOT_FOUND">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>The invoice receiver is not found in the receiver register
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="LOOKUP_KEY_MISSING_DATA">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>Missing input data on lookup key
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="MULTIPLE_RECEIVERS">
</xsd:restriction><xsd:annotation>
</xsd:enumeration><xsd:documentation>Multiple receivers found for the given details. More info is needed
to find an exact match.
</xsd:documentation>
</xsd:annotation><xsd:complexType name="AuditInformationType">
<xsd:annotation>
</xsd:complexType><xsd:documentation>Information used for auditing and logging
</xsd:documentation>
</xsd:annotation><xsd:complexType name="DueDateType">
<xsd:annotation>
<xsd:documentation>The invoice due date
</xsd:documentation>
</xsd:annotation><xsd:sequence>
</xsd:complexType><xsd:element name="originalDueDate" type="xsd:date">
<xsd:annotation>
</xsd:element><xsd:documentation>The original due date given on the invoice. Must be at least be the same date as the invoice is created
</xsd:documentation>
</xsd:annotation><xsd:element name="dueDatePaid" type="xsd:date" minOccurs="0">
</xsd:sequence><xsd:annotation>
</xsd:element><xsd:documentation>The updated due date updated by the end user
</xsd:documentation>
</xsd:annotation><xsd:complexType name="eFakturaReferenceAndContentProviderType"></xsd:complexType>
<xsd:complexType name="FullNameType">
<xsd:annotation>
</xsd:complexType><xsd:documentation>The name used to search for receiver to get efaktura identifier.
Both elements must match those registered on the receiver
</xsd:documentation>
</xsd:annotation><xsd:complexType name="AddressType">
<xsd:annotation>
<xsd:documentation>The address used to search for receiver to get efaktura identifier.
All elements must match those registered on the receiver
</xsd:documentation>
</xsd:annotation><xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:complexType name="GetAmountType">
<xsd:annotation>
<xsd:documentation>The invoice amount total
</xsd:documentation>
</xsd:annotation><xsd:sequence>
</xsd:complexType><xsd:element name="originalAmount" type="tns:simpleAmountType">
<xsd:annotation>
</xsd:element><xsd:documentation>The original amount given on the invoice
</xsd:documentation>
</xsd:annotation><xsd:element name="minimumAmount" type="tns:simpleAmountType" minOccurs="0">
<xsd:annotation>
</xsd:element><xsd:documentation>The minimum amount and currency set by the issuer
</xsd:documentation>
</xsd:annotation><xsd:element name="amountPaid" minOccurs="0" type="tns:simpleAmountType">
<xsd:annotation>
</xsd:element><xsd:documentation>The updated amount updated by the end user
</xsd:documentation>
</xsd:annotation><xsd:element name="currency">
</xsd:sequence><xsd:simpleType></xsd:simpleType>
</xsd:element><xsd:complexType name="InvoiceType">
<xsd:sequence>
</xsd:complexType><xsd:choice></xsd:choice>
</xsd:sequence><xsd:complexType name="InvoicesType">
<xsd:annotation>
</xsd:complexType><xsd:documentation>
Represents an invoice. Allows up to a 1000 invoices per consignment.
</xsd:documentation>
</xsd:annotation><xsd:complexType name="EfakturaIdentifierKeyType">
<xsd:annotation>
<xsd:documentation>Contains the keys used to search for a unique receiver to get the efaktura identifier.
The following rules apply:
1. Search can be made on social security number, organization number, efaktura identifier or eFakturaReferenceAndContentProvider as single key.
2. If email alias or phone alias or date of birth is provided at least two of them must match
3. If only one of date of birth, email alias or phone alias is provided, one of either name, address or
postal code must match.
4. If none of date of birth, email alias or phone alias is given all of name, address and postal code must match.
5. For name and address it is allowed for search where the text is a part of the given field
6. First and last name is also to be switched, meaning a first name search will also try to search in the last
name column
</xsd:documentation>
</xsd:annotation><xsd:sequence>
</xsd:complexType><xsd:choice minOccurs="0"></xsd:choice>
</xsd:sequence><xsd:complexType name="EfakturaIdentifiersKeyType">
<xsd:annotation>
</xsd:complexType><xsd:documentation>
Contains a set of keys used to search for unique receivers to get the efaktura identifier. Allows for search up to a 1000 receivers.
</xsd:documentation>
</xsd:annotation><xsd:complexType name="SenderInfoType">
<xsd:sequence>
</xsd:complexType><xsd:element name="consignmentId" type="tns:consignmentIdType" minOccurs="0">
<xsd:annotation>
</xsd:element><xsd:documentation>
consignmetId is optional for single invoice shipments
</xsd:documentation>
</xsd:annotation><xsd:element name="commissionId" type="tns:commissionIdType" minOccurs="0">
</xsd:sequence><xsd:annotation>
</xsd:element><xsd:documentation>
commissionId is optional and are generated automatically if not set.
This value serves no use for external parties and can safely be omitted.
</xsd:documentation>
</xsd:annotation><xsd:complexType name="InvoiceIssuerResponseType">
<xsd:annotation>
</xsd:complexType><xsd:documentation>The result of issuer lookup in the getEfakturaIdentifier call. It returns if
issuer is blocked by receiver, issuer has efaktura agreement with receiver,
and if found a valid efaktura-referanse is returned
</xsd:documentation>
</xsd:annotation><xsd:complexType name="EfakturaIdentifierResponseType">
<xsd:annotation>
<xsd:documentation>Result of efaktura identifier lookup. The lookup-key is also returned
to pair the efaktura identifier with the correct receiver.
</xsd:documentation>
</xsd:annotation><xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:complexType name="EfakturaIdentifiersResponseType">
<xsd:annotation>
</xsd:complexType><xsd:documentation>List with efaktura identifier keys and efaktura identifier if found
</xsd:documentation>
</xsd:annotation><xsd:complexType name="GetInvoiceStatusesType"></xsd:complexType>
<xsd:complexType name="GetInvoiceStatusType"></xsd:complexType>
<xsd:complexType name="InvoiceStatusResponsesType"></xsd:complexType>
<xsd:complexType name="InvoiceStatusResponseType">
<xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:complexType name="RejectedInvoicesType"></xsd:complexType>
<xsd:complexType name="RejectedInvoiceType">
<xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:complexType name="CancelledInvoicesType"></xsd:complexType>
<xsd:complexType name="CancelledInvoiceType"></xsd:complexType>
<xsd:complexType name="BlackListResponsesType"></xsd:complexType>
<xsd:complexType name="BlackListResponseType">
<xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:element name="AddInvoices">
<xsd:annotation>
</xsd:element><xsd:documentation>
To get a status for the consignment and invoices use the getConsignmentStatus and getInvoiceStatus
calls.
Possible validation error codes from operation:
209 - Duplicate consignmentId (Sender has used this consignmentId before)
</xsd:documentation>
</xsd:annotation><xsd:element name="AddInvoicesResponse"></xsd:element>
<xsd:element name="InvoiceLogicalIdentityType">
<xsd:annotation>
<xsd:documentation>
MPS internal for now. To identift a single one invoice added, identified uniqly by invoiceNumber and serviceProvider (consignmentId for compatibility and use with backend system).
</xsd:documentation>
</xsd:annotation><xsd:complexType>
</xsd:element><xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:element name="GetAddedInvoiceValidationResponse">
<xsd:annotation>
<xsd:documentation>
MPS internal for now. Contains status for a single invoice added. Reject attribute populated when status is REJECTED only.
</xsd:documentation>
</xsd:annotation><xsd:complexType></xsd:complexType>
</xsd:element><xsd:element name="GetInvoiceStatus">
<xsd:complexType>
</xsd:element><xsd:sequence>
</xsd:complexType><xsd:element name="getInvoiceStatuses" type="tns:GetInvoiceStatusesType">
</xsd:sequence><xsd:annotation>
</xsd:element><xsd:documentation>List of invoices, to get status for
</xsd:documentation>
</xsd:annotation><xsd:element name="GetInvoiceStatusResponse">
<xsd:complexType>
</xsd:element><xsd:sequence>
</xsd:complexType><xsd:element name="invoiceStatusResponses" type="tns:InvoiceStatusResponsesType">
</xsd:sequence><xsd:annotation>
</xsd:element><xsd:documentation>List of invoices, with status
</xsd:documentation>
</xsd:annotation><xsd:element name="GetConsignmentStatus">
<xsd:annotation>
</xsd:element><xsd:documentation>
Possible validation error codes from operation
201 - Unable to find consignment
202 - Multiple consignments found for id
</xsd:documentation>
</xsd:annotation><xsd:element name="GetConsignmentStatusResponse">
<xsd:complexType>
</xsd:element><xsd:sequence>
</xsd:complexType><xsd:element name="rejectedInvoices" type="tns:RejectedInvoicesType" minOccurs="0">
<xsd:annotation>
</xsd:element><xsd:documentation>List of rejected invoices.
</xsd:documentation>
</xsd:annotation><xsd:element name="cancelledInvoices" type="tns:CancelledInvoicesType" minOccurs="0">
</xsd:sequence><xsd:annotation>
</xsd:element><xsd:documentation>List of cancelled invoices.
</xsd:documentation>
</xsd:annotation><xsd:element name="GetEfakturaIdentifiers">
<xsd:complexType></xsd:complexType>
</xsd:element><xsd:element name="GetEfakturaIdentifiersResponse"></xsd:element>
<xsd:element name="ValidateSecuritySignature">
<xsd:annotation>
</xsd:element><xsd:documentation>
Possible validation error codes from operation:
207 - The signature has timed out (is too old).
208 - The signature is not valid or manipulated.
</xsd:documentation>
</xsd:annotation><xsd:element name="ValidateSecurityToken">
<xsd:annotation>
</xsd:element><xsd:documentation>
Possible validation error codes from operation:
212 - Different algorithm used for encryption.
213 - Issuer/Content using to verify is not matching.
214 - The token is expired.
215 - The token is Invalid.
</xsd:documentation>
</xsd:annotation><xsd:element name="ValidateSecuritySignatureResponse"></xsd:element>
<xsd:element name="ValidateSecurityTokenResponse"></xsd:element>
<xsd:element name="CancelConsignment">
<xsd:annotation>
</xsd:element><xsd:documentation>
Possible validation error codes from operation:
201 - Unable to find consignment.
202 - Multiple consignments found for id
205 - Consignment already cancelled
</xsd:documentation>
</xsd:annotation><xsd:element name="CancelConsignmentResponse">
<xsd:complexType></xsd:complexType>
</xsd:element><xsd:element name="CancelInvoice">
<xsd:annotation>
</xsd:element><xsd:documentation>
Possible validation error codes from operation
203 - Multiple invoices found for id
204 - Unable to find invoice
206 - Invoice already cancelled
</xsd:documentation>
</xsd:annotation><xsd:element name="CancelSingleInvoice">
<xsd:annotation>
</xsd:element><xsd:documentation>
Possible validation error codes from operation
203 - Multiple invoices found for issuer id
204 - Unable to find invoice
206 - Invoice already cancelled
</xsd:documentation>
</xsd:annotation><xsd:element name="CancelInvoiceResponse">
<xsd:complexType></xsd:complexType>
</xsd:element><xsd:element name="GetBlackList">
<xsd:annotation>
<xsd:documentation>Request a list of black listed issuers
</xsd:documentation>
</xsd:annotation><xsd:complexType></xsd:complexType>
</xsd:element><xsd:element name="GetBlackListResponse">
<xsd:complexType>
</xsd:element><xsd:sequence>
</xsd:complexType><xsd:element name="blackListResponses" type="tns:BlackListResponsesType">
</xsd:sequence><xsd:annotation>
</xsd:element><xsd:documentation>List of BlackListed invoice issuers
</xsd:documentation>
</xsd:annotation><xsd:element name="GetJwk">
<xsd:annotation>
<xsd:documentation>Get a list of JSON Web Keys used to verify the jwt signature.
</xsd:documentation>
</xsd:annotation><xsd:complexType></xsd:complexType>
</xsd:element><xsd:element name="GetJwkResponse">
<xsd:complexType>
</xsd:element><xsd:sequence>
</xsd:complexType><xsd:element name="jwtResponses" type="tns:JwkResponsesType">
</xsd:sequence><xsd:annotation>
</xsd:element><xsd:documentation>List of Json Web Keys
</xsd:documentation>
</xsd:annotation><xsd:complexType name="JwkResponsesType"></xsd:complexType>
<xsd:complexType name="JwkResponseType">
<xsd:annotation>
<xsd:documentation>RSA public key in X.509 format.</xsd:documentation>
</xsd:annotation><xsd:sequence>
</xsd:complexType><xsd:element name="alg" type="xsd:string">
<xsd:annotation>
</xsd:element><xsd:documentation>The specific cryptographic algorithm used with the key.</xsd:documentation>
</xsd:annotation><xsd:element name="kid" type="xsd:string">
<xsd:annotation>
</xsd:element><xsd:documentation>The unique identifier for the key.</xsd:documentation>
</xsd:annotation><xsd:element name="use" type="xsd:string">
<xsd:annotation>
</xsd:element><xsd:documentation>How the key was meant to be used. Where sig represents signature usage.</xsd:documentation>
</xsd:annotation><xsd:element name="n" type="xsd:string">
<xsd:annotation>
</xsd:element><xsd:documentation>Modulus, the RSA key length.</xsd:documentation>
</xsd:annotation><xsd:element name="e" type="xsd:string">
<xsd:annotation>
</xsd:element><xsd:documentation>The public key exponent.</xsd:documentation>
</xsd:annotation><xsd:element name="kty" type="xsd:string">
</xsd:sequence><xsd:annotation>
</xsd:element><xsd:documentation>The family of cryptographic algorithms used with the key.</xsd:documentation>
</xsd:annotation><xsd:element name="ServerFault">
<xsd:annotation>
<xsd:documentation>
Indicates an internal server error.
</xsd:documentation>
</xsd:annotation><xsd:complexType></xsd:complexType>
</xsd:element><xsd:element name="ValidationFault">
</xsd:schema><xsd:annotation>
</xsd:element><xsd:documentation>
Indicates that the client has sent an invalid request.
</xsd:documentation>
</xsd:annotation><wsdl:message name="addInvoices"></wsdl:message>
<wsdl:message name="addInvoicesResponse"></wsdl:message>
<wsdl:message name="invoiceLogicalIdentity"></wsdl:message>
<wsdl:message name="getAddedInvoiceValidationResponse"></wsdl:message>
<wsdl:message name="getInvoiceStatus"></wsdl:message>
<wsdl:message name="getInvoiceStatusResponse"></wsdl:message>
<wsdl:message name="getConsignmentStatus"></wsdl:message>
<wsdl:message name="getConsignmentStatusResponse"></wsdl:message>
<wsdl:message name="getEfakturaIdentifiers"></wsdl:message>
<wsdl:message name="getEfakturaIdentifiersResponse"></wsdl:message>
<wsdl:message name="validateSecuritySignature"></wsdl:message>
<wsdl:message name="validateSecuritySignatureResponse"></wsdl:message>
<wsdl:message name="validateSecurityToken"></wsdl:message>
<wsdl:message name="validateSecurityTokenResponse"></wsdl:message>
<wsdl:message name="cancelConsignment"></wsdl:message>
<wsdl:message name="cancelConsignmentResponse"></wsdl:message>
<wsdl:message name="cancelInvoice"></wsdl:message>
<wsdl:message name="cancelSingleInvoice"></wsdl:message>
<wsdl:message name="cancelInvoiceResponse"></wsdl:message>
<wsdl:message name="getBlackList"></wsdl:message>
<wsdl:message name="getBlackListResponse"></wsdl:message>
<wsdl:message name="getJwkResponse"></wsdl:message>
<wsdl:message name="validationFault"></wsdl:message>
<wsdl:message name="serverFault"></wsdl:message>
<wsdl:portType name="submitter-service-port-type">
<wsdl:operation name="addInvoices">
<wsdl:documentation>Creates an invoice that is to be displayed in the online bank
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getAddedInvoiceValidation">
<wsdl:documentation>Check processing status for one posted invoice, returns the full document rejection if so.</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getInvoiceStatus">
<wsdl:documentation>Gets an already created invoice
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getConsignmentStatus">
<wsdl:documentation>Get status on consignment</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getEfakturaIdentifiers">
<wsdl:documentation>Returns efakturaIdentifier and auto accept agreement if the receiver is found by
efaktura identifier, personalnumber, organization number, phone, email, name, or address.
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="validateSecuritySignature">
<wsdl:documentation>Validates the given security signature and returns the decrypted value.
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="validateSecurityToken">
<wsdl:documentation>Validates the given security signature and returns the decrypted value.
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="cancelConsignment">
<wsdl:documentation>Cancel all invoices in a consignment
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="cancelInvoice">
<wsdl:documentation>Cancel spesific invoices in a consignment
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="cancelSingleInvoice">
<wsdl:documentation>Cancel a single consignment independent invoice.
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getBlackList">
<wsdl:documentation>get BlackListed invoice issuers
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getJwk">
</wsdl:portType><wsdl:documentation>Get JSON Web Key. Used for validating token in the signed commercial invoice URL.
</wsdl:documentation>
</wsdl:operation><wsdl:binding name="submitter-service-soap-binding" type="tns:submitter-service-port-type">
<wsdl:operation name="addInvoices">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="getAddedInvoiceValidation">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="getInvoiceStatus">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="getConsignmentStatus">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="getEfakturaIdentifiers">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="validateSecuritySignature">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="cancelConsignment">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="cancelInvoice">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="cancelSingleInvoice">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="getBlackList">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="validateSecurityToken">
</wsdl:binding><wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:service name="submitter-service"></wsdl:service>
<wsp:Policy wsu:Id="UsernameToken"
</wsdl:definitions> xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"
><wsp:ExactlyOne>
</wsp:Policy><wsp:All>
</wsp:ExactlyOne><sp:SupportingTokens>
</wsp:All><wsp:Policy></wsp:Policy>
</sp:SupportingTokens>