Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

 

...

 

How to create a new key

You need to copy the content of the public key to X509 Public Key Certificate field. (If you don't have this, go to the Installation Guide, it's the content of the file Xero/etc/certs/magenest.cer, you can open it in any text editor). 

 

Image Added

Or creating a new content of public key: 

Go to http://developer.xero.com/ > Docs > Advanced Docs > Public/private key pair > Using OpenSSL and follow the instructions: 

 

Image Removed

 

Running run 3 commands to create 2 files: public key.cer and private key.pem

 

+ Copy and paste content file .cer into magenest/xero/etc/certs/magenest.cer 

+ Copy and paste content file .pem into magenest/xero/etc/certs/magenest.pem

 After

Image Added

 

When you have file etc that copy and paste content file etc/certs/magenest.cer into X509 as below: 

 

Image Removed

copy and paste them into X509. 

You will see the Xero accounting interface after you've done the last step but now we need to continue our setup, go to this site: https://app.xero.com/Application to create the Application.

Choose the application mode (usually is Private), application name (the name for the application is not very important), choose your organization (this is where the Magento 2 data will be synced into). 

After that, check the information again then check on "I have read and agree to the Xero Developer Platform" & click Save

 

Image Added

 

 

If everything goes right, you will see the following content. By now we have done everything on the Xero site, now move to your magento 2 backend but don't close this site.

 

 

Image Added

Click on "Show" button to show the Consumer Key & Consumer Secret.


...

Configuration

Setup Xero.

For this integration you will need to have an account in Xero Website. 
First, go to https://www.xero.com/ and register an Xero accounts (click on "Try xero for free" or "Free Trial"). If you already have an account, you can skip this step.

...

When your account is activated, go to https://login.xero.com/ and login with your account. 

 

 

If your account is new, Xero will ask you to create a new organization. Enter the name of your organization and choose other information. Press on Start Trial, or Buy Now to continue.

 

 

You will see the Xero accounting interface after you've done the last step but now we need to continue our setup, go to this site: https://app.xero.com/Application to create the Application.

Choose the application mode (usually is Private), application name (the name for the application is not very important), choose your organization (this is where the Magento 2 data will be synced into).

The next step is very important, you need to copy the content of the public key to X509 Public Key Certificate field. (If you don't have this, go to the Installation Guide, it's the content of the file Xero/etc/certs/magenest.cer, you can open it in any text editor).

After that, check the information again then check on "I have read and agree to the Xero Developer Platform" & click Save.

 

Image Removed

 

If everything goes right, you will see the following content. By now we have done everything on the Xero site, now move to your magento 2 backend but don't close this site.

 

Image Removed

 

Click on "Show" to show the Copy and paste Consumer Key & Consumer Secret, copy and paste them to  from above into Magento 2 backend configuration like in the picture. 

Choose the Sync Mode (Cron Job or Immediately), you may want to consider the cron job modemode 

  • Immediately mode: the data will be synced as soon as they're created or updated. 
  • Cron Job: the data will be queued and will be synced together every 30 minutes. 

The immediately mode seems better than cron job mode, but some application mode (like private) only allowed 1000 requests a day. So choosing Cron Job will guarantee all data will be synced. Unless you're a partner to Xero and have an special Application, we suggest you choose Cron Job mode.

Press Save Config after you've done (refresh the cache if needed).

Click on Test Connection.

 

 

If everything is right, a window will show up and inform you like this.

 

 

Else it will display the error.

 


 

...