InitialBaselineSubmissionV03

tsmt.019.001.03

Scope The InitialBaselineSubmission message is sent by the initiator of a transaction to the matching application. This message is used to initiate a transaction. Usage The InitialBaselineSubmission message can be sent by a party to register a transaction in the matching application. The message can be submitted with either lodge or push-through instruction. When the push-through instruction is present, the matching application acknowledges the receipt of the message to the sender by sending an Acknowledgement message, stores the submitted information and informs the counterparty about the registration of the transaction by sending a FullPushThroughReport message. With the BaselineReSubmission message the counterparty responds with matching baseline information in order to establish the transaction (baseline). When the lodge instruction is present, the matching application acknowledges the receipt of the message to the sender by sending an Acknowledgement message and stores the submitted information. No matching of the submitted baseline data with other baseline information will take place. For example the submission of an InitialBaselineSubmission message containing a lodge instruction establishes the transaction (baseline) in the matching application. The InitialBaselineSubmission message consists of data which relates to the purchasing agreement covered by the transaction, for example line item details, shipping details.

Message Construction

Every ISO20022 message has at the highest level what we call ‘building blocks’. Because the message is constructed as immutable records, the association is by composition. Below you can see the relationship between the message and its constituent building blocks: For comparison, see the ISO20022 official specification

classDiagram
     direction LR
%% InitialBaselineSubmissionV03 recursion level 0 with max 0
InitialBaselineSubmissionV03 *-- "1..1" MessageIdentification1 : SubmissionIdentification
InitialBaselineSubmissionV03 *-- "1..1" SimpleIdentificationInformation : SubmitterTransactionReference
InitialBaselineSubmissionV03 *-- "1..1" InstructionType1 : Instruction
InitialBaselineSubmissionV03 *-- "1..1" Baseline3 : Baseline
InitialBaselineSubmissionV03 *-- "0..1" ContactIdentification1 : BuyerContactPerson
InitialBaselineSubmissionV03 *-- "0..1" ContactIdentification1 : SellerContactPerson
InitialBaselineSubmissionV03 *-- "1..1" ContactIdentification1 : BuyerBankContactPerson
InitialBaselineSubmissionV03 *-- "1..1" ContactIdentification1 : SellerBankContactPerson
InitialBaselineSubmissionV03 *-- "0..1" ContactIdentification3 : OtherBankContactPerson
  

Now, we will zero-in one-by-one on each of these building blocks.

SubmissionIdentification building block

Identifies the submitted information. Identifies a message by a unique identifier and the date and time when the message was created by the sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% MessageIdentification1 recursion level 0 with max 1
class MessageIdentification1{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}
  

MessageIdentification1 members

SubmitterTransactionReference building block

Reference to the transaction for the requesting financial institution. Information related to an identification, eg, party identification or account identification. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SimpleIdentificationInformation recursion level 0 with max 1
class SimpleIdentificationInformation{
    Identification IsoMax35Text
}
  

SimpleIdentificationInformation members

Instruction building block

Specifies the instruction requested by the submitter by means of a code. Specifies the type of instruction requested by the submitter by means of a code. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% InstructionType1 recursion level 0 with max 1
class InstructionType1{
    Type InstructionType1Code
}
  

InstructionType1 members

Baseline building block

