Frames | No Frames

Return to Stylus Studio EDIFACT home page.
Return to Stylus Studio EDIFACT D03B Messages page.
UN/EDIFACT
UNITED NATIONS STANDARD MESSAGE (UNSM)

Application error and acknowledgement message

Version:D
Release:03B
Contr. Agency:UN
Revision:4
Date:2003-12-22
SOURCE:TBG3 Transport

CONTENTS
Application error and acknowledgement message
  1. INTRODUCTION
  2. SCOPE
    1. Functional definition
    2. Field of application
    3. Principles
  3. REFERENCES
  4. TERMS AND DEFINITIONS
    1. Standard terms and definitions
  5. MESSAGE DEFINITION
    1. Segment clarification
    2. Segment index (alphabetical sequence by tag)
    3. Message structure
      1. Segment table

For general information on UN standard message types see UN Trade Data Interchange Directory, UNTDID, Part 4, Section 2.3, UN/ECE UNSM General Introduction


This message also occurs in the following versions of this standard:
D95A, D95B, D96A, D96B, D97A, D97B, D98A, D98B, D99A, D99B, D00A, D00B, D01A, D01B, D01C, D02A, D02B, D03A, D03B, D04A, D04B

0. INTRODUCTION

This specification provides the definition of the Application error and acknowledgement message (APERAK) to be used in Electronic Data Interchange (EDI) between trading partners involved in administration, commerce and transport.


1. SCOPE


1.1. Functional definition

The function of this message is:

  1. to inform a message issuer that his message has been received by the addressee's application and has been rejected due to errors encountered during its processing in the application.
  2. to acknowledge to a message issuer the receipt of his message by the addressee's application.

1.2. Field of application

The Application error and acknowledgement message may be used for both national and international applications. It is based on universal practice related to administration, commerce and transport, and is not dependent on the type of business or industry.


1.3. Principles

A message being first controlled at system level (CONTRL) to detect syntax errors and to acknowledge its receipt is then transmitted to the application process to be processed.

If an error is detected at the application level, which prevents its complete processing, an APERAK message is sent to the original message issuer giving details of the error(s) encountered. If no error has been detected and when an acknowledgement is necessary (when no dedicated answer to the original message exists) an APERAK message is sent precising the reasons of acknowledgement. In case of application error, the APERAK message will need manual processing e.g. when the underlying reason is a programming error.

In case of acknowledgement the APERAK message may be automatically or manually processed at recipient's discretion.


2. REFERENCES

See UNTDID, Part 4, Chapter 2.3 UN/ECE UNSM - General Introduction, Section 1.


3. TERMS AND DEFINITIONS


3.1. Standard terms and definitions

See UNTDID, Part 4, Chapter 2.3 UN/ECE UNSM - General Introduction, Section 2.


4. MESSAGE DEFINITION


4.1. Segment clarification

This section should be read in conjunction with the segment table which indicates mandatory, conditional and repeating requirements.

0010 UNH, Message header

A service segment starting and uniquely identifying a message. The message type code for the Application error and acknowledgement message is APERAK.

Note: Application error and acknowledgement messages conforming to this document must contain the following data in segment UNH, composite S009:

Data element0065APERAK
0052D
005403B
0051UN

0020 BGM, Beginning of message

A segment to indicate the type and function of the message and to transmit the identifying number.

0030 DTM, Date/time/period

A segment to specify related date/time.

0040 FTX, Free text

A segment to specify free form or processable supplementary information related to the whole message. In computer-to-computer exchanges free form text will normally require the receiver to process this segment manually.

0050 CNT, Control total

A segment to provide message control totals.

0060 Segment Group 1: DOC-DTM

A segment group to provide information on the document being acknowledged.

0070 DOC, Document/message details

A segment to provide the necessary identification information about the document being acknowledged.

0080 DTM, Date/time/period

A segment to provide the relevant dates concerning the document being acknowledged.

