FirstAgentInstruction

Further information related to the processing of the payment instruction, which may need to be acted upon by the first agent, depending on agreement between customer and the first agent. The instruction can relate to a level of service between the
customer and the first agent, or can be information required by the first agent.

See http://www.openapplications.org/platform/1.

Element information

Content

• Sequence [1..1]
  1. ProprietaryText [0..1]    Provides a roprietary text description.
  2. DebitPurposeText [0..1]    Reason or nature of the debit, on the debtor’s account, that must be returned in debit advices/statements to the debtor.
  3. RemitLocationMethodCode [0..1]    Specifies the method to be used by the first agent to deliver the remittance advice information.
  4. RemitLocationURI [0..1]    Electronic address to which the first agent is to send the remittance information.
  5. RemitLocationPostalAddress [0..1]    Postal address to which the first agent is to send the remittance information.
  6. PaymentTransactionTax [0..1]    Amount of money due to government or tax authority, according to various pre-defined parameters such as thresholds or income.
  7. UserArea [0..1]    Allows the user of OAGIS to extend the specification in order to provide additional information that is not captured in OAGIS.This is done by defining the additional information in XML Schema and referencing the new schema in the xml instance document through the use of namespaces. Once this is done the additional information defined there can be carried in the BOD XML instance document.The Open Applications Group will make best efforts to quickly consider all proposed submissions.The USERAREA is always the last element in all components, except where the component has been extended inline.

Attributes

None

Used in

• Type PaymentTransactionType (Element PaymentTransaction)

Sample instance

<FirstAgentInstruction>
   <ProprietaryText>string</ProprietaryText>
   <DebitPurposeText>string</DebitPurposeText>
   <RemitLocationMethodCode>normalizedString</RemitLocationMethodCode>
   <RemitLocationURI>http://www.example.com/</RemitLocationURI>
   <RemitLocationPostalAddress>
      <ID>normalizedString</ID>
      <FormatCode>normalizedString</FormatCode>
      <AttentionOfName>string</AttentionOfName>
      <CareOfName>string</CareOfName>
      <AddressLine>string</AddressLine>
      <CitySubDivisionName>string</CitySubDivisionName>
      <CityName>string</CityName>
      <CountrySubDivisionCode>normalizedString</CountrySubDivisionCode>
      <CountryCode>normalizedString</CountryCode>
      <PostalCode>normalizedString</PostalCode>
      <Status>
         <Code>normalizedString</Code>
         <Description>string</Description>
         <EffectiveDateTime>2000-01-01</EffectiveDateTime>
         <ReasonCode>normalizedString</ReasonCode>
         <Reason>string</Reason>
         <TimePeriod>...
         </TimePeriod>
         <UserArea>
            <!--any element-->
         </UserArea>
      </Status>
      <Preference>
         <Sequence>1</Sequence>
         <Indicator>true</Indicator>
         <EffectiveTimePeriod>...
         </EffectiveTimePeriod>
         <UserArea>
            <!--any element-->
         </UserArea>
      </Preference>
      <UserArea>
         <!--any element-->
      </UserArea>
   </RemitLocationPostalAddress>
   <PaymentTransactionTax>
      <CreditorTaxID>normalizedString</CreditorTaxID>
      <CreditorTaxType>normalizedString</CreditorTaxType>
      <DebtorTaxID>normalizedString</DebtorTaxID>
      <TaxReferenceNumber>normalizedString</TaxReferenceNumber>
      <TotalTaxableBaseAmount currencyID="AED">1.0</TotalTaxableBaseAmount>
      <TotalTaxAmount currencyID="AED">1.0</TotalTaxAmount>
      <Tax>
         <ID>normalizedString</ID>
         <TaxJurisdicationCodes>
         </TaxJurisdicationCodes>
         <BasisAmount currencyID="AED">1.0</BasisAmount>
         <Calculation>...
         </Calculation>
         <Exemption>...
         </Exemption>
         <Description>string</Description>
         <TaxAuthorityAmount currencyID="AED">1.0</TaxAuthorityAmount>
         <Amount currencyID="AED">1.0</Amount>
         <CurrencyExchangeRate>...
         </CurrencyExchangeRate>
         <UserArea>
            <!--any element-->
         </UserArea>
      </Tax>
      <UserArea>
         <!--any element-->
      </UserArea>
   </PaymentTransactionTax>
   <UserArea>
      <!--any element-->
   </UserArea>
</FirstAgentInstruction>