MT802 (Prowide Core API Reference)

java.lang.Object
- com.prowidesoftware.swift.model.AbstractMessage
- - com.prowidesoftware.swift.model.mt.AbstractMT
  - - com.prowidesoftware.swift.model.mt.mt8xx.MT802

All Implemented Interfaces:

JsonSerializable, java.io.Serializable
```
@Generated
public class MT802
extends AbstractMT
implements java.io.Serializable
```
MT 802 - T/C Settlement Advice
SWIFT MT802 (ISO 15022) message structure:
- Field 20 (M)
- Field 28 (M)
- Field 32 A (M)
- Field 52 A,D (O)
- Field 53 A,B,D (O)
- Field 54 A,B,D (O)
- Field 72 (O)
This source code is specific to release SRU 2018
For additional resources check https://www.prowidesoftware.com/resources
See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`NAME` Constant for MT name, this is part of the classname, after `MT`
`static int`	`SRU` Constant identifying the SRU to which this class belongs to.

Fields inherited from class com.prowidesoftware.swift.model.mt.AbstractMT
m

Constructor Summary

Constructors
Constructor and Description
`MT802()` Creates and initializes a new MT802 input message setting TEST BICS as sender and receiver. All mandatory header attributes are completed with default values.
`MT802(java.io.File file)` Creates a new MT802 by parsing a file with the message content in its swift FIN format. If the file content is null or cannot be parsed as a message, the internal message object will be initialized (blocks will be created) but empty. If the file contains multiple messages, only the first one will be parsed.
`MT802(java.io.InputStream stream)` Creates a new MT802 by parsing a input stream with the message content in its swift FIN format, using "UTF-8" as encoding. If the message content is null or cannot be parsed, the internal message object will be initialized (blocks will be created) but empty. If the stream contains multiple messages, only the first one will be parsed.
`MT802(int messageType, java.lang.String sender, java.lang.String receiver)` Deprecated. Use instead `new MT802(sender, receiver)` instead
`MT802(MtSwiftMessage m)` Creates an MT802 initialized with the parameter MtSwiftMessage.
`MT802(java.lang.String fin)` Creates a new MT802 by parsing a String with the message content in its swift FIN format. If the fin parameter is null or the message cannot be parsed, the internal message object will be initialized (blocks will be created) but empty. If the string contains multiple messages, only the first one will be parsed.
`MT802(java.lang.String sender, java.lang.String receiver)` Creates and initializes a new MT802 input message from sender to receiver. All mandatory header attributes are completed with default values.
`MT802(SwiftMessage m)` Creates an MT802 initialized with the parameter SwiftMessage

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`MT802`	`append(Field... fields)` Add all the fields to the end of the block4.
`MT802`	`append(SwiftTagListBlock block)` Add all tags from block to the end of the block4.
`MT802`	`append(Tag... tags)` Add all tags to the end of the block4.
`static MT802`	`fromJson(java.lang.String json)` Creates an MT802 messages from its JSON representation.
`Field20`	`getField20()` Iterates through block4 fields and return the first one whose name matches 20, or null if none is found. The first occurrence of field 20 at MT802 is expected to be the only one.
`Field28`	`getField28()` Iterates through block4 fields and return the first one whose name matches 28, or null if none is found. The first occurrence of field 28 at MT802 is expected to be the only one.
`Field32A`	`getField32A()` Iterates through block4 fields and return the first one whose name matches 32A, or null if none is found. The first occurrence of field 32A at MT802 is expected to be the only one.
`Field52A`	`getField52A()` Iterates through block4 fields and return the first one whose name matches 52A, or null if none is found. The first occurrence of field 52A at MT802 is expected to be the only one.
`Field52D`	`getField52D()` Iterates through block4 fields and return the first one whose name matches 52D, or null if none is found. The first occurrence of field 52D at MT802 is expected to be the only one.
`Field53A`	`getField53A()` Iterates through block4 fields and return the first one whose name matches 53A, or null if none is found. The first occurrence of field 53A at MT802 is expected to be the only one.
`Field53B`	`getField53B()` Iterates through block4 fields and return the first one whose name matches 53B, or null if none is found. The first occurrence of field 53B at MT802 is expected to be the only one.
`Field53D`	`getField53D()` Iterates through block4 fields and return the first one whose name matches 53D, or null if none is found. The first occurrence of field 53D at MT802 is expected to be the only one.
`Field54A`	`getField54A()` Iterates through block4 fields and return the first one whose name matches 54A, or null if none is found. The first occurrence of field 54A at MT802 is expected to be the only one.
`Field54B`	`getField54B()` Iterates through block4 fields and return the first one whose name matches 54B, or null if none is found. The first occurrence of field 54B at MT802 is expected to be the only one.
`Field54D`	`getField54D()` Iterates through block4 fields and return the first one whose name matches 54D, or null if none is found. The first occurrence of field 54D at MT802 is expected to be the only one.
`Field72`	`getField72()` Iterates through block4 fields and return the first one whose name matches 72, or null if none is found. The first occurrence of field 72 at MT802 is expected to be the only one.
`java.lang.String`	`getMessageType()` Returns this MT number
`static MT802`	`parse(java.io.File file)` Creates a new MT802 by parsing a file with the message content in its swift FIN format. If the file contains multiple messages, only the first one will be parsed.
`static MT802`	`parse(java.io.InputStream stream)` Creates a new MT802 by parsing a input stream with the message content in its swift FIN format, using "UTF-8" as encoding. If the stream contains multiple messages, only the first one will be parsed.
`static MT802`	`parse(MtSwiftMessage m)` Creates an MT802 initialized with the parameter MtSwiftMessage.
`static MT802`	`parse(java.lang.String fin)` Creates a new MT802 by parsing a String with the message content in its swift FIN format. If the fin parameter cannot be parsed, the returned MT802 will have its internal message object initialized (blocks will be created) but empty. If the string contains multiple messages, only the first one will be parsed.