0090 Segment Group 2: RFF-DTM

A group of segments to specify the document/message to which the current message relates, and related date and time.

0100 RFF, Reference

A segment to indicate the reference number of the document/message.

0110 DTM, Date/time/period

A segment to specify the date and time of the referenced document/message.

0120 Segment Group 3: NAD-CTA-COM

A group of segments to specify the identifications of message sender and message receiver with their contacts and communication channels.

0130 NAD, Name and address

A segment to specify the identification of the message issuer and message receiver.

0140 CTA, Contact information

A segment to specify a person or department inside the party's organization, to which communication should be directed.

0150 COM, Communication contact

A segment to indicate communication channel type and number inside the party's organization, to which communication should be directed.

0160 Segment Group 4: ERC-FTX-SG5

A group of segments to identify the application error(s) within a specified received message and to give specific details related to the error type or to precise the type of acknowledgement.

0170 ERC, Application error information

A segment identifying the type of application error or acknowledgement within the referenced message. In case of an error, the error code may specify the error in detail (e.g. a measurement relating to a piece of equipment is wrong) or as a rough indication (e.g. a measurement is wrong).

0180 FTX, Free text

A segment to provide explanation and/or supplementary information related to the specified application error or acknowledgement. For example, the explanation may provide exact details relating to a generic error code.

0190 Segment Group 5: RFF-FTX

A group of segments to specify the functional entity reference (e.g. goods item level, equipment level) relating to the specified error; further details can be added to identify the error more precisely.

0200 RFF, Reference

A segment to provide a reference relating to the acknowledgement type or the specified error (e.g. functional entity reference such as equipment level).

0210 FTX, Free text

A segment to provide additional details relating to the reference, e.g. the content of the wrong data (and its exact place in the message).

0220 UNT, Message trailer

A service segment ending a message, giving the total number of segments in the message (including the UNH & UNT) and the control reference number of the message.


4.2. Segment index (alphabetical sequence by tag)

BGM Beginning of message
CNT Control total
COM Communication contact
CTA Contact information
DOC Document/message details
DTM Date/time/period
ERC Application error information
FTX Free text
NAD Name and address
RFF Reference
UNH Message header
UNT Message trailer

4.3. Message structure


4.3.1. Segment table

├─UNH Message header ×1 (M)
├─BGM Beginning of message ×1 (M)
├─DTM Date/time/period ×9 (C)
├─FTX Free text ×9 (C)
├─CNT Control total ×9 (C)
├─Segment Group 1 ×99 (C)
├─DOC Document/message details ×1 (M)
└─DTM Date/time/period ×99 (C)
├─Segment Group 2 ×9 (C)
├─RFF Reference ×1 (M)
└─DTM Date/time/period ×9 (C)
├─Segment Group 3 ×9 (C)
├─NAD Name and address ×1 (M)
├─CTA Contact information ×9 (C)
└─COM Communication contact ×9 (C)
├─Segment Group 4 ×99999 (C)
├─ERC Application error information ×1 (M)
├─FTX Free text ×1 (C)
└─Segment Group 5 ×9 (C)
──├─RFF Reference ×1 (M)
──└─FTX Free text ×9 (C)
└─UNT Message trailer ×1 (M)

Return to Stylus Studio EDIFACT D03B Messages page.
EDI to XML Mapping for EDIFACT/X12 Convert EDIFACT/X12 Schemas to XML Schema Legacy Data Conversion Tools Access Relational Data as XML Visual XSLT and XQuery Mapping Tools Simplify Legacy Data Integration with Stylus Studio XML Enterprise Edition - Free Download!
Return to Stylus Studio EDIFACT home page.

Return to Stylus Studio home page.
Site Map | Privacy Policy | Terms of Use | Trademarks
Stylus Scoop XML Newsletter:
W3C Member
Stylus Studio® and DataDirect XQuery ™are from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2011 All Rights Reserved.