ZagTrader

cafm: File Management

cafm.001 File Action Initiation

Written and maintained by ZagTrader. Last reviewed . How this page is sourced and checked

cafm.001 is the ISO 20022 FileActionInitiation message in the File Management business area (cafm). The latest version is cafm.001.001.03, and 3 versions are in the repository.

Message
FileActionInitiation
Latest version
cafm.001.001.03
Submitting organisation
ISO TC68/SC9/TG1
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What cafm.001 is for

The FileActionInitiation message can be initiated by any party and received by any party (acquirer, agent or issuer).

This message is used to inquire, add, change, delete or replace a file or a record.

Definition from the ISO 20022 e-Repository, release of 24 April 2025.

cafm.001 versions

Every version published in the e-Repository, newest first. A message keeps its business purpose across versions; each new version is a separate schema with its own namespace.

VersionRegistration statusPublished in
cafm.001.001.03latestRegisteredLatest version set
cafm.001.001.02RegisteredPrevious version set
cafm.001.001.01RegisteredArchive

cafm.001 message structure

The building blocks of cafm.001.001.03 and the elements directly under them, with multiplicity ([0..1] optional, [1..1] mandatory, * any number) and the data type or component. Element names and definitions are from the ISO 20022 repository; usage guidelines such as CBPR+ or a market infrastructure's rules can restrict them further.

  • Document [1..1]
    • FileActnInitn FileActionInitiation [1..1]
      • Hdr Header [1..1]Header71

        Information related to the protocol management.

        • MsgFctn Message Function [1..1]ExternalMessageFunction1Code

          Identifies the type of process related to the message.

        • PrtcolVrsn Protocol Version [1..1]Max2048Text

          Version of the acquirer to issuer protocol specifications.

        • XchgId Exchange Identification [0..1]Max35Text

          Unique identification of an exchange of messages between two parties.

        • ReTrnsmssnCntr Re Transmission Counter [0..1]Max3NumericText

          Number of retransmission of the message.

        • 6 more elements not shown
      • MsgRsn Message Reason [0..*]ISO8583MessageReasonCode

        Reason or purpose to send the message.

      • AltrnMsgRsn Alternate Message Reason [0..*]Max256Text

        Supports message reason codes that are not defined in external code list.

      • FileActnScp File Action Scope [0..1]FileActionScope1Code

        Scope of file action.

      • FileActnTp File Action Type [0..1]FileActionType2Code

        Type of file action.

      • OthrFileActnTp Other File Action Type [0..1]Max35Text

        Other file action type in free text.

      • TxDesc Transaction Description [0..1]Max1000Text

        Transaction data related to programmes and services, content and format based on bilateral agreements.

      • Conttn Continuation [0..1]TrueFalseIndicator

        Indicates that batch or collection is not complete.

      • Orgtr Originator [0..1]PartyIdentification286

        Identifies the originator of the transaction.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • 3 more elements not shown
      • Acqrr Acquirer [0..1]PartyIdentification286

        Identification of the acquirer.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • 3 more elements not shown
      • Sndr Sender [0..1]PartyIdentification286

        Party sending the message to another intermediary agent or to the final destination.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • 3 more elements not shown
      • Card Card [1..1]CardData15

        Card or payment token performing the transaction.

        • PAN PAN [0..1]Max19NumericText

          Primary Account Number (PAN) of the card or a surrogate of the PAN such as a payment token.

        • PrtctdPAN Protected PAN [0..1]TrueFalseIndicator

          To indicate whether the PAN is using ProtectedData for encryption or not.

        • CardSeqNb Card Sequence Number [0..1]Min2Max3NumericText

          Distinguishes between instances of the same payment card.

        • FctvDt Effective Date [0..1]ISOYearMonth

          Date as from which the card can be used, expressed in one of the following formats: YYYY-MM-DD, YYYY-MM, YY-MM-DD.

        • 9 more elements not shown
      • Rcvr Receiver [0..1]PartyIdentification286

        Party receiving the message from the origin or from an intermediary agent.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • 3 more elements not shown
      • Issr Issuer [0..1]PartyIdentification286

        Information related to the issuer.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • 3 more elements not shown
      • Dstn Destination [0..1]PartyIdentification286

        Identifies the destination of the transaction.

        • Id Identification [1..1]Max11NumericText

          Identification of the party.

        • Assgnr Assigner [0..1]Max35Text

          Entity in charge of assigning an identification to a party.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country of the party.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the party.

        • 3 more elements not shown
      • Prgrmm Programme [0..1]ProgrammeMode5

        Programme, network, or brand processes the transaction.

        • ApldId Applied Identification [1..1]Max35Text

          Identification of the programme, network, or brand applied to the transaction.

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification of the program, network, or brand processed the transaction.

      • SysTracAudtNb System Trace Audit Number [1..1]Max12NumericText

        Number assigned by a transaction originator to assist in identifying a transaction uniquely.

      • TrnsmssnDtTm Transmission Date Time [1..1]ISODateTime

        Date and time expressed in UTC of the message as sent by the initiator.

      • RtrvlRefNb Retrieval Reference Number [0..1]Exact12Text

        A reference supplied by the system retaining the original source information and used to assist in locating that information or a copy thereof.

      • LifeCyclId Life Cycle Identification [0..1]Exact15Text

        Transaction lifecycle identification

      • FileNm File Name [0..1]Max140Text

        Identification of the file.

      • Frmt Format [0..1]OutputFormat5Code

        File format code.

      • DataRcrd Data Record [0..1]DataRecord1Choice (choice)

        Content of record to be added, updated, deleted or replaced.

        • Binry Binary [1..*]Max20MbBinary

          Contains the data record in Binary format.

        • Txt Text [1..*]Max10MbText

          Contains the data record in Text format.

      • ActnDt Action Date [0..1]ISODate

        Date when the file action should be performed.

      • FileSctyCd File Security Code [0..1]Max35Text

        Indicates that the originator of the message is authorised to update the file.

      • Crrctn Correction [0..1]CorrectionIdentification1

        Identifies that this batch or collection is a corrected version of a batch or collection that was previously sent.

        • Ind Indicator [0..1]TrueFalseIndicator

          Indicates the message contains an updated version of a message that was previously sent.

        • Dt Date [0..1]ISODate

          Contains the date of the update.

        • Tm Time [0..1]ISOTime

          Contains the time of the update.

      • Accptr Acceptor [0..1]PartyIdentification284

        Card acceptor performing the card transaction.

        • Id Identification [0..1]Max35Text

          Identification of the acceptor.

        • Assgnr Assigner [0..1]Max35Text

          Identification of the entity assigning an identification to the acceptor.

        • Ctry Country [0..1]ISO3NumericCountryCode

          Country code of the acceptor.

        • ShrtNm Short Name [0..1]Max35Text

          Short name of the acceptor.

        • 24 more elements not shown
      • Termnl Terminal [0..1]Terminal7

        Payment terminal or ATM performing the transaction.

        • Id Identification [1..1]Max16Text

          Identification of the terminal.

        • AddtlId Additional Identification [0..*]AdditionalData1

          Additional identification assigned by an agent to an acceptor.

        • Tp Type [0..1]TerminalType1Code

          Type of terminal.

        • OthrTp Other Type [0..1]Max35Text

          Other type of terminal.

        • 20 more elements not shown
      • POICmpnt POI Component [0..*]PointOfInteractionComponent16

        Data related to the components of the POI (Point Of Interaction) performing the transactions.

        • Tp Type [1..1]POIComponentType5Code

          Type of component belonging to a POI (Point Of Interaction) Terminal.

        • ItmNb Item Number [0..1]Max35Text

          Hierarchical identification of a hardware component inside all the hardware component of the POI.

        • PrvdrId Provider Identification [0..1]Max35Text

          Identifies the provider of the software, hardware or parameters of the POI component.

        • Id Identification [0..1]Max35Text

          Identification of the POI component assigned by its provider.

        • 1 more elements not shown
      • Pyer Payer [0..1]PartyIdentification287

        The party providing source of funds.

        • FI Financial Institution [0..1]FinancialInstitution8

          Financial institution-related data required by business and/or regulation (for example, money or funds transfer).

        • Id Identification [0..1]Max35Text

          Identification of the customer assigned by a party.

        • Dsgnt Designation [0..1]Max2NumericText

          Identifies the specific customer when multiple customers are associated with the same account.

        • Crdntls Credentials [0..*]Credentials3

          Credentials of the financial customer.

        • 8 more elements not shown
      • Pyee Payee [0..1]PartyIdentification287

        The party receiving funds.

        • FI Financial Institution [0..1]FinancialInstitution8

          Financial institution-related data required by business and/or regulation (for example, money or funds transfer).

        • Id Identification [0..1]Max35Text

          Identification of the customer assigned by a party.

        • Dsgnt Designation [0..1]Max2NumericText

          Identifies the specific customer when multiple customers are associated with the same account.

        • Crdntls Credentials [0..*]Credentials3

          Credentials of the financial customer.

        • 8 more elements not shown
      • Tkn Token [0..1]Token2

        Details of payment token.

        • PmtTkn Payment Token [0..1]Max19NumericText

          Surrogate value of the PAN.

        • TknXpryDt Token Expiry Date [0..1]ISOYearMonth

          Expiry date of the payment token.

        • TknRqstrId Token Requestor Identification [0..1]Max11NumericText

          Identification of a party requesting a token.

        • TknAssrncData Token Assurance Data [0..1]Max140Text

          Supporting information for the Token Assurance Method.

        • 7 more elements not shown
      • CstmrDvc Customer Device [0..1]CustomerDevice5

        Identification of the customer device performing the transaction.

        • Manfctr Manufacturer [0..1]Max70Text

          Manufacturer of the device.

        • ManfctrMdlId Manufacturer Model Identification [0..1]Max70Text

          Manufacturer's identification of the model.

        • Tp Type [0..1]CustomerDeviceType2Code

          Type of customer device.

        • OthrTp Other Type [0..1]Max35Text

          Other type of customer device in free text.

        • 16 more elements not shown
      • Wllt Wallet [0..1]Wallet3

        Container for tenders used by the customer to perform the payment transaction.

        • Prvdr Provider [0..1]PartyIdentification285

          Identification of the provider of the wallet.

        • PANAge PAN Age [0..1]Max5PositiveNumber

          Number of days that the user’s PAN has been on file for the user.

        • UsrAcctAge User Account Age [0..1]Max5PositiveNumber

          Number of days since the user wallet account for this user exists.

        • AcctAge Account Age [0..1]Max5PositiveNumber

          Number of days since the user created the wallet account or started using the wallet.

        • 15 more elements not shown
      • Crdhldr Cardholder [0..1]Cardholder22

        Cardholder performing the card payment transaction.

        • Nm Name [0..1]CardholderName3

          Contains the registered cardholder name that issuer knows to be correct.

        • Id Identification [0..*]Credentials3

          Identification of the cardholder.

        • Adr Address [0..1]Address2

          Complete address of the cardholder.

        • CtctInf Contact Information [0..1]ContactPersonal1

          Contact information.

        • 4 more elements not shown
      • Jursdctn Jurisdiction [0..1]Jurisdiction2

        Contains information that identifies or is specific to a transaction jurisdiction.

        • DmstInd Domestic Indicator [0..1]TrueFalseIndicator

          When true, indicates the transaction is considered to be domestic.

        • DmstQlfctn Domestic Qualification [0..1]Max35Text

          Identifies the reason the transaction is considered to be domestic or non-domestic.

      • SttlmSvc Settlement Service [0..1]SettlementService6

        Type of settlement service for specific services requiring settlement.

        • Tp Type [0..1]Max35Text

          Type of settlement service applied

        • Id Identification [0..1]Max35Text

          Identification of settlement service applied.

        • ReqdDt Requested Date [0..1]ISODate

          Date requested for settlement.

        • Dfrrd Deferred [0..1]TrueFalseIndicator

          Indicate a deferred Settlement date.

        • 7 more elements not shown
      • AddtlFee Additional Fee [0..*]AdditionalFee3

        Fees not included in the transaction amount.

        • Tp Type [1..1]TypeOfAmount21Code

          Type or class of fee.

        • OthrTp Other Type [0..1]Max35Text

          Additional information to specify the type of amount of fee.

        • Prgm Program [0..1]Max35Text

          Identification of fee program.

        • Dscrptr Descriptor [0..1]Max35Text

          Identification of specific fee.

        • 9 more elements not shown
      • Rcncltn Reconciliation [0..1]Reconciliation4

        Identification of the reconciliation period between the acquirer and the issuer or their respective agents.

        • Id Identification [0..1]Max35Text

          Identification of the reconciliation.

        • Dt Date [0..1]ISODate

          Date of the reconciliation.

        • ChckptRef Checkpoint Reference [0..1]Max35Text

          A value used to allow a period within a reconciliation date.

      • AddtlData Additional Data [0..*]AdditionalData2

        Contains additional data.

        • Tp Type [0..1]Max35Text

          Type of information.

        • Dtls Details [0..*]AdditionalData1

          Detail of the specific type of data.

      • RspnCd Response Code [0..1]ISO8583ResponseCode

        Response code defined in ISO 8583.

      • PrtctdData Protected Data [0..*]ProtectedData2

        Contains protected data and the attributes used to protect the data.

        • CnttTp Content Type [1..1]ContentType3Code

          Type of data protection.

        • EnvlpdData Enveloped Data [0..1]EnvelopedData12

          Consists of an encrypted content of any type and encrypted content-encryption keys for one or more recipients.

        • NcrptdData Encrypted Data [0..1]EncryptedData2

          Contains encrypted data and the attributes used to encrypt the data using the ISO 13492 methods for data encryption.

      • SplmtryData Supplementary Data [0..*]SupplementaryData1

        Additional information that can not be captured in the structured fields and/or other specific block.

        • PlcAndNm Place And Name [0..1]Max350Text

          Unambiguous reference to the location where the supplementary data must be inserted in the message instance.

        • Envlp Envelope [1..1]SupplementaryDataEnvelope1

          Technical element wrapping the supplementary data.

      • SctyTrlr Security Trailer [0..1]ContentInformationType41

        Trailer of the message containing a MAC

        • MACData MAC Data [1..1]MACData1

          Type of data protection.

        • MAC MAC [1..1]Max8HexBinaryText

          Message Authentication Code data.

Have a cafm.001 message? Paste it into the parser to see every element with its name and definition, and format checks on BICs, IBANs, dates and amounts.

External code sets used in cafm.001

These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.

cafm.001 questions

What is the latest version of cafm.001?
The latest version in the ISO 20022 e-Repository release of 24 April 2025 is cafm.001.001.03.
What is the root element of cafm.001?
The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:cafm.001.001.03, and its message element is FileActnInitn (FileActionInitiation).
Is there an MT equivalent of cafm.001?
No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

All ISO 20022 messages · ISO 20022 code sets · MT messages

The ISO 20022 message definitions, element names and definitions on this page are reproduced from material published at iso20022.org under the ISO 20022 Intellectual Property Rights policy. This is not the official source: the up-to-date ISO 20022 standards and repository material are published only at iso20022.org. Explanations in our own words are by ZagTrader. ZagTrader is not affiliated with or endorsed by ISO or Swift.