Specifies the commercial details of the underlying transaction. Specifies the commercial details of the underlying transaction. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Baseline3 recursion level 0 with max 1
class Baseline3{
    ServiceCode TradeFinanceService2Code
    LatestMatchDate IsoISODate
    IntentToPayExpected IsoYesNoIndicator
}
Baseline3 *-- "1..1" DocumentIdentification1 : SubmitterBaselineIdentification
Baseline3 *-- "1..1" DocumentIdentification7 : PurchaseOrderReference
Baseline3 *-- "1..1" PartyIdentification26 : Buyer
Baseline3 *-- "1..1" PartyIdentification26 : Seller
Baseline3 *-- "1..1" BICIdentification1 : BuyerBank
Baseline3 *-- "1..1" BICIdentification1 : SellerBank
Baseline3 *-- "0..0" BICIdentification1 : BuyerSideSubmittingBank
Baseline3 *-- "0..0" BICIdentification1 : SellerSideSubmittingBank
Baseline3 *-- "0..1" PartyIdentification26 : BillTo
Baseline3 *-- "0..1" PartyIdentification26 : ShipTo
Baseline3 *-- "0..1" PartyIdentification26 : Consignee
Baseline3 *-- "1..1" LineItem7 : Goods
Baseline3 *-- "1..0" PaymentTerms1 : PaymentTerms
Baseline3 *-- "0..1" SettlementTerms2 : SettlementTerms
Baseline3 *-- "0..0" PaymentObligation1 : PaymentObligation
Baseline3 *-- "1..1" RequiredSubmission2 : CommercialDataSetRequired
Baseline3 *-- "0..1" RequiredSubmission2 : TransportDataSetRequired
Baseline3 *-- "0..1" RequiredSubmission3 : InsuranceDataSetRequired
Baseline3 *-- "0..0" RequiredSubmission4 : CertificateDataSetRequired
Baseline3 *-- "0..0" RequiredSubmission5 : OtherCertificateDataSetRequired
%% DocumentIdentification1 recursion level 1 with max 1
class DocumentIdentification1{
    Identification IsoMax35Text
    Version IsoNumber
}
DocumentIdentification1 *-- "1..1" BICIdentification1 : Submitter
%% DocumentIdentification7 recursion level 1 with max 1
class DocumentIdentification7{
    Identification IsoMax35Text
    DateOfIssue IsoISODate
}
%% PartyIdentification26 recursion level 1 with max 1
class PartyIdentification26{
    Name IsoMax70Text
}
PartyIdentification26 *-- "0..1" GenericIdentification4 : ProprietaryIdentification
PartyIdentification26 *-- "1..1" PostalAddress5 : PostalAddress
%% PartyIdentification26 recursion level 1 with max 1
class PartyIdentification26{
    Name IsoMax70Text
}
PartyIdentification26 *-- "0..1" GenericIdentification4 : ProprietaryIdentification
PartyIdentification26 *-- "1..1" PostalAddress5 : PostalAddress
%% BICIdentification1 recursion level 1 with max 1
class BICIdentification1{
    BIC IsoBICIdentifier
}
%% BICIdentification1 recursion level 1 with max 1
class BICIdentification1{
    BIC IsoBICIdentifier
}
%% BICIdentification1 recursion level 1 with max 1
class BICIdentification1{
    BIC IsoBICIdentifier
}
%% BICIdentification1 recursion level 1 with max 1
class BICIdentification1{
    BIC IsoBICIdentifier
}
%% PartyIdentification26 recursion level 1 with max 1
class PartyIdentification26{
    Name IsoMax70Text
}
PartyIdentification26 *-- "0..1" GenericIdentification4 : ProprietaryIdentification
PartyIdentification26 *-- "1..1" PostalAddress5 : PostalAddress
%% PartyIdentification26 recursion level 1 with max 1
class PartyIdentification26{
    Name IsoMax70Text
}
PartyIdentification26 *-- "0..1" GenericIdentification4 : ProprietaryIdentification
PartyIdentification26 *-- "1..1" PostalAddress5 : PostalAddress
%% PartyIdentification26 recursion level 1 with max 1
class PartyIdentification26{
    Name IsoMax70Text
}
PartyIdentification26 *-- "0..1" GenericIdentification4 : ProprietaryIdentification
PartyIdentification26 *-- "1..1" PostalAddress5 : PostalAddress
%% LineItem7 recursion level 1 with max 1
class LineItem7{
    GoodsDescription IsoMax70Text
    PartialShipment IsoYesNoIndicator
    TransShipment IsoYesNoIndicator
    LineItemsTotalAmount IsoCurrencyAndAmount
    TotalNetAmount IsoCurrencyAndAmount
}
LineItem7 *-- "0..1" ShipmentDateRange1 : ShipmentDateRange
LineItem7 *-- "1..0" LineItemDetails7 : LineItemDetails
LineItem7 *-- "0..1" TransportMeans1 : RoutingSummary
LineItem7 *-- "0..0" Incoterms1 : Incoterms
LineItem7 *-- "0..0" Adjustment3 : Adjustment
LineItem7 *-- "0..1" Charge12 : FreightCharges
LineItem7 *-- "0..0" Tax13 : Tax
LineItem7 *-- "0..0" UserDefinedInformation1 : BuyerDefinedInformation
LineItem7 *-- "0..0" UserDefinedInformation1 : SellerDefinedInformation
%% PaymentTerms1 recursion level 1 with max 1
class PaymentTerms1{
    OtherPaymentTerms IsoMax140Text
    Percentage IsoPercentageRate
    Amount IsoCurrencyAndAmount
}
PaymentTerms1 *-- "1..1" PaymentPeriod1 : PaymentCode
%% SettlementTerms2 recursion level 1 with max 1
SettlementTerms2 *-- "0..1" IFinancialInstitutionIdentification4Choice : CreditorAgent
SettlementTerms2 *-- "1..1" CashAccount7 : CreditorAccount
%% PaymentObligation1 recursion level 1 with max 1
class PaymentObligation1{
    Amount IsoCurrencyAndAmount
    Percentage IsoPercentageRate
    ChargesAmount IsoCurrencyAndAmount
    ChargesPercentage IsoPercentageRate
    ExpiryDate IsoISODate
    ApplicableLaw CountryCode
}
PaymentObligation1 *-- "1..1" BICIdentification1 : ObligorBank
PaymentObligation1 *-- "1..1" BICIdentification1 : RecipientBank
PaymentObligation1 *-- "0..0" PaymentTerms2 : PaymentTerms
PaymentObligation1 *-- "0..1" SettlementTerms2 : SettlementTerms
%% RequiredSubmission2 recursion level 1 with max 1
RequiredSubmission2 *-- "1..0" BICIdentification1 : Submitter
%% RequiredSubmission2 recursion level 1 with max 1
RequiredSubmission2 *-- "1..0" BICIdentification1 : Submitter
%% RequiredSubmission3 recursion level 1 with max 1
class RequiredSubmission3{
    MatchIssueDate IsoYesNoIndicator
    MatchTransport IsoYesNoIndicator
    MatchAmount IsoYesNoIndicator
    ClausesRequired InsuranceClauses1Code
    MatchAssuredParty AssuredType1Code
}
RequiredSubmission3 *-- "1..0" BICIdentification1 : Submitter
RequiredSubmission3 *-- "0..1" PartyIdentification27 : MatchIssuer
%% RequiredSubmission4 recursion level 1 with max 1
class RequiredSubmission4{
    CertificateType TradeCertificateType1Code
    MatchIssueDate IsoYesNoIndicator
    MatchInspectionDate IsoYesNoIndicator
    AuthorisedInspectorIndicator IsoYesNoIndicator
    MatchConsignee IsoYesNoIndicator
    LineItemIdentification IsoMax70Text
}
RequiredSubmission4 *-- "1..0" BICIdentification1 : Submitter
RequiredSubmission4 *-- "0..1" PartyIdentification27 : MatchIssuer
RequiredSubmission4 *-- "0..1" PartyIdentification27 : MatchManufacturer
%% RequiredSubmission5 recursion level 1 with max 1
class RequiredSubmission5{
    CertificateType TradeCertificateType2Code
}
RequiredSubmission5 *-- "1..0" BICIdentification1 : Submitter
  

