Sign in

Delivery Help Center

Address book

Avatar
Anna Isaksson
Updated

ESSENTIAL STANDARD

Subscription plans

Create and maintain your address book manually, via API or by file import.

You should register at least one sender. You can have several senders with different names and/or address information. They can also have different carrier customer numbers, depending on your needs.

Note

The upper limit for senders/receivers is 30,000.

Add a new sender in the GUI

  1. Go to Maintenance > Senders.

  2. Click New sender.

    Tip

    Quick ID is a unique reference to identify a sender, for example "123", and can be used in many different scenarios.

    Tip

    Check the Receiver box if the sender should act as receiver as well.

    Note

    Check the System integration box if the sender should be available as default sender in nShift Checkout.

  3. Enter Address details.

  4. Enter account information if you use Cash on Delivery or any other service that requires account information.

  5. Enter carrier information, such as customer number.

    Caution

    Before you make your first shipment you have to add your carrier customer number(s) and other relevant information.

    To add a carrier:

    1. Click DEL_AddCarrier_big_button-en.png in the Carriers section.

    2. Select a carrier from the Carrier dropdown menu.

    3. Enter your carrier customer number in the CustNo field.

      Note

      Contact the carrier if you're unsure which customer number to use.

    4. Enter other carrier information, if relevant or requested by the carrier.

  6. In the Search information section, add category values to enable category search.

  7. In the Default values section, add information, such as sender reference and delivery instructions, that will be set as default values when creating shipments.

You can add a new sender when printing, using standard printing and, if the option hasn't been locked, using printing favorites.

If you want to edit, copy or delete a sender, use the search function.

Add a new receiver in the GUI

  1. Go to Maintenance > Receivers.

  2. Click New receiver.

    Tip

    Check the Sender box if the receiver should act as sender as well.

  3. Enter Address details.

  4. Enter account information if you use Cash on Delivery or any other service that requires account information.

  5. Enter carrier information, such as customer number.

  6. In the Search information section, add category values to enable category search.

  7. In the Default values section, add information, such as receiver reference and delivery instructions, that will be set as default values when creating shipments.

You can add a new receiver when printing, using standard printing and, if the option hasn't been locked, using printing favorites.

If you want to edit, copy or delete a receiver, use the search function.

Address book via API

If you keep your address book in another system you can use Address book via API to maintain and synchronize senders and receivers in your address book.

Learn more about Address book via API.

Import address book

If you keep your address book in another system you can import it to nShift Delivery. You can add the entries as senders, receivers or both.

The prerequisites are that you can export the name and address information, edit the data and create a tab delimited text file.

Import the file

  1. Go to Maintenance > Senders or Receivers and click Import.

  2. After adding the file, select ”Standard, address (Tab separated)” as Import type and, in most cases, "ISO-8859-1" as Character encoding.

  3. Check the Also import as receiver/Also import as sender box if the address party should act as both sender and receiver.

  4. Check the Replace matching quick ID box if you want existing information to be replaced by information from the file for address parties with the same unique quick ID.

    Tip

    It's recommended to select Replace matching quick ID to avoid duplicates.

  5. Click Import.

If you get an error message saying that the file is incorrect, check the file structure and contents. Make the necessary changes and try to import the file again.

File structure

The import file must have the following structure and content:

  • ISO -8859-1 (Windows ANSI) or UTF-8 encoding.

  • Records that are separated by a line break.

  • Headers (top row) must be spelled correctly and appear in square brackets, for example, [quickid]. You only need to include headers that you want to import. If a header shouldn't be used, it's important to remove it, not just delete the content.

Download an example file and open in a text editor or Microsoft Excel to see what it should look like.

Customer and address information

Header

Description

Type

Value

[quickid]

Quick ID for the address party. Often the customer number or similar in the system you retrieve the information from.

string

[sender]

Indicates if it's a sender. When you import senders, the value must be "Y" and you must check the Sender box in the GUI. If the field doesn't exist in the file the address will be entered as sender if the box is checked in the GUI.

boolean

Y, N

[receiver]

Indicates if it's a receiver. When you import receivers, the value must be "Y" and you must check the Receiver box in the GUI. If the field doesn't exist in the file the address will be entered as receiver if the box is checked in the GUI.

boolean

Y, N

[orgno]

Organization registration number

string

[vatno]

VAT number

string

[category1text]

Used for categorizing entries, for example, A1

string

[category2text]

Used for categorizing entries, for example, VIP2019

string

[category3text]

Used for categorizing entries, for example, Import date 20190624

string

[category1no]

Used for categorizing entries, for example, 1234

integer

[category2no]

Used for categorizing entries, for example, 2019

integer

[category3no]

Used for categorizing entries, 20190624

integer

[category4no]

Used for categorizing entries, for example, 1234

integer

[category5no]

Used for categorizing entries, for example, 2019

integer

[category6no]

Used for categorizing entries, for example, 20190624

integer

[name]

Name of the address party (organization or private person)

string

[address1]

Delivery address, line 1 (street address, unit or department)

string

[address2]

Delivery address, line 2 (street address, if unit or department has been entered in line 1)

string

[zipcode]

Delivery postal code, without country code

string

[city]

Delivery city

string

[state]

Delivery code for state in certain countries

string

[country]

Delivery country code in ISO 1366-2 format

string

SE, DK, NO, FI, etc.

[contact]

Contact person for address party

string

[email]

Email address

string

[phone]

Phone number

string

[fax]

Fax number

string

[sms]

SMS number

string

[doorcode]

Door code

string

[postaladdress1]

Postal address, line 1 (street, PO box, unit or department, if different from delivery address)

string

[postaladdress2]

Postal address, line 2 (street, PO box, if unit or department has been entered in line 2 and if different from delivery address)

string

[postalzipcode]

Postal code, without country code (if different from delivery postal code)

string

[postalcity]

Postal city (if different from delivery city)

string

[postalstate]

Postal code for state (if different from delivery state)

string

[postalcountry]

Postal country code in ISO 1366-2 format

string

SE, DK, NO, FI, etc.)

[deliv1]

Delivery instructions, line 1

string

[deliv2]

Delivery instructions, line 2

string

[deliv3]

Delivery instructions, line 3

string

[deliv4]

Delivery instructions, line 4

string

[receiverref]

Receiver reference

string

[senderref]

Sender reference

string

[codref]

Payment reference for COD/Efterkrav

string

[profilegroup]

Name of the profile group that the sender/receiver should be stored in. If the field is left blank the sender/receiver will be stored in the default profile group.

string

Account for COD/Efterkrav

Header

Description

Type

Value

[account_1_type]

Type of account (some accounts can be in text or OCR)

string

PGTXT, PGOCR, BGTXT, BGOCR, IBAN

[account_1_number]

Account number

string

[account_1_bic]

BIC code (only used if the account type is IBAN)

string

[account_2_type]

Type of account (some accounts can be in text or OCR)

string

PGTXT, PGOCR, BGTXT, BGOCR, IBAN

[account_2_number]

Account number

string

[account_2_bic]

BIC code (only used if the account type is IBAN)

string

[account_3_type]

Type of account (some accounts can be in text or OCR)

string

PGTXT, PGOCR, BGTXT, BGOCR, IBAN

[account_3_number]

Account number

string

[account_3_bic]

BIC code Only used if the account type is IBAN

string

[account_4_type]

Type of account (some accounts can be in text or OCR)

string

PGTXT, PGOCR, BGTXT, BGOCR, IBAN

[account_4_number]

Account number

string

[account_4_bic]

Type of account (some accounts can be in text or OCR)

string

[account_5_type]

Type of account (some accounts can be in text or OCR)

string

PGTXT, PGOCR, BGTXT, BGOCR, IBAN

[account_5_number]

Account number

string

[account_5_bic]

Type of account (some accounts can be in text or OCR)

string

Carrier information

  • Go to Help > Code lists in nShift Delivery to find carrier codes.

  • Select Services in the scroll bar Lists and click Show.

  • Use the code that is to the left of the carrier's name (bold text).

In the field names below "xxx" should be replaced with the carrier code.

Header

Description

Type

Value

[partner_xxx_custno]

Customer number

string

[partner_xxx_palletregno]

Pallet registration number

string

[partner_xxx_retailerid]

Retailer ID

string

[partner_xxx_sortpos]

Code for sorting position

string

[partner_xxx_destcode]

Sorting code

string

[partner_xxx_paymentmethod]

Code for payment method for letters

string

[partner_xxx_ediaddress]

EDI address

string

[partner_xxx_deliveryaddressref]

Delivery address reference

string

[partner_xxx_bookingid]

Booking number

string

[partner_xxx_bookingoffice]

Booking office

string

[partner_xxx_senderid]

Customer number as prefix to shipment id

string

[partner_free_<name>_custno]

Customer number for neutral carrier

Example: [partner_free_joanjet_custno]

string

[partner_free_<name>_palletregno]

Pallet registration number for neutral carrier

Example: [partner_free_joanjet_palletregno]

string

Other

Header

Description

Type

Value

[system_integration]

Indicates if the address party is used for system integration.

boolean

Y, N

Clean the address book

ESSENTIAL PLUS

Subscription plans

You can use the import/export function to clean your address book, that is, remove duplicates, outdated addresses, etc.

  1. Go to Maintenance > Senders or Receivers.

  2. Search the address book without using search values, which will retrieve all senders/receivers in your address book.

  3. Click Export.

  4. Edit the file in, for example, Microsoft Excel.

  5. Go to Maintenance > Senders or Receivers.

  6. Search the address book without using search values.

  7. Click Delete.

    Caution

    You remove the entire address book and it can't be undone. Make sure that you've a correct file to import.

  8. Click Import to import your updated address book file.

Search by category

Category values are useful if you want to send something to a group of receivers or remove receivers belonging to a specific category.

You give the receivers a value in one of the category fields, for example "Summer gift 2020" in [category1text], and use that category search value when printing, preferably using batch printing.

If you want to remove receivers, use a category search value and click Delete.

Caution

Make sure you've made the correct selection so you don't accidentally delete the entire address book.

Related articles