Find Consumer

Describes how to find or search consumer

Find the consumer eFaktura identifier and its status information by providing the SSN, name, and address, i.e., whether they can receive an eInvoice or not.

Endpoint Details:

post

Header parameters

companyIdinteger · int64Required

ERP/ZERP companyId

Example: 1

organisationNumberinteger · int64Required

Organisation Number

Example: 986559469

customerIdinteger · int64Required

customer identifier from the ERP or ZERP customer table

Example: 10

firstNamestringOptional

first name of the customer

Example: Trond

lastNamestringOptional

last name of the customer

Example: Andersen

socialSecurityNumberstringOptional

social security number of the customer or consumer

efakturaIdentifierstringOptional

efakturaIdentifier of the customer or consumer

dateOfBirthstring · dateOptional

date of birth of the customer

emailstringOptional

email address

Example: [email protected]

telephoneNumberstringOptional

telephone number

Example: 4790037509

customerOrganisationNumberinteger · int64Optional

organsation number if the customer is representing a company

addressLine1stringOptional

address line 1

Example: Wonder Land

addressLine2stringOptional

Frydenlundgata 7

postalCodestringOptional

postal code

Example: 169

citystringOptional

city

Example: Oslo

countryCodestringOptional

country code

Example: NO

langstringOptional

language code such as no, en

Example: no

Responses

202

Consumer search completed successfully.

application/json

409

Consumer search failed.

application/json

post

/v2/consumers

HTTPcURLJavaScriptPython

POST /efaktura/v2/consumers HTTP/1.1
Host: api.beta.zerp.no
companyId: 1
organisationNumber: 1
customerId: 1
Accept: */*

{
  "consumer": {
    "customerId": 1,
    "firstName": "text",
    "lastName": "text",
    "dateOfBirth": "2025-12-12",
    "email": "text",
    "telephoneNumber": "text",
    "organisationNumber": 1,
    "socialSecurityNumber": "text",
    "addressLine1": "text",
    "addressLine2": "text",
    "postalCode": "text",
    "city": "text",
    "countryCode": "text",
    "eFakturaIdentifier": "text",
    "eInvoiceReference": "text",
    "agreementStatus": "text",
    "issuerBlocked": true,
    "receiverBlockedByIssuer": true
  },
  "consumers": [
    {
      "customerId": 1,
      "firstName": "text",
      "lastName": "text",
      "dateOfBirth": "2025-12-12",
      "email": "text",
      "telephoneNumber": "text",
      "organisationNumber": 1,
      "socialSecurityNumber": "text",
      "addressLine1": "text",
      "addressLine2": "text",
      "postalCode": "text",
      "city": "text",
      "countryCode": "text",
      "eFakturaIdentifier": "text",
      "eInvoiceReference": "text",
      "agreementStatus": "text",
      "issuerBlocked": true,
      "receiverBlockedByIssuer": true
    }
  ],
  "code": 1,
  "message": "text",
  "messageArgs": [
    "text"
  ],
  "companies": [
    1
  ],
  "attributes": [
    "text"
  ]
}