Web Service: EfakturaNetsSubmitterService
Nets logo

Web Service: EfakturaNetsSubmitterService

Target Namespace:
https://efaktura-services.nets.no/invoicing-nets-submitter/v1/

Port EfakturaNetsSubmittertPort Port typeSource code

Location:
https://efaktura-services.nets.no/invoicing-nets-submitter/v1/
Protocol:
SOAP
Default style:
document
Transport protocol:
SOAP over HTTP
Operations:
  1. addInvoicesDetailSource code
  2. cancelInvoiceDetailSource code
  3. getCancellableInvoiceDetailSource code
  4. getConsignmentStatusDetailSource code
  5. getEfakturaIdentifiersDetailSource code
  6. getInvoiceStatusDetailSource code

Operations

    Port type EfakturaNetsSubmitterPortTypeSource code

    1. addInvoices
      Description:
      Creates an invoice that is to be displayed in the online bank 5003 - One of efakturaReference,efakturaIdentifier or socialSecurityNumber is required
      Operation type:
      Request-response. The endpoint receives a message, and sends a correlated message.
      SOAP action:
      https://efaktura-services.nets.no/invoicing-nets-submitter/v1/addInvoices
      Input:
      addInvoices (soap:body, use = literal)Source code
      addInvoices type AddInvoices
      To get status for the invoices and consignments use the getInvoiceStatus and
      getConsignmentStatus call.

      Possible validation error codes from operation
      5009 - User must supply service provider id
      5010 - User not allowed to supply service provider id
      • auditInformation type AuditInformationType
        Information used for auditing and logging messages
        • messageIdentifier type MessageIdentifierType - type string with restriction minLength(5) maxLength(50)
          A unique identifier for a request/response message pair used for logging
      • serviceProvider - optional; type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
      • consignmentId type ConsignmentIdType - type string with restriction maxLength(40) minLength(1)
        Unique consignment reference
      • invoices type InvoicesType
      • A choice of one of the following elements:
        • invoice type InvoiceType
          • invoiceNumber type InvoiceNumberType - type string with restriction maxLength(100) minLength(1)
            Unique reference to the invoice for the issuer.
          • 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, the unique efaktura address for this 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)
          • issuer type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
          • receiverName - optional; type FullNameType
            • firstName - optional; type NameType - type string with restriction maxLength(100) minLength(1)
              Name of the issuer
            • lastName type NameType - type string with restriction maxLength(100) minLength(1)
              Name of the issuer
          • receiverAddress - optional; type AddressType
            • 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 PostalCityType - type string with restriction maxLength(30) minLength(1)
            • countryCode - optional; type CountryCodeType - type string with restriction maxLength(2) minLength(2)
          • receiverEmail - optional; type EmailType - type string with restriction minLength(5) maxLength(100) pattern([^@]+@[^\.]+\..+)
            A valid email address
          • receiverPhone - optional; type TelephoneType - type string with restriction minLength(6) maxLength(16) pattern(\+?\d+)
            A valid phone number
          • kid - optional; type KidType - type string with restriction maxLength(25) minLength(2) pattern(\d*)
            KID
          • dueDate type date
          • amount type SimpleAmountType - type decimal with restriction fractionDigits(2) minInclusive(0.00)
            The amount represented as a number with two decimals. Must not be negative
          • minimumAmount - optional; type SimpleAmountType - type decimal with restriction fractionDigits(2) minInclusive(0.00)
            The amount represented as a number with two decimals. Must not be negative
          • accountNumber type BillingAccountNumberType - type string with restriction length(11)
            Must be a Norwegian account number with 11 digits
          • documentType type documentType - type string with restriction - enum { 'EFAKTURA', 'AVTALEGIRO' }
          • invoiceDocumentType - optional; type invoiceDocumentType - type string with restriction - enum { 'INVOICE', 'REMINDER', 'CREDIT_NOTE', 'COLLECTION_NOTICE', 'DUNNING', 'PAYMENT_REQUEST', 'ENFORCEMENT_WARNING' }
          • A choice of one of the following elements:
            • pdf type Pdf - type base64Binary with restriction
              PDF representation of the invoice
            • invoiceSpecification type InvoiceSpecification
              Contains the invoice specification fields
              • receiverName - optional; type FullNameType
                • firstName - optional; type NameType - type string with restriction maxLength(100) minLength(1)
                  Name of the issuer
                • lastName type NameType - type string with restriction maxLength(100) minLength(1)
                  Name of the issuer
              • receiverAddress - optional; type AddressType
                • 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 PostalCityType - type string with restriction maxLength(30) minLength(1)
                • countryCode - optional; type CountryCodeType - type string with restriction maxLength(2) minLength(2)
              • senderName - optional; type FullNameType
                • firstName - optional; type NameType - type string with restriction maxLength(100) minLength(1)
                  Name of the issuer
                • lastName type NameType - type string with restriction maxLength(100) minLength(1)
                  Name of the issuer
              • senderAddress - optional; type AddressType
                • 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 PostalCityType - type string with restriction maxLength(30) minLength(1)
                • countryCode - optional; type CountryCodeType - type string with restriction maxLength(2) minLength(2)
              • invoiceDate - optional; type date
              • paymentTerms - optional; type Text100 - type string with restriction maxLength(200)
              • customValues - optional; type CustomValuesType
                Key-value pair for adding custom values. Note that the key's
                must be unique if more than one is added
                • key type Text20 - type string with restriction maxLength(20)
                • value type Text50 - type string with restriction maxLength(100)
              • invoiceTaxTotals - optional; type TaxTotalType
                • taxAmount type decimal
                • taxAmountPerCategory - unbounded; type TaxPerCategoryType
                  • taxPercent - optional; type decimal
                  • taxableAmount - optional; type decimal
                  • taxAmount type decimal
              • invoiceDescription - optional; type Text100 - type string with restriction maxLength(200)
              • invoiceLines type InvoiceLinesType
                • invoiceLine type InvoiceLineType
                  • itemName type Text100 - type string with restriction maxLength(200)
                  • itemDescription - optional; type Text50 - type string with restriction maxLength(100)
                  • invoicedQuantity - optional; type decimal
                  • lineAmount type decimal
                  • taxPercent - optional; type decimal
                  • taxAmount - optional; type decimal
                  • itemIdentification - optional; type Text50 - type string with restriction maxLength(100)
                  • itemPrice type decimal
        • efhXml type EhfXml - type base64Binary with restriction
          Base64 encoded ehfFile. Must contain a unique number per invoice
      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(5000) maxExclusive(5999)
      • 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. cancelInvoice
      Description:
      Cancel an invoice by an unique id
      Operation type:
      Request-response. The endpoint receives a message, and sends a correlated message.
      SOAP action:
      https://efaktura-services.nets.no/efaktura-submitter-service/v1/cancelInvoice
      Input:
      cancelInvoice (soap:body, use = literal)Source code
      cancelInvoice type CancelInvoice
      Possible validation error codes from operation
      5004 - Unable to find invoice
      5005 - Cancellation on paid invoice
      5006 - Invoice already cancelled
      5008 - Authorization failed
      • auditInformation type AuditInformationType
        Information used for auditing and logging messages
        • messageIdentifier type MessageIdentifierType - type string with restriction minLength(5) maxLength(50)
          A unique identifier for a request/response message pair used for logging
      • invoiceId type long
      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
      • invoiceId type long
      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(5000) maxExclusive(5999)
      • 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. getCancellableInvoice
      Description:
      Find cancellable invoice using mandatory and optional parameters
      Operation type:
      Request-response. The endpoint receives a message, and sends a correlated message.
      SOAP action:
      https://efaktura-services.nets.no/efaktura-submitter-service/v1/getCancellableInvoice
      Input:
      cancellableInvoice (soap:body, use = literal)Source code
      cancellableInvoice type CancellableInvoiceSearchCriteria
      Possible validation error codes from operation
      5004 - Unable to find invoice
      5005 - Cancellation on paid invoice
      5006 - Invoice already cancelled
      5007 - Multiple invoices found
      • auditInformation type AuditInformationType
        Information used for auditing and logging messages
        • messageIdentifier type MessageIdentifierType - type string with restriction minLength(5) maxLength(50)
          A unique identifier for a request/response message pair used for logging
      • issuer type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
      • kid - optional; type KidType - type string with restriction maxLength(25) minLength(2) pattern(\d*)
        KID
      • dueDate type date
      • amount type SimpleAmountType - type decimal with restriction fractionDigits(2) minInclusive(0.00)
        The amount represented as a number with two decimals. Must not be negative
      • minimumAmount - optional; type SimpleAmountType - type decimal with restriction fractionDigits(2) minInclusive(0.00)
        The amount represented as a number with two decimals. Must not be negative
      • accountNumber type BillingAccountNumberType - type string with restriction length(11)
        Must be a Norwegian account number with 11 digits
      • documentType type documentType - type string with restriction - enum { 'EFAKTURA', 'AVTALEGIRO' }
      Output:
      cancellableInvoiceResponse (soap:body, use = literal)Source code
      cancellableInvoiceResponse type CancellableInvoiceResponse
      • messageIdentifier type MessageIdentifierType - type string with restriction minLength(5) maxLength(50)
        A unique identifier for a request/response message pair used for logging
      • invoiceId type long
      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(5000) maxExclusive(5999)
      • 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. getConsignmentStatus
      Description:
      Get status on consignment
      Operation type:
      Request-response. The endpoint receives a message, and sends a correlated message.
      SOAP action:
      https://efaktura-services.nets.no/invoicing-nets-submitter/v1/getConsignmentStatus
      Input:
      getConsignmentStatus (soap:body, use = literal)Source code
      getConsignmentStatus type GetConsignmentStatus
      Possible validation error codes from operation
      5001 - Unable to find consignment
      5002 - Multiple consignments found for id
      5009 - User must supply service provider id
      5010 - User not allowed to supply service provider id
      • auditInformation type AuditInformationType
        Information used for auditing and logging messages
        • messageIdentifier type MessageIdentifierType - type string with restriction minLength(5) maxLength(50)
          A unique identifier for a request/response message pair used for logging
      • serviceProvider - optional; type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
      • consignmentId type ConsignmentIdType - type string with restriction maxLength(40) minLength(1)
        Unique 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', 'PROCESSED', 'REJECTED', 'STOPPED' }
      • rejectedReason - optional; type RejectReasonType - type string with restriction maxLength(2000) minLength(1)
        The reason the invoice or consignment was rejected.
      • acceptedInvoiceCount type long
      • rejectedInvoiceCount type long
      • rejectedInvoices - optional; type RejectedInvoicesType
        • rejectedInvoice - optional; type RejectedInvoiceType
          • invoiceNumber type InvoiceNumberType - type string with restriction maxLength(100) minLength(1)
            Unique reference to the invoice for the issuer.
          • rejectedReason type RejectReasonType - type string with restriction maxLength(2000) minLength(1)
            The reason the invoice or consignment was rejected.
        List of rejected 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(5000) maxExclusive(5999)
      • 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. getEfakturaIdentifiers
      Description:
      Returns efakturaIdentifier and auto accept agreement if the receiver is found by efaktura identifier, personalnumber, organization number, phone, email, name, or address.
      Operation type:
      Request-response. The endpoint receives a message, and sends a correlated message.
      SOAP action:
      https://efaktura-services.nets.no/invoicing-nets-submitter/v1/getEfakturaIdentifiers
      Input:
      getEfakturaIdentifiers (soap:body, use = literal)Source code
      getEfakturaIdentifiers type GetEfakturaIdentifiers
      • auditInformation type AuditInformationType
        Information used for auditing and logging messages
        • 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 a unique receiver to get the efaktura identifier
        • 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
          • 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, the unique efaktura address for this 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. This is encrypted
            • organizationNumber type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
          • 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
            • firstName - optional; type NameType - type string with restriction maxLength(100) minLength(1)
              Name of the issuer
            • lastName type NameType - type string with restriction maxLength(100) minLength(1)
              Name of the issuer
          • address - optional; type AddressType
            • 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 PostalCityType - type string with restriction maxLength(30) minLength(1)
            • countryCode - optional; type CountryCodeType - type string with restriction maxLength(2) minLength(2)
          • invoiceIssuer - optional; type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
          • 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
      • returnOnlyMatchingKeyParams - optional; type boolean
      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 efakturaidentifier-keys and efakturaidentifier if found
        • efakturaIdentifierResponse type EfakturaIdentifierResponseType
          Result of efakturaidentifier 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, the unique efaktura address for this 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
            • 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, the unique efaktura address for this 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. This is encrypted
              • organizationNumber type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
            • 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
              • firstName - optional; type NameType - type string with restriction maxLength(100) minLength(1)
                Name of the issuer
              • lastName type NameType - type string with restriction maxLength(100) minLength(1)
                Name of the issuer
            • address - optional; type AddressType
              • 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 PostalCityType - type string with restriction maxLength(30) minLength(1)
              • countryCode - optional; type CountryCodeType - type string with restriction maxLength(2) minLength(2)
            • invoiceIssuer - optional; type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
            • 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(5000) maxExclusive(5999)
      • 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. getInvoiceStatus
      Description:
      Gets an already created invoice
      Operation type:
      Request-response. The endpoint receives a message, and sends a correlated message.
      SOAP action:
      https://efaktura-services.nets.no/invoicing-nets-submitter/v1/getInvoiceStatus
      Input:
      getInvoiceStatus (soap:body, use = literal)Source code
      getInvoiceStatus type GetInvoiceStatus
      Possible validation error codes from operation
      5009 - User must supply service provider id
      5010 - User not allowed to supply service provider id
      • auditInformation type AuditInformationType
        Information used for auditing and logging messages
        • messageIdentifier type MessageIdentifierType - type string with restriction minLength(5) maxLength(50)
          A unique identifier for a request/response message pair used for logging
      • serviceProvider - optional; type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
      • getInvoiceStatuses type GetInvoiceStatusesType
        List of invoices, to get status for
        • showDistributed - optional; type boolean
          To show outbound channel for invoices.
        • getInvoiceStatus type GetInvoiceStatusType
          • issuer type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
          • invoiceNumber type InvoiceNumberType - type string with restriction maxLength(100) minLength(1)
            Unique reference to the invoice for the issuer.
      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
        List of invoices, with status
        • invoiceStatusResponse type InvoiceStatusResponseType
          • issuer type OrganizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
          • invoiceNumber type InvoiceNumberType - type string with restriction maxLength(100) minLength(1)
            Unique reference to the invoice for the issuer.
          • status type InvoiceStatusType - type string with restriction - enum { 'PROCESSED', 'REJECTED', 'IN_PROGRESS', 'DUPLICATE', 'NOT_FOUND', 'CANCELLED' }
          • rejectReason - optional; type RejectReasonType - type string with restriction maxLength(2000) minLength(1)
            The reason the invoice or consignment was rejected.
          • distributed - optional; type Text20 - type string with restriction maxLength(20)
            Outbound channel for invoices (B2C, PRINT, EMAIL)
      Fault:
      validationFault (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(5000) maxExclusive(5999)
      • 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="invoicing-nets-submitter" targetNamespace="https://efaktura-services.nets.no/invoicing-nets-submitter/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/invoicing-nets-submitter/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/invoicing-nets-submitter/v1/">
<xsd:complexType name="CustomValuesType">
<xsd:annotation>
<xsd:documentation>Key-value pair for adding custom values. Note that the key's must be unique if more than one is added</xsd:documentation>
</xsd:annotation>
</xsd:complexType>
<xsd:simpleType name="BillingAccountNumberType">
<xsd:annotation>
<xsd:documentation>Must be a Norwegian account number with 11 digits</xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<xsd:simpleType name="RejectReasonType">
<xsd:annotation>
<xsd:documentation>The reason the invoice or consignment was rejected.</xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<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:complexType name="AuditInformationType">
<xsd:annotation>
<xsd:documentation>Information used for auditing and logging messages</xsd:documentation>
</xsd:annotation>
</xsd:complexType>
<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:simpleType name="EfakturaIdentifierType">
<xsd:annotation>
<xsd:documentation>The efakturaIdentifier of the receiver, the unique efaktura address for this receiver </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: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: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="AddressLineType">
<xsd:annotation>
<xsd:documentation>Street, postal or other address </xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<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 a unique receiver to get the efaktura identifier </xsd:documentation>
</xsd:annotation>
</xsd:complexType>
<xsd:element name="AddInvoices">
<xsd:annotation>
<xsd:documentation> To get status for the invoices and consignments use the getInvoiceStatus and getConsignmentStatus call. Possible validation error codes from operation 5009 - User must supply service provider id 5010 - User not allowed to supply service provider id </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="GetConsignmentStatus">
<xsd:annotation>
<xsd:documentation> Possible validation error codes from operation 5001 - Unable to find consignment 5002 - Multiple consignments found for id 5009 - User must supply service provider id 5010 - User not allowed to supply service provider id </xsd:documentation>
</xsd:annotation>
</xsd:element>
<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="PROCESSED">
<xsd:annotation>
<xsd:documentation>Processing of the consignment is finished </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="REJECTED">
<xsd:annotation>
<xsd:documentation>The whole consignment is rejected </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="Pdf">
<xsd:annotation>
<xsd:documentation>PDF representation of the invoice</xsd:documentation>
</xsd:annotation>
</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="EhfXml">
<xsd:annotation>
<xsd:documentation>Base64 encoded ehfFile. Must contain a unique number per invoice</xsd:documentation>
</xsd:annotation>
</xsd:simpleType>
<xsd:simpleType name="InvoiceNumberType">
<xsd:annotation>
<xsd:documentation>Unique reference to the invoice for the issuer.</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:element name="GetInvoiceStatus">
<xsd:annotation>
<xsd:documentation> Possible validation error codes from operation 5009 - User must supply service provider id 5010 - User not allowed to supply service provider id </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:simpleType name="InvoiceStatusType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="PROCESSED">
<xsd:annotation>
<xsd:documentation>The invoice is processed successfully </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="REJECTED">
<xsd:annotation>
<xsd:documentation>The invoice is rejected </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="IN_PROGRESS">
<xsd:annotation>
<xsd:documentation>The invoice processing is in progress </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="DUPLICATE">
<xsd:annotation>
<xsd:documentation>The invoice number is a duplicate </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="NOT_FOUND">
<xsd:annotation>
<xsd:documentation>The invoice is not found </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:enumeration value="CANCELLED">
<xsd:annotation>
<xsd:documentation>The invoice is cancelled </xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
</xsd:restriction>
</xsd:simpleType>
<xsd:element name="CancelInvoice">
<xsd:annotation>
<xsd:documentation> Possible validation error codes from operation 5004 - Unable to find invoice 5005 - Cancellation on paid invoice 5006 - Invoice already cancelled 5008 - Authorization failed </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="EfakturaNetsSubmitterPortType">
<wsdl:operation name="addInvoices">
<wsdl:documentation> Creates an invoice that is to be displayed in the online bank 5003 - One of efakturaReference,efakturaIdentifier or socialSecurityNumber is required </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:portType>
<wsdl:binding name="EfakturaNetsSubmitterSoapBinding" type="tns:EfakturaNetsSubmitterPortType"></wsdl:binding>
</wsdl:definitions>