Create Expense External Bank Account Rest API
Create Expense External Bank Account Rest API
https://faehyp129.fa.dc1.c9dev2.oraclecorp.com//fscmRestApi/resources/11.13.18.05/
externalBankAccounts
Bank branch ID and Bank ID were used from an existing bank account. We performed a get Operation
https://docs.oracle.com/en/cloud/saas/financials/20d/farfa/op-externalbankaccounts-get.html
Payload used.
"BankAccountNumber": "123456",
"CountryCode": "EG",
"BankBranchIdentifier": 100100208507213,
"BankIdentifier": 100100208507205,
"AccountType": "SAVINGS",
"AllowInternationalPaymentIndicator": "Y",
"Intent": "Employee",
"PartyId": 100010032637367,
Payload response. Checking the ID for the bank account created. 300100234925252
"BankAccountNumber": "XX3456",
"CountryCode": "EG",
"BankBranchIdentifier": 100100208507213,
"BankIdentifier": 100100208507205,
"BankAccountId": 300100234925252,
"CurrencyCode": null,
"IBAN": null,
"CheckDigits": null,
"AccountType": "SAVINGS",
"AccountSuffix": null,
"AgencyLocationCode": null,
"AllowInternationalPaymentIndicator": "Y",
"SecondaryAccountReference": null,
"StartDate": "2020-10-27",
"EndDate": "4712-12-31",
"AlternateAccountName": null,
"BankBranchPartyIndicator": "Y",
"BankName": "21",
"BankNumber": null,
"BankBranchName": "123",
"BankBranchNumber": null,
"BIC": "12345678",
"VendorId": null,
"PersonId": null,
"Intent": "Employee",
"PartyId": 100010032637367,
https://docs.oracle.com/en/cloud/saas/financials/20d/farfa/op-externalbankaccounts-bankaccountid-
child-accountowners-post.html
https://faehyp129.fa.dc1.c9dev2.oraclecorp.com/fscmRestApi/resources/11.13.18.05/
externalBankAccounts/300100234925252/child/accountOwners
AccountOwnerPartyIdentifier represent the party id for dummy employee Mary Johnson. Same
hz_parties table was used as in step 1
Payload used:
"AccountOwnerPartyIdentifier": 100010032637367,
"Intent" : "Employee"
Response
"AccountOwnerPartyIdentifier": 100010032637367,
"AccountOwnerPartyNumber": "100010032637367",
"PrimaryOwnerIndicator": "Y",
"StartDate": "2020-10-27",
"EndDate": "4712-12-31",
"AccountOwnerId": 300100234925261,
"Intent": "Employee",
"PersonId": null,
3 . Instrument Assignment
After the owner is assigned, in order to be visible in UI, instrument assignment should be created.
Reference
https://docs.oracle.com/en/cloud/saas/financials/20d/farfa/op-instrumentassignments-post.html
Instrument assignment ID
Link used
https://faehyp129.fa.dc1.c9dev2.oraclecorp.com//fscmRestApi/resources/11.13.18.05/
instrumentAssignments
Payload used:
where
PaymentPartyId - Ext_payee_id from bellow query. Party id is the one retrieved from HZ_parties.
Payment instrument id - External bank account ID (the one created in first API)
Payload used:
"PaymentPartyId": 100010023924852,
"PaymentInstrumentId": 300100234925252,
"PaymentFlow": "DISBURSEMENTS",
"PaymentInstrumentType": "BANKACCOUNT",
"Intent": "Employee"
}
Response used.
"PaymentInstrumentAssignmentId": 300100234925278,
"PaymentPartyId": 100010023924852,
"PaymentInstrumentId": 300100234925252,
"PaymentFlow": "DISBURSEMENTS",
"PaymentInstrumentType": "BANKACCOUNT",
"PrimaryIndicator": "Y",
"StartDate": "2020-10-27",
"EndDate": "4712-12-31",
"MaskedBankAccountNumber": "XX3456",
"MaskedCreditCardNumber": null,
"VendorId": null,
"PersonId": null,
Print screens:
3. Instrument assignment
4 Print screen From UI showing that bank account is visible.