Using supplier
Overview
The company's suppliers are created and maintained here.
| Property | Description | Default | Create |
|---|---|---|---|
| address | The street address of the supplier. See Address object below. | x | |
| agreementAmount | The value of the agreement. | ||
| agreementExpiresDate | Here you can enter the date for when any agreement with the supplier expires. | ||
| bankAccountNumber | The bank account number of the supplier. | x | |
| contactInfo | Contact info of the supplier. See Contact object below. | x | |
| contactPerson | Details of the individual to be contacted on behalf of the supplier, if different from contact info. See Contact object below. | x | |
| customer | Add the customer object if the supplier is also a registered customer | ||
| ean | The international article number of the supplier to identify a specific retail product type, if applicable | x | |
| externalId | If the supplier has an identifier in an external system linked to this one, the identifier can be set here. used for duplicate checks. | x | |
| foreignBankInfo | Information for payments to abroad (foreign bank) is registered here. Also used if domestic payment is in foreign currency. You can put the "Iban" info in the iban field within this object and Duett will gather the other information about the bank for you: "foreignBankInfo": {"iban":GB24BKEN10000031510604}. See foreignBankInfo below. | x | |
| groupAffiliations | An array of group ids that this supplier will be connected to | ||
| hourRegistrations | A list of hour registrations associated with work done for this supplier | ||
| id | Unique id given by Duett for this particular supplier. | ||
| name | Required. The name of the supplier. | x | |
| ourCustomerNumber | This is a purely information field where the company's customer number with this supplier can be entered. | ||
| pidNumber | The national identity number of the supplier, if applicable. | x | |
| show | "False" if soft deleted. | True | |
| supplierNumber | Automatically generated ID in the duett system. Used in internal systems. If provided, ensure that it is a reserved series in Duett so that the provided customer number does not conflict. See /Register/v2/AccountIntervals. Supplier numbers can be changed for special needs, but they cannot be duplicate numbers. | ||
| useForeignBank | Boolean. Whether you will use a foregn bank for the supplier bank account. This also applies to payments in foreign currency to accounts in Norwegian banks. When true, fill inn the foreignBankInfo objekt. | x | |
| vatNumber | If the supplier has a vatNumber and is liable for VAT it should be added in this field. | x |
| Property | Description | Default | Create |
|---|---|---|---|
| address1 | The first line of the street address. | x | |
| address2 | The second address line of the street address, if relevant. | x | |
| address3 | The third address line of the street address, if relevant. | x | |
| zipCodeKey | A valid Norwegian zipcode, can be fetched from Register/v2/ZipCodes. Must be null for addresses outside Norway. |
x | |
| countryCode | Any valid international Country Code. Required for addesses outside Norway.Optional for addresses in Norway (NO). If the countryCode is other than NO, the postcode will not be saved/or removed when it is changed. | x | |
| AbroadZipCode | The zip code if the supplier's address is not based in norway. | x | |
| AbroadZipCodeName | The zip code area name if the supplier's address is not based in norway. | x |
| Property | Description | Default | Create |
|---|---|---|---|
| E-mail address of the contact | |||
| mobile | Mobile phone number of the contact | ||
| name | Name of the contact | ||
| phone1 | Alternative phone number for the contact | ||
| phone2 | Further contact numbers for the contact |
| Property | Description | Default | Create |
|---|---|---|---|
| iban | The field contains a check that it is a valid IBAN number based on the criterion that the IBAN number starts with a country code and a certain number of characters (numbers and letters) that are used for the individual country. The field can also be filled in with a numerical account number if the supplier has a bank account in a country that does not use IBAN. | X | |
| bicSwift | BIC stands for Bank Identifier Code and is the code that identifies the bank. BIC is also called SWIFT and is required for payments to a number of countries and always when using IBAN. | Automatically completed if Iban has been submitted. | X |
| bankCode | Used in countries that do not have an IBAN, e.g. the USA. The code differs from country to country, and should be used together with the BIC/SWIFT in those countries. | Automatically completed if Iban has been submitted. | |
| costCoverage | Code. As standard when creating new suppliers, this is set to "Delt" (Shared). "Delt" means that the sender pays costs in Norway and the recipient pays costs abroad. Shared costs are mandatory for SEPA payments where IBAN is also mandatory. The SEPA area comprises the EU (including some overseas possessions) + Norway, Liechtenstein, Iceland, Switzerland, Andorra, Monaco, San Marino and the United Kingdom. Other choices from the list are "Mottaker betaler" (Recipient pays), "Avsender betaler" (Sender pays) and "Avsender betaler kostnader i Norge, mottaker betaler i utlandet" (Sender pays costs in Norway, recipient pays abroad). This last option applies if the supplier has an account type other than IBAN. See /Register/v2/GetCostCoverage | Automatically completed if Iban has been submitted. | X |
| payType | Code. The Currency Register Act requires information on what the amount applies to when paying abroad. Purchase/sale of goods is set as standard. This can be changed, see selection in pick list. If you receive 2 invoices of such a size that the type of payment is required, and these apply to 2 different purchases (e.g. one applies to the purchase of goods and the other applies to the purchase of services) then you should change the code for payment of the next invoice. See /Register/v2/GetPayType | Automatically completed if Iban has been submitted. | X |
| bankName | Name of the bank. | Automatically completed if Iban has been submitted. | X |
| abroadZipCode | Foreign zip code. | Automatically completed if Iban has been submitted. | X |
| abroadZipCodeName | Name of the town/ place. | Automatically completed if Iban has been submitted. | X |
| address | Address. | Automatically completed if Iban has been submitted. | C |
| address2 | Address. | Automatically completed if Iban has been submitted. | X |
| countryCode | ISO country code. | Automatically completed if Iban has been submitted. | X |
Example:
{
"name": "TestLeverandør",
"vatNumber": "227119195",
"pidNumber": "22035032030",
"bankAccountNumber": "91554827050",
"useForeignBank": false,
"foreignBankInfo": null,
"address": {
"address1": "Random veien 140",
"address2": "address2",
"address3": "address3",
"zipCodeKey": "0018",
"countryCode": "NO"
},
"contactInfo": {
"phone1": "82424122",
"phone2": "89998888",
"phone3": "89997777",
"mobile": "88888888",
"email": "examplen@epost.com",
"homepage": "http://example.com"
},
"contactPerson": {
"name": "Janne Pedersen",
"phone1": "89992222",
"phone2": "82321231",
"phone3": "82314213",
"mobile": "88888888",
"email": "notrealemail@example.com"
},
"ean": "1235",
"groupAffiliations": [
{
"id": 17037
},
{
"id": 16982
},
{
"id": 15868
}
]
}
Foreign supplier example:
{
"name": "TestLeverandør",
"bankAccountNumber": "91554827050",
"useForeignBank": true,
"foreignBankInfo": {
"iban": "GB24BKEN10000031510604"
},
"address": {
"address1": "Versjon 2 veien 140",
"address2": "address2",
"address3": "address3",
"isForeign": false,
"zipCodeKey": null,
"zipCodeName": null,
"countryCode": "GB",
"abroadZipCode": "L1 2AA",
"abroadZipCodeName": "London"
},
"contactInfo": {
"phone1": "82424122",
"phone2": "89998888",
"phone3": "89997777",
"mobile": "88888888",
"email": "example@epost.com",
"homepage": "http://example.com"
},
"contactPerson": {
"name": "Janne Pedersen",
"phone1": "89992222",
"phone2": "82321231",
"phone3": "82314213",
"mobile": "88888888",
"email": "putnotrealemail@example.com"
},
"ean": "1235"
}
Foreign supplier US example:
{
"name": "TestLeverandør",
"bankAccountNumber": "91554827050",
"useForeignBank": true,
"foreignBankInfo": {
"iban": null,
"bicSwift": "BKNYUS33XXX",
"bankCode": "FW123456789",
"bankName": "BANK OF USA",
"address": "Threadneedle Street ",
"address2": "Door #2",
"abroadZipCode": "EC2R 8AH",
"abroadZipCodeName": "New York",
"countryCode": "US",
"payType": "9dba1e4a-6bb6-4b0f-82a4-9be0fe6aaf87",
"costCoverage": "82580e42-434c-42f4-8d78-73d806b4bc3a"
},
"address": {
"address1": "Versjon 2 veien 140",
"address2": "address2",
"address3": "address3",
"isForeign": false,
"zipCodeKey": null,
"zipCodeName": null,
"countryCode": "GB",
"abroadZipCode": "L1 2AA",
"abroadZipCodeName": "London"
},
"contactInfo": {
"phone1": "82424122",
"phone2": "89998888",
"phone3": "89997777",
"mobile": "88888888",
"email": "example@epost.com",
"homepage": "http://example.com"
},
"contactPerson": {
"name": "Janne Pedersen",
"phone1": "89992222",
"phone2": "82321231",
"phone3": "82314213",
"mobile": "88888888",
"email": "putnotrealemail@example.com"
},
"ean": "1235"
}