What is the latest version of camt.017?

The latest version in the ISO 20022 e-Repository release of 24 April 2025 is camt.017.001.05.

What is the root element of camt.017?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:camt.017.001.05, and its message element is RtrCcyXchgRate (ReturnCurrencyExchangeRate).

Is there an MT equivalent of camt.017?

No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

camt: Cash Management

camt.017 Return Currency Exchange Rate

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

camt.017 is the ISO 20022 ReturnCurrencyExchangeRate message in the Cash Management business area (camt). The latest version is camt.017.001.05, and 2 versions are in the repository.

Message: ReturnCurrencyExchangeRate
Latest version: camt.017.001.05
Submitting organisation: Swift
MT equivalent: None listed

In use: published in the current ISO 20022 catalogue.

What camt.017 is for

The ReturnCurrencyExchangeRate message is sent by the transaction administrator to a member of the system.
It is used to provide information on static data and related to currency exchange details as maintained for system operations by the transaction administrator.
The ReturnCurrencyExchangeRate message can be sent as a response to a related GetCurrencyExchangeRate message (pull mode) or initiated by the account servicer (push mode). The push of information can take place either at prearranged times or as a warning or alarm when a problem has occurred.
The transaction administrator is in charge of providing the members with business information. The term business information covers all information related to the management of the system, that is, not related to the transactions or requests created in the system. The type of business information available can vary depending on the system.
When a system manages a pool of accounts in various currencies for a member, it needs to maintain currency exchange details between the various currencies and the reporting on base currency. The reporting on base currency is used to calculate the actual position of the members in terms of aggregate limits and balances. It also allows the system to contain risk within defined and agreed boundaries.
The currency exchange details can be fixed for the entire operational day or regularly updated according to near real-time market feeds.
The member can request information about a currency exchange operation through a series of criteria, corresponding to the known information stored within the transaction administrator. Based on the criteria received within the request, the transaction administrator will select items that will match with the request and report them to the requestor.

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

camt.017 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.

Version	Registration status	Published in
camt.017.001.05latest	Registered	Latest version set
camt.017.001.04	Registered	Previous version set

camt.017 message structure

The building blocks of camt.017.001.05 to three levels, 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]
- RtrCcyXchgRate ReturnCurrencyExchangeRate [1..1]
  - MsgHdr Message Header [1..1]MessageHeader7
    Common business identification for the message.
    - MsgId Message Identification [1..1]Max35Text
      Point to point reference, as assigned by the sender, to unambiguously identify the message.
    - CreDtTm Creation Date Time [0..1]ISODateTime
      Date and time at which the message was created.
    - ReqTp Request Type [0..1]RequestType4Choice (choice)
      Specific actions to be executed through the request.
      - PmtCtrl Payment Control [1..1]ExternalPaymentControlRequestType1Code
      - Enqry Enquiry [1..1]ExternalEnquiryRequestType1Code
      - Prtry Proprietary [1..1]GenericIdentification1
    - OrgnlBizQry Original Business Query [0..1]OriginalBusinessQuery1
      Unique identification of the original query message.
      - MsgId Message Identification [1..1]Max35Text
      - MsgNmId Message Name Identification [0..1]Max35Text
      - CreDtTm Creation Date Time [0..1]ISODateTime
    - QryNm Query Name [0..1]Max35Text
      Recalls the criteria (search and return criteria) defined in a preceding query.
  - RptOrErr Report Or Error [1..1]ExchangeRateReportOrError3Choice (choice)
    Reports on currency exchange information.
    - CcyXchgRpt Currency Exchange Report [1..*]CurrencyExchangeReport4
      Reports on currency exchange information.
      - CcyRef Currency Reference [1..1]CurrencySourceTarget1
      - CcyXchgOrErr Currency Exchange Or Error [1..1]ExchangeRateReportOrError4Choice (choice)
    - OprlErr Operational Error [1..*]ErrorHandling3
      Indicates that an operational error has been issued during the processing of the related request.
      - Err Error [1..1]ErrorHandling1Choice (choice)
      - Desc Description [0..1]Max140Text
  - SplmtryData Supplementary Data [0..*]SupplementaryData1
    Additional information that cannot be captured in the structured elements and/or any 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.

Have a camt.017 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 camt.017

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

camt.017 questions

What is the latest version of camt.017?: The latest version in the ISO 20022 e-Repository release of 24 April 2025 is camt.017.001.05.
What is the root element of camt.017?: The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:camt.017.001.05, and its message element is RtrCcyXchgRate (ReturnCurrencyExchangeRate).
Is there an MT equivalent of camt.017?: 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.