Books API Receiving an Error that Doesn't Make Sense when Creating Credit Note - trying to use 'ignore_auto_number_generation' argument

Books API Receiving an Error that Doesn't Make Sense when Creating Credit Note - trying to use 'ignore_auto_number_generation' argument

Hello,

I'm working on a newly created routine and I'm getting an error that doesn't make sense when trying to create a new Credit Note.

Here is my POST request.


Body:
    {
    "customer_id": "3853445000000088169",
    "date" : "2025-10-22",
    "creditnote_number": "VRBO_458657_HA-FFDB0X_REFUND",
    "ignore_auto_number_generation": true,
    "line_items" : [
        {
            "invoice_id": "3853445000011912001",
            "item_id": "3853445000008744186",
            "rate": 734.75
        }
    }


My authentication is good because this request is successful if I remove the 'creditnote_number' and 'ignore_auto_number_generation' arguments.

This request gets the following 400 error response:   {"code":8,"message":"Invalid Element ignore_auto_number_generation"} 

But the documentation says otherwise on this page. 'ignore_auto_number_generation' is a valid argument. https://www.zoho.com/books/api/v3/credit-notes/#create-a-credit-note-ignore_auto_number_generation

If I remove the 'ignore_auto_number_generation' argument, I get an error that says I need to disable Auto Number Generation.
   {"code":4097,"message":"Number entered does not match the auto-generated number. To proceed, please disable auto-generation and continue."}


And again, this request is successful IF I remove the 'ignore_auto_number_generation' and 'creditnote_number' arguments. However, I need to use a custom name for my credit notes so I don't know what I'm missing.

Anyone see what I'm missing? I don't see any other arguments that would be required.

Thanks for your help.

john

      Zoho Campaigns Resources


        • Desk Community Learning Series


        • Digest


        • Functions


        • Meetups


        • Kbase


        • Resources


        • Glossary


        • Desk Marketplace


        • MVP Corner


        • Word of the Day


        • Ask the Experts


          Zoho CRM Plus Resources

            Zoho Books Resources


              Zoho Subscriptions Resources

                Zoho Projects Resources


                  Zoho Sprints Resources


                    Zoho Orchestly Resources


                      Zoho Creator Resources


                        Zoho WorkDrive Resources



                          Zoho CRM Resources

                          • CRM Community Learning Series

                            CRM Community Learning Series


                          • Tips

                            Tips

                          • Functions

                            Functions

                          • Meetups

                            Meetups

                          • Kbase

                            Kbase

                          • Resources

                            Resources

                          • Digest

                            Digest

                          • CRM Marketplace

                            CRM Marketplace

                          • MVP Corner

                            MVP Corner




                            Zoho Writer Writer

                            Get Started. Write Away!

                            Writer is a powerful online word processor, designed for collaborative work.

                              Zoho CRM コンテンツ




                                ご検討中の方