Baseline3 members

BuyerContactPerson building block

Person to be contacted in the organisation of the buyer. Information needed to contact a physical person. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ContactIdentification1 recursion level 0 with max 1
class ContactIdentification1{
    Name IsoMax35Text
    NamePrefix NamePrefix1Code
    GivenName IsoMax35Text
    Role IsoMax35Text
    PhoneNumber IsoPhoneNumber
    FaxNumber IsoPhoneNumber
    EmailAddress IsoMax256Text
}
  

ContactIdentification1 members

SellerContactPerson building block

Person to be contacted in the organisation of the seller. Information needed to contact a physical person. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ContactIdentification1 recursion level 0 with max 1
class ContactIdentification1{
    Name IsoMax35Text
    NamePrefix NamePrefix1Code
    GivenName IsoMax35Text
    Role IsoMax35Text
    PhoneNumber IsoPhoneNumber
    FaxNumber IsoPhoneNumber
    EmailAddress IsoMax256Text
}
  

ContactIdentification1 members

BuyerBankContactPerson building block

Person to be contacted in the buyer’s bank. Information needed to contact a physical person. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ContactIdentification1 recursion level 0 with max 1
class ContactIdentification1{
    Name IsoMax35Text
    NamePrefix NamePrefix1Code
    GivenName IsoMax35Text
    Role IsoMax35Text
    PhoneNumber IsoPhoneNumber
    FaxNumber IsoPhoneNumber
    EmailAddress IsoMax256Text
}
  

ContactIdentification1 members

SellerBankContactPerson building block

Person to be contacted in the seller’s bank. Information needed to contact a physical person. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ContactIdentification1 recursion level 0 with max 1
class ContactIdentification1{
    Name IsoMax35Text
    NamePrefix NamePrefix1Code
    GivenName IsoMax35Text
    Role IsoMax35Text
    PhoneNumber IsoPhoneNumber
    FaxNumber IsoPhoneNumber
    EmailAddress IsoMax256Text
}
  

