Add shipping option for insurance

[avido]

Description

Insurance shipment option added.

Motivation and context

Why is this change required? What problem does it solve?

If it fixes an open issue, please link to the issue here (if you write fixes #num
or closes #num, the issue will be automatically closed when the pull is accepted.)

How has this been tested?

Please describe in detail how you tested your changes.

Include details of your testing environment, and the tests you ran to
see how your change affects other areas of the code, etc.

Types of changes

What types of changes does your code introduce? Put an x in all the boxes that apply:

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

Go over all the following points, and put an x in all the boxes that apply.

Please, please, please, don't send your pull request until all of the boxes are ticked.

• I have read the CONTRIBUTING document.
• My pull request addresses exactly one patch/feature.
• [x ] I have created a branch for this patch/feature.
• Each individual commit in the pull request is meaningful.
• I have added tests to cover my changes.
• All new and existing tests passed.
• If my change requires a change to the documentation, I have updated it accordingly.
• My code follows the code style of this project.

If you're unsure about any of these, don't hesitate to ask. We're here to help!

[mvdnbrk]

The amount should be in passed in cents to the API of MyParcel.
Think we should make this clear in the documentation.

[mvdnbrk]

From the MyParcel API docs:

insurance

This option allows a shipment to be insured up to certain amount. Only package type 1 (package) shipments can be insured. > NL shipments can be insured for 500,- euros. EU shipments must be insured for 500,- euros. Global shipments must be >insured for 200,- euros. The following shipment options are mandatory when insuring an NL shipment: only_recipient and >signature.

only_recipient and signature are mandatory here for NL, this would mean you would have to call it like this:

$parcel->insurance(50000)->onlyRecipient->signature();

Bit cumbersome and one or the other method might be forgotten.
Would be easier if you could just do (and set the appropriate options internally):

$parcel->insurance(50000);

[avido]

From the MyParcel API docs:

insurance

This option allows a shipment to be insured up to certain amount. Only package type 1 (package) shipments can be insured. > NL shipments can be insured for 500,- euros. EU shipments must be insured for 500,- euros. Global shipments must be >insured for 200,- euros. The following shipment options are mandatory when insuring an NL shipment: only_recipient and >signature.

only_recipient and signature are mandatory here for NL, this would mean you would have to call it like this:

$parcel->insurance(50000)->onlyRecipient->signature();

Bit cumbersome and one or the other method might be forgotten.
Would be easier if you could just do (and set the appropriate options internally):

$parcel->insurance(50000);

But only mandatory for NL therefore didn't set them internally

[mvdnbrk]

Think this package will be used most for NL shipments, so it makes sense to set these internally, we could check if the recipients address is in NL?

[avido]

Think this package will be used most for NL shipments, so it makes sense to set these internally, we could check if the recipients address is in NL?

That's a risky assumption :)
It's possible recipient is not set when setting insurance. Therefore the country code isn't present.
It's possible to check if the recipient is present, but this leads to some (unwanted) overhead in code. Also i believe the api of myparcel will auto add the mandatory options on request.

[mvdnbrk]

True, but I think it might be worth the little overhead.
In stead of making notes in the docs like: "Hey don't forget to call this method and this method when setting an insurance for your parcel" 😉

In my opinion you should always set the recipient first before calling any additional option methods, even though this is possible at the moment.