Adrien, The only difference between "The cutoff day for applying bills to the next month. After the cutoff, bills are applied to the following month.” And "cutoff: day of the month used to decide if the due date will be in the next month or in the month thereafter” is that the former says “the following month” and the latter says “the month thereafter”. Nothing in either says anything at all about paying the bill *this* month.
This usage goes back to 18th and 19th century writing [1], when it was common to use latin-ish words to designate the previous month (ultimo), the current one (instant) and the next one (proximo). The simple use of the word “proximo”, both in the list box that presents it to the user and in the documentation, tells you that it’s about next month. But that usage has been out of fashion for at least a century, so it’s perhaps unfair to expect modern readers to know that. Would it help to explain that in the Guide? Regards, John Ralls [1] https://www.worldwidewords.org/ww-ult2.html > On Oct 9, 2026, at 12:24, Adrien Monteleone <[email protected]> > wrote: > > Thanks John, > > It seems then, there is a bug in the Guide and tooltip. > > Both say this about Cutoff: > > "The cutoff day for applying bills to the next month. After the cutoff, bills > are applied to the following month. Negative values count backwards from the > end of the month." > > But only in the code docs does it say: > > "cutoff: day of the month used to decide if the due date will be in the next > month or in the month thereafter" > > There is no indication except that code documentation that it is impossible > to get a due date within the same month as the posting date using Proximo. > The user documentation and tooltip imply that it is. > > Note, the Guide & tooltip for Due Day: > > "The day of the month bills are due" > > It does not say "the day of a *subsequent* month". > > I just ran into this issue with a billing term I have set for 10th of Month. > The bill is dated 10/1/26 and is due on 10/10/26. (listed on the bill as "Due > by the 10th") The Due Day is 10, the Cutoff is 9. From the above user docs & > tooltips, I expected a due date of 10/10/26. Instead, I get a due date of > 11/10/26. I would have to use a term of Type:Days and set it to "9". > > I also have bills due the 15th of the same month they are posted and have the > same problem. (and others possibly as well, I'm just getting started > assisting a family business and don't yet have a list of all terms needed) > > While I can resort to type:Days, that only works for consistent posting days > from Vendors, which isn't the real-world case. (some due on the 15th post on > the 1st one month, maybe the 2nd next month, occasionally the 3rd too!) > Instead, I've had to simply use 'none' for terms and set the date manually > which is fine, but it would be nice if these worked as expected and needed. > > ----- > Should I proceed as you suggested with amending the RFE and then file a bug > on the Guide & Tooltips? > > Or, are the user-facing docs correct and the code is indeed not operating as > intended? (though documented accurately as to how it functions) > > Regards, > Adrien > > On 10/6/26 13:48, John Ralls wrote: >> GnuCash’s billing-terms proximo sets the due date as either the specified >> day next month if the bill is recorded on or before the cutoff day or the >> following month if after the cutoff date. The Guide [1] presents it a bit >> sparsely; there’s a little more detail in the API doc [2]. >> My reading of but 670215 is the opposite of what you’re looking for: He >> wanted to be able to specify proximo for multiple months out: You’re looking >> to be able to specify it for 0 months. It would make sense to do both at >> once, so you should add your request as a comment. I doubt that change is >> likely to be a priority for the current core team so you’ll need to recruit >> somebody to write a PR. >> Regards, >> John Ralls >> [1] >> https://www.gnucash.org/docs/v5/C/gnucash-guide/bus_setup.html#bus-setupterms >> [2] https://code.gnucash.org/docs/STABLE/group__BillTerm.html#details > > _______________________________________________ > gnucash-user mailing list > [email protected] > To update your subscription preferences or to unsubscribe: > https://lists.gnucash.org/mailman/listinfo/gnucash-user > ----- > Please remember to CC this list on all your replies. > You can do this by using Reply-To-List or Reply-All. _______________________________________________ gnucash-user mailing list [email protected] To update your subscription preferences or to unsubscribe: https://lists.gnucash.org/mailman/listinfo/gnucash-user ----- Please remember to CC this list on all your replies. You can do this by using Reply-To-List or Reply-All.