ContactIdentification1 members

OtherBankContactPerson building block

Person to be contacted in another bank than seller or buyer’s bank. Information needed to contact a physical person. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ContactIdentification3 recursion level 0 with max 1
class ContactIdentification3{
    BIC IsoBICIdentifier
    Name IsoMax35Text
    NamePrefix NamePrefix1Code
    GivenName IsoMax35Text
    Role IsoMax35Text
    PhoneNumber IsoPhoneNumber
    FaxNumber IsoPhoneNumber
    EmailAddress IsoMax256Text
}
  

ContactIdentification3 members

Extensibility and generalization considerations

To facilitate generalized design patterns in the system, the InitialBaselineSubmissionV03 implementation follows a specific implementaiton pattern. First of all, InitialBaselineSubmissionV03 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, InitialBaselineSubmissionV03Document implements IOuterDocument. Because InitialBaselineSubmissionV03 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type InitialBaselineSubmissionV03.

classDiagram
    class IOuterRecord
    InitialBaselineSubmissionV03 --|> IOuterRecord : Implements
    InitialBaselineSubmissionV03Document --|> IOuterDocument~InitialBaselineSubmissionV03~ : Implements
    class IOuterDocument~InitialBaselineSubmissionV03~ {
        InitialBaselineSubmissionV03 Message
     }
  

Document wrapper for serialization

The only real purpose InitialBaselineSubmissionV03Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:tsmt.019.001.03’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using InitialBaselineSubmissionV03.ToDocument() method. The returned InitialBaselineSubmissionV03Document value will serialize correctly according to ISO 20022 standards.

classDiagram
    InitialBaselineSubmissionV03Document *-- InitialBaselineSubmissionV03 : Document
  

Sample of message format

This is an abbreviated version of what the message should look like.

