Ansicht
Dokumentation

ADDRESS_SHOW_PRINTFORM - Display a formatted address in a popup

Fill RESBD Structure from EBP Component Structure   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
This documentation is copyright by SAP AG.

Functionality

The function module ADDRESS_INTO_PRINTFORM formats an address for printing.

The address is formatted according to your entries and postal guidelines in the correct number of lines. A one-line short address (name and city) and a one-line short address for the data carrier (payment without documents per data carrier exchange (DCE)) are also returned.

Country-specific formats, which depend on the recipient land, are supported.

These are based on international address formats from the official Federal German Post Office postal code book.

An overview of the currently implemented country-specific formats follows below.

Customers can program their own formatting routines in Customer exits using the SAP enhancement SZAD0001 in the development class SZAD (-> transaction CMOD).

Control parameters

See also the appropriate parameter documentation.

ADDRESS_TYPE - Address type (from 3.0C)
There are three different address types:
Address type '1': addresses of firms or organizations; the address structure which is used in most SAP applications as 'Address'.
Address type '2': address of a living person
Address type '3': company address, usually the address of a contact person in a company
The default value SPACE for the address type is handled as type '1' and is required for the upwards-compatibility of the function module.

Address type SPACE uses the interface parameters ADRSWA_IN, ADRSWA_OUT and ADDRESS_NUMBER, the other address types use the remaining interface parameters and ADDRESS_NUMBER.

The following parameters correspond:
ADDRESS_NUMBER - no equivalent
SENDER_COUNTRY - ADRSWA_IN-INLND
RECEIVER_LANGUAGE - ADRSWA_IN-SPRAS
NUMBER_OF_LINES - ADRSWA_IN-ANZZL
STREET_HAS_PRIORITY - ADRSWA_IN-WAREN
LINE_PRIORITY - ADRSWA_IN-PRIOR
COUNTRY_NAME_IN_RECEIVER_LANGU - no equivalent
LANGUAGE_FOR_COUNTRY_NAME - no equivalent
NUMBER_OF_USED_LINES - ADRSWA_OUT-ANZZL
NAME_IS_EMPTY - no equivalent
The meanings of the parameters are explained in the parameter documentation.

The three-character recipient country "

Address format key" (LAND1) controls which of the existing country-specific address formatting routines in that country is to be used. This key is in the field T005-ADDRS, and is entered in customizing in the detail screen of Global settings -> Countries -> Define countries under "Address format key".
Keys for user routines in the SAP enhancement SZAD0001 can be maintained via the transaction SM30 (Extended table maintenance), table name T005A, in the customer name range, and be assigned in country customizing.

The address attributes are passed in the structures ADDRESS1 (type 1), ADDRESS2 (type 2), ADDRESS3 (type 3) or ADRSWA_IN (type SPACE) depending on the address type.

NUMBER_OF_LINES (ADRSWA_IN-ANZZL)
Number of lines available for the address format. If the number of lines is not enough for the complete address format, lines are consecutively suppressed, according to the rules of the country. The parameter LINE_PRIORITY (ADRSWA_IN-PRIOR) overrules the standard line-suppression sequence.

LINE_PRIORITY (ADRSWA_IN-PRIOR)
If not SPACE, this field overrules the standard line-suppression sequence when the number of lines available ANZZL is insufficient.
The standard sequence is as follows:
Type 1: 'AP43RTLC2BSIO' (GB: 'APRT432CBSLIO')
Type 2: 'APRTLCBSIO' (GB: 'PRTCBSLIO')
Type 3: 'AP43RTLC2BSNDIO' (GB: 'APRT432CBSLNDIO')
where (if they occupy a line of their own):
A = title
P = compulsory empty line
4 = name 4
3 = name 3
R = region
T = district
D = department
L = country
C = postal code
2 = name 2
B = PO box
S = street or postbox
N = name (and title) of a living person
I = location
O = city

STREET_HAS_PRIORITY (ADRSWA_IN-WAREN)
'X': street has priority over PO box (e.g. delivery address)
' ': PO box has priority over street. This is the default value.

SENDER_COUNTRY (ADRSWA_IN-INLND)
Sender country key to determine whether the address is domestic or foreign.

RECEIVER_LANGUAGE (ADRSWA_IN-SPRAS)
Recipient language (if different from the language set for the recipient country; example Switzerland)

COUNTRY_NAME_IN_RECEIVER_LANGUAGE
Use recipient language for country name flag.

LANGUAGE_FOR_COUNTRY_NAME
Explicit specification of a language for the country name (e.g. always English for customs transit papers).

ADDRESS_NUMBER
Address number for the addresses for which there is an additional character set version in the central address table SADR (Japan). If the parameter is set, the address is reread and formatted instead of the actual address (e.g. customer).

Return parameters

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

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

A one-line data carrier short address is returned in the parameter ADDRESS_DATA_CARRIER (in the field ADRSWA_OUT-LINED). This usually consists of the postal code, city and country ID, formatted country-specifically.

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 was performed because some name fields were not filled.

General formatting rules

It is intended to take account of other internationally required, (above all in Asia) address attributes such as street supplement, building, floor, room. (above all in Asia) address attributes such as street supplement, building, floor, room.

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_HANDLE
ADDRESS_NOT_FOUND
ADDRESS_NUMBER
ADDRESS_PRINTFORM
ADDRESS_SHORT_FORM
ADDRESS_TYPE
BLK_EXCPT
COUNTRY_NAME_IN_RECEIVER_LANGU
EV_EXIT_CAUSED_BY_CALLER
EV_EXIT_CAUSED_BY_USER
IS_BUPA_TIME_DEPENDENCY
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

ABAP Short Reference   Fill RESBD Structure from EBP Component Structure  
This documentation is copyright by SAP AG.

Length: 28614 Date: 20240523 Time: 094602     sap01-206 ( 256 ms )