Killbill 0.24.5 - After following the Quick Start Guide invoice with amount $0 is created

[Rogelio Delgado]

Hello everybody,

We are currently evaluating Kill-Bill. After reading the docs I'm impressed of all the things that this software does. While following the "Quick Start Guide with KAUI" I'm confused by a behavior with invoice generation after a subscription creation. 

The guide states that, after the step number 5 (subscription creation), you could go to the invoices menu and see the new invoice created, but in my environment shows this:

But in the details of the invoice, it seems to be correct:

Is this the correct behavior, or it's a bug? 

Thank you!

[Rogelio Delgado]

BTW, I'm using the docker images:

killbill/killbill:0.24.5

killbill/kaui:2.0.11

killbill/mariadb:0.24

[Reshma Bidikar]

Hi Rogelio,

The invoice amount being displayed as $0 in Kaui is a known issue in Kill Bill 0.24.x. There is an invoice pagination feature implemented in 0.24.x (#1272). This is not yet implemented on the Kaui side causing the invoice amounts to be displayed as $0. There is a ticket that tracks this: #329. In addition, the Retrieve account invoices endpoint is updated with a new query parameter called includeInvoiceComponents . This needs to be passed with a true value in order to be able to retrieve invoice amounts. Again, this feature is not implemented on the Kaui side.

Hope this helps,

Regards,

Reshma

[Rogelio Delgado]

Oh ok, thanks for pointing me in the right direction. 

I just tried the Retrieve account invoices end point with the includeInvoiceComponents option and it worked, but calling the alternative paginated version seems to return the list of somewhat "incomplete" invoices registries, like this:

  {
    "amount": 0.00,
    "currency": "USD",
    "status": "COMMITTED",
    "creditAdj": 0.00,
    "refundAdj": 0.00,
    "invoiceId": "104e23ba-c382-4c4e-8abe-ee8bc174fc6a",
    "invoiceDate": "2023-10-09",
    "targetDate": "2023-10-09",
    "invoiceNumber": "1",
    "balance": 0.00,
    "accountId": "2995fbc9-bd62-486d-88e0-f96acea2dd25",
    "bundleKeys": null,
    "credits": null,
    "items": [],
    "trackingIds": [],
    "isParentInvoice": false,
    "parentInvoiceId": null,
    "parentAccountId": null,
    "auditLogs": []
  },

I'm testing this with this curl call:

curl -v \
     -u admin:password \
     -H "X-Killbill-ApiKey: bob" \
     -H "X-Killbill-ApiSecret: lazar" \
     -H "Accept: application/json" \
     "http://127.0.0.1:8080/1.0/kb/accounts/2995fbc9-bd62-486d-88e0-f96acea2dd25/invoices/pagination?includeInvoiceComponents=true&offset=0&limit=5"

In the documentation, it is not clear if the includeInvoiceComponents should work with the "pagination" end-point. Is this the expected behavior?

Thanks in advance!

[Reshma Bidikar]

Hello,

Are you referring to the Retrieve paginated account invoices endpoint? If so, then yes. This endpoint does not accept the includeInvoiceComponents query parameter, it returns shallow invoices (invoices without items, payments, etc.).

We will update the docs to reflect this.

Regards,

Reshma