X12 Application Partners Change: (Tag X12AppPartnersAddChange)

Use this tag to add an X12 Application Partner to an existing Trading Partner, or change an existing Application Partner. To add, set the tag "AddFlag" to Y; leaving "AddFlag" blank, not specified, or set to N will change the existing X12 Application Partner if it exists.

Contacts can be added via this tag as well; include a Contacts tag set within the X12AppPartnersAddChange tags to add new Contacts to an existing Application Partner. You cannot add a Contact if one exists with that First and Last Name.

Note: Deleting or changing existing Contacts is not supported by the XML Autoload Utility, and must be done using Partner Manager.

ApplicationName and GS_ApplicationID together are not required when changing, but at least 1 must be specified to identify the Application Partner. If AddFlag is Y, then these two fields are required.

If changing the Application Name or GS Address, use ApplicationNameChange and GS_ApplicationIDChange. These "Change" fields cannot be specified when the AddFlag is Y. The tag and field descriptions are:

Field Label FieldName/Tag Req'd Max. Len. Validation Notes
N/A (ISA + IID) ISA_IID Yes 17 IchgQual + IchgID of Trading Partner 1
Application Partner Name ApplicationName No 35 Unique within the Trading Partner 2
GS Address GS_ApplicationID No 15 Unique within the Trading Partner 3
Alias AliasName No 20 Unique if present 4
User Defined 1 UserDefined1 No 20    
User Defined 2 UserDefined2 No 20    
Institution Institution No 255   5
N/A AddFlag No Y/N    
N/A ApplicationNameChange No 35    
N/A GS_ApplicationIDChange No 15    

Notes:

  1. Combination Trading Partner's ISA Address and Interchange ID associated with this Application Partner.
  2. Do not use the name "UNKNOWN, or "ALL", or any variation of the case of these two words. For example, do not use "Unknown", or "All".
  3. Cannot contain single/double quotes.
  4. Alias Names are unique across all X12 Application Partners, if present.
  5. Specify optional HIPAA Institution, used for HIPAA Type 7 validations. If specified, must exist in the table HIPAA_Institutions. Valid only for External Application Partners.