Error message when you use Web Services for Microsoft Dynamics GP: "An ISO 4217 Currency Code must be three characters long; your value is [Code]"


Source: Microsoft Support

RAPID PUBLISHING

RAPID PUBLISHING ARTICLES PROVIDE INFORMATION DIRECTLY FROM WITHIN THE MICROSOFT SUPPORT ORGANIZATION. THE INFORMATION THAT IS CONTAINED HEREIN IS CREATED IN RESPONSE TO EMERGING OR UNIQUE TOPICS, OR IS INTENDED TO SUPPLEMENT OTHER KNOWLEDGE BASE INFORMATION.

Symptoms


When you use Web Services for Microsoft Dynamics GP 10.0 or for Microsoft Dynamics GP 9.0, a SOAP exception occurs. If you click
Inner Exception Detail when you view the exception in the Exception Management console, you find an error message that resembles the following error message:
An ISO 4217 Currency Code must be three characters long; your value is Code.
Note The Code placeholder represents the actual currency code that you use. The currency code contains one or two characters. For example, the Code placeholder may be US.

Cause


This problem occurs because an invalid ISO currency code was used in Microsoft Dynamics GP. Web Services for Microsoft Dynamics GP requires a three-character ISO currency code for each currency in Microsoft Dynamics GP. Therefore, if you use a one-character ISO currency code or a two-character ISO currency code in Microsoft Dynamics GP, you cannot perform any operation that refers to that currency.

Resolution


To resolve this problem, modify the invalid ISO currency code in Microsoft Dynamics GP. To do this, follow these steps:
  1. Log on to Microsoft Dynamics GP as a user who has administrator role.
  2. Use the appropriate method:
    • If you use Microsoft Dynamics GP 10.0, click
      Microsoft Dynamics GP, point to Tools, point to Setup, point to System, and then click
      Currency.
    • If you use Microsoft Dynamics GP 9.0, click
      Tools, point to Setup, point to
      System, and then click Currency.
  3. In the Currency Setup window, click the lookup button next to the Currency ID field.
  4. In the Currencies window, click the currency ID that has the invalid ISO currency code, and then click Select.
  5. In the Currency Setup window, type three characters in the
    ISO Code field to make a unique currency code, and then click
    Save.

DISCLAIMER

MICROSOFT AND/OR ITS SUPPLIERS MAKE NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY, THE RELIABILITY OR THE ACCURACY OF THE INFORMATION THAT IS CONTAINED IN THE DOCUMENTS AND THE RELATED GRAPHICS PUBLISHED ON THIS WEB SITE (THE “MATERIALS”) FOR ANY PURPOSE.

THE MATERIALS MAY INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS AND MAY BE REVISED AT ANY TIME WITHOUT NOTICE. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, MICROSOFT AND/OR ITS SUPPLIERS DISCLAIM AND EXCLUDE ALL REPRESENTATIONS, WARRANTIES, AND CONDITIONS WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO REPRESENTATIONS, WARRANTIES, OR CONDITIONS OF TITLE, NON-INFRINGEMENT, SATISFACTORY CONDITION OR QUALITY, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE MATERIALS.