Krokedil Shipping Connector

You install this plugin just like any other WordPress plugin:

1. Download and unzip the latest release zip file.
2. If you use the WordPress plugin uploader to install this plugin skip to step 4.
3. Upload the entire plugin directory to your /wp-content/plugins/ directory.
4. Activate the plugin through the ‘Plugins’ menu in WordPress Administration.

Configuration – plugin

1. Navigate to WooCommerce -> Settings -> Shipping.
2. Now Krokedil Shipping Connector is displayed as an available option in the horizontal menu at the top. Click on this link to access the Krokedil Shipping Connector settings.
3. Unifaun id - Your Unifaun API ID . Available from your Unifaun Online account. 
   In your Unifaun Online account, navigate to → M aintenance → API keys, and click on the search button. Now you will see a list of the API Keys in your account. Click on the "Pen" next to API Id. Now you will find the ID.
4. Unifaun secret id - Your Unifaun Secret API ID. Available from your Unifaun Online account. 
   In your Unifaun Online account, navigate to → M aintenance → API keys, and click on the search button. Now you will see a list of the API Keys in your account. Click on the "Pen" next to API Id. Now you will find the Secret ID.
5. Unifaun quick id - Your Unifaun Quick ID. Available from your Unifaun Online account.
   In your Unifaun Online account, navigate to  → maintenance → senders → and click on the search button. Now you will see a list of the API Keys in your account. Now you will see a list of the companies you have added and there you will see the Quick ID for each individual company.
6. Unifaun printing favorite mapper - Map Delivery Option Title with Printing favorite Name.
   - The Delivery Option Title is the name of the shipping method displayed for the customer (and what is stored as shipping method in the order in WooCommerce).
   - The  Printing favorite Name is available from your Unifaun Online account. In your Unifaun Online account, navigate to   → Maintenance → Printing favorites → and click on the search button. Now you will see a list of your printing setups. You should add the Name on the one you want to use as a favorite in the plugin settings.
   
   The data saved in this setting must be saved as valid JSON for the mapper to work. You can check if your text is valid JSON at jsonlint.com. Here is an example how to enter the text:
   
   

   {
   	"Delivery Option Title": "Printing favorite Name",
           "DHL Home delivery": "DHL Home",
   	"Postnord Service point": "Servicepoint"
   }
   			

7. Fallback printing favorite - Enter your default Unifaun Printing favorite Name. Will be used if no match is found in the "Unifaun printing favorite mapper".
8. Debug log - Log events in the module. You can find the log by navigating to → WooCommerce → Status → Logs.
9. Unifaun Track & Trace - Tracking link of the shipment will be available for customer and merchant. (Requires you to have the additional "Track & Trace" service active on your Unifaun-plus account). 
10. Create Shipment or Store Shipment - Select where you want to handle the shipments and printing of the pdf shipment labels. Detailed explanation here.
11. Choose status on orders with Krokedil Shipping Connector - Setting for choosing the order status on orders edited with Krokedil Shipping Connector plugin.
12. Create/Store Shipment on order complete - Tick the checkbox if you want the plugin to automatically make a request to Unifaun and create/store the shipment when the order in WooCommerce is set to status Completed.  

Configuration – KSA / Unifaun

• Configuration of Klarna Shipping Assistant together with Unifaun DeliveryCheckout is something that you need to do in your Klarna and Unifaun backend accounts. 
• It's recommended that you start the configuration in a staging/test environment so you don't break your production web store.

Read more about how to get started with KSS & Unifaun in this onboarding document & in Unifaun's documentation.

Conditional shipping methods

1. Add a shipping class to a product. In this case we call it Bulky.
   
   
2. Navigate to Unifaunonline.com and edit the delivery checkout you are using for the KSA integration.
3. Add a new Parameter. Give it the same name as the WooCommerce Shipping Class slug (in our case bulky). Set the Type to Boolean and specify the default value (in our case false).
   
4. Now you need to configure each delivery option and specify the Condition.
   
   The shipping options that should be available only when an order doesn't contain Bulky goods you enter bulky = false in the Condition box. 
   The shipping options that should be available only when an order does contain Bulky goods you enter bulky = true in the Condition box. 
   
5. After saving the changes you can first test the Delivery checkout directly in Unifaun online's test tool. When you see that it is working you can test it in Klarna Checkout.
   
   

---

Free shipping coupons 

In the same way as product shipping classes is passed to Klarna (and then forwarded to Unifaun), a tag named ksa_free_shipping is sent to Klarna if a coupon code is used that enables the customer free shipping. In the same way as the bulky example in the Conditional shipping methods section above, you can enable free shipping in the Unifaun Delivery Checkout configuration if ksa_free_shipping = true.

Order management

Create Shipment

1. Navigate to → WooCommerce → Orders.
2. You can Create a shipment in multiple ways.
   1. Clicking the truck icon located to the right when viewing all orders.
   2. Selecting the Create Shipment option in the WordPress Bulk Action drop down menu.
   3. Navigating to the specific order and clicking the Create Shipment button located inside the metabox to the right.
3. If a shipment was successfully created, the order note will display "Shipment successfully created".

Store Shipment

1. Navigate to → WooCommerce → Orders.
2. You can Store a shipment in multiple ways.
   1. Clicking the arrow icon located to the right when viewing all orders.
   2. Selecting the Create Stored Shipment option in the WordPress Bulk Action drop down menu.
   3. Navigating to the specific order and clicking the Create Stored Shipment button located inside the metabox to the right.
3. If a shipment was successfully stored, the order note will display "Shipment successfully stored".

Cancel Shipment

1. Navigate to → WooCommerce → Orders.
2. Navigating to the specific order and clicking the "Cancel Shipment" button located inside the metabox to the right.
3. If a shipment was successfully cancelled, the order note will display "Shipment successfully cancelled".