Methods inherited from class com.prowidesoftware.swift.model.mt.AbstractMT
addField, containsSequence, containsSequenceList, create, create, getApplicationId, getFields, getLogicalTerminal, getMessagePriority, getMtId, getReceiver, getSender, getSequence, getSequence, getSequence, getSequenceList, getSequenceList, getSequenceNumber, getServiceId, getSessionNumber, getSwiftMessage, getSwiftMessageNotNullOrException, getVariant, isIncoming, isInput, isOutgoing, isOutput, isType, json, message, nameFromClass, read, setReceiver, setReceiver, setSender, setSender, setSwiftMessage, tag, tags, toJson, toString, write, write, xml

Methods inherited from class com.prowidesoftware.swift.model.AbstractMessage
getMessageStandardType, isMT, isMX

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - SRU
```
public static final int SRU
```
    Constant identifying the SRU to which this class belongs to.
    
    See Also:
    
    Constant Field Values
  - NAME
```
public static final java.lang.String NAME
```
    Constant for MT name, this is part of the classname, after MT
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - MT802
```
public MT802(SwiftMessage m)
```
    Creates an MT802 initialized with the parameter SwiftMessage
    
    Parameters:
    
    m - swift message with the MT802 content
  - MT802
```
public MT802(MtSwiftMessage m)
```
    Creates an MT802 initialized with the parameter MtSwiftMessage.
    
    Parameters:
    
    m - swift message with the MT802 content, the parameter can not be null
    
    See Also:
    
    MT802(String)
  - MT802
```
public MT802()
```
    Creates and initializes a new MT802 input message setting TEST BICS as sender and receiver.
    All mandatory header attributes are completed with default values.
    
    Since:
    
    7.6
  - MT802
```
public MT802(java.lang.String sender,
             java.lang.String receiver)
```
    Creates and initializes a new MT802 input message from sender to receiver.
    All mandatory header attributes are completed with default values. In particular the sender and receiver addresses will be filled with proper default LT identifier and branch codes if not provided,
    
    Parameters:
    
    sender - the sender address as a bic8, bic11 or full logical terminal consisting of 12 characters
    
    receiver - the receiver address as a bic8, bic11 or full logical terminal consisting of 12 characters
    
    Since:
    
    7.7
  - MT802
```
@Deprecated
 @ProwideDeprecated(phase4=_2019)
public MT802(int messageType,
                                                           java.lang.String sender,
                                                           java.lang.String receiver)
```
    Deprecated. Use instead new MT802(sender, receiver) instead
    
    DO NOT USE THIS METHOD It is kept for compatibility but will be removed very soon, since the messageType parameter is actually ignored.
    
    Parameters:
    
    messageType - the message type number
    
    sender - the sender address as a bic8, bic11 or full logical terminal consisting of 12 characters
    
    receiver - the receiver address as a bic8, bic11 or full logical terminal consisting of 12 characters
    
    See Also:
    
    MT802(String, String)
  - MT802
