- Collections (steps 1–8): what every customer sets up. Stuut only reads from Finance & Operations.
- Cash Application write-back (steps 9–13): optional. Stuut posts the payments it applies as customer payment journals and settles the invoices. This needs a Stuut extension installed in your environment and a second security role.
What Stuut reads and writes
Part 1: Collections
1. Grant admin consent to the Stuut application
Stuut is a multi-tenant Microsoft Entra ID application, and a Global Administrator grants admin consent to it once. Stuut then signs in as a user with the delegateduser_impersonation scope and calls Finance & Operations only. It does not call Microsoft Graph.
You do not need to change any Entra ID API permissions, now or for Cash Application later. What Stuut can see and do is decided entirely by the security roles of the Finance & Operations user it signs in as (steps 2 and 3).
2. Create a dedicated Dynamics user
Create or identify a dedicated Finance & Operations user for Stuut, for examplecollections@yourcompany.com, rather than an individual administrator’s everyday account. Stuut signs in as this user, so the data it can read is exactly the data this user can read.
Give the user the standard System user role plus the Stuut role from step 3. Do not give it System administrator.
3. Create the Stuut Integration – Collections role
Create a security role named Stuut Integration – Collections and give it View (read) access on the entities below. A denied entity fails the whole model rather than degrading it, so grant all of them.
To build the role:
- Go to System administration → Security → Security configuration.
- On the Roles tab, click Create new and name the role.
- Under Privileges, add the auto-generated View privilege of each entity above. No duty is needed.
- Click Publish all.
- Go to System administration → Users → Users, open the Stuut user and click Assign roles. Add the role.
- With the role selected, click Assign organizations → Grant access to specific organizations individually, and select only the legal entity that the Stuut connection will use. Do not leave it at all organizations.
4. Two entities that are easy to miss
The last two rows above are optional for the sync to run, but leaving them out loses data without any error. The affected models still report Done, so the gap does not show up in the sync status.CustomerElectronicAddresses — needed if your customer email addresses live on the customer Contact information grid.
Without it Stuut reads only CustomersV3.PrimaryContactEmail, which Dynamics fills only when an email row is marked Primary on that grid. A customer with three email addresses and the Primary marker on a phone number reaches Stuut with no address at all, and cannot be emailed.
Employees — needed if you want Stuut to assign a collector to each customer.
CustomersV3.EmployeeResponsibleNumber holds a personnel number, not a name or address, so Stuut cannot match it to a user on its own. Without this entity, supply a list mapping each personnel number to a name and email instead.
5. Collect the connection settings
Sandboxes use their own host name.
6. Connect Dynamics 365 to Stuut
Log in to Stuut and navigate to General Settings → Connectors → All Connectors. Choose Microsoft Dynamics 365 Finance & Operations from the list. Click Add and follow the instructions in the window: enter the instance URL, sign in as the dedicated Dynamics user, then choose the legal entity.7. Validate the connection
Click Check Health in the top right. If everything was set up correctly the connection shows as Linked. The Overview tab reports each model separately, so Customers, Contacts, Invoices, Credit Memos and Payments each show Done once the import finishes. The Logs tab lists every request including failures, which is the fastest way to find an entity the role is still missing.8. Optional: invoice PDFs
Stuut attaches the invoice PDF to collections email when it can find one. It reads the attachment on the sales order namedCustomer invoice, which is what Print Management writes when Save to Attachments is enabled for the customer invoice report.
Part 2: Cash Application write-back (optional)
With write-back on, a payment approved in Stuut is posted to Finance & Operations automatically. Nobody needs to open or post a journal in Finance & Operations. Standard OData cannot post a journal, so Stuut posts through a small extension, the StuutPaymentConnector model, installed in your environment. Stuut never writes through the standard data entities. Complete Part 1 first. Collections keeps working on its own whether or not you go on to Part 2.9. Install the Stuut extension
Stuut provides the StuutPaymentConnector deployable package. Your Dynamics administrator or implementation partner installs it through your normal release process:- Lifecycle Services (LCS) for LCS-managed environments.
- Power Platform admin center for unified (Power Platform-hosted) environments.
StuutPaymentService, and two security roles. It does not change any standard Finance & Operations object.
10. Assign the Cash Application roles
Give the Stuut user these roles, each scoped to the connection’s legal entity only (Assign organizations, as in step 3):11. Choose a customer payment journal
Stuut posts into a journal name you choose. Use an existing journal name with journal type Customer payment under General ledger → Journal setup → Journal names (oftenCustPay), or create one for Stuut.
Set New voucher to One voucher number only. Send the journal name to your Stuut contact.
12. Map your bank accounts in Stuut
In Stuut, go to General Settings → Connectors → Bank accounts and link each bank account Stuut sees deposits on to its Finance & Operations bank account. The bank account is the offset on every journal line, so a deposit on an unmapped account cannot be posted.13. Turn write-back on
Write-back is off on every connection by default. Once steps 9–12 are done, your Stuut contact turns it on and checks that Stuut can reach the extension.How a payment is posted
For each approved deposit, Stuut:- Creates one customer payment journal in your journal name.
- Adds one line per customer payment, dated with the deposit date, with the bank account as the offset.
- Marks each invoice the payment applies to, for the applied amount.
- Posts the journal. Posting settles the marked invoices in the same step.
- Checks Finance & Operations’ settlement records to confirm each invoice was settled for its applied amount, then records the voucher on the payment in Stuut.
What Stuut does not post
Stuut posts payments applied in full to invoices. It refuses the following and shows the reason on the payment, so your team can apply it in Finance & Operations directly:- Payments that include a credit memo or an adjustment (for example a short-pay or bank fee write-off).
- Payments with an unapplied remainder. Stuut does not post a balance on account.
- Payments in a different currency from the invoice.
A few things to know
- Posting date. The journal is dated with the deposit date. A closed or on-hold fiscal period for that date stops the post.
- Inactive bank accounts. Finance & Operations does not check bank account status on this path, so an inactive bank account does not stop a post. Keep the mapping in step 12 current.
- Idle environments are slow to wake. After an environment has been idle, the first call to the extension can take several minutes. Stuut waits for it and confirms the result, so this delays a post but does not fail it.