Negotiation documentation

[SariSaar]

Update documentation for the release of default negotiation process. With this change, we are also releasing a change that means providers can initiate transactions against customer listings. For this change, we are decoupling the concepts of provider and listing author where relevant.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
flex-docs	Ready	Preview	Comment	Oct 9, 2025 10:41am

[Amanda-Kauppinen]

Just highlighting the TODO's here in case they are ready and missed - also line 121

[SariSaar]

I'll update these once the feature is released in template – the URLs should point to user.duck.js fetchCurrentUserNotifications function

[Amanda-Kauppinen]

I think this should maybe be this line: case FETCH_CURRENT_USER_NOTIFICATIONS_SUCCESS:

It currently points to case FETCH_CURRENT_USER_HAS_LISTINGS_ERROR:

[SariSaar]

Good catch! Currently, the notification count is based on a single value from user state, but after the negotiation process is released, it's actually based on two values (customer notification count and provider notification count) that get combined in TopbarContainer mapStateToProps, so most likely this link should point there instead of anywhere in user.duck.js.

I've added more URL TODOs in this paragraph so I can update all of them at the same time once the feature is in Template.

[Amanda-Kauppinen]

Just a general comment that I think not all pages had the updated date - not sure if all of them need it, since some changes are really minor? but reminding just in case!

[Amanda-Kauppinen]

I don't see the article referenced yet - is this intentional, as in we'll update again when the feature is out to reveal the doc?

[SariSaar]

TODO add last-entered-state to time point reference

[shareoc]

I don't have that much prior knowledge of the technical details of this feature so these were the questions I had after reading the overview:

• How do I toggle between forward and reverse flows (is there a setting or are they different transaction process paths or are they both enabled by default)
• There is a mention that the process does not support bookings or stock. What kind of offering is the process optimised for?
• I am having a hard time to picture the process flow. What do you think of there be a visualisation (a simplification) depicting the general flow?
• How do I create a transaction process where a provider can initiate a transaction? Is this a new endpoint parameter or is it defined in the transaction process?

[SariSaar]

Great questions! I'll incorporate these answers in the article and the rest of the documentation.

[SariSaar]

I added some clarifications now. I'll also check in with CA on the non-technical documentation and mention these questions – I think some of them will be better suited for a deeper discussion in the help center.