Add extra API functionality for order_status, payment_status & total_order_value

[Web10-Joris]

Currently it is not possible to add order_status, payment_status & total_order_value per Parcel right?
Is it possible to built this in?

https://api.sendcloud.dev/docs/sendcloud-public-api/integrations/operations/create-a-integration-shipment

[villermen]

@Web10-Joris The documentation you're referring to is of the integrations API. This client supports the shipping and service points APIs right now. I've checked and there is no option to work with these properties there. It's unlikely I will be available to implement a full new API anytime soon without a PR by someone else.

I'm happy to think with you about an alternative solution for your use case though.

[Web10-Joris]

@villermen Thanks for your response! I see that the Shipments API also provides order_status & total_order_value as possible input options. https://api.sendcloud.dev/docs/sendcloud-public-api/parcels/operations/create-a-parcel

This is part of the Shipping API right? Then only the payment_status wouldn't be possible, but adding the other two will significantly improve the usage, since it is then possible to set insurances based on the order value and to sync the shipments with the webshop based on their order_status.

[villermen]

@Web10-Joris For parcel creation it appears only total_order_value+total_order_value_currency are possible because they are linked to delivery (cash on delivery). I'm not seeing the other properties in these calls/the parcel model.

An alternative route could be to send insured_value with the request (currently also not possible) and update it when the order status changes.

[Web10-Joris]

Will the total_order_value be supported in the future? Would be very helpful for us :)

[villermen]

@Web10-Joris I've added options for total_order_value and total_order_value_currency to the createParcel() method in #39. Note that the client does not perform any validation on these values whatsoever so please make sure to send the value as a decimal string ("99.99"). Improved validation will probably come as part of #38.