Class MT202COV

  • All Implemented Interfaces:
    JsonSerializable, java.io.Serializable

    @Generated
    public class MT202COV
    extends AbstractMT
    implements java.io.Serializable
    MT 202COV - General Financial Institution Transfer.

    SWIFT MT202COV (ISO 15022) message structure:

    • Sequence A (M)
      • Field 20 (M)
      • Field 21 (M)
      • Field 13 C (O) (repetitive)
      • Field 32 A (M)
      • Field 52 A,D (O)
      • Field 53 A,B,D (O)
      • Field 54 A,B,D (O)
      • Field 56 A,D (O)
      • Field 57 A,B,D (O)
      • Field 58 A,D (M)
      • Field 72 (O)
    • Sequence B (M)
      • Field 50 A,F,K (M)
      • Field 52 A,D (O)
      • Field 56 A,C,D (O)
      • Field 57 A,B,C,D (O)
      • Field 59 A,F,NONE (M)
      • Field 70 (O)
      • Field 72 (O)
      • Field 33 B (O)

    This source code is specific to release SRU 2022

    For additional resources check https://www.prowidesoftware.com/resources

    See Also:
    Serialized Form
    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  MT202COV.SequenceA
      Class to model Sequence "A" in MT 202COV.
      static class  MT202COV.SequenceB
      Class to model Sequence "B" in MT 202COV.
    • Field Summary

      Fields 
      Modifier and Type Field 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 Description
      MT202COV()
      Creates and initializes a new MT202COV input message setting TEST BICS as sender and receiver.
      MT202COV​(MtSwiftMessage m)
      Creates an MT202COV initialized with the parameter MtSwiftMessage.
      MT202COV​(SwiftMessage m)
      Creates an MT202COV initialized with the parameter SwiftMessage.
      MT202COV​(java.io.File file)
      Creates a new MT202COV by parsing a file with the message content in its swift FIN format.
      MT202COV​(java.io.InputStream stream)
      Creates a new MT202COV by parsing a input stream with the message content in its swift FIN format, using "UTF-8" as encoding.
      MT202COV​(java.lang.String fin)
      Creates a new MT202COV by parsing a String with the message content in its swift FIN format.
      MT202COV​(java.lang.String sender, java.lang.String receiver)
      Creates and initializes a new MT202COV input message from sender to receiver.
    • 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

      • MT202COV

        public MT202COV​(SwiftMessage m)
        Creates an MT202COV initialized with the parameter SwiftMessage.
        Parameters:
        m - swift message with the MT202COV content
      • MT202COV

        public MT202COV​(MtSwiftMessage m)
        Creates an MT202COV initialized with the parameter MtSwiftMessage.
        Parameters:
        m - swift message with the MT202COV content, the parameter can not be null
        See Also:
        MT202COV(String)
      • MT202COV

        public MT202COV()
        Creates and initializes a new MT202COV input message setting TEST BICS as sender and receiver. All mandatory header attributes are completed with default values.
        Since:
        7.6
      • MT202COV

        public MT202COV​(java.lang.String sender,
                        java.lang.String receiver)
        Creates and initializes a new MT202COV 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
      • MT202COV

        public MT202COV​(java.lang.String fin)
        Creates a new MT202COV 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
      • MT202COV

        public MT202COV​(java.io.InputStream stream)
                 throws java.io.IOException
        Creates a new MT202COV 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
      • MT202COV

        public MT202COV​(java.io.File file)
                 throws java.io.IOException
        Creates a new MT202COV 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 MT202COV parse​(MtSwiftMessage m)
        Creates an MT202COV initialized with the parameter MtSwiftMessage.
        Parameters:
        m - swift message with the MT202COV content
        Returns:
        the created object or null if the parameter is null
        Since:
        7.7
        See Also:
        MT202COV(String)
      • parse

        public static MT202COV parse​(java.lang.String fin)
        Creates a new MT202COV by parsing a String with the message content in its swift FIN format. If the fin parameter cannot be parsed, the returned MT202COV 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 MT202COV or null if fin is null
        Since:
        7.7
      • parse

        public static MT202COV parse​(java.io.InputStream stream)
                              throws java.io.IOException
        Creates a new MT202COV 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 MT202COV 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 MT202COV parse​(java.io.File file)
                              throws java.io.IOException
        Creates a new MT202COV 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 MT202COV 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
      • getUETR

        public java.lang.String getUETR()
        Gets the Unique End to End Transaction Reference (field 121 from block 3).

        This field is used by the SWIFT gpi service to track payments messages.

        Returns:
        the UETR value or null if block3 or field 121 in block3 are not present
        Since:
        7.10.0
      • append

        public MT202COV 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 MT202COV 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 MT202COV 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 MT202COV fromJson​(java.lang.String json)
        Creates an MT202COV messages from its JSON representation.

        For generic conversion of JSON into the corresponding MT instance see AbstractMT.fromJson(String)

        Parameters:
        json - a JSON representation of an MT202COV message
        Returns:
        a new instance of MT202COV
        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 MT202COV 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)
      • getField21

        public Field21 getField21()
        Iterates through block4 fields and return the first one whose name matches 21, or null if none is found. The first occurrence of field 21 at MT202COV is expected to be the only one.
        Returns:
        a Field21 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 MT202COV 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)
      • 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 MT202COV 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 MT202COV 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 MT202COV 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 MT202COV 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 MT202COV 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 MT202COV 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)
      • getField58A

        public Field58A getField58A()
        Iterates through block4 fields and return the first one whose name matches 58A, or null if none is found. The first occurrence of field 58A at MT202COV is expected to be the only one.
        Returns:
        a Field58A object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField58D

        public Field58D getField58D()
        Iterates through block4 fields and return the first one whose name matches 58D, or null if none is found. The first occurrence of field 58D at MT202COV is expected to be the only one.
        Returns:
        a Field58D object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField50A

        public Field50A getField50A()
        Iterates through block4 fields and return the first one whose name matches 50A, or null if none is found. The first occurrence of field 50A at MT202COV is expected to be the only one.
        Returns:
        a Field50A object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField50F

        public Field50F getField50F()
        Iterates through block4 fields and return the first one whose name matches 50F, or null if none is found. The first occurrence of field 50F at MT202COV is expected to be the only one.
        Returns:
        a Field50F object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField50K

        public Field50K getField50K()
        Iterates through block4 fields and return the first one whose name matches 50K, or null if none is found. The first occurrence of field 50K at MT202COV is expected to be the only one.
        Returns:
        a Field50K object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField56C

        public Field56C getField56C()
        Iterates through block4 fields and return the first one whose name matches 56C, or null if none is found. The first occurrence of field 56C at MT202COV is expected to be the only one.
        Returns:
        a Field56C object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField57C

        public Field57C getField57C()
        Iterates through block4 fields and return the first one whose name matches 57C, or null if none is found. The first occurrence of field 57C at MT202COV is expected to be the only one.
        Returns:
        a Field57C object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField59A

        public Field59A getField59A()
        Iterates through block4 fields and return the first one whose name matches 59A, or null if none is found. The first occurrence of field 59A at MT202COV is expected to be the only one.
        Returns:
        a Field59A object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField59F

        public Field59F getField59F()
        Iterates through block4 fields and return the first one whose name matches 59F, or null if none is found. The first occurrence of field 59F at MT202COV is expected to be the only one.
        Returns:
        a Field59F object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField59

        public Field59 getField59()
        Iterates through block4 fields and return the first one whose name matches 59, or null if none is found. The first occurrence of field 59 at MT202COV is expected to be the only one.
        Returns:
        a Field59 object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField70

        public Field70 getField70()
        Iterates through block4 fields and return the first one whose name matches 70, or null if none is found. The first occurrence of field 70 at MT202COV is expected to be the only one.
        Returns:
        a Field70 object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField33B

        public Field33B getField33B()
        Iterates through block4 fields and return the first one whose name matches 33B, or null if none is found. The first occurrence of field 33B at MT202COV is expected to be the only one.
        Returns:
        a Field33B object or null if the field is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagByName(String)
      • getField13C

        public java.util.List<Field13C> getField13C()
        Iterates through block4 fields and return all occurrences of fields whose names matches 13C, or Collections.emptyList() if none is found. Multiple occurrences of field 13C at MT202COV are expected at one sequence or across several sequences.
        Returns:
        a List of Field13C objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)
      • getField52A

        public java.util.List<Field52A> getField52A()
        Iterates through block4 fields and return all occurrences of fields whose names matches 52A, or Collections.emptyList() if none is found. Multiple occurrences of field 52A at MT202COV are expected at one sequence or across several sequences.
        Returns:
        a List of Field52A objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)
      • getField52D

        public java.util.List<Field52D> getField52D()
        Iterates through block4 fields and return all occurrences of fields whose names matches 52D, or Collections.emptyList() if none is found. Multiple occurrences of field 52D at MT202COV are expected at one sequence or across several sequences.
        Returns:
        a List of Field52D objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)
      • getField56A

        public java.util.List<Field56A> getField56A()
        Iterates through block4 fields and return all occurrences of fields whose names matches 56A, or Collections.emptyList() if none is found. Multiple occurrences of field 56A at MT202COV are expected at one sequence or across several sequences.
        Returns:
        a List of Field56A objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)
      • getField56D

        public java.util.List<Field56D> getField56D()
        Iterates through block4 fields and return all occurrences of fields whose names matches 56D, or Collections.emptyList() if none is found. Multiple occurrences of field 56D at MT202COV are expected at one sequence or across several sequences.
        Returns:
        a List of Field56D objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)
      • getField57A

        public java.util.List<Field57A> getField57A()
        Iterates through block4 fields and return all occurrences of fields whose names matches 57A, or Collections.emptyList() if none is found. Multiple occurrences of field 57A at MT202COV are expected at one sequence or across several sequences.
        Returns:
        a List of Field57A objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)
      • getField57B

        public java.util.List<Field57B> getField57B()
        Iterates through block4 fields and return all occurrences of fields whose names matches 57B, or Collections.emptyList() if none is found. Multiple occurrences of field 57B at MT202COV are expected at one sequence or across several sequences.
        Returns:
        a List of Field57B objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)
      • getField57D

        public java.util.List<Field57D> getField57D()
        Iterates through block4 fields and return all occurrences of fields whose names matches 57D, or Collections.emptyList() if none is found. Multiple occurrences of field 57D at MT202COV are expected at one sequence or across several sequences.
        Returns:
        a List of Field57D objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)
      • getField72

        public java.util.List<Field72> getField72()
        Iterates through block4 fields and return all occurrences of fields whose names matches 72, or Collections.emptyList() if none is found. Multiple occurrences of field 72 at MT202COV are expected at one sequence or across several sequences.
        Returns:
        a List of Field72 objects or Collections.emptyList() if none is not found
        Throws:
        java.lang.IllegalStateException - if SwiftMessage object is not initialized
        See Also:
        SwiftTagListBlock.getTagsByName(String)
      • getSequenceA

        @SequenceStyle(GENERATED_FIXED_WITH_OPTIONAL_TAIL)
        public MT202COV.SequenceA getSequenceA()
        Get the single occurrence of SequenceA delimited by leading tag and end, with an optional tail. The presence of this method indicates that this sequence can occur only once according to the Standard. If block 4 is empty this method returns null.
        Returns:
        the found sequence or an empty sequence if none is found
        See Also:
        SwiftTagListBlock.getSubBlockDelimitedWithOptionalTail(String[], String[], String[])
      • getSequenceA

        @SequenceStyle(GENERATED_FIXED_WITH_OPTIONAL_TAIL)
        public MT202COV.SequenceA getSequenceA​(SwiftTagListBlock parentSequence)
        Get the single occurrence of SequenceA delimited by leading tag and end, with an optional tail. The presence of this method indicates that this sequence can occur only once according to the Standard. If block 4 is empty this method returns null.
        Parameters:
        parentSequence - a not null parent sequence to find SequenceA within it
        Returns:
        the found sequence or an empty sequence if none is found, or null if the parent sequence is null or empty
        Since:
        7.7
        See Also:
        SwiftTagListBlock.getSubBlockDelimitedWithOptionalTail(String[], String[], String[])
      • getSequenceB

        @SequenceStyle(GENERATED_FIXED_WITH_OPTIONAL_TAIL)
        public MT202COV.SequenceB getSequenceB()
        Get the single occurrence of SequenceB delimited by leading tag and end, with an optional tail. The presence of this method indicates that this sequence can occur only once according to the Standard. If block 4 is empty this method returns null.
        Returns:
        the found sequence or an empty sequence if none is found
        See Also:
        SwiftTagListBlock.getSubBlockDelimitedWithOptionalTail(String[], String[], String[])
      • getSequenceB

        @SequenceStyle(GENERATED_FIXED_WITH_OPTIONAL_TAIL)
        public MT202COV.SequenceB getSequenceB​(SwiftTagListBlock parentSequence)
        Get the single occurrence of SequenceB delimited by leading tag and end, with an optional tail. The presence of this method indicates that this sequence can occur only once according to the Standard. If block 4 is empty this method returns null.
        Parameters:
        parentSequence - a not null parent sequence to find SequenceB within it
        Returns:
        the found sequence or an empty sequence if none is found, or null if the parent sequence is null or empty
        Since:
        7.7
        See Also:
        SwiftTagListBlock.getSubBlockDelimitedWithOptionalTail(String[], String[], String[])