Utfylt og klar i nettbanken din

Submitter Service

Web Service: submitter-service
Nets logo

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:
  1. addInvoicesDetailSource code
  2. cancelConsignmentDetailSource code
  3. cancelInvoiceDetailSource code
  4. getBlackListDetailSource code
  5. getConsignmentStatusDetailSource code
  6. getEfakturaIdentifiersDetailSource code
  7. getInvoiceStatusDetailSource code
  8. validateSecuritySignatureDetailSource code

Operations

    Port type submitter-service-port-typeSource code

    1. addInvoices
      Description:
      Creates an invoice that is to be displayed in the online bank
      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/addInvoices
      Input:
      addInvoices (soap:body, use = literal)Source code
      addInvoices type AddInvoices
      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)
      • auditInformation type AuditInformationType
        Information 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
      • senderInfo type SenderInfoType
        • consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(11) pattern([0-9]{11})
          Unique 11 digit consignment reference
        • contentProviderId type providerIdType - type string with restriction minLength(9) maxLength(9) pattern([0-9]{9})
          Id of the issuer
      • invoices type InvoicesType
        Represents an invoice. Allows up to a 1000 invoices per consignment.
        • invoice type InvoiceType
          • invoiceId type invoiceReferenceType - type string with restriction maxLength(50) 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(40)
            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' }
      Output:
      addInvoicesResponse (soap:body, use = literal)Source code
      addInvoicesResponse 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 restriction
        The number of invoices received
      Fault:
      validationFault (soap:fault, use = literal)Source code
      validationFault type ValidationFault
      Indicates 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 code
      serverFault type ServerFault
      Indicates 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
    2. cancelConsignment
      Description:
      Cancel all invoices in a consignment
      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/cancelConsignment
      Input:
      cancelConsignment (soap:body, use = literal)Source code
      cancelConsignment type CancelConsignment
      Possible validation error codes from operation:
      201 - Unable to find consignment.
      202 - Multiple consignments found for id
      205 - Consignment already cancelled
      • auditInformation type AuditInformationType
        Information 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
      • consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(11) pattern([0-9]{11})
        Unique 11 digit consignment reference
      Output:
      cancelConsignmentResponse (soap:body, use = literal)Source code
      cancelConsignmentResponse 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 code
      validationFault type ValidationFault
      Indicates 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 code
      serverFault type ServerFault
      Indicates 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
    3. cancelInvoice
      Description:
      Cancel spesific invoices in a consignment
      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 (soap:body, use = literal)Source code
      cancelInvoice type CancelInvoice
      Possible validation error codes from operation
      203 - Multiple invoices found for id
      204 - Unable to find invoice
      206 - Invoice already cancelled
      • auditInformation type AuditInformationType
        Information 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
      • consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(11) pattern([0-9]{11})
        Unique 11 digit consignment reference
      • invoiceId type invoiceReferenceType - type string with restriction maxLength(50) minLength(1) pattern([a-zA-Z0-9\-:{}]+)
        Unique character invoice reference
      Output:
      cancelInvoiceResponse (soap:body, use = literal)Source code
      cancelInvoiceResponse 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 code
      validationFault type ValidationFault
      Indicates 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 code
      serverFault type ServerFault
      Indicates 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
    4. getBlackList
      Description:
      get BlackListed invoice issuers
      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/getBlackList
      Input:
      getBlackList (soap:body, use = literal)Source code
      getBlackList type GetBlackList
      Request a list of black listed issuers
      • auditInformation type AuditInformationType
        Information 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
      Output:
      getBlackListResponse (soap:body, use = literal)Source code
      getBlackListResponse 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
      Fault:
      validationFault (soap:fault, use = literal)Source code
      validationFault type ValidationFault
      Indicates 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 code
      serverFault type ServerFault
      Indicates 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
    5. 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/efaktura-submitter-service/v1/getConsignmentStatus
      Input:
      getConsignmentStatus (soap:body, use = literal)Source code
      getConsignmentStatus type GetConsignmentStatus
      Possible validation error codes from operation
      201 - Unable to find consignment
      202 - Multiple consignments found for id
      • auditInformation type AuditInformationType
        Information 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
      • consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(11) pattern([0-9]{11})
        Unique 11 digit consignment reference
      Output:
      getConsignmentStatusResponse (soap:body, use = literal)Source code
      getConsignmentStatusResponse 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(50) 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
        List of rejected invoices.
      • cancelledInvoices - optional; type CancelledInvoicesType
        • cancelledInvoice - optional; type CancelledInvoiceType
          • invoiceId type invoiceReferenceType - type string with restriction maxLength(50) minLength(1) pattern([a-zA-Z0-9\-:{}]+)
            Unique character invoice reference
        List of cancelled invoices.
      Fault:
      validationFault (soap:fault, use = literal)Source code
      validationFault type ValidationFault
      Indicates 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 code
      serverFault type ServerFault
      Indicates 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
    6. 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/efaktura-submitter-service/v1/getEfakturaIdentifiers
      Input:
      getEfakturaIdentifiers (soap:body, use = literal)Source code
      getEfakturaIdentifiers type GetEfakturaIdentifiers
      • auditInformation type AuditInformationType
        Information 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
      • getEfakturaIdentifiersKey type EfakturaIdentifiersKeyType
        Contains 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 EfakturaIdentifierKeyType
          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
          • 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 FullNameType
            The 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
          • address - optional; type AddressType
            The 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
          • 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
      Output:
      getEfakturaIdentifiersResponse (soap:body, use = literal)Source code
      getEfakturaIdentifiersResponse 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 EfakturaIdentifiersResponseType
        List with efaktura identifier keys and efaktura identifier if found
        • efakturaIdentifierResponse type EfakturaIdentifierResponseType
          Result 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 EfakturaIdentifierKeyType
            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
            • 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 FullNameType
              The 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
            • address - optional; type AddressType
              The 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
            • 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
          • issuerResponse - optional; type InvoiceIssuerResponseType
            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
            • 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)
      Fault:
      validationFault (soap:fault, use = literal)Source code
      validationFault type ValidationFault
      Indicates 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 code
      serverFault type ServerFault
      Indicates 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
    7. 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/efaktura-submitter-service/v1/getInvoiceStatus
      Input:
      getInvoiceStatus (soap:body, use = literal)Source code
      getInvoiceStatus type GetInvoiceStatus
      • auditInformation type AuditInformationType
        Information 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
      • getInvoiceStatuses type GetInvoiceStatusesType
        • getInvoiceStatus type GetInvoiceStatusType
          • consignmentId type consignmentIdType - type string with restriction maxLength(11) minLength(11) pattern([0-9]{11})
            Unique 11 digit consignment reference
          • invoiceId type invoiceReferenceType - type string with restriction maxLength(50) minLength(1) pattern([a-zA-Z0-9\-:{}]+)
            Unique character invoice reference
        List of invoices, to get status for
      Output:
      getInvoiceStatusResponse (soap:body, use = literal)Source code
      getInvoiceStatusResponse 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(11) pattern([0-9]{11})
            Unique 11 digit consignment reference
          • invoiceId type invoiceReferenceType - type string with restriction maxLength(50) 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
        List of invoices, with status
      Fault:
      validationFault (soap:fault, use = literal)Source code
      validationFault type ValidationFault
      Indicates 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 code
      serverFault type ServerFault
      Indicates 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
    8. validateSecuritySignature
      Description:
      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/validateSecuritySignature
      Input:
      validateSecuritySignature (soap:body, use = literal)Source code
      validateSecuritySignature type ValidateSecuritySignature
      Possible validation error codes from operation:
      207 - The signature has timed out (is too old).
      208 - The signature is not valid or manipulated.
      • auditInformation type AuditInformationType
        Information 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
      • encryptedSignature type encryptedSignatureType - type string with restriction pattern(%3CMSG.*%3E)
        An encrypted signature
      Output:
      validateSecuritySignatureResponse (soap:body, use = literal)Source code
      validateSecuritySignatureResponse 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 restriction
        A decrypted signature
      Fault:
      validationFault (soap:fault, use = literal)Source code
      validationFault type ValidationFault
      Indicates 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 code
      serverFault type ServerFault
      Indicates 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

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/">
<xsd:simpleType name="messageIdentifierType">
<xsd:annotation>
<xsd:documentation>A unique identifier for a request/response message pair used for logging </xsd:documentation>
</xsd:annotation>
</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: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:simpleType>
<xsd:simpleType name="nameType">
<xsd:annotation>
<xsd:documentation>Name of the receiver, first name or last name </xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<xsd:simpleType name="efakturaIdentifierType">
<xsd:annotation>
<xsd:documentation>The efakturaIdentifier of the receiver - a unique identifier for the receiver </xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<xsd:simpleType name="addressLineType">
<xsd:annotation>
<xsd:documentation>Street, postal or other address </xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<xsd:simpleType name="telephoneAliasType">
<xsd:annotation>
<xsd:documentation>A valid phone number, prefixed with country code (i.e. +4799999999), used for alias </xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<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:simpleType>
<xsd:simpleType name="brandNameType">
<xsd:annotation>
<xsd:documentation>Name that is shown to the receiver of the invoice </xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<xsd:simpleType name="invoiceCountType">
<xsd:annotation>
<xsd:documentation>The number of invoices received </xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<xsd:simpleType name="consignmentStatusType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="IN_PROGRESS">
<xsd:annotation>
<xsd:documentation>Processing of the consignment is in progress </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="DONE">
<xsd:annotation>
<xsd:documentation>Processing of the consignment is finished </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="STOPPED">
<xsd:annotation>
<xsd:documentation>Consignment is stopped by operator </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="documentType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="EFAKTURA">
<xsd:annotation>
<xsd:documentation>document Type of efaktura</xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="AVTALEGIRO">
<xsd:annotation>
<xsd:documentation>document Type of AvtaleGiro</xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="invoiceStatusType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="ACCEPTED">
<xsd:annotation>
<xsd:documentation>The invoice has been delete by the receiver </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="REJECTED">
<xsd:annotation>
<xsd:documentation>The invoice is unprocessed by the receiver </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="NOT_FOUND">
<xsd:annotation>
<xsd:documentation>The invoice is not found in the database </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="CANCELLED">
<xsd:annotation>
<xsd:documentation>The invoice is cancelled by the provider </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="simpleAmountType">
<xsd:annotation>
<xsd:documentation>The amount represented as a number with two decimals. Must not be negative </xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<xsd:simpleType name="efakturaIdentifierResultType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="UNIQUE_RECEIVER_FOUND">
<xsd:annotation>
<xsd:documentation>The invoice receiver is found in the receiver register </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="RECEIVER_NOT_FOUND">
<xsd:annotation>
<xsd:documentation>The invoice receiver is not found in the receiver register </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="LOOKUP_KEY_MISSING_DATA">
<xsd:annotation>
<xsd:documentation>Missing input data on lookup key </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="MULTIPLE_RECEIVERS">
<xsd:annotation>
<xsd:documentation>Multiple receivers found for the given details. More info is needed to find an exact match. </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="AuditInformationType">
<xsd:annotation>
<xsd:documentation>Information used for auditing and logging </xsd:documentation>
</xsd:annotation>
</xsd:complexType>
<xsd:complexType name="DueDateType">
<xsd:annotation>
<xsd:documentation>The invoice due date </xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="originalDueDate" type="xsd:date">
<xsd:annotation>
<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>
<xsd:element name="dueDatePaid" type="xsd:date" minOccurs="0">
<xsd:annotation>
<xsd:documentation>The updated due date updated by the end user </xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="FullNameType">
<xsd:annotation>
<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>
<xsd:complexType name="GetAmountType">
<xsd:annotation>
<xsd:documentation>The invoice amount total </xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element name="originalAmount" type="tns:simpleAmountType">
<xsd:annotation>
<xsd:documentation>The original amount given on the invoice </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="minimumAmount" type="tns:simpleAmountType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>The minimum amount and currency set by the issuer </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="amountPaid" minOccurs="0" type="tns:simpleAmountType">
<xsd:annotation>
<xsd:documentation>The updated amount updated by the end user </xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="InvoicesType">
<xsd:annotation>
<xsd:documentation> Represents an invoice. Allows up to a 1000 invoices per consignment. </xsd:documentation>
</xsd:annotation>
</xsd:complexType>
<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:complexType>
<xsd:complexType name="EfakturaIdentifiersKeyType">
<xsd:annotation>
<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>
<xsd:complexType name="InvoiceIssuerResponseType">
<xsd:annotation>
<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>
<xsd:element name="AddInvoices">
<xsd:annotation>
<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>
<xsd:element name="GetConsignmentStatus">
<xsd:annotation>
<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>
<xsd:element name="ValidateSecuritySignature">
<xsd:annotation>
<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>
<xsd:element name="CancelConsignment">
<xsd:annotation>
<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>
<xsd:element name="CancelInvoice">
<xsd:annotation>
<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>
<xsd:element name="GetBlackList">
<xsd:annotation>
<xsd:documentation>Request a list of black listed issuers </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ServerFault">
<xsd:annotation>
<xsd:documentation> Indicates an internal server error. </xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:schema>
</wsdl:types>
<wsdl:portType name="submitter-service-port-type">
<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:portType>
<wsdl:binding name="submitter-service-soap-binding" type="tns:submitter-service-port-type"></wsdl:binding>
</wsdl:definitions>