```
public MT802(java.lang.String fin)
```
    Creates a new MT802 by parsing a String with the message content in its swift FIN format.
    If the fin parameter is null or the message cannot be parsed, the internal message object will be initialized (blocks will be created) but empty.
    If the string contains multiple messages, only the first one will be parsed.
    
    Parameters:
    
    fin - a string with the MT message in its FIN swift format
    
    Since:
    
    7.7
  - MT802
```
public MT802(java.io.InputStream stream)
      throws java.io.IOException
```
    Creates a new MT802 by parsing a input stream with the message content in its swift FIN format, using "UTF-8" as encoding.
    If the message content is null or cannot be parsed, the internal message object will be initialized (blocks will be created) but empty.
    If the stream contains multiple messages, only the first one will be parsed.
    
    Parameters:
    
    stream - an input stream in UTF-8 encoding with the MT message in its FIN swift format.
    
    Throws:
    
    java.io.IOException - if the stream data cannot be read
    
    Since:
    
    7.7
  - MT802
```
public MT802(java.io.File file)
      throws java.io.IOException
```
    Creates a new MT802 by parsing a file with the message content in its swift FIN format.
    If the file content is null or cannot be parsed as a message, the internal message object will be initialized (blocks will be created) but empty.
    If the file contains multiple messages, only the first one will be parsed.
    
    Parameters:
    
    file - a file with the MT message in its FIN swift format.
    
    Throws:
    
    java.io.IOException - if the file content cannot be read
    
    Since:
    
    7.7
- Method Detail
  - parse
```
public static MT802 parse(MtSwiftMessage m)
```
    Creates an MT802 initialized with the parameter MtSwiftMessage.
    
    Parameters:
    
    m - swift message with the MT802 content
    
    Returns:
    
    the created object or null if the parameter is null
    
    Since:
    
    7.7
    
    See Also:
    
    MT802(String)
  - parse
```
public static MT802 parse(java.lang.String fin)
```
    Creates a new MT802 by parsing a String with the message content in its swift FIN format.
    If the fin parameter cannot be parsed, the returned MT802 will have its internal message object initialized (blocks will be created) but empty.
    If the string contains multiple messages, only the first one will be parsed.
    
    Parameters:
    
    fin - a string with the MT message in its FIN swift format. fin may be null in which case this method returns null
    
    Returns:
    
    a new instance of MT802 or null if fin is null
    
    Since:
    
    7.7
  - parse
```
public static MT802 parse(java.io.InputStream stream)
                   throws java.io.IOException
```
    Creates a new MT802 by parsing a input stream with the message content in its swift FIN format, using "UTF-8" as encoding.
    If the stream contains multiple messages, only the first one will be parsed.
    
    Parameters:
    
    stream - an input stream in UTF-8 encoding with the MT message in its FIN swift format.
    
    Returns:
    
    a new instance of MT802 or null if stream is null or the message cannot be parsed
    
    Throws:
    
    java.io.IOException - if the stream data cannot be read
    
    Since:
    
    7.7
  - parse
```
public static MT802 parse(java.io.File file)
                   throws java.io.IOException
```
    Creates a new MT802 by parsing a file with the message content in its swift FIN format.
    If the file contains multiple messages, only the first one will be parsed.
    
    Parameters:
    
    file - a file with the MT message in its FIN swift format.
    
    Returns:
    
    a new instance of MT802 or null if; file is null, does not exist, can't be read, is not a file or the message cannot be parsed
    
    Throws:
    
    java.io.IOException - if the file content cannot be read
    
    Since:
    
    7.7
  - getMessageType
```
public java.lang.String getMessageType()
```
    Returns this MT number
    
    Specified by:
    
    getMessageType in class AbstractMT
    
    Returns:
    
    the message type number of this MT
    
    Since:
    
    6.4
  - append
```
public MT802 append(SwiftTagListBlock block)
```
    Add all tags from block to the end of the block4.
    
    Overrides:
    
    append in class AbstractMT
    
    Parameters:
    
    block - to append
    
    Returns:
    
    this object to allow method chaining
    
    Since:
    
    7.6
  - append
```
public MT802 append(Tag... tags)
```
    Add all tags to the end of the block4.
    
    Overrides:
    
    append in class AbstractMT
    
    Parameters:
    
    tags - to append
    
    Returns:
    
    this object to allow method chaining
    
    Since:
    
    7.6
  - append
