WooCommerce

his page will guide you through on how to add a WooCommerce integration to your myOGO account with a few simple steps!

There are two ways to integrate WooCommerce to myOGO; by installing the integration on the myOGO site or by installing the plugin in WooCommerce. To get best experience, it is needed to install plugin and the integration, so all of the features are available to use. The differences between these integrations are listed below. Key features marked in bold.

Installing the integration

First, you need to create a Consumer key and Consumer secret in WooComerce.

1. Go to WooCommerce
2. Then go to WooCommerce → Settings → Advanced
3. Click on REST API
   
4. Click Add key to create new API key
5. Give the key a name, description and give the permission to read and write.
   
6. Then click Generate API key
7. Copy and save the Consumer key and Consumer secret
   - Note! They can not be accessed again
8. Next, get your site URL from the Settings page

Next you may add the integration to myOGO

1. Go to Edit Merchant → Integrations
2. Click on New Integration
3. Choose WooCommerce
4. Fill in the Store Url, Consumer key and Consumer secret
5. Save
6. Select the warehouse to be used
7. Adjust the settings

Make sure that by default the following settings in Settings → General are not selected. By default the integration will work as intended without these selected.

Installing the OGOship plugin

The OGOship for WooCommerce plugin connects your store to OGOship, adds the OGOship product fields to WooCommerce, and shows shipment tracking to your customers.

Connecting takes about two minutes. You do not need to create or copy an API key yourself: WooCommerce creates one and hands it to OGOship directly when you approve the connection.

Before you start

• WooCommerce is installed and active on your store.
• Your store is served over HTTPS.
• You can sign in to WordPress as an administrator.
• You have a myOGO account with a warehouse assigned to it.

1. Install the plugin

In your WordPress admin, go to Plugins → Add New and search for OGOship. Choose OGOship for WooCommerce, published by ogoship, and click Install Now.

When the installation finishes, click Activate. The plugin then appears in your plugins list with a Connect link of its own.

2. Start the connection

Click Connect in the plugins list, or go to WooCommerce → OGOship. Then click Connect to OGOship.

3. Sign in to myOGO

You are taken to OGOship to sign in with your myOGO account. If you are already signed in, this step is skipped.

4. Choose the account and warehouse

Pick the OGOship account this store belongs to and the warehouse that will ship its orders, then click Continue to WooCommerce. If you only have one account, or one warehouse, it is selected for you.

5. Approve the connection in your own store

You are returned to your WooCommerce admin, where WooCommerce asks you to approve the connection. This screen is WooCommerce's own — OGOship never sees your store password. Click Approve.

6. Check that it worked

After approving, you land back on WooCommerce → OGOship, which confirms "This store is connected to OGOship".

For more detail, open WooCommerce → Status → OGOship. That panel is read-only and shows when OGOship last contacted your store, which order most recently received tracking, and your plugin version.

What the plugin adds

• An OGOship tab on the product page for EAN code, supplier name and code, purchase price, product group, customs description, country of origin, HS code, and a "do not send to OGOship" flag. The same fields are available on individual variations — leave a variation field blank and it inherits the parent product's value.
• Shipment tracking for your customers, shown on the My Account order page, on the order confirmation page, and in your WooCommerce order emails.
• A tracking column and panel on your admin orders screens.

The plugin does not send orders to OGOship. OGOship reads orders from your store over the WooCommerce REST API, which is what the connection above sets up.

Upgrading from the older OGOship plugin

If your store still runs the older Ogoship API for WooCommerce (version 3.x), install the new plugin first, then deactivate the old one. Nothing needs to be migrated and nothing is re-entered: both plugins store your product data in exactly the same place, so it carries across untouched.

While both are active, the new plugin holds back its product fields and tracking so you do not see two copies of every field. It shows a notice on the WooCommerce → OGOship screen with a button that deactivates the old plugin for you.

Troubleshooting

The Connect button is disabled and warns about HTTPS. Your store is not served over HTTPS. WooCommerce will not release API credentials to an insecure connection, so the automatic setup cannot run. Enable HTTPS on your store, or contact OGOship support to have the store connected manually.

"This account has no warehouse assigned yet." Your OGOship account does not yet have a warehouse, so a store cannot be connected to it. Please contact OGOship support.

"Your account isn't set up yet." Onboarding is not finished for your OGOship account. Complete it, then start again from your WooCommerce store.

The connect link is missing or has expired. Start again from WooCommerce → OGOship in your store. The link can only be used once.

My customers cannot see any tracking. Open WooCommerce → Status → OGOship. If it shows no API activity, OGOship is not reaching your store — check that the API key has not been revoked under WooCommerce → Settings → Advanced → REST API, and reconnect from WooCommerce → OGOship if it has. If there is activity but no tracking, the order has not shipped from the warehouse yet.

The status panel says the old OGOship plugin is still active. Deactivate Ogoship API for WooCommerce under Plugins. The new plugin's product fields and tracking stay switched off until you do.

Synchronizing products

Once the integration is set up, it's time to sync your products, go to the myOGO Products → Sync webshop products. If the products are not yet visible, click Refresh.

When the products are visible on the left side of the page, click on all, or the desired products, and select Create product. Read more about the product sync page.

Note! If you don't want to send every product to OGOship, check the box Do not export to OGOship on the product page in WooCommerce. Also, make sure that all products have the setting Manage Stock "Enable stock management at product level" - selected.

If you are selling variable products, remember also to set a different SKU for each one. Otherwise, it won't transfer to myOGO.

Setting up shipping methods

Now that you have your integration set as well with products created next you need to connect the shipping methods from your online store to myOGO.

Once you have created the shipping methods to your online store, please find the detailed guide for shipping method configuration here.

Installing the old plugin (version 3.x)

1. Go to your Wordpress Market Place and search for OGOship plugin
2. Install and activate it
3. Next, go to your myOGO account to get your Merchant ID and Secret Token
4. Go to Edit Merchant → Integrations
5. Copy the merchant ID and Secret Token
6. Add them to WooCommerce general settings under "OGOship Plugin General Settings"
7. Save

OGOship plugin tips (not relevant when using integration)

Verify plugin

Once you have goods in stock, you may verify the plugin with stock sync in WooCommerce, by clicking "upload product info from OGOship to WooCommerce" under OGOship Plugin General Settings.

Orders not syncing?

If the orders are not transferred to myOGO check the following settings in WooCommerce. Orders can be also sent manually to myOGO. If the order is not transferred to myOGO there will be an error message on the Order notes.

A common reason for order not transferring is, that the ordered product has no SKU, or the setting on the product page Do not export to OGOship is on (see photo above). Also on the WooCommerce settings page the setting Automatically send orders to OGOship needs to be on.

Pickup / service point select plugins supported by myOGO integration:

• Budbee
• Schenker
• Posti

Note. We are able to support most of other plugins also. Just make a test order and send email to our support, and we will update integration.