Create Supplier

post https://api.next-tech.com/v1/supplier/

Body Params

accountno

string | null

Used to create accounting rows for supplier invoices

active

boolean

Defaults to true

If this supplier is active and in use

apartmentno

string | null

Number of the apartment

bankaccountno

string | null

Account no in bank

bankgiro

string | null

Bank giro number

bankname

string | null

Name of bank

billaddress1

string | null

Address line 1, usually name

billaddress2

string | null

Address line 2, usually street address

billaddress3

string | null

Address line 3, usually secondary street address information, building number, box, etc.

billaddress4

string | null

Address line 4, usually postal number

billaddress5

string | null

Address line 5, usually city

billaddress6

string | null

Address line 6, usually country

billingtermsid

integer | null

Billing terms (id). Will be used on the invoice

clearingno

string | null

Clearing no

constructioncompany

boolean

Defaults to false

If the company is a construction company. Controls if the company by default is invoiced VAT. Is not allowed to be 'true' when novat is 'true'

contractorvataccountno

string | null

Used to create contractor vat accounting row for supplier invoices

countrycode

string | null

Country code

currencyid

integer

Currency (id) for the customer. If a value is left out when a record is created, the default currency will be used.

customerno

string | null

Number of customer/supplier, used in connection to external system

customernote

string | null

Internal notes about the customer/supplier

customertypeid

integer

required

Type (id) of customer/supplier (Company, Private, Government...)

defaultexternalworkorderstatusid

integer | null

External workorder status that should be inherited to workorders of this customer/supplier

disablepayment

boolean

Defaults to false

Indicates that invoices from this supplier should be disabled from payment in external economy system

domainname

string | null

Used as suffix when creating subcontractor staff log client users

eancode

string | null

EAN Code

ediAddress

string | null

EDI Address

string | null

Email to customer/supplier

externalid

string | null

Id in external system. Null if created in NEXT and not yet exported

fax

string | null

Fax

housingcooperativeorgno

string | null

Organization no (Housing cooperative)

iban

string | null

IBAN

markup

number | null

Markup percentage

mobile

string | null

Mobile phone, can be used for SMS

name

string

required

length ≤ 50

Name of customer/supplier

nopayoff

boolean

Defaults to false

True to avoid creating payoff for this supplier

novat

boolean

Defaults to false

If NO VAT should be applied to invoices by default. Is not allowed to be 'true' when constructioncompany is 'true'

organizationno

string

required

length ≤ 15

Organization identification number

phone

string | null

Primary phone

plusgiro

string | null

Postal giro number

propertyname

string | null

Name of property

supplierno

string

required

length ≤ 50

Number of supplier, used in connection to external system

swiftbic

string | null

SWIFT / BIC

vatno

string | null

VAT number

webaddress

string | null

Web address

Responses

Response body

object

integer

required

Id of record, used as primary key when looking up items using the API

changed

date-time

required

Timestamp of the last time the object was modified

changeduserid

integer

required

The Id of the user that last made changes to the object

created

date-time

required

Timestamp of when the object was first created

createduserid

integer

required

The Id of the user that first created the object

accountno

string | null

Used to create accounting rows for supplier invoices

active

boolean

Defaults to true

If this supplier is active and in use

apartmentno

string | null

Number of the apartment

bankaccountno

string | null

Account no in bank

bankgiro

string | null

Bank giro number

bankname

string | null

Name of bank

billaddress1

string | null

Address line 1, usually name

billaddress2

string | null

Address line 2, usually street address

billaddress3

string | null

Address line 3, usually secondary street address information, building number, box, etc.

billaddress4

string | null

Address line 4, usually postal number

billaddress5

string | null

Address line 5, usually city

billaddress6

string | null

Address line 6, usually country

billingterms

string | null

Billing terms (description). Will be used on the invoice

billingtermsid

integer | null

Billing terms (id). Will be used on the invoice

