Use this client to convieniently interact with ShopCtrl. This PHP package was developed by Afosto to make a reliable connection between Afosto (Retail Software) and ShopCtrl and provides the following functionality:
- get product data from ShopCtrl
- get order data from ShopCtrl
- create new orders at ShopCtrl
Simply follow the installation instructions. You will need an account at ShopCtrl that is set up for you to use.
What things you need to install the software and how to install them
- PHP5.5+
- Composer (for installation)
Installing is easy through Composer.
composer require afosto/shopctrl
Now, to fetch productdata from ShopCtrl use the following code.
First set some configuration parameters:
$settings = new Settings();Define the settings with data obtained from ShopCtrl
$settings->shopId = '';
$settings->baseUrl = '';
$settings->username = '';
$settings->password = '';
$settings->cultureId = '';Initialze the application:
App::init($settings);Run a foreach for ProductSelections to get shop-context-related data and the full product that belongs to the productSelection data
foreach (ProductSelection::model()->findAll() as $productSelection) {
$product = Product::model()->find($productSelection->productId);
//Use the product data
dump($productSelection, $product);
}To create an order use the following sample. First set the contact data.
$contact = new ContactInfo();
$contact->streetAddress = 'Grondzijl';
$contact->streetAddressNumber = 16;
$contact->city = 'Groningen';
$contact->countryCode = 'NL';
$contact->companyName = 'Afosto SaaS BV';
$contact->eMail = '[email protected]';
$contact->firstName = 'Peter';
$contact->lastName = 'Bakker';
$contact->postalCode = '9731DG';
$contact->phone = '0507119519';Create an order row.
$orderRow = new OrderRow();
$orderRow->orderRowKey = 1;
$orderRow->itemQuantity = 1;
$orderRow->productName = 'TestProduct';
$orderRow->productCode = 'ProductSku';
$orderRow->productDescription = 'Description test product';
$orderRow->itemPriceIncVat = 5.00;
$orderRow->rowDiscountIncVat = 0;
$orderRow->vatperc = 21;
$orderRow->rowTotalIncVat = 5;Create an order.
$order = new Order();
$order->id = 0;
$order->shipToContact = $contact;
$order->billToContact = $contact;
$order->date = (new DateTime())->format('Y/m/d H:i:s');
$order->viewModusIncVAT = true;
$order->paymentFeeIncVat = 0;
$order->shippingCostsIncVat = 0;
$order->customerNote = '';
$order->syncSource = 'Afosto';
$order->discountIncVat = 0;
$order->orderRows[] = $orderRow;
$order->orderCode = 'test' . time();
$order->orderTotalIncVat = 5.00;
$order->currencyId = 1;
$order->currencyCode = 'EUR';Set some specific data for the order based on the context / settings
$order->paymentTypeId = App::getInstance()->getSettings()->getPaymentTypeId('iDeal');
$order->cultureId = App::getInstance()->getSetting('cultureId');
$order->shopId = App::getInstance()->getSetting('shopId');
$order->mainStatusId = App::getInstance()->getSettings()->getOrderStatus('Active');Now create the order
$order->create();Now use the new data (model is updated with the results from the server)
$order->id;In the examples directory you will find more examples of this project.
We use SemVer for versioning. For the versions available, see the tags on this repository.
This project is licensed under the Apache License 2.0 - see the LICENSE.md file for details
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent