Ansicht
Dokumentation

ADDRESS_INTO_PRINTFORM - Address Format According to Post Office Guidelines

Addresses (Business Address Services) BAL_S_LOG - Application Log: Log header data
This documentation is copyright by SAP AG.

Functionality

The Function module ADDRESS_INTO_PRINTFORM formats an address for printing.

It formats a correct postal address with the required number of lines from your input.
It also returns a one-line short address (name and city) and a one-line short address for the data carrier (payment without document by data carrier exchange (DCE)).

A number of country-specific formats are supported which correspond to the postal regulations of recipient countries.

These are based on various national and international guidelines and norms, including:

ISO 11180,

World postal association contracts (Seoul 1994),

World postal association international address templates

and various national guidelines.

An overview of the country-specific layout formats which are currently supported is given below.

Customers can program their own format routines via a customer exit using the SAP enhancement SZAD0001 in the package SZAD (transaction CMOD).

Control Parameters

Return parameters

The formatted address is returned in the 10 fields LINE0 to LINE9 of return structure ADDRESS_PRINTFORM (or the structure ADRSWA_OUT for address type SPACE).

A one line short address, consisting of Name and City, is returned in the parameter ADDRESS_SHORT_FORM (field ADRSWA_OUT-LINEK). The format is NAME1 / City (of the formatted address).

Similarly, ADDRESS_SHORT_FORM_S is a single-line short address with the format Name / Street / City.

The two-line short address for the data carrier is returned in the parameters ADDRESS_DATA_CARRIER and ADDRESS_DATA_CARRIER_0 (in the field ADRSWA_OUT-LINED and ADRSWA_OUT-LINED0).
The parameter ADDRESS_DATA_CARRIER (field ADRSWA_OUT-LINED) usually comprises the postal code, City and country code, the parameter ADDRESS_DATA_CARRIER_0 (field ADRSWA_OUT-LINED0) is identical to the address line which contains the street or PO Box.

NUMBER_OF_USED_LINES (ADRSWA_OUT-ANZZL)
The number of lines used for the address is returned here.

NAME_IS_EMPTY
Return code which indicates that no formatting has been performed because some name fields were not filled.

ADDRESS_NOT_FOUND
Return code which indicates that the address was not found in the BAS database tables when the address number (address and person number for address types 2/3) was transferred.

Business Add-In ADDR_PRINTFORM_SHORT

The Business Add-In ADDR_PRINTFORM_SHORT is country-independent. It overrides the short forms (ADDRESS_SHORT_FORM, ADDRESS_SHORT_FORM_S and ADDRESS_SHORT_FORM_WO_NAME) and the data carrier (ADDRESS_DATA_CARRIER und ADDRESS_DATA_CARRIER_0).

General formatting rules

The address format depends on whether the sender country is the same as, or different from, the recipient country. The country is always specified from abroad, either as a text name, or as an identification code of up to three characters (license plate code or country key).

Where the country name is written out in full, it is written in the language of the sender country. If a language is not specified for the sender country, or the sender country itself is not specified, the logon language is used instead.
Exception: the language for the country code can be explicitly overwritten by a parameter in the print program (e.g. when the country code for customs transit papers is always to be specified in a particular language, such as English). if the "Print country name in recipient language" flag is set in the print program, the recipient language is used.

Other language-dependent components such as the title and the word 'PO Box' are printed in the recipient language or the recipient country language. If this cannot be determined, the logon language is again used.

For all formats except Great Britain (006), Japan (013), and South Korea (017), the core of the address is formatted as follows (without empty lines, except for the compulsory empty line:)

title line (if applicable)

name block (differs depending on the address type, see below)

street address or PO Box

(compulsory empty line, if applicable)

city line with postal code

country code (if applicable)

The city line and the country name are always printed in upper case for foreign addresses (only for the complete address, not for short forms).

The name block generally consists of the following:

"Normal" addresses (address type SPACE and address type 1):

NAME1

NAME2

NAME3

NAME4

Personal addresses (address type 2):

Title of person and name of person

Business address with department and contact person (address type 3):

NAME1

NAME2

NAME3

NAME4

department

title of person and name of person

In addresses entered using Business Address Services (central address management) (see Release notes Central Address Management for Release 4.0 and Central Address Management for Release 4.5), the street address can comprise several lines (see Print street address), otherwise street and house number are maintained in the Street field.

Some countries do not have a compulsory empty line (see notes below). The city and district are printed in the city line, connected by a hyphen (exceptions: 004 USA, 006 Great Britain/Ireland, 013 Japan, 015 Germany, 017 South Korea, 019 Denmark), provided that the total length does not exceed 35 characters. If a different city is specified for the PO Box (PFORT), this is used in the PO Box address.

In all formats which use a country code (currently 001 European standard format 002 Italy, 011 Switzerland and 014 Austria ), the license plate code for that country is used. If this is not maintained, the country key in table T005 is used.

If the "Print country name in foreign addresses" flag is set for the sender country in table 005, the country code is not used; the country name is printed in the last line of the address.

Formats 004 (USA), 005 (Canada) and 008 (Singapore) contain a line ('F') for the function of the contact person in the company (if address type = '3'). This line comes immediately after the line 'N' (Name (and title) of the natural person).

In formats 002 (Italy), 004 (USA), 005 (Canada), 006 (Great Britain), 007 (Brazil) and Australia (009), the REGIO field (Region, State, Province, County) is formatted. For the USA, Canada, Brazil and Australia, the key from table T005S is used; for Great Britain the text name from table T005U.

In all countries for which no "Address structure key" is maintained, a standard format is used which corresponds to format "010".

Overview of the currently implemented country-specific formats

An example of a domestic and a foreign address is given for each address format.

"Short form" is the one-line short form of the address (with street). The short form without the street is formed by omitting the middle part.

"DME" is the one-line form for the data medium (payment transactions without documents per data medium exchange (DME)). The second line for the data medium is the same as the street line (Street/house number or PO Box) and is not displayed separately.

001: European standard address

(valid e.g. for Belgium, The Czech Republic, Denmark, Finland, France, Greece, Hungary, Iceland, Liechtenstein, Luxemburg, Monaco, Norway, Portugal, Russia, San Marino, The Slovak Republic, Slovenia, Sweden, Turkey and Vatican City).

Note: The country name is only printed instead of the license plate code if the "Print country name in foreign addresses" flag is set for the sender country in the country table.
For Slovenia, the code "SI" is used instead of the license plate code "SLO", for San Marino and the Vatican the code "I" (for Italy) instead of "RSM" and "SCV" respectively.
Liechtenstein and Switzerland have a common post office with a uniform postal code system (they treat each other as domestic).

Examples:
Belgium as the sender country:
SAP Belgium SA
Bld., de la Woluwe 2
1150 Brussels

Short form: SAP Belgium SA / 1150 Brussels

DME: 1150 Brussels

Italy as the sender country ("Print country name in foreign addresses" flag is not set):
SAP Belgium SA
Bld., de la Woluwe 2
B-1150 BRUSSELS

Short form: SAP Belgium SA / Bld., de la Woluwe 2 / B-1150 Brussels

DME B-1150 Brussels Belgium

USA as the sender country ("Print country name in foreign addresses" flag is set):
SAP Belgium SA
Bld., de la Woluwe 2
1150 BRUSSELS
BELGIUM

Short form: SAP Belgium SA / Bld., de la Woluwe 2 / 1150 Brussels

DME: 1150 Brussels Belgium

002: Italy

The format is the European standard address format with the region code at the end of the city line.

003: Netherlands

Note: if the LOCATION (Street 5 / Location) field is filled, the field contents are output in a line of their own above the street line (in combination with a PO Box address it is not output).
The city is always in upper-case letters.
There are two spaces between the postal code and the city.

Example:
SAP Nederland B.V.
Bruistensingel 400
5232 AG S'HERTOGENBOSCH

SAP Nederland B.V.
Bruistensingel 400
5232 AG S'HERTOGENBOSCH
NETHERLANDS

Short form:
SAP Nederland B.V. / Bruistensingel 400 / 5232 AG s'Hertogenbosch
DME:
5232 AG s'Hertogenbosch
5232 AG s'Hertogenbosch Netherlands

004: USA

Note: The city line format is
'City State (key from T005S) ZIP code'.
If the length of this formatted line is greater than 35 characters, the State and ZIP code are moved to the next line, which then has the format
"USA State ZIP code" (from abroad) or
"State ZIP code" (from within the USA).
There are two spaces between State and ZIP code.
The district is not output.
The ZIP code is output as entered, i.e. either the 5-character ZIP code or ZIP+4 code (with hyphen).

Example:
Superintendent of Documents
U.S.Government Printing
Office
Washington DC 20402-1575

Superintendent of Documents
U.S.Government Printing
Office
WASHINGTON DC 20402-1575
USA

Short form:
Superintendent of Documents / Washington DC 20402-1575
DME: Washington DC 20402-1575
Washington DC 20402-1575 USA

005: Canada

Note: The city line has the format
"City Province (key from T005S) Postal code". Domestically, the postal code and possibly the province are written on the next line if the city line is too long. From abroad, the city name is abbreviated if necessary, as the next line is occupied by the country name.

Example:
Societe canadienne des postes
Ottawa ON K1A 1H7

Societe canadienne des postes
Ottawa ON K1A 1H7
CANADA

Short form:
Societe canadienne des postes / Ottawa ON K1A 1H7
DME:
Ottawa, ON K1A 1H7
Ottawa, ON K1A 1H7 Canada

006: United Kingdom and Ireland

Note: The sequence in which lines are suppressed deviates from the standard (see the LINE_PRIORITY parameter documentation in the ADDRESS_INTO_PRINTFORM function module).
The format is as follows:

name block

street or PO Box

district

1 to 3 city lines

country name (if applicable)

If there is a district, it is output on a line of its own, below street/PO Box and above the city lines.
If it does not cause any other lines to be suppressed, the city is formatted in two or three lines, i.e. either:
City
County (text from T005U)
Postcode
or:
City
County Postcode
or:
City Postcode

Example:
The Post Office
Post Office Headquarters
33 Grosvenor Place
London
SW1X 1PX

The Post Office
Post Office Headquarters
33 Grosvenor Place
LONDON
SW1X 1PX
GREAT BRITAIN

Short form:
The Post Office / 33 Grosvenor Place / SW1X 1PX
DME:
London SW1X 1PX
London SW1X 1PX Great Britain

007: Brazil

Note: The state code (key from T005S) is added to the city line with a hyphen.

Example:
Entreprise bresilienne des
postes et telegraphes
SBN - Conjunto 3 - Bloco A

70002-Brasilia-DF

Entreprise bresilienne des
postes et telegraphes
SBN - Conjunto 3 - Bloco A

70002-BRASILIA-DF
BRAZIL

Short form:
Entreprise bresilienne des / SBN - Conjunto 3 - Bloco A / 70002
Brasilia - DF
DME:
70002 Brasilia
70002 Brasilia Brazil

008: Postal code after the city (e.g. Singapore)

Note: The city line format is
"City Postal code".

Example:
Postal Services Group Telecoms
111 Somerset Road 05-06
Singapore 179433

Postal Services Group Telecoms
111 Somerset Road 05-06
SINGAPORE 179433
SINGAPORE

Short form:
Postal Services Group Telecoms / 111 Somerset Road 05-06 /
Singapore 179433
DME:
Singapore 179433
Singapore 179433 Singapore

009: Australia

Note: The city line contains
'City Province (key from T005S) Postal code', or, if this line is more than 35 characters long, only
'City Province'.
The city line is always output in upper-case letters

Example:
Australian Postal Commission
PO Box 302
CARLTON SOUTH VC 3053

Australian Postal Commission
PO Box 302
CARLTON SOUTH VC 3053
AUSTRALIA

Short form:
Australian Postal Commission / PO Box 302 / Carlton South VC 3053
DME:
Carlton South VC 3053
Carlton South VC 3053 Australia

010: Postal code before the city, without country code (e.g. China).

Example:
Direction generale des postes
et telegraphes

28070 Madrid

Direction generale des postes
et telegraphes

28070 MADRID
SPAIN

Short form:
Direction generale des postes / 28070 Madrid
DME:
28070 Madrid
28070 Madrid Spain

011: Switzerland

Note: The country name is only output instead of the license plate code if the "Print country name in foreign addresses" flag is set for the sender country in the country table.
No compulsory empty line. Switzerland and Liechtenstein have a common post office with a uniform postal code system (they treat each other as domestic).

Examples:
Switzerland as the sender country:
SAP (Schweiz) AG
Leugenestr.6
2500 Biel 6

Short form: SAP (Schweiz) AG / Leugenestr.6 / 2500 Biel 6
DME: 2500 Biel 6

Italy as the sender country: ("Print country name in foreign addresses" indicator is not set):
SAP (Schweiz) AG
Leugenestr.6
CH-2500 BIEL 6

Short form:SAP (Schweiz) AG / Leugenestr.6 / CH-2500 Biel 6
DME: CH-2500 Biel 6 Switzerland

USA as the sender country: ("Print country name in foreign addresses" flag is set):
SAP (Schweiz) AG
Leugenestr.6
2500 BIEL 6
SWITZERLAND

Short form:SAP (Schweiz) AG / Leugenestr.6 / 2500 Biel 6
DME: 2500 Biel 6 Switzerland

012: South Africa

Note: The postal code is in a new line below the city. In letters from abroad, the country name comes after the postal code.

Example:

Postmaster General

Private Bag X148

Pretoria

0001

Postmaster General

Private Bag X148

PRETORIA

0001 SOUTH AFRICA

Short form:
Postmaster General / Private Bag X148 / Pretoria
DME:
0001 Pretoria
0001 Pretoria South Africa

013: Japan (old)

As of SAP_BASIS 6.20 Support Package 28 (or SAP_BASIS 6.40) a new Japanese print format will be available. See print format 113.

Note: The postal code of the PO box is ignored.
The following format applies from abroad:

Name block with title

Street or PO Box

City

District (if maintained)

Country Postal code
(if the postal code is longer than 3 characters, a hyphen is inserted in the 4th character, unless the 4th character is already a hyphen.)

Example:
Ministere des postes et
telecommunications
3-2, Kasumigaseki 1 chome
CHIYODA-KU, TOKYO
JAPAN 100

Within Japan:

Postal code (possibly with hyphen in 4th place)

Street, City without space separator

District

PO Box

empty line

name2 Title or Name1 Title (if Name2 is empty)

name3

name4

Short form:
Ministere des postes et / 3-2, Kasumigaseki 1 chome / Chiyoda-ku
DME:
Tokyo -
Tokyo - Japan

113: Japan (new)

Note: If you choose print format 113 instead of 013, you have to use screen variant 013 in addition. To change the active screen variant, use transaction SA15. This setting applies to all clients and all users. For individual users you can also set the SET/GET parameter ADDRESS_SCREEN = 013 in transaction SU3/SU01.

The following format applies to mail from abroad:

Name block with title

(Title is always printed in English)

c/o name (if maintained)

Street and house number or PO box

District (if maintained)

City, prefecture (with space separator; name of prefecture always printed in English)

Country postal code

Example:

,,Mr Taro Tanaka
,,c/o SAP Japan
,,7-2 Otemachi 1-chome
,,Chiyoda-ku, TOKYO
,,100-0004 JAPAN,,

Short form: Mr Taro Tanaka / 7-2 Otemachi 1-chome / Chiyoda-ku, TOKYO

DME:,,Chiyoda-ku, TOKYO Japan

Within Japan, the formatting follows the priniciple of "from the top to the bottom, the granularity increases":

Postal code (with a hyphen as the fourth character, if necessary)

Prefecture and city without a space as a separator

District (if maintained)

Street with house number or PO box

c/o name (if maintained)

Mandatory empty line

Name1 Title

Name2

Name3

Name4

Example:

,,100-0004
,,TOKYOChiyoda-ku
,,Otemachi 1-chome7-2
,,Tokyo Sankei Bldg
,,c/o SAP Japan

,,Tanaka Taro Mr

Short form: Tanaka Taro Mr / TOKYOChiyoda-kuOtemachi 1-chome7-2

DME: TOKYOChiyoda-ku

014: Austria

Note: When Austria is the sender country, the country name is always in the last line when letters are sent abroad, even if the indicator "Print country name in foreign addresses" is not set.

Examples:
Austria as the sender country:
SAP Ges.m.b.H.
Stadlauer Straße 54
1221 Vienna

Short form:SAP Ges.m.b.H./ Stadlauer Straße 54 / 1221 Vienna
DME: 1221 Vienna

Italy as the sender country ("Print country name in foreign addresses" indicator is not set):
SAP Ges.m.b.H.
Stadlauer Straße 54
A-1221 VIENNA
AUSTRIA
Short form:SAP Ges.m.b.H. / Stadlauer Straße 54 / A-1221 Vienna
DME: A-1221 Vienna Austria

USA as the sender country ("Print country name in foreign addresses" indicator is set):
SAP Ges.m.b.H.
Stadlauer Straße 54
1221 VIENNA
AUSTRIA

Short form:SAP Ges.m.b.H./ Stadlauer Straße 54 / 1221 Vienna
DTA: 1221 Vienna Austria

015: Germany (with license plate code)

Note: The district is output on an individual line before the street line for the street address (house address).
The district is not output in PO Box addresses or for large customers who have their own postal code.

Examples:
Germany as the sender country:
Firma
Meyer und Söhne
Riem
Hauptstr. 57
81829 Munich

Short form: Meyer und Söhne / Hauptstr. 57 / 81829 Munich
DME: 81829 Munich

USA as the sender country
Firma
Meyer und Söhne
Riem
Hauptstr. 57

81829 MUNICH
GERMANY

Short form: Meyer und Söhne / Hauptstr. 57 / 81829 Munich
DME: 81829 Munich Germany

017: South Korea

Note: The PO Box postal code is ignored.

From abroad:

- Name block with title
- Street
- District
- City
- Country postal code

Example:
SAP Korea Ltd.
23-2, Youido-dong
Seoul
South Korea 150-010

Address with PO Box :

Name block
Street (the Post office with the PO Box)
'PO BOX' PO Box
District
City
Country postal code

Example:
Samsung SDS Co. Ltd.
Chamshil Post Office
PO BOX 123456
Songpa-gu
Seoul
South Korea 123-456

Within Korea:
- City, District
- Street
- Name 1
- Name 2
- Name 3
- Name 4

- Postal code

Example:
Seoul, Youngdeungpo-ku
23-2 Youido-dong
SAP Korea Ltd.

150-010

Addresses with PO Boxes :

City, District
Street (the Post office with the PO Box)
'PO BOX' PO Box
Name block

The Korean name for 'PO Box' is output.

Example:
Seoul Songpa-gu
Chamshil Post Office
PO BOX 123456
Samsung SDS Co. Ltd.
123-456

Kurzform:
Samsung SDS Co. Ltd./Seoul

DTA:
Seoul 123-456

019: Denmark

Notes: The country name is only output instead of the license plate code, if the "Print country name in foreign address" flag is set for the sender country in the country table.
The district is output in an extra line above the district. It is not output in PO Box and major customer addresses

Example:
Sender country Denmark:
SAPFuture Dänemark A/S
Tietgensgade 23
Kastrup
1566 Copenhagen
Short form: SAPFuture Dänemark A/S / Tietgensgade 23 / 1566 Copenhagen
DTA: 1566 Copenhagen

Parameters

ADDRESS_1
ADDRESS_2
ADDRESS_3
ADDRESS_DATA_CARRIER
ADDRESS_DATA_CARRIER_0
ADDRESS_HANDLE
ADDRESS_NOT_FOUND
ADDRESS_NUMBER
ADDRESS_PRINTFORM
ADDRESS_PRINTFORM_TABLE
ADDRESS_SHORT_FORM
ADDRESS_SHORT_FORM_S
ADDRESS_SHORT_FORM_WO_NAME
ADDRESS_TYPE
ADRSWA_IN
ADRSWA_OUT
BLK_EXCPT
COUNTRY_NAME_IN_RECEIVER_LANGU
EV_NATION
IS_BUPA_TIME_DEPENDENCY
IV_COUNTRY_NAME_SEPARATE_LINE
IV_DISPLAY_COUNTRY_IN_SHRTFORM
IV_LANGU_CREA
IV_NATION
IV_NATION_SPACE
IV_PERSON_ABOVE_ORGANIZATION
LANGUAGE_FOR_COUNTRY_NAME
LINE_PRIORITY
NAME_IS_EMPTY
NO_UPPER_CASE_FOR_CITY
NUMBER_OF_LINES
NUMBER_OF_USED_LINES
PERSON_HANDLE
PERSON_NUMBER
RECEIVER_LANGUAGE
SENDER_COUNTRY
STREET_HAS_PRIORITY

Exceptions

ADDRESS_BLOCKED
ADDR_TO_BE_FORMATED_IS_BLOCKED
CONTACT_PERSON_BLOCKED
PERSON_BLOCKED

Function Group

SADR

PERFORM Short Reference RFUMSV00 - Advance Return for Tax on Sales/Purchases
This documentation is copyright by SAP AG.

Length: 36025 Date: 20240523 Time: 094338 sap01-206 ( 349 ms )

Ansicht Dokumentation

ADDRESS_INTO_PRINTFORM - Address Format According to Post Office Guidelines

Functionality

Control Parameters

Return parameters

Business Add-In ADDR_PRINTFORM_SHORT

General formatting rules

Overview of the currently implemented country-specific formats

Parameters

Exceptions

Function Group

Ansicht
Dokumentation