Jump to content

Upgrading/Downgrading a service via API


codym

Recommended Posts

Hello everyone,
I have a service with multiple configurable options. These configurable options are range-bound quantities. The client should be able to edit the quantities of these configurable options per-service. I am able to complete this task in the portal just fine and everything works as it should on both admin and client-side. I am trying to reproduce this behavior programmatically via the API but am running into some issues. Specifically, there are three variables which must be defined on the service_changes/add endpoint:

  1. service_id
  2. invoice_id
  3. vars

I'm having trouble specifically with the invoice_id. (One would think the service_change endpoint would automatically create an invoice for the difference, but I digress!) I attempted to provide the endpoint with an invoice generated from the service I was attempting to modify, invoices/createFromServices, however I receive error 400: 'Invalid invoice ID.' What should I be doing here? Should this be a blank invoice? If so, how do I create a blank one?

Additionally, I should be able to include my configurable option ID and the new quantity under vars once I have the invoice ID working properly, correct? Like so:
vars[configoptions][config_option_id]=10

Here is a screenshot of my postman attempt:

Snag_15c3892b.png.5a56a5d22f06de15958676a665bc336d.png

Thank you for your time!

Link to comment
Share on other sites

Since this post I've also tried:

  • supplying the next available invoice_id without an invoice attached
  • supplying the last invoice issued for the target service

Both of which also gave an 'Invalid invoice ID.' error.
I assume that I somehow need to manually create an invoice with the prorated data and the new options prorated as well?

Link to comment
Share on other sites

I have made some progress by reading through the app/controllers/client_services.php file.

I see that Blesta is using various private functions to pull together the data it needs to GET the endpoint service_changes/getPresenter.
This endpoint is what is providing the array of 'difference' data to create the invoice needed for the service change endpoint.

However, once again documentation is sparse regarding this endpoint. I can successfully post to it and get a 200 OK, but the response is just an empty object.

Assuming the service has no custom fields, this is what the post should look like and which gives me a 200 OK:

Snag_20446e78.png.b760a9cc907bc9de3caf69599e0bbc4f.png

 

The following values were pulled from the services/get endpoint with the service_id of '9', which is referred to as 'service':
vars[pricing_id] = service.package_pricing.id
vars[qty] = service.qty
vars[configoptions][5] = service.options[option_id].qty
vars[configoptions][6] = service.options[option_id].qty
vars[configoptions][7] = service.options[option_id].qty
vars[configoptions][9] = service.options[option_id].qty

These are the only 4 configoptions which are available to this package and are all the correct IDs and within their defined ranges. This is confirmed by using the package_options/getAllByPackageId endpoint, just as Blesta has done under the Review() function of the app/controllers/client_services.php file.

Finally, vars[use_module] = true in the screenshot below as that is set in the Review() function of the blesta code, however is not mentioned in the documentation. With or without this variable still gives me a 200 OK empty response.

Link to comment
Share on other sites

Do you really mean to use a ServiceChange?  Would Services::edit do what you want instead?  Service changes are processed automatically via cron after their invoice is paid. An edit would happen immediately.  use_module tells Blesta whether to invoke the module when making the edit, so yes it will work with or without it.

That being said, I'm not sure of your question at this point.  Are you asking what parameters should be submitted to getPresenter?

Link to comment
Share on other sites

Thanks for the reply Jono!

I think Services::edit would do what I want.... I'll play around with it and see what happens. I did some initial testing with it but it wasn't generating the prorated invoice for me. I'll get back to you on that.

Link to comment
Share on other sites

5 hours ago, Jono said:

Do you really mean to use a ServiceChange?  Would Services::edit do what you want instead?  Service changes are processed automatically via cron after their invoice is paid. An edit would happen immediately.  use_module tells Blesta whether to invoke the module when making the edit, so yes it will work with or without it.

That being said, I'm not sure of your question at this point.  Are you asking what parameters should be submitted to getPresenter?

Jono,

So, there is weird behavior with the Services::edit endpoint. When editing a service, all configurable option data and field data that is not included in the edit is deleted. Is this intended?
As well, a prorated invoice is not generated for the service.

Link to comment
Share on other sites

Yea, sorry about the learning curve there.  As documented, all config options should be submitted.  It is intended behavior that all others will be deleted.

The lack of invoice is also intended behavior.  A good place to reference is app/controllers/admin_clients.php.  Particularly lines 5590-5689

Link to comment
Share on other sites

10 hours ago, Jono said:

Yea, sorry about the learning curve there.  As documented, all config options should be submitted.  It is intended behavior that all others will be deleted.

The lack of invoice is also intended behavior.  A good place to reference is app/controllers/admin_clients.php.  Particularly lines 5590-5689

What is the name of the function I should look at? I'm on 4.4.1

Link to comment
Share on other sites

So I think I found what you're talking about, which is app/controllers/admin_clients.php::editService.

This function, when editing a service, uses the service_changes::getPresenter function to retrieve the prorated invoice details to generate an invoice for the service. So, the entire question circles back around to my reply right before your first reply where I am attempting to use the service_changes::getPresenter function to get prorated line items for an upgrade/downgrade to a service to manually create the invoice.

I am receiving a 200 OK but empty response from that function, just as in that reply.
 

Quote

This endpoint is what is providing the array of 'difference' data to create the invoice needed for the service change endpoint.

However, once again documentation is sparse regarding this endpoint. I can successfully post to it and get a 200 OK, but the response is just an empty object.

Assuming the service has no custom fields, this is what the post should look like and which gives me a 200 OK:

Snag_20446e78.png.b760a9cc907bc9de3caf69599e0bbc4f.png

 

The following values were pulled from the services/get endpoint with the service_id of '9', which is referred to as 'service':
vars[pricing_id] = service.package_pricing.id
vars[qty] = service.qty
vars[configoptions][5] = service.options[option_id].qty
vars[configoptions][6] = service.options[option_id].qty
vars[configoptions][7] = service.options[option_id].qty
vars[configoptions][9] = service.options[option_id].qty

These are the only 4 configoptions which are available to this package and are all the correct IDs and within their defined ranges. This is confirmed by using the package_options/getAllByPackageId endpoint, just as Blesta has done under the Review() function of the app/controllers/client_services.php file.

 

Link to comment
Share on other sites

Well, the return is a php object referencing a php class, so I don't think there is a way to make that work.  That being said, try ServiceChanges::getItems().  I know it's deprecated but I believe it will get the results you want in a way that can be sent to node.

Link to comment
Share on other sites

4 hours ago, Jono said:

Well, the return is a php object referencing a php class, so I don't think there is a way to make that work.  That being said, try ServiceChanges::getItems().  I know it's deprecated but I believe it will get the results you want in a way that can be sent to node.

https://www.php.net/manual/en/jsonserializable.jsonserialize.php

Link to comment
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Loading...
×
×
  • Create New...