Easy order import

Important! Remember to always backup your data before applying changes to your platform. Fraktjakt is not responsible for any complications that might occur when you change the script or webshop.

If you have installed additions or changes in the system, you may also need to change which statuses apply to the orders to be transferred to Freight Hunt. Open the downloaded file in a text editor and change the $order_statuses line to the statuses that apply to your current system.

# Return orders by the following order statuses
 $order_statuses = [1]; // Example [1, 2, ...]

You can also specify which order number the order connection should start with at the next order connection to avoid older orders being downloaded over. You set this directly under your integration settings in Fraktjakt. The Start Order ID is then automatically counted up to the last order you downloaded over, so that future order connections skip already connected orders.

The shipping events that can generate a callback are the following; 'created', 'incomplete', 'complete', 'ready_to_ship', 'shipped', 'delivered', 'attention' and 'returned'.

Look for the following section in your Easy Order Import and decide what status each event should result in in your online store. This requires basic knowledge of your e-commerce system's different status levels for your orders and what the status ID of each status is. Enter '0' or 'null' to skip and avoid changing the status of the order.

 # Set new order status id upon notifications, set 0 or null to skip
 $new_order_statuses = [
 'created'       => 0,
 'incomplete'    => 0,
 'complete'      => 0,
 'ready_to_ship' => 0,
 'shipped'       => 3,
 'delivered'     => 0,
 'attention'     => 0,
 'returned'      => 0,
 ];

Shipping events that can initiate a callback

• 'created' - The order is imported to Fraktjakt and can be managed there.
• 'incomplete' - There is some sort of problem with the imported order shipment and it needs to be handled in Fraktjakt.
• 'complete' - There are no problems with the imported order shipment, it is ready for purchase.
• 'ready_to_ship' - The order is ready to be sent.
• 'shipped' - The order is sent.
• 'delivered' - The order is delivered to the end-customer.
• 'attention' - Not implemented yet, but will indicate that something is wrong with the delivery to the end-customer.
• 'returned' - The order has returned to the webshop.

• Examine JSON output
• Enable PHP Strict error reporting
• Turn on PHP error displaying
• Show a complete backtrace of an error
• Log PHP errors to disk
• Log incoming requests to fraktjakt.log
• Set Date and X-Checksum headers if missing. This way you can open the URLs straight in your browser to make sure the output is fine.

These are the valid endpoints you can test using your browser:

HTTP GET https://www.yoursite.tld/fraktjakt.php/orders

HTTP GET https://www.yoursite.tld/fraktjakt.php/orders/{orderid}

HTTP POST https://www.yoursite.tld/fraktjakt.php/notifications

HTTP GET https://www.yoursite.tld/fraktjakt.php/info

Please note having fraktjakt_debug.inc.php present poses a security risk. Therefore it should be removed when no longer needed.

location / {
 rewrite ^/fraktjakt.php/ /fraktjakt.php last;  # <--- See this line
 try_files $uri $uri/ /index.php?$query_string;
 }

 RewriteEngine on
 RewriteCond %{REQUEST_URI} !^/pub/
 RewriteCond %{REQUEST_URI} !^/setup/
 RewriteCond %{REQUEST_URI} !^/update/
 RewriteCond %{REQUEST_URI} !^/dev/
 RewriteCond %{REQUEST_FILENAME} !fraktjakt\.php$ # <--- Add
 RewriteRule .* /pub/$0 [L]
 DirectoryIndex index.php
 

Download our technical documentation for additional information if, for example, you want to troubleshoot further, customize your integration or develop your own order import.