• Contents

Connecting Cin7 to Magento

Last updated 28/05/2019

This article outlines the steps required to connect your Magento and Cin7 accounts.

Overview


The below setup requires technical expertise, so we strongly recommend involving your Magento developer. If completed correctly it will take around 10 minutes.

These instructions relate to Magento Community Edition 1.9 and should be similar for previous versions (1.6 - 1.8). Version 2 onwards has a separate process outlined in Connecting Cin7 to Magento 2.

We recommend using a staging site to test on before connecting to your live Magento server. It is also recommended that you connect a new Magento module in Cin7 when switching to your live site so that it does not conflict with the data mapped to your staging site.

The process for connecting the two platforms is as follows:

  • Create Magento API details
  • Add Magento to your Cin7 Account
  • Connect the two accounts
  • Install Plugins to Magento
  • Add cin7_import attribute

Each step is outlined in detail below.

Create a Magento API role and user


Before you can connect Magento to your Cin7 account, you must first obtain Magento API details. To do this:

  1. Log in to Magento with your Administrator Account.
  2. Create an API Role:
    System > Web Services > SOAP/XML-RPC Roles > Add New Role 
    Fill in the fields.
    Under Role Resources set Resource Access to All.
  3. Create an API user:
    System > Web Services > SOAP/XML-RPC Users > Add New User.
    Fill in the fields.
    Under User Role select the role created in previous step.
    Make note of the details as you will need them later.

Adding Magento to your Cin7 account


Once you have retrieved this information, you will need to add the Magento module to your Cin7 account.

To add the module:

  1. Whilst logged in as an Administrator, from the left navigation,  click Integrations then App Store.
  2. From the App Store, select Ecommerce then click Magento.
  3. Click Request App Installation.

Cin7 account managers will receive the request and will get in touch with you.

Connecting the two accounts


Next, connect the two accounts using the details obtained earlier.

  1. Whilst logged in as an Administrator, from the left navigation,  click Integrations then select your Magento module.
  2. Click Settings and go to the Connect tab.
  3. Insert your Web Address, API Username and API Password in the fields provided. These are the details created earlier.
  4. Ensure you select "https" if you are using SSL and make sure to remove this from the Web Address field.
  5. If your Magento installation is not at the root of the server, you can change the Api Path setting to custom and enter the correct path.
  6. Click Save Connection Settings

Install Plugins


We must install a few plugins to your Magento installation into download orders. For ease of use we have created a script that will install all plugins for you. For more information on what is installed, or to do this manually, see Installing Magento Plugins Manually.

  1. Log in to your Magento Administrator Account.
  2. Set the below
    System > Configuration > Developer > Enable symlinks > Set to Yes  .
  3. Download the install file - cin7installer.zip 
  4. Extract the contents, which is a single file called cin7installer.sh
  5. Copy or move the file to your Magento installation directory. 
    This is usually the public_html folder where you can see index.php file and app directory.
    We suggest any ofthefollowingmethods to copy the file:
    • use FTP to copy the file
    • if you can SSH into your server, run "vim" (or any editor) and copy the cin7installer.sh content in a new file with the same name and extension, or
    • if you are familiar with UNIX you may use SCP as follows: 
      scp cin7installer.sh your_username@yourhostingurl:/magentodirectory
  6. SSH to your server and go to the Magento directory where you can see the cin7installer.sh file you copied in the step above.
    (In the next two steps, if you have writing and execution privilege, you may have to remove "sudo" from your commands).
  7. Run this command:
    sudo chmod +x cin7installer.sh
  8. Run Cin7 installer.sh with the following command:
    sudo ./cin7installer.sh
  9. In your Magento Admin Panel go to System > Cache Management > Select All > Submit to refresh the Magento cache.
  10. If the installation has worked you will see a .modman directory and geterrors.php file in the Magento installation directory.
    The cin7installer.sh will take care of all dependencies and installs for the required packages.
    You should also see API Import under Services in System > Configuration

Insert a new attribute


Cin7 requires an additional attribute cin7_import to track which products have been successfully updated.

Make this attribute Global and Text insert into all attribute sets.

 

FAQs

Can we have API updates into a git repository?

Yes but is up to the developer's discretion as Cin7 does not support this.

Does the installation script support CentOS 6.6?

No, the current installation script is based on Debian Linux, like Ubuntu. You can install the Cin7 plugin manually however.

Is TLS supported?

Http and Https (SSL) are supported by the API but not TLS.

Will the integration work with other Magento addons?

The Cin7 Integration is set up to work with a default environment in Magento. At Cin7 we do not test extensions for compatibility except the two required for the actual integration.

As a rule of thumb we say that an extension is likely to be compatible if it doesn't add any complex data to the order or products data required by Cin7. E.g. if you had an addon that had an extra field in the product you wanted to include in Cin7, that should be fine, however if you had an addon that produced a many to many relationship between multiple products and you required Cin7 to do the same thing then that wouldn't be possible.