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.

Element information

Content

• Sequence [1..1]
  from type IdentificationType
  ID [0..*]    Is the Identifiers of the given instance of an entity within the scope of the integration. The schemeAgencyID attribute identifies the party that provided or knows this party by the given identifier.
  IDSet [0..*]    
  from type FirstAgentInstructionBaseType
  Proprietary [0..1]    Provides a roprietary text description.
  DebitPurposeReason [0..1]    Reason or nature of the debit, on the debtor’s account, that must be returned in debit advices/statements to the debtor.
  RemitLocationMethodCode [0..1]    Specifies the method to be used by the first agent to deliver the remittance advice information.
  RemitLocationURI [0..1]    Electronic address to which the first agent is to send the remittance information.
  RemitLocationPostalAddress [0..1]    Postal address to which the first agent is to send the remittance information.
  PaymentTransactionTax [0..1]    Amount of money due to government or tax authority, according to various pre-defined parameters such as thresholds or income.
  1. Extension [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 Extension is always the last element in all components, except where the component has been extended inline.

Attributes

Used in

• Type PaymentTransactionBaseType
• Type PaymentTransactionType via extension of PaymentTransactionBaseType (Element PaymentTransaction)

Sample instance

<FirstAgentInstruction>
   <ID/>
   <IDSet>
      <ID/>
   </IDSet>
   <Proprietary/>
   <DebitPurposeReason/>
   <RemitLocationMethodCode>token</RemitLocationMethodCode>
   <RemitLocationURI>normalizedString</RemitLocationURI>
   <RemitLocationPostalAddress>
      <ID/>
      <IDSet>
         <ID/>
      </IDSet>
      <Name/>
      <AttentionOfName/>
      <CareOfName/>
      <BuildingNumber/>
      <BuildingName/>
      <BlockName/>
      <StreetName/>
      <StreetTypeCode>normalizedString</StreetTypeCode>
      <Floor/>
      <Unit/>
      <StairCase/>
      <Door/>
      <PostOfficeBox/>
      <DeliveryPointID>normalizedString</DeliveryPointID>
      <PlotID>normalizedString</PlotID>
      <CityName/>
      <CitySubDivisionName/>
      <CountrySubDivisionCode>token</CountrySubDivisionCode>
      <CountryCode>token</CountryCode>
      <PostalCode>normalizedString</PostalCode>
      <Status>
         <ID/>
         <IDSet>...
         </IDSet>
         <Code/>
         <Description/>
         <ReasonCode>normalizedString</ReasonCode>
         <Reason/>
         <EffectiveTimePeriod>..................
         </EffectiveTimePeriod>
         <Extension>.......................................
         </Extension>
      </Status>
      <Preference>
         <ID/>
         <IDSet>...
         </IDSet>
         <PrioritySequenceValue>1</PrioritySequenceValue>
         <EffectiveTimePeriod>..................
         </EffectiveTimePeriod>
         <AvailableTimePeriod>..................
         </AvailableTimePeriod>
         <UnavailableTimePeriod>..................
         </UnavailableTimePeriod>
         <Description/>
         <Note/>
         <Extension>.......................................
         </Extension>
      </Preference>
      <GeographicalCoordinate>
         <ID/>
         <IDSet>...
         </IDSet>
         <Description/>
         <ReferenceSystemID/>
         <VerticalReferenceSystemID/>
         <VerticalMeasure>1.0</VerticalMeasure>
         <LatitudeMeasure>1.0</LatitudeMeasure>
         <LongitudeMeasure>1.0</LongitudeMeasure>
         <VerticalAccuracyMeasure>1.0</VerticalAccuracyMeasure>
         <HorizontalAccuracyMeasure>1.0</HorizontalAccuracyMeasure>
         <Extension>.......................................
         </Extension>
      </GeographicalCoordinate>
      <Usage>
         <ID/>
         <IDSet>...
         </IDSet>
         <GeographicalRegionCode>normalizedString</GeographicalRegionCode>
         <LegalIndicator>true</LegalIndicator>
         <FormattedName/>
         <FormattedAddressUse>...
         </FormattedAddressUse>
         <EffectiveTimePeriod>..................
         </EffectiveTimePeriod>
         <Extension>.......................................
         </Extension>
      </Usage>
      <Extension>
         <AnyExtension>
            <!--any element-->
         </AnyExtension>
         <Amount/>
         <Code/>
         <DateTime></DateTime>
         <ID/>
         <Indicator>true</Indicator>
         <Measure/>
         <Name/>
         <Number>1.0</Number>
         <Quantity/>
         <Text/>
         <Time></Time>
         <ValueText>string</ValueText>
      </Extension>
   </RemitLocationPostalAddress>
   <PaymentTransactionTax>
      <ID/>
      <IDSet>
         <ID/>
      </IDSet>
      <CreditorTaxID>normalizedString</CreditorTaxID>
      <CreditorTaxTypeCode>normalizedString</CreditorTaxTypeCode>
      <DebtorTaxID>normalizedString</DebtorTaxID>
      <TaxReferenceNumber>normalizedString</TaxReferenceNumber>
      <TotalTaxableBaseAmount/>
      <TotalTaxAmount/>
      <Tax>
         <ID/>
         <IDSet>...
         </IDSet>
         <TaxJurisdicationCodes>...
         </TaxJurisdicationCodes>
         <BasisAmount/>
         <BasisQuantity>1.0</BasisQuantity>
         <Calculation>...
         </Calculation>
         <Exemption>...
         </Exemption>
         <Description/>
         <TaxAuthorityAmount/>
         <Amount/>
         <CurrencyExchangeRate>...
         </CurrencyExchangeRate>
         <Extension>.......................................
         </Extension>
      </Tax>
      <Extension>
         <AnyExtension>
            <!--any element-->
         </AnyExtension>
         <Amount/>
         <Code/>
         <DateTime></DateTime>
         <ID/>
         <Indicator>true</Indicator>
         <Measure/>
         <Name/>
         <Number>1.0</Number>
         <Quantity/>
         <Text/>
         <Time></Time>
         <ValueText>string</ValueText>
      </Extension>
   </PaymentTransactionTax>
   <Extension>
      <AnyExtension>
         <!--any element-->
      </AnyExtension>
      <Amount/>
      <Code/>
      <DateTime></DateTime>
      <ID/>
      <Indicator>true</Indicator>
      <Measure/>
      <Name/>
      <Number>1.0</Number>
      <Quantity/>
      <Text/>
      <Time></Time>
      <ValueText>string</ValueText>
   </Extension>
</FirstAgentInstruction>