clearingno

string | null

Clearing no

companycategories

string | null

Company categories.

constructioncompany

boolean

Defaults to false

If the company is a construction company. Controls if the company by default is invoiced VAT. Is not allowed to be 'true' when novat is 'true'

contractorvataccountno

string | null

Used to create contractor vat accounting row for supplier invoices

countrycode

string | null

Country code

currencycode

string

required

length ≤ 3

Currency (code) for the customer/supplier

currencyid

integer

Currency (id) for the customer. If a value is left out when a record is created, the default currency will be used.

customerno

string | null

Number of customer/supplier, used in connection to external system

customernote

string | null

Internal notes about the customer/supplier

customertypeid

integer

required

Type (id) of customer/supplier (Company, Private, Government...)

customertypename

string

required

length ≤ 50

Type (name) of customer/supplier (Company, Private, Government...)

defaultexternalworkorderstatusid

integer | null

External workorder status that should be inherited to workorders of this customer/supplier

disablepayment

boolean

Defaults to false

Indicates that invoices from this supplier should be disabled from payment in external economy system

domainname

string | null

Used as suffix when creating subcontractor staff log client users

eancode

string | null

EAN Code

ediAddress

string | null

EDI Address

string | null

Email to customer/supplier

evaluationtext

string | null

Evaluation text, used by Procurement

evaluationvalue

integer | null

Evaluation value between 0 and 5, used by Procurement

externalid

string | null

Id in external system. Null if created in NEXT and not yet exported

fax

string | null

Fax

hasfavorites

boolean

Has favorites

hasprices

boolean

Has prices

housingcooperativeorgno

string | null

Organization no (Housing cooperative)

iban

string | null

IBAN

markup

number | null

Markup percentage

mobile

string | null

Mobile phone, can be used for SMS

name

string

required

length ≤ 50

Name of customer/supplier

nopayoff

boolean

Defaults to false

True to avoid creating payoff for this supplier

novat

boolean

Defaults to false

If NO VAT should be applied to invoices by default. Is not allowed to be 'true' when constructioncompany is 'true'

organizationno

string

required

length ≤ 15

Organization identification number

phone

string | null

Primary phone

plusgiro

string | null

Postal giro number

propertyname

string | null

Name of property

regions

string | null

Regions

supplierno

string | null

Number of supplier, used in connection to external system

swiftbic

string | null

SWIFT / BIC

vatno

string | null

VAT number

webaddress

string | null

Web address

Language

Credentials

OAuth2

URL


xxxxxxxxxx
13
1
curl --request POST \
2
     --url https://api.next-tech.com/v1/supplier/ \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "active": true,
8
  "constructioncompany": false,
9
  "disablepayment": false,
10
  "nopayoff": false,
11
  "novat": false
12
}
13
'


xxxxxxxxxx
60
}
1
{
2
  "id": 5,
3
  "changed": "2025-04-13T07:51:27.698Z",
4
  "changeduserid": 7,
5
  "created": "2025-04-13T07:51:27.698Z",
6
  "createduserid": 3,
7
  "accountno": "78766",
8
  "active": false,
9
  "apartmentno": "15",
10
  "bankaccountno": "6547 893216 5478",
11
  "bankgiro": "5432-2345",
12
  "bankname": "Handelsbanken",
13
  "billaddress1": "Builders 'R Us",
14
  "billaddress2": "Generic Street 15",
15
  "billaddress3": "Box 456",
16
  "billaddress4": "543 21",
17
  "billaddress5": "Gothenburg",
18
  "billaddress6": "Sweden",
19
  "billingterms": "30 days",
20
  "billingtermsid": 2,
21
  "clearingno": "8480",
22
  "companycategories": "Decontamination and demolition",
23
  "constructioncompany": true,
24
  "contractorvataccountno": "7813",
25
  "countrycode": "SE",

200Successful Response

422Validation Error