<Document xmlns="urn:iso:std:iso:20022:tech:xsd:tsmt.019.001.03">
    <InitlBaselnSubmissn>
        <SubmissnId>
            <!-- SubmissionIdentification inner content -->
        </SubmissnId>
        <SubmitrTxRef>
            <!-- SubmitterTransactionReference inner content -->
        </SubmitrTxRef>
        <Instr>
            <!-- Instruction inner content -->
        </Instr>
        <Baseln>
            <!-- Baseline inner content -->
        </Baseln>
        <BuyrCtctPrsn>
            <!-- BuyerContactPerson inner content -->
        </BuyrCtctPrsn>
        <SellrCtctPrsn>
            <!-- SellerContactPerson inner content -->
        </SellrCtctPrsn>
        <BuyrBkCtctPrsn>
            <!-- BuyerBankContactPerson inner content -->
        </BuyrBkCtctPrsn>
        <SellrBkCtctPrsn>
            <!-- SellerBankContactPerson inner content -->
        </SellrBkCtctPrsn>
        <OthrBkCtctPrsn>
            <!-- OtherBankContactPerson inner content -->
        </OthrBkCtctPrsn>
    </InitlBaselnSubmissn>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_p4KUyNE8Ed-BzquC8wXy7w_-1224818269"
  nextVersions="_7DK6cdNTEeK-v49t1oWkNA"
  name="InitialBaselineSubmissionV03"
  definition="Scope&#xD;&#xA;The InitialBaselineSubmission message is sent by the initiator of a transaction to the matching application.&#xD;&#xA;This message is used to initiate a transaction.&#xD;&#xA;Usage&#xD;&#xA;The InitialBaselineSubmission message can be sent by a party to register a transaction in the matching application. The message can be submitted with either lodge or push-through instruction.&#xD;&#xA;When the push-through instruction is present, the matching application acknowledges the receipt of the message to the sender by sending an Acknowledgement message, stores the submitted information and informs the counterparty about the registration of the transaction by sending a FullPushThroughReport message. With the BaselineReSubmission message the counterparty responds with matching baseline information in order to establish the transaction (baseline).&#xD;&#xA;When the lodge instruction is present, the matching application acknowledges the receipt of the message to the sender by sending an Acknowledgement message and stores the submitted information. No matching of the submitted baseline data with other baseline information will take place. For example the submission of an InitialBaselineSubmission message containing a lodge instruction establishes the transaction (baseline) in the matching application.&#xD;&#xA;The InitialBaselineSubmission message consists of data which relates to the purchasing agreement covered by the transaction, for example line item details, shipping details."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlTag="InitlBaselnSubmissn"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <xors
    xmi:id="_p4dPsdE8Ed-BzquC8wXy7w_1449720887"
    name="BuyerBankOrSellerBankContactPersonRule"
    definition="If BuyerBankContactPerson is present, then SellerBankContactPerson may not be present. If BuyerBankContactPerson is absent, then SellerBankContactPerson must be present."
    registrationStatus="Provisionally Registered"
    impactedMessageBuildingBlocks="_p4TettE8Ed-BzquC8wXy7w_-1224817416 _p4Tet9E8Ed-BzquC8wXy7w_-1224817493" />
  <messageBuildingBlock
    xmi:id="_p4TesNE8Ed-BzquC8wXy7w_-1224818173"
    nextVersions="_7DK6ddNTEeK-v49t1oWkNA"
    name="SubmissionIdentification"
    definition="Identifies the submitted information."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="SubmissnId"
    complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
  <messageBuildingBlock
    xmi:id="_p4TesdE8Ed-BzquC8wXy7w_-1224818208"
    nextVersions="_7DK6d9NTEeK-v49t1oWkNA"
    name="SubmitterTransactionReference"
    definition="Reference to the transaction for the requesting financial institution."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="SubmitrTxRef"
    complexType="_P-ile9p-Ed-ak6NoX_4Aeg_745508310" />
  <messageBuildingBlock
    xmi:id="_p4TestE8Ed-BzquC8wXy7w_-1224818250"
    nextVersions="_7DK6edNTEeK-v49t1oWkNA"
    name="Instruction"
    definition="Specifies the instruction requested by the submitter by means of a code."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="Instr"
    complexType="_RJpGoNp-Ed-ak6NoX_4Aeg_-1851556220" />
  <messageBuildingBlock
    xmi:id="_p4Tes9E8Ed-BzquC8wXy7w_-1224817338"
    nextVersions="_7DK6e9NTEeK-v49t1oWkNA"
    name="Baseline"
    definition="Specifies the commercial details of the underlying transaction."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="Baseln"
    complexType="_Sq9IZdp-Ed-ak6NoX_4Aeg_-88106768" />
  <messageBuildingBlock
    xmi:id="_p4TetNE8Ed-BzquC8wXy7w_-1224817819"
    nextVersions="_7DK6fdNTEeK-v49t1oWkNA"
    name="BuyerContactPerson"
    definition="Person to be contacted in the organisation of the buyer."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="BuyrCtctPrsn"
    complexType="_QBOtE9p-Ed-ak6NoX_4Aeg_-1391367345" />
  <messageBuildingBlock
    xmi:id="_p4TetdE8Ed-BzquC8wXy7w_-1224817896"
    nextVersions="_7DK6f9NTEeK-v49t1oWkNA"
    name="SellerContactPerson"
    definition="Person to be contacted in the organisation of the seller."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="SellrCtctPrsn"
    complexType="_QBOtE9p-Ed-ak6NoX_4Aeg_-1391367345" />
  <messageBuildingBlock
    xmi:id="_p4TettE8Ed-BzquC8wXy7w_-1224817416"
    name="BuyerBankContactPerson"
    definition="Person to be contacted in the buyer's bank."
    registrationStatus="Provisionally Registered"
    minOccurs="1"
    xmlTag="BuyrBkCtctPrsn"
    complexType="_QBOtE9p-Ed-ak6NoX_4Aeg_-1391367345" />
  <messageBuildingBlock
    xmi:id="_p4Tet9E8Ed-BzquC8wXy7w_-1224817493"
    name="SellerBankContactPerson"
    definition="Person to be contacted in the seller's bank."
    registrationStatus="Provisionally Registered"
    minOccurs="1"
    xmlTag="SellrBkCtctPrsn"
    complexType="_QBOtE9p-Ed-ak6NoX_4Aeg_-1391367345" />
  <messageBuildingBlock
    xmi:id="_p4dPsNE8Ed-BzquC8wXy7w_1151862285"
    nextVersions="_7DK6hdNTEeK-v49t1oWkNA"
    name="OtherBankContactPerson"
    definition="Person to be contacted in another bank than seller or buyer's bank."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="OthrBkCtctPrsn"
    complexType="_QDTwsdp-Ed-ak6NoX_4Aeg_-1939165929" />
  <messageDefinitionIdentifier
    businessArea="tsmt"
    messageFunctionality="019"
    flavour="001"
    version="03" />
</messageDefinition>

ISO Building Blocks

The following items are used as building blocks to construct this message.