Troubleshooting

What goes wrong with SharePoint Document Filing, how to recognise it, and what to do.

Nothing is being filed

There is no rule. Microsoft 365 > Configuration > Filing Rules is empty on install, and nothing is filed until you add one.

An attachment was ignored

Check the rule's filters:

• Only these types - is the mimetype matched? A trailing slash matches a family, so image/ matches image/png.
• Only files larger than - is the file above the floor?
• Is it an attachment backing a binary field? Those are never filed.

"The client secret has expired"

Microsoft's AADSTS7000222. Create a new secret in Entra and set it again. The module names this one specifically because the generic message sends people looking at permissions instead.

"Microsoft refused the request (HTTP 403)"

The app registration does not have the permission, or admin consent was never granted. Add Files.ReadWrite.All or Sites.ReadWrite.All as an application permission and consent to it.

"Microsoft could not find it (404)"

Usually the drive id. Use Choose a library to list what the app can actually see and pick from that.

Everything is stuck in Queued

Check the scheduled action Microsoft 365: file queued attachments is active, and that Odoo's cron worker is running at all.

A file failed and is not retrying

Permanent failures are not retried, because a folder nobody granted access to will still be refused in ten minutes. Fix the cause, then press Retry.

Retryable failures give up after five attempts for the same reason.

"is larger than the 4 MB that can be uploaded in one request"

Graph needs an upload session above 4 MB. File that one by hand, or keep it in Odoo.

The folder name is not what I expected

Every segment is sanitised: characters SharePoint refuses are replaced, and a record's name cannot introduce a slash. Check the Folder column on the filing record to see exactly what was used.

I removed the Odoo copy and now I cannot find the file

Open the filing record and use Open - it has the SharePoint link. If the state is not Filed, the copy was never removed; the module only removes it on a confirmed upload.

Where do I look first?

Microsoft 365 > Filed Documents, filtered to Failed. The error column is Microsoft's own words.