diglin/ricardo

ricardo.ch PHP library - Used for example by the ricardo.ch Extension for Magento

Introduction

The Diglin ricardo.ch source code is a PHP Library to get access to the ricardo.ch API which is a .NET Webservice sending Json or SOAP requests. With this library we handle only json requests.

Installation

Install for custom framework

To start you have to include in your PHP include path, the folder of your library folder where you are going to install this library and then set the autoloader. Here is an example with a provided autoloader:

require_once __DIR__ . '/src/SplAutoloader.php';
$autoload = new SplAutoloader(null, realpath(dirname(__DIR__) . '/src'));
$autoload->register();

Install via Composer

Add the following requirements into your composer.json at root project level. You do not need to add an autoloader, composer will handle it for you if your application is compatible with it.

 {
    "require" : {
        "diglin/ricardo": "1.*"
    },
    "repositories" : [
        {
            "type": "vcs",
            "url": "[email protected]:diglin/ricardo.git"
        }
    ]
 }

Magento Composer Installer

In your composer.json at the Magento project level, you will have to set the following informations:

{
   "require" : {
       "magento-hackathon/magento-composer-installer" : "*",
       "diglin/ricardo": "1.*"
   },
   "repositories" : [
   	{
           "type" : "composer",
           "url" : "http://packages.firegento.com"
       },
       {
           "type": "vcs",
           "url": "[email protected]:diglin/ricardo.git"
       }
   ],
   "extra" : {
       "magento-root-dir" : "./"
   },
   "scripts": {
       "post-package-install": [
           "Diglin\\Ricardo\\Composer\\Magento::postPackageAction"
       ],
       "post-package-update": [
           "Diglin\\Ricardo\\Composer\\Magento::postPackageAction"
       ],
       "pre-package-uninstall": [
           "Diglin\\Ricardo\\Composer\\Magento::cleanPackageAction"
       ]
   }
}

How to use it

TODO

Tests

How to configure the test case

To configure the test, please create an ini file in tests/conf/config.ini with the following content: Pay attention, you need two different configurations for each interface language. During the tests, only the German section is supported. So use only this one.

// Ricardo API Config for German version (for example)

[GERMAN]
host = ws.betaqxl.com
partnership_key = YOUR_PARTNER_KEY
partnership_passwd = YOUR_PARTNER_PASS
partner_url = YOUR_WEBSITE_URL
allow_authorization_simulation = true
customer_username =
customer_password = ''
debug = true
display_test_content = true

[FRENCH]
host = ws.betaqxl.com
partnership_key = YOUR_PARTNER_KEY
partnership_passwd = YOUR_PARTNER_PASS
partner_url = YOUR_WEBSITE_URL
allow_authorization_simulation = true
customer_username =
customer_password = ''
debug = true
display_test_content = true

ricardo's Issues

ArticleInformationParameter - Increment should be float value

Diglin/Ricardo/Managers/Sell/Parameter/ArticleInformationParameter.php

See:
https://help.ricardo.ch/hc/de/articles/115002433845-How-to-list-an-article
https://ws.ricardo.ch/RicardoApi/documentation/html/P_Ricardo_Contracts_Models_Sell_Parameter_ArticleInformationParameter_Increment.htm

Bug fix for Diglin/Ricardo/Services/SellerAccount.php -> getPlannedArticles()

The Parameter is wrong and should be of type "PlannedArticlesParameter".

Exception:

Argument 1 passed to Diglin\Ricardo\Services\SellerAccount::getPlannedArticles() must be an instance of Diglin\Ricardo\Managers\SellerAccount\Parameter\PlannedArticleParameter, instance of Diglin\Ricardo\Managers\SellerAccount\Parameter\PlannedArticlesParameter given, called in /Ricardo/Lib/Diglin/Ricardo/Service.php on line 204 and defined in /Ricardo/Lib/Diglin/Ricardo/Services/SellerAccount.php:329