```
public MT802 append(Field... fields)
```
    Add all the fields to the end of the block4.
    
    Overrides:
    
    append in class AbstractMT
    
    Parameters:
    
    fields - to append
    
    Returns:
    
    this object to allow method chaining
    
    Since:
    
    7.6
  - fromJson
```
public static final MT802 fromJson(java.lang.String json)
```
    Creates an MT802 messages from its JSON representation.
    For generic conversion of JSON into the corresopnding MT instance see AbstractMT.fromJson(String)
    
    Parameters:
    
    json - a JSON representation of an MT802 message
    
    Returns:
    
    a new instance of MT802
    
    Since:
    
    7.10.3
  - getField20
```
public Field20 getField20()
```
    Iterates through block4 fields and return the first one whose name matches 20, or null if none is found.
    The first occurrence of field 20 at MT802 is expected to be the only one.
    
    Returns:
    
    a Field20 object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField28
```
public Field28 getField28()
```
    Iterates through block4 fields and return the first one whose name matches 28, or null if none is found.
    The first occurrence of field 28 at MT802 is expected to be the only one.
    
    Returns:
    
    a Field28 object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField32A
```
public Field32A getField32A()
```
    Iterates through block4 fields and return the first one whose name matches 32A, or null if none is found.
    The first occurrence of field 32A at MT802 is expected to be the only one.
    
    Returns:
    
    a Field32A object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField52A
```
public Field52A getField52A()
```
    Iterates through block4 fields and return the first one whose name matches 52A, or null if none is found.
    The first occurrence of field 52A at MT802 is expected to be the only one.
    
    Returns:
    
    a Field52A object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField52D
```
public Field52D getField52D()
```
    Iterates through block4 fields and return the first one whose name matches 52D, or null if none is found.
    The first occurrence of field 52D at MT802 is expected to be the only one.
    
    Returns:
    
    a Field52D object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField53A
```
public Field53A getField53A()
```
    Iterates through block4 fields and return the first one whose name matches 53A, or null if none is found.
    The first occurrence of field 53A at MT802 is expected to be the only one.
    
    Returns:
    
    a Field53A object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField53B
```
public Field53B getField53B()
```
    Iterates through block4 fields and return the first one whose name matches 53B, or null if none is found.
    The first occurrence of field 53B at MT802 is expected to be the only one.
    
    Returns:
    
    a Field53B object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField53D
```
public Field53D getField53D()
```
    Iterates through block4 fields and return the first one whose name matches 53D, or null if none is found.
    The first occurrence of field 53D at MT802 is expected to be the only one.
    
    Returns:
    
    a Field53D object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField54A
```
public Field54A getField54A()
```
    Iterates through block4 fields and return the first one whose name matches 54A, or null if none is found.
    The first occurrence of field 54A at MT802 is expected to be the only one.
    
    Returns:
    
    a Field54A object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField54B
```
public Field54B getField54B()
```
    Iterates through block4 fields and return the first one whose name matches 54B, or null if none is found.
    The first occurrence of field 54B at MT802 is expected to be the only one.
    
    Returns:
    
    a Field54B object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField54D
```
public Field54D getField54D()
```
    Iterates through block4 fields and return the first one whose name matches 54D, or null if none is found.
    The first occurrence of field 54D at MT802 is expected to be the only one.
    
    Returns:
    
    a Field54D object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)
  - getField72
```
public Field72 getField72()
```
    Iterates through block4 fields and return the first one whose name matches 72, or null if none is found.
    The first occurrence of field 72 at MT802 is expected to be the only one.
    
    Returns:
    
    a Field72 object or null if the field is not found
    
    Throws:
    
    java.lang.IllegalStateException - if SwiftMessage object is not initialized
    
    See Also:
    
    SwiftTagListBlock.getTagByName(String)

Class MT802

Field Summary

Fields inherited from class com.prowidesoftware.swift.model.mt.AbstractMT

Constructor Summary

Method Summary

Methods inherited from class com.prowidesoftware.swift.model.mt.AbstractMT

Methods inherited from class com.prowidesoftware.swift.model.AbstractMessage

Methods inherited from class java.lang.Object

Field Detail

SRU

NAME

Constructor Detail

MT802

MT802

MT802

MT802

MT802

MT802

MT802

MT802

Method Detail

parse

parse

parse

parse

getMessageType

append

append

append

fromJson

getField20

getField28

getField32A

getField52A

getField52D

getField53A

getField53B

getField53D

getField54A

getField54B

getField54D

getField72