READ ME FIRST - Developer information


Developer info:

Our remarks are labelled like this in this mock up of a settings page. All data is dummy data and the page is done in static html just for illustration purposes.

Most of this settings communicate with an external API and we have full back-end priveledges to the API as well as extensive knowledge of the API it self. We also provide a Sandbox account.

It is an HTTP REST interface divided into distinct resources, each documented separately. Data exchange is done with XML

The flow of the Cargonizer API:

- GET profile.xml
- GET printers.xml
- GET transport-agreements.xml
- GET service-partnerst.xml (If required by transport-agreements.xml)
- POST consignments.xml
- GET printers.xml (print)

Everything you see here is up for discussion and even though this settings page is still work in progress we believe most settings are covered.

If you know better ways to do this, we are all ears :) This is just how we would have done it in other systems, but due to our little experience in Shopify we might ask for too much or too little. Bear with us and we'll bear with you.

We have bought this template in use and can provide all source files, also the source files for this settings page that is our own design based on the template. We ar enot "hell bent" on using this template, but would prefer it. The template also offers a Ruby on Rails set.



Settings

  1. C-IT.no
  2. Settings
Initial setup - C-IT.no Cargonizer

Connect to Cargonizer

This app requires an account for Cargonizer from Logistra AS.

You can create a free test account with Logistra AS allowing you to generate 50 packages by visiting www.logistra.no. You will then be able to use all your registered carriers in Cargonizer directly here in Shopify!

 

Cargonizer API Key

The API key is found in Cargonizers Settings. Please copy this key and paste it in the field below. Then click "Connect it" before you move to the next step.




Developer info:

Using the API key we pull information from web-service profile.xml to present the user and the sender(s) to the right.

 

Cargonizer User

Your API key belongs to this user in Cargonizer. If this is not you, please verify your api key in the previous step or contact Logistra to get your own API key.



Developer info:

These fields are non-editable and are populated from web-service profile.xml when clicking "Connect it" to the left.

 

Cargonizer Sender

Your user-account in Cargonizer might be administrating several companies. Please select which company this app shall integrate with.



Developer info:

This information is also pulled from the webservice profile.xml. Selecting this will give us the SenderID needed for later use in the setup.

A SenderID is the sender/company in Cargonizer. A user (Api-key) can send through many accounts (companies) in Cargonizer

You will find the SenderID(s) and names in the response file through:

User > managerships > managership > id
and
User > managerships > managership > id > sender > name

Print and Quick Send settings

Print settings

Reccomended

If you have one or more DirectPrints from Logistra please select your preferred DirectPrint as we then can route your label directly to the desired printer. A link to the pdf with the label will be presented if you do not have this so that you can manually print your labels.

If you have a DirectPrint, but can't see your DirectPrint(s) here, make sure you have connected them as described by Logistra. Contact Logistra for support if you experience any problems.



Do you also send goods with the freight alternative "Pakke i postkassen" with RFID tracking? If so, please select your RFID printer so we can direct your labels to the correct printer.



Developer info:

This list is populated from using the printers.xml webservice using the Api key and SenderID provided in the first step. "I dont have a DirectPrint" is shown if there is no found.

Available printers are found through the response:

printers > printer > id
printers > printer > name

Store the ID as we will send the print job to this ID after generating the consignment.

Quick-Send options

Please chose the freight alternative you want to use when you Quick-Send an order. This is the fastest way to produce a shipment, but you have less flexibility when creating your shipment.


Here you can select several services that you want to add to your Quick-Send shipment. You can only add services corresponding with your selected carrier above. Note that some services might require information not available in this app.



Developer info:

Both of these are populated from using the transport-agreements.xml webservice using the Api key and SenderID provided in the first step.

Default shipping method:

In the optgroup we will use:

transport-agreements > transport-agreement > carrier > name

and for selectables we use

transport-agreements > transport-agreement > products > name

Default services:

In the optgroup we will use information from

transport-agreements > transport-agreement > carrier > name

For selectables we use:

transport-agreements > transport-agreement > products > product > services > service > name

Pay attention to the response tag <requires_service_partner> in transport-agreement > products > product as if this is 'true' we will need to add a pickup-point segment to the consignments.xml.

 

This will be used for your quick-send orders and all your packages will be of this weight.

If you have registered the weight of all your products, we can also summarize the total weight of your order based on the weight of your products. Note that enabling this feature, will override your registered default weight.

   Auto calculate weight from product data


Selecting this option will always also produce a return-shipment for your Quick-Send shipments. Note that these are two separate consignments. Chosing this option requires you to set a default return method.



Developer info:

The first of these are needed for generating a shipment. This as some products require weight or volume.

The second of these are populated from using the transport-agreements.xml webservice using the Api key and SenderID provided in the first step.

Default return method (The same as when presenting default shipping method):

In the optgroup we will use:

transport-agreements > transport-agreement > carrier > name

and for selectables we use

transport-agreements > transport-agreement > products > name

Other settings

Other settings

If you want us to let Logistra know that they should automatically transfer the information to the carriers, please select this option. If this selection is not selected you will need to transfer your consignments manuelly directly in Cargonizer or use the feature below.

   Auto transfer shipment information

Note! This feature might be un-stable. Neither C-IT.no nor Logistra can guarantee that the transfer is done exactly at the specified time and take no responsibility for the timed transfer. History has shown though that it is relatively stable and will most likely work as intended. Enabling this setting will override the "Auto transfer" setting above.

 

By default we will use your registered shipping origin as your return address. If you would like to override this, please make your adjustments here.

Address 1:
Address 2:
Zip Code:
City:
Country:

Enable this if you want your orders to be fulfilled when you send your order.

   Auto fulfill orders

If you have enabled this it will require us to make a small change in our codes. Therefore, please enable this if your customers can checkout as a company.

   Companies can check-out

This option will add the freight cost to your orders for the Weight based rates based on your registered product data. Contact Logistra to make sure you are receiving your correct agreement freight prices.

   Real-time freight cost

Finish the setup

Terms and Conditions

C-IT.no acts as a link between your Shopify store and Logistra Cargonizer. I understand that C-IT.no can not be held responsible for errors as the data sent is collected from my own Shopify registries.