Using the Payment Journal

This guide outlines how one can use the Payment Journal together with Atlar.

Before continuing, make sure you’ve completed the following steps:


Payments

In line with Atlar’s integration philosophy for Business Central, changes to the standard Payment Journal are minimal.

Payments in Business Central work largely as described in the official Dynamics 365 Business Central documentation.
In summary, the payment process consists of the following steps:

  1. Create a Purchase Invoice.
  2. Open a Payment Journal and export the journal (or selected lines).
  3. Approve payments in the Atlar dashboard.
  4. Post the Payment Journal (or selected lines) when they reach the EXECUTED status.

Following this process creates payments in Atlar that follow your Atlar Approval Chains and are executed through the connected bank for the selected account.

💡

Heads up:

Payment exports and status updates between Business Central and Atlar happen asynchronously.
It may take a short time before a newly exported or updated payment shows its final status.


1. Create a purchase invoice

To follow along with this example, create a manual purchase invoice.


2. Open a payment journal and export payment lines

To pay the invoices you just created, navigate to Cash ManagementPayment Journals. You’ll see a list of journals by account.

Select the journal for the source account you want to initiate payments from.
Within the journal, you can use Suggest Vendor Payments to have Business Central automatically generate payment lines based on your open invoices.

Review the suggested lines and confirm all details. When ready, go to the Bank tab and select Export. This sends the payment lines to Atlar, where you can review them in the Atlar Dashboard.

If any exported line encounters an issue, the error will appear in Atlar and will also be synced back asynchronously to the corresponding payment line in Business Central. You can correct the issue and export again.

💡

Tip:

You can export specific payment lines instead of the entire journal — handy when only part of a batch is ready for approval or payment.


3. Approve payments in Atlar

This step happens in the Atlar dashboard and is not specific to Business Central.
See Approvals for details on configuring and managing approval chains.

🧩

Note:

If your organization uses multi-step approvals, make sure all approvers are correctly assigned in Atlar.
Payments won’t be executed until all approval steps are complete.


4. Post payment lines

Atlar reports the status of each exported payment line as CREATED, APPROVED, SENT, FAILED, or EXECUTED.
If a payment fails, the status FAILED is reported back to Business Central.

Resolving a FAILED status

If a payment line shows FAILED, it means the bank was unable to process the payment.
You can view the detailed reason in the Atlar Dashboard.

Once resolved, trigger Export again to re-submit the payment to Atlar. It will follow the same approval chain.

⚠️

Warning:

Only post payment lines with EXECUTED status.
Posting before execution can cause reconciliation mismatches in Business Central.

Payment lines with the EXECUTED status indicate that the transaction has been completed.
These lines should be Posted so they can be matched later in Business Central’s native Bank Account Reconciliation module.