Web Service: EfakturaAtgService
Target Namespace:
https://efaktura-services.nets.no/efaktura-atg-service/v1/
Port EfakturaAtgPort Port typeSource code
Location:
https://efaktura-services.nets.no/efaktura-atg-service/v1/
Protocol:
SOAP
Default style:
document
Transport protocol:
SOAP over HTTP
Operations:
- addShipmentDetailSource code
- cancelShipmentDetailSource code
- cancelTransactionDetailSource code
- getAtgMandateDetailSource code
- getBlackListDetailSource code
- getEfakturaIdentifiersDetailSource code
- getShipmentsDetailSource code
- getShipmentStatusDetailSource code
- getTransactionStatusDetailSource code
- validateSecuritySignatureDetailSource code
Operations
- addShipmentDescription:Creates a shipment with transactions (eFaktura, AvtaleGiro or a combination). Possible validation error codes from operation: 3002 - Shipment id already exists 3003 - Transaction id already exists 3010 - ATG info is missing for an ATG transaction 3011 - eFaktua info is missing for an eFaktura transaction 3020 - KID is missing for an ATG transaction 3021 - ATG transaction is not document type INVOICE 3100 - Document type not implemented (currently only INVOICE is allowed) 3101 - AvtaleGiro transactions are not allowedOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-atg-service/v1/addShipmentInput:addShipment (soap:body, use = literal)Source codeaddShipment type AddShipmentRequestAdd a new shipment with transactions.
Use getShipmentStatus or getTransactionStatus to check the status.- auditInformation type AuditInformationTypeInformation used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.- 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)
- shipmentId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
- issuer type organizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
- transactions type TransactionsTypeAllows up to a 1000 transactions per shipment.
- transactions type TransactionType
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
- paymentType type paymentType - type string with restriction - enum { 'EFAKTURA', 'EFAKTURA_AND_AVTALEGIRO', 'EFAKTURA_AND_EXTERNAL_AVTALEGIRO', 'AVTALEGIRO' }
- documentType type documentType - type string with restriction - enum { 'INVOICE', 'CREDIT_NOTE', 'REMINDER', 'COLLECTION_NOTICE', 'DUNNING', 'PAYMENT_REQUEST', 'ENFORCEMENT_WARNING' }
- kid - optional; type kidType - type string with restriction maxLength(25) minLength(2) pattern(\d*)Mandatory for ATGs, but not for eFaktruas
- accountNumber type accountNumberType - type string with restriction length(11)The account number that the issuer will be credited.
Must be a Norwegian account number with 11 digits - amount type simpleAmountType - type decimal with restriction fractionDigits(2) minInclusive(0.00)The amount represented as a positive number with two decimals.
- dueDate type date
- efakturaInfo - optional; type EfakturaTypeMust be added for eFakturas
- 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})
- eFakturaReference type efakturaReferenceType - type string with restriction maxLength(32) minLength(1)The eFaktura reference of the receiver
- minimumAmount - optional; type simpleAmountType - type decimal with restriction fractionDigits(2) minInclusive(0.00)The amount represented as a positive number with two decimals.
- brandName type brandNameType - type string with restriction maxLength(40)Name that is shown to the receiver of the eFaktura
- eFakturaUrl type eFakturaUrlType - type string with restriction maxLength(255) minLength(1)URL to where the eFaktura invoice is located
- collectionNoticeNotification - optional; type CollectionNoticeNotificationForced notifications for collection notices. Only valid for collection notice.
- email - optional; type emailType - type string with restriction minLength(5) maxLength(100) pattern([^@]+@[^\.]+\..+)A valid email address - used for alias.
- mobilePhone - optional; type telephoneType - type string with restriction minLength(6) maxLength(16) pattern(\+\d+)A valid phone number - used for alias.
Prefixed with country code (i.e. +4799999999).
- email - optional; type emailType - type string with restriction minLength(5) maxLength(100) pattern([^@]+@[^\.]+\..+)
- atgInfo - optional; type AtgTypeMust be added for ATGs
- atgNotification type boolean
- atgNotificationText - optional; type atgNotificationTextType - type string with restriction maxLength(3360) minLength(0)Notification text for AvtaleGiro.
Max length 3360, but should be divided in 80 character lines and maximum 42 lines. - atgAbbreviatedName - optional; type atgAbbreviatedNameType - type string with restriction maxLength(10) minLength(1)The field may be used to inform payer about the AvtaleGiro payment.
The external reference will be transferred to payer’s statement and AvtaleGiro info.
The external reference will override the set text on payer’s regular payment assignment. - atgExternalReference - optional; type atgExternalReferenceType - type string with restriction maxLength(25) minLength(1)The abbreviated name for the AvtaleGiro payer.
The field should be filled in to make identification of any denied due payments easier.
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})
- transactions type TransactionType
Output:addShipmentResponse (soap:body, use = literal)Source codeaddShipmentResponse type AddShipmentResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- noOfTransactions type transactionsCountType - type int with restriction
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(3000) maxExclusive(3999)
- 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
- cancelShipmentDescription:Cancel a shipment. Possible validation error codes from operation: 3000 - Shipment not foundOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-atg-service/v1/cancelShipmentInput:cancelShipment (soap:body, use = literal)Source codecancelShipment type CancelShipmentRequestCancel all transactions in shipment.
- auditInformation type AuditInformationTypeInformation used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.- 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)
- shipmentId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
Output:cancelShipmentResponse (soap:body, use = literal)Source codecancelShipmentResponse type CancelShipmentResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- shipmentId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
- efakturaStatus type efakturaShipmentCancellationStatusType - type string with restriction - enum { 'NO_EFAKTURA_IN_SHIPMENT', 'CANCELLATION_REQUESTED', 'ALREADY_CANCELLED', 'NOT_FOUND', 'PROCESSING_IN_PROGRESS-TRY_LATER' }
- atgStatus type atgShipmentCancellationStatusType - type string with restriction - enum { 'NO_ATG_IN_SHIPMENT', 'CANCELLATION_REQUESTED', 'NOT_ALLOWED', 'NOT_FOUND', 'PROCESSING_IN_PROGRESS-TRY_LATER' }
- atgCancellationMessage - optional; type string
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(3000) maxExclusive(3999)
- 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
- cancelTransactionDescription:Cancel a transaction. Possible validation error codes from operation: 3001 - Transaction not foundOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-atg-service/v1/cancelTransactionsInput:cancelTransaction (soap:body, use = literal)Source codecancelTransaction type CancelTransactionRequest
- auditInformation type AuditInformationTypeInformation used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.- 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)
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
Output:cancelTransactionResponse (soap:body, use = literal)Source codecancelTransactionResponse type CancelTransactionResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
- efakturaStatus type efakturaTransactionCancellationStatusType - type string with restriction - enum { 'NOT_AN_EFAKTURA_TRANSACTION', 'CANCELLATION_REQUESTED', 'ALREADY_CANCELLED', 'NOT_FOUND', 'PROCESSING_IN_PROGRESS-TRY_LATER' }
- atgStatus type atgTransactionCancellationStatusType - type string with restriction - enum { 'NOT_AN_ATG_TRANSACTION', 'CANCELLATION_REQUESTED', 'NOT_ALLOWED', 'NOT_FOUND', 'PROCESSING_IN_PROGRESS-TRY_LATER' }
- atgCancellationMessage - optional; type string
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(3000) maxExclusive(3999)
- 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
- getAtgMandateDescription:Check if a mandate exists Possible validation error codes from operation: 3102 - Get mandate is currently disabledOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-atg-service/v1/getAtgMandateInput:getAtgMandateRequest (soap:body, use = literal)Source codegetAtgMandateRequest type GetAtgMandateRequestCheck if a mandate exists.
- auditInformation type AuditInformationTypeInformation used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.- 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)
- kid type kidType - type string with restriction maxLength(25) minLength(2) pattern(\d*)
- creditAccount type accountNumberType - type string with restriction length(11)The account number that the issuer will be credited.
Must be a Norwegian account number with 11 digits
Output:getAtgMandateResponse (soap:body, use = literal)Source codegetAtgMandateResponse type GetAtgMandateResponseReturn the mandate if exists, else mandate will be null.- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- mandate - optional; type MandateInfoType
- kid type kidType - type string with restriction maxLength(25) minLength(2) pattern(\d*)
- creditAccount type accountNumberType - type string with restriction length(11)The account number that the issuer will be credited.
Must be a Norwegian account number with 11 digits - notification type boolean
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(3000) maxExclusive(3999)
- 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 black listed eFaktura issuersOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-atg-service/v1/getBlackListInput:getBlackList (soap:body, use = literal)Source codegetBlackList type GetBlackListRequest
- auditInformation type AuditInformationTypeInformation used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.- 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
- 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(3000) maxExclusive(3999)
- 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-atg-service/v1/getEfakturaIdentifiersInput:getEfakturaIdentifiers (soap:body, use = literal)Source codegetEfakturaIdentifiers type GetEfakturaIdentifiersRequest
- auditInformation type AuditInformationTypeInformation used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.- 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 EfakturaIdentifiersKeyType
- 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.- 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})
- organizationNumber type organizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
- telephoneAlias - optional; type telephoneType - type string with restriction minLength(6) maxLength(16) pattern(\+\d+)A valid phone number - used for alias.
Prefixed with country code (i.e. +4799999999). - emailAlias - optional; type emailType - 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)
- lastName 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)
- addressLine2 - optional; type addressLineType - type string with restriction maxLength(50)
- 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)
- efakturaIssuer - 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 eFaktura issuer and receiver. - contentProviderId type providerIdType - type string with restriction minLength(9) maxLength(9) pattern([0-9]{9})
- efakturaReference type eFakturaReferenceType - type string with restriction maxLength(32)
- efakturaIdentifier - optional; type eFakturaIdentifierType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
- efakturaIdentifierKey type EfakturaIdentifierKeyType
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 efakturaidentifier-keys and efakturaidentifier if found
- efakturaIdentifierResponse type EfakturaIdentifierResponseTypeResult 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' }
- autoAcceptEfaktura type booleanIf all eFaktura agreements should be accepted
automatically for this eFaktura receiver. - 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 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.- 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})
- organizationNumber type organizationNumberType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
- telephoneAlias - optional; type telephoneType - type string with restriction minLength(6) maxLength(16) pattern(\+\d+)A valid phone number - used for alias.
Prefixed with country code (i.e. +4799999999). - emailAlias - optional; type emailType - 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)
- lastName 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)
- addressLine2 - optional; type addressLineType - type string with restriction maxLength(50)
- 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)
- efakturaIssuer - 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 eFaktura issuer and receiver. - contentProviderId type providerIdType - type string with restriction minLength(9) maxLength(9) pattern([0-9]{9})
- efakturaReference type eFakturaReferenceType - type string with restriction maxLength(32)
- efakturaIdentifier - optional; type eFakturaIdentifierType - type string with restriction maxLength(9) minLength(9) pattern([0-9]{9})
- issuerResponse - optional; type EfakturaIssuerResponseTypeThe result of issuer lookup in the getEfakturaIdentifier call. It returns if
issuer is blocked by receiver, if issuer has eFaktura agreement with receiver,
and if found a valid eFaktura reference 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 eFaktura issuer and receiver.
- 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(3000) maxExclusive(3999)
- 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
- getShipmentsDescription:Returns all shipment IDs sent in by the user within a time interval. Possible validation error codes from operation: 3040 - interval too longOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-atg-service/v1/getShipmentsInput:getShipments (soap:body, use = literal)Source codegetShipments type GetShipmentsRequest
- auditInformation type AuditInformationTypeInformation used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.- 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)
- from type dateTime
- to type dateTime
Output:getShipmentsResponse (soap:body, use = literal)Source codegetShipmentsResponse type GetShipmentsResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- numberOfShipmentsFound type int
- shipmentsResponses type ShipmentsResponsesType
- shipmentsResponseType - optional, unbounded; type ShipmentsResponseType
- id type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
- id type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})
- shipmentsResponseType - optional, unbounded; type ShipmentsResponseType
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(3000) maxExclusive(3999)
- 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
- getShipmentStatusDescription:Get the status of a shipment. Possible validation error codes from operation: 3000 - Shipment not foundOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-atg-service/v1/getShipmentStatusInput:getShipmentStatus (soap:body, use = literal)Source codegetShipmentStatus type GetShipmentStatusRequest
- auditInformation type AuditInformationTypeInformation used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.- 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)
- shipmentId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
Output:getShipmentStatusResponse (soap:body, use = literal)Source codegetShipmentStatusResponse type GetShipmentStatusResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- shipmentId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
- efakturaShipmentStatus type shipmentEfakturaStatusType - type string with restriction - enum { 'IN_PROGRESS', 'PROCESSED', 'STOPPED', 'NO_EFAKTURA_IN_SHIPMENT' }
- atgShipmentStatus type shipmentAtgStatusType - type string with restriction - enum { 'NO_ATG_IN_SHIPMENT', 'IN_PROGRESS', 'RECEIVED', 'REJECTED', 'PROCESSING', 'PROCESSED', 'PROCESSED_WITH_WARNING', 'SENT_TO_BDS', 'CANCELLATION_RECEIVED', 'CANCELLATION_VALIDATED', 'CANCELLATION_PROCESSED', 'CANCELLATION_PROCESSING', 'CANCELLATION_REJECTED', 'CANCELLATION_SENT_TO_BDS', 'CANCELLATION_REJECTED_BY_BDS', 'CANCELLATION_ACCEPTED_BY_BDS' }
- transactionCount type int
- efakturaTransactionCount type int
- atgTransactionCount type int
- transactionsStatuses - optional; type TransactionStatusesType
- transactionStatus type TransactionStatusType
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
- efakturaTransactionStatus - optional; type EfakturaTransactionStatusType
- status type efakturaStatusType - type string with restriction - enum { 'NOT_AN_EFAKTURA_TRANSACTION', 'IN_PROGRESS', 'CANCELLED', 'REJECTED', 'STOPPED', 'ACCEPTED' }
- rejectionCode - optional; type rejectionCodeType - type string with restriction maxLength(4) minLength(1)The reason why something was rejected, as a code
- rejectionText - optional; type rejectionTextType - type string with restriction maxLength(2000) minLength(1)The reason why something was rejected
- atgTransactionStatus - optional; type AtgTransactionStatusType
- status type atgStatusType - type string with restriction - enum { 'NOT_AN_ATG_TRANSACTION', 'EXTERNAL_ATG', 'IN_PROGRESS', 'RECEIVED', 'REJECTED', 'PROCESSING', 'PROCESSED', 'PROCESSED_WITH_WARNING', 'SENT_TO_BDS', 'CANCELLATION_RECEIVED', 'CANCELLATION_VALIDATED', 'CANCELLATION_PROCESSED', 'CANCELLATION_PROCESSING', 'CANCELLATION_REJECTED', 'CANCELLATION_SENT_TO_BDS', 'CANCELLATION_REJECTED_BY_BDS', 'CANCELLATION_ACCEPTED_BY_BDS' }
- code - optional; type rejectionCodeType - type string with restriction maxLength(4) minLength(1)The reason why something was rejected, as a code
- text - optional; type rejectionTextType - type string with restriction maxLength(2000) minLength(1)The reason why something was rejected
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})
- transactionStatus type TransactionStatusType
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(3000) maxExclusive(3999)
- 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
- getTransactionStatusDescription:Get the status of a transaction. Possible validation error codes from operation: 3001 - Transaction not foundOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-atg-service/v1/getTransactionStatusInput:getTransactionStatus (soap:body, use = literal)Source codegetTransactionStatus type GetTransactionStatusRequest
- auditInformation type AuditInformationTypeInformation used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.- 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)
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
Output:getTransactionStatusResponse (soap:body, use = literal)Source codegetTransactionStatusResponse type GetTransactionStatusResponse- messageIdentifier type messageIdentifierType - type string with restriction minLength(5) maxLength(50)A unique identifier for a request/response message pair used for logging
- transactionStatus type TransactionStatusType
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
- efakturaTransactionStatus - optional; type EfakturaTransactionStatusType
- status type efakturaStatusType - type string with restriction - enum { 'NOT_AN_EFAKTURA_TRANSACTION', 'IN_PROGRESS', 'CANCELLED', 'REJECTED', 'STOPPED', 'ACCEPTED' }
- rejectionCode - optional; type rejectionCodeType - type string with restriction maxLength(4) minLength(1)The reason why something was rejected, as a code
- rejectionText - optional; type rejectionTextType - type string with restriction maxLength(2000) minLength(1)The reason why something was rejected
- atgTransactionStatus - optional; type AtgTransactionStatusType
- status type atgStatusType - type string with restriction - enum { 'NOT_AN_ATG_TRANSACTION', 'EXTERNAL_ATG', 'IN_PROGRESS', 'RECEIVED', 'REJECTED', 'PROCESSING', 'PROCESSED', 'PROCESSED_WITH_WARNING', 'SENT_TO_BDS', 'CANCELLATION_RECEIVED', 'CANCELLATION_VALIDATED', 'CANCELLATION_PROCESSED', 'CANCELLATION_PROCESSING', 'CANCELLATION_REJECTED', 'CANCELLATION_SENT_TO_BDS', 'CANCELLATION_REJECTED_BY_BDS', 'CANCELLATION_ACCEPTED_BY_BDS' }
- code - optional; type rejectionCodeType - type string with restriction maxLength(4) minLength(1)The reason why something was rejected, as a code
- text - optional; type rejectionTextType - type string with restriction maxLength(2000) minLength(1)The reason why something was rejected
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})
- transaction type TransactionType
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})A unique reference - UUID
- paymentType type paymentType - type string with restriction - enum { 'EFAKTURA', 'EFAKTURA_AND_AVTALEGIRO', 'EFAKTURA_AND_EXTERNAL_AVTALEGIRO', 'AVTALEGIRO' }
- documentType type documentType - type string with restriction - enum { 'INVOICE', 'CREDIT_NOTE', 'REMINDER', 'COLLECTION_NOTICE', 'DUNNING', 'PAYMENT_REQUEST', 'ENFORCEMENT_WARNING' }
- kid - optional; type kidType - type string with restriction maxLength(25) minLength(2) pattern(\d*)Mandatory for ATGs, but not for eFaktruas
- accountNumber type accountNumberType - type string with restriction length(11)The account number that the issuer will be credited.
Must be a Norwegian account number with 11 digits - amount type simpleAmountType - type decimal with restriction fractionDigits(2) minInclusive(0.00)The amount represented as a positive number with two decimals.
- dueDate type date
- efakturaInfo - optional; type EfakturaTypeMust be added for eFakturas
- 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})
- eFakturaReference type efakturaReferenceType - type string with restriction maxLength(32) minLength(1)The eFaktura reference of the receiver
- minimumAmount - optional; type simpleAmountType - type decimal with restriction fractionDigits(2) minInclusive(0.00)The amount represented as a positive number with two decimals.
- brandName type brandNameType - type string with restriction maxLength(40)Name that is shown to the receiver of the eFaktura
- eFakturaUrl type eFakturaUrlType - type string with restriction maxLength(255) minLength(1)URL to where the eFaktura invoice is located
- collectionNoticeNotification - optional; type CollectionNoticeNotificationForced notifications for collection notices. Only valid for collection notice.
- email - optional; type emailType - type string with restriction minLength(5) maxLength(100) pattern([^@]+@[^\.]+\..+)A valid email address - used for alias.
- mobilePhone - optional; type telephoneType - type string with restriction minLength(6) maxLength(16) pattern(\+\d+)A valid phone number - used for alias.
Prefixed with country code (i.e. +4799999999).
- email - optional; type emailType - type string with restriction minLength(5) maxLength(100) pattern([^@]+@[^\.]+\..+)
- atgInfo - optional; type AtgTypeMust be added for ATGs
- atgNotification type boolean
- atgNotificationText - optional; type atgNotificationTextType - type string with restriction maxLength(3360) minLength(0)Notification text for AvtaleGiro.
Max length 3360, but should be divided in 80 character lines and maximum 42 lines. - atgAbbreviatedName - optional; type atgAbbreviatedNameType - type string with restriction maxLength(10) minLength(1)The field may be used to inform payer about the AvtaleGiro payment.
The external reference will be transferred to payer’s statement and AvtaleGiro info.
The external reference will override the set text on payer’s regular payment assignment. - atgExternalReference - optional; type atgExternalReferenceType - type string with restriction maxLength(25) minLength(1)The abbreviated name for the AvtaleGiro payer.
The field should be filled in to make identification of any denied due payments easier.
- transactionId type uuidType - type string with restriction maxLength(36) minLength(36) pattern([a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12})
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(3000) maxExclusive(3999)
- 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. Possible validation error codes from operation: 3030 - the signature has timed out 3031 - the signature is manipulatedOperation type:Request-response. The endpoint receives a message, and sends a correlated message.SOAP action:https://efaktura-services.nets.no/efaktura-atg-service/v1/validateSecuritySignatureInput:validateSecuritySignature (soap:body, use = literal)Source codevalidateSecuritySignature type ValidateSecuritySignatureRequest
- auditInformation type AuditInformationTypeInformation used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.- 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)
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 restriction
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(3000) maxExclusive(3999)
- 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 EfakturaAtgPortTypeSource code
WSDL source code
<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="wsdl-viewer.xsl" ?>
<wsdl:definitions name="efaktura-atg" targetNamespace="https://efaktura-services.nets.no/efaktura-atg-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-atg-service/v1/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy"
><wsp:Policy wsu:Id="UsernameToken"
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><wsdl:types>
<xsd:schema targetNamespace="https://efaktura-services.nets.no/efaktura-atg-service/v1/">
</wsdl:types><xsd:simpleType name="eFakturaUrlType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>URL to where the eFaktura invoice is located
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="atgAbbreviatedNameType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
The field may be used to inform payer about the AvtaleGiro payment.
The external reference will be transferred to payer’s statement and AvtaleGiro info.
The external reference will override the set text on payer’s regular payment assignment.
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="atgExternalReferenceType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
The abbreviated name for the AvtaleGiro payer.
The field should be filled in to make identification of any denied due payments easier.
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="atgNotificationTextType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
Notification text for AvtaleGiro.
Max length 3360, but should be divided in 80 character lines and maximum 42 lines.
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="brandNameType">
<xsd:annotation>
<xsd:documentation>
Name that is shown to the receiver of the eFaktura
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="organizationNumberType"></xsd:simpleType>
<xsd:simpleType name="postalCodeType"></xsd:simpleType>
<xsd:simpleType name="postalCityType"></xsd:simpleType>
<xsd:simpleType name="countryCodeType"></xsd:simpleType>
<xsd:simpleType name="accountNumberType">
<xsd:annotation>
<xsd:documentation>
The account number that the issuer will be credited.
Must be a Norwegian account number with 11 digits
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><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="rejectionTextType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
The reason why something was rejected
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="rejectionCodeType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
The reason why something was rejected, as a code
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="efakturaStatusType"></xsd:simpleType>
<xsd:simpleType name="efakturaShipmentCancellationStatusType"></xsd:simpleType>
<xsd:simpleType name="atgShipmentCancellationStatusType"></xsd:simpleType>
<xsd:simpleType name="efakturaTransactionCancellationStatusType"></xsd:simpleType>
<xsd:simpleType name="atgTransactionCancellationStatusType"></xsd:simpleType>
<xsd:simpleType name="atgStatusType">
<xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="efakturaIdentifierResultType">
<xsd:restriction base="xsd:string">
</xsd:simpleType><xsd:enumeration value="UNIQUE_RECEIVER_FOUND">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>
The eFaktura receiver is found in the receiver register
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="RECEIVER_NOT_FOUND">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>
The eFaktura 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:simpleType name="socialSecurityNumberType"></xsd:simpleType>
<xsd:simpleType name="eFakturaIdentifierType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
The efakturaIdentifier of the receiver - the unique efaktura address for this receiver.
</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 eFaktura issuer and receiver.
</xsd:documentation>
</xsd:annotation><xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="emailType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
A valid email address - used for alias.
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="telephoneType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
A valid phone number - used for alias.
Prefixed with country code (i.e. +4799999999).
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="providerIdType"></xsd:simpleType>
<xsd:simpleType name="uuidType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
A unique reference - UUID
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="addressLineType">
<xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="shipmentEfakturaStatusType">
<xsd:restriction base="xsd:string">
</xsd:simpleType><xsd:enumeration value="IN_PROGRESS">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>
Processing of the shipment is in progress
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="PROCESSED">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>
Processing of the shipment is finished
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="STOPPED">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>
Processing of the shipment is stopped
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="NO_EFAKTURA_IN_SHIPMENT">
</xsd:restriction><xsd:annotation>
</xsd:enumeration><xsd:documentation>
The shipment has no eFakturas
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="shipmentAtgStatusType">
<xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="paymentType">
<xsd:restriction base="xsd:string">
</xsd:simpleType><xsd:enumeration value="EFAKTURA">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>
Payment type for eFaktura only. efakturaInfo must be added the the transaction.
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="EFAKTURA_AND_AVTALEGIRO">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>
Payment type for both eFaktura and AvtaleGiro combined.
atgInfo and efakturaInfo must be added to the transaction.
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="EFAKTURA_AND_EXTERNAL_AVTALEGIRO">
<xsd:annotation>
</xsd:enumeration><xsd:documentation>
Payment type for both eFaktura and AvtaleGiro combined,
but with the AvtaleGiro provided by itself.
</xsd:documentation>
</xsd:annotation><xsd:enumeration value="AVTALEGIRO">
</xsd:restriction><xsd:annotation>
</xsd:enumeration><xsd:documentation>
Payment type for AvtaleGiro only. atgInfo must be added to the transaction.
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="documentType">
<xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="simpleAmountType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
The amount represented as a positive number with two decimals.
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="kidType"></xsd:simpleType>
<xsd:simpleType name="nameType"></xsd:simpleType>
<xsd:simpleType name="efakturaReferenceType">
<xsd:annotation>
</xsd:simpleType><xsd:documentation>
The eFaktura reference of the receiver
</xsd:documentation>
</xsd:annotation><xsd:simpleType name="encryptedSignatureType">
<xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType><xsd:simpleType name="errorCodeType"></xsd:simpleType>
<xsd:complexType name="AuditInformationType">
<xsd:annotation>
</xsd:complexType><xsd:documentation>
Information used for auditing and logging messages. The service replies with
the same messageIdentifier sent in.
</xsd:documentation>
</xsd:annotation><xsd:complexType name="EfakturaTransactionStatusType"></xsd:complexType>
<xsd:complexType name="AtgTransactionStatusType"></xsd:complexType>
<xsd:complexType name="EfakturaIssuerResponseType">
<xsd:annotation>
</xsd:complexType><xsd:documentation>
The result of issuer lookup in the getEfakturaIdentifier call. It returns if
issuer is blocked by receiver, if issuer has eFaktura agreement with receiver,
and if found a valid eFaktura reference is returned
</xsd:documentation>
</xsd:annotation><xsd:complexType name="EfakturaIdentifierResponseType">
<xsd:annotation>
<xsd:documentation>
Result of efakturaidentifier lookup. The lookup-key is also returned
to pair the efaktura identifier with the correct receiver.
</xsd:documentation>
</xsd:annotation><xsd:sequence>
</xsd:complexType><xsd:element name="autoAcceptEfaktura" type="xsd:boolean">
</xsd:sequence><xsd:annotation>
</xsd:element><xsd:documentation>
If all eFaktura agreements should be accepted
automatically for this eFaktura receiver.
</xsd:documentation>
</xsd:annotation><xsd:complexType name="EfakturaIdentifiersResponseType">
<xsd:annotation>
</xsd:complexType><xsd:documentation>
List with efakturaidentifier-keys and efakturaidentifier if found
</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="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:complexType>
<xsd:complexType name="TransactionsType">
<xsd:annotation>
</xsd:complexType><xsd:documentation>
Allows up to a 1000 transactions per shipment.
</xsd:documentation>
</xsd:annotation><xsd:complexType name="TransactionType">
<xsd:sequence>
</xsd:complexType><xsd:element name="kid" type="tns:kidType" minOccurs="0">
</xsd:sequence><xsd:annotation>
</xsd:element><xsd:documentation>
Mandatory for ATGs, but not for eFaktruas
</xsd:documentation>
</xsd:annotation><xsd:complexType name="AtgType">
<xsd:annotation>
<xsd:documentation>
Must be added for ATGs
</xsd:documentation>
</xsd:annotation><xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:complexType name="EfakturaType">
<xsd:annotation>
<xsd:documentation>
Must be added for eFakturas
</xsd:documentation>
</xsd:annotation><xsd:sequence>
</xsd:complexType><xsd:choice></xsd:choice>
</xsd:sequence><xsd:complexType name="MandateInfoType"></xsd:complexType>
<xsd:complexType name="TransactionStatusesType"></xsd:complexType>
<xsd:complexType name="TransactionStatusType"></xsd:complexType>
<xsd:complexType name="BlackListResponseType">
<xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:complexType name="ShipmentsResponseType">
<xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:complexType name="BlackListResponsesType"></xsd:complexType>
<xsd:complexType name="ShipmentsResponsesType"></xsd:complexType>
<xsd:complexType name="CollectionNoticeNotification">
<xsd:annotation>
</xsd:complexType><xsd:documentation>
Forced notifications for collection notices. Only valid for collection notice.
</xsd:documentation>
</xsd:annotation><xsd:element name="GetShipmentStatusRequest"></xsd:element>
<xsd:element name="GetTransactionStatusRequest"></xsd:element>
<xsd:element name="GetTransactionStatusResponse"></xsd:element>
<xsd:element name="GetEfakturaIdentifiersRequest"></xsd:element>
<xsd:element name="GetEfakturaIdentifiersResponse"></xsd:element>
<xsd:element name="GetAtgMandateRequest">
<xsd:annotation>
</xsd:element><xsd:documentation>
Check if a mandate exists.
</xsd:documentation>
</xsd:annotation><xsd:element name="GetAtgMandateResponse">
<xsd:annotation>
</xsd:element><xsd:documentation>
Return the mandate if exists, else mandate will be null.
</xsd:documentation>
</xsd:annotation><xsd:element name="CancelShipmentRequest">
<xsd:annotation>
</xsd:element><xsd:documentation>
Cancel all transactions in shipment.
</xsd:documentation>
</xsd:annotation><xsd:element name="CancelShipmentResponse">
<xsd:complexType>
</xsd:element><xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:element name="CancelTransactionRequest"></xsd:element>
<xsd:element name="CancelTransactionResponse">
<xsd:complexType>
</xsd:element><xsd:sequence></xsd:sequence>
</xsd:complexType><xsd:element name="AddShipmentRequest">
<xsd:annotation>
<xsd:documentation>
Add a new shipment with transactions.
Use getShipmentStatus or getTransactionStatus to check the status.
</xsd:documentation>
</xsd:annotation><xsd:complexType></xsd:complexType>
</xsd:element><xsd:element name="AddShipmentResponse"></xsd:element>
<xsd:element name="GetShipmentStatusResponse">
<xsd:complexType>
</xsd:element><xsd:sequence></xsd:sequence>
</xsd:complexType><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:annotation>
</xsd:element><xsd:documentation>
Indicates that the client has sent an invalid request.
</xsd:documentation>
</xsd:annotation><xsd:element name="ValidateSecuritySignatureRequest"></xsd:element>
<xsd:element name="ValidateSecuritySignatureResponse"></xsd:element>
<xsd:element name="GetBlackListRequest">
<xsd:complexType></xsd:complexType>
</xsd:element><xsd:element name="GetBlackListResponse"></xsd:element>
<xsd:element name="GetShipmentsRequest"></xsd:element>
<xsd:element name="GetShipmentsResponse"></xsd:element>
</xsd:schema><wsdl:message name="addShipment"></wsdl:message>
<wsdl:message name="addShipmentResponse"></wsdl:message>
<wsdl:message name="getShipmentStatus"></wsdl:message>
<wsdl:message name="getShipmentStatusResponse"></wsdl:message>
<wsdl:message name="getTransactionStatus"></wsdl:message>
<wsdl:message name="getTransactionStatusResponse"></wsdl:message>
<wsdl:message name="getAtgMandateRequest"></wsdl:message>
<wsdl:message name="getAtgMandateResponse"></wsdl:message>
<wsdl:message name="cancelShipment"></wsdl:message>
<wsdl:message name="cancelShipmentResponse"></wsdl:message>
<wsdl:message name="cancelTransaction"></wsdl:message>
<wsdl:message name="cancelTransactionResponse"></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="getBlackList"></wsdl:message>
<wsdl:message name="getBlackListResponse"></wsdl:message>
<wsdl:message name="getShipments"></wsdl:message>
<wsdl:message name="getShipmentsResponse"></wsdl:message>
<wsdl:message name="validationFault"></wsdl:message>
<wsdl:message name="serverFault"></wsdl:message>
<wsdl:portType name="EfakturaAtgPortType">
<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="addShipment">
<wsdl:documentation>
Creates a shipment with transactions (eFaktura, AvtaleGiro or a combination).
Possible validation error codes from operation:
3002 - Shipment id already exists
3003 - Transaction id already exists
3010 - ATG info is missing for an ATG transaction
3011 - eFaktua info is missing for an eFaktura transaction
3020 - KID is missing for an ATG transaction
3021 - ATG transaction is not document type INVOICE
3100 - Document type not implemented (currently only INVOICE is allowed)
3101 - AvtaleGiro transactions are not allowed
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getShipmentStatus">
<wsdl:documentation>
Get the status of a shipment.
Possible validation error codes from operation:
3000 - Shipment not found
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getTransactionStatus">
<wsdl:documentation>
Get the status of a transaction.
Possible validation error codes from operation:
3001 - Transaction not found
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getAtgMandate">
<wsdl:documentation>
Check if a mandate exists
Possible validation error codes from operation:
3102 - Get mandate is currently disabled
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="cancelShipment">
<wsdl:documentation>
Cancel a shipment.
Possible validation error codes from operation:
3000 - Shipment not found
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="cancelTransaction">
<wsdl:documentation>
Cancel a transaction.
Possible validation error codes from operation:
3001 - Transaction not found
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="validateSecuritySignature">
<wsdl:documentation>
Validates the given security signature and returns the decrypted value.
Possible validation error codes from operation:
3030 - the signature has timed out
3031 - the signature is manipulated
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getBlackList">
<wsdl:documentation>
Get black listed eFaktura issuers
</wsdl:documentation>
</wsdl:operation><wsdl:operation name="getShipments">
</wsdl:portType><wsdl:documentation>
Returns all shipment IDs sent in by the user within a time interval.
Possible validation error codes from operation:
3040 - interval too long
</wsdl:documentation>
</wsdl:operation><wsdl:binding name="EfakturaAtgSoapBinding" type="tns:EfakturaAtgPortType">
</wsdl:definitions><wsdl:operation name="getEfakturaIdentifiers">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="addShipment">
<soap:operation soapAction="https://efaktura-services.nets.no/efaktura-atg-service/v1/addShipment"/>
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="getShipmentStatus">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="getTransactionStatus">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="getAtgMandate">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="cancelShipment">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="cancelTransaction">
<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="getBlackList">
<wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation><wsdl:operation name="getShipments">
</wsdl:binding><wsdl:input></wsdl:input>
<wsdl:output></wsdl:output>
</wsdl:operation>