3128 lines
84 KiB
PHP
3128 lines
84 KiB
PHP
<?php
|
|
|
|
/**
|
|
* PHP version 5.3
|
|
*
|
|
* API client class
|
|
*
|
|
* @category RetailCRM
|
|
* @package RetailCRM
|
|
*/
|
|
|
|
namespace RetailCrm;
|
|
|
|
use InvalidArgumentException;
|
|
use RetailCrm\Exception\CurlException;
|
|
use RetailCrm\Http\Client;
|
|
use RetailCrm\Response\ApiResponse;
|
|
|
|
/**
|
|
* PHP version 5.3
|
|
*
|
|
* API client class
|
|
*
|
|
* @category RetailCRM
|
|
* @package RetailCRM
|
|
*/
|
|
class ApiClient
|
|
{
|
|
|
|
const VERSION = 'v5';
|
|
|
|
protected $client;
|
|
protected $unversionedClient;
|
|
|
|
/**
|
|
* Site code
|
|
*/
|
|
protected $siteCode;
|
|
|
|
/**
|
|
* Client creating
|
|
*
|
|
* @param string $url api url
|
|
* @param string $apiKey api key
|
|
* @param string $site site code
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
*/
|
|
public function __construct($url, $apiKey, $site = null)
|
|
{
|
|
if ('/' !== $url[strlen($url) - 1]) {
|
|
$url .= '/';
|
|
}
|
|
|
|
$versionedUrl = $url . 'api/' . self::VERSION;
|
|
$unversionedUrl = $url . 'api';
|
|
|
|
$this->client = new Client($versionedUrl, array('apiKey' => $apiKey));
|
|
$this->siteCode = $site;
|
|
|
|
$this->unversionedClient = new Client($unversionedUrl, ['apiKey' => $apiKey]);
|
|
}
|
|
|
|
/**
|
|
* Returns users list
|
|
*
|
|
* @param array $filter
|
|
* @param int|null $page
|
|
* @param int|null $limit
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function usersList(array $filter = [], int $page = null, int $limit = null): ApiResponse
|
|
{
|
|
$parameters = [];
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/users',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get user groups
|
|
*
|
|
* @param null $page
|
|
* @param null $limit
|
|
*
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function usersGroups($page = null, $limit = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/user-groups',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Change user status
|
|
*
|
|
* @param integer $id user ID
|
|
* @param string $status user status
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function usersStatus($id, $status)
|
|
{
|
|
$statuses = array("free", "busy", "dinner", "break");
|
|
|
|
if (empty($status) || !in_array($status, $statuses)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `status` must be not empty & must be equal one of these values: free|busy|dinner|break'
|
|
);
|
|
}
|
|
|
|
/** @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
"/users/$id/status",
|
|
Client::METHOD_POST,
|
|
array('status' => $status)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns user data
|
|
*
|
|
* @param integer $id user ID
|
|
*
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \InvalidArgumentException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function usersGet($id)
|
|
{
|
|
return $this->client->makeRequest("/users/$id", Client::METHOD_GET);
|
|
}
|
|
|
|
/**
|
|
* Returns filtered orders list
|
|
*
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersList(array $filter = array(), $page = null, $limit = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/orders',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/*
|
|
* Create customers corporate
|
|
*
|
|
* @param array $customer customer corporate data
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersCorporateCreate(array $customer, $site = null)
|
|
{
|
|
if (! count($customer)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `customer` must contains a data'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/customers-corporate/create',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, array('customerCorporate' => json_encode($customer)))
|
|
);
|
|
}
|
|
|
|
/*
|
|
* Save customer corporate IDs' (id and externalId) association in the CRM
|
|
*
|
|
* @param array $ids ids mapping
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersCorporateFixExternalIds(array $ids)
|
|
{
|
|
if (! count($ids)) {
|
|
throw new InvalidArgumentException(
|
|
'Method parameter must contains at least one IDs pair'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/customers-corporate/fix-external-ids',
|
|
Client::METHOD_POST,
|
|
array('customersCorporate' => json_encode($ids))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Upload array of the customers corporate
|
|
*
|
|
* @param array $customers array of customers
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersCorporateUpload(array $customers, $site = null)
|
|
{
|
|
if (! count($customers)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `customers` must contains array of the customers'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/customers-corporate/upload',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, array('customersCorporate' => json_encode($customers)))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get customer corporate by id or externalId
|
|
*
|
|
* @param string $id customers-corporate identificator
|
|
* @param string $by (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersCorporateGet($id, $by = 'externalId', $site = null)
|
|
{
|
|
$this->checkIdParameter($by);
|
|
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/$id",
|
|
Client::METHOD_GET,
|
|
$this->fillSite($site, array('by' => $by))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get corporate customer companies by id or externalId
|
|
*
|
|
* @param string $id corporate customer identifier
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
* @param string $by (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateCompanies(
|
|
$id,
|
|
array $filter = [],
|
|
$page = null,
|
|
$limit = null,
|
|
$by = 'externalId',
|
|
$site = null
|
|
) {
|
|
|
|
$this->checkIdParameter($by);
|
|
|
|
$parameters = ['by' => $by];
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/$id/companies",
|
|
Client::METHOD_GET,
|
|
$this->fillSite($site, $parameters)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get customers corporate history
|
|
*
|
|
* @param array $filter
|
|
* @param int|null $limit
|
|
*
|
|
* @return ApiResponse
|
|
*
|
|
*/
|
|
public function customersCorporateHistory(array $filter = [], ?int $limit = 100)
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/customers-corporate/history',
|
|
Client::METHOD_GET,
|
|
['filter' => $filter, 'limit' => $limit]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create corporate customer contact
|
|
*
|
|
* @param string $id corporate customer identifier
|
|
* @param array $contact (default: array())
|
|
* @param string $by (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
*/
|
|
public function customersCorporateContactsCreate($id, array $contact = [], $by = 'externalId', $site = null)
|
|
{
|
|
if (! count($contact)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `contact` must contains a data'
|
|
);
|
|
}
|
|
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/$id/contacts/create",
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, ['contact' => json_encode($contact), 'by' => $by])
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get corporate customer contacts by id or externalId
|
|
*
|
|
* @param string $id corporate customer identifier
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
* @param string $by (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateContacts(
|
|
$id,
|
|
array $filter = [],
|
|
$page = null,
|
|
$limit = null,
|
|
$by = 'externalId',
|
|
$site = null
|
|
) {
|
|
$this->checkIdParameter($by);
|
|
$parameters = ['by' => $by];
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/$id/contacts",
|
|
Client::METHOD_GET,
|
|
$this->fillSite($site, $parameters)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns filtered corporate customers list
|
|
*
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateList(array $filter = [], $page = null, $limit = null)
|
|
{
|
|
$parameters = [];
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
'/customers-corporate',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns filtered corporate customers notes list
|
|
*
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateNotesList(array $filter = [], $page = null, $limit = null)
|
|
{
|
|
$parameters = [];
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
'/customers-corporate/notes',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create corporate customer note
|
|
*
|
|
* @param array $note (default: array())
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateNotesCreate($note, $site = null)
|
|
{
|
|
if (empty($note['customer']['id']) && empty($note['customer']['externalId'])) {
|
|
throw new InvalidArgumentException(
|
|
'Customer identifier must be set'
|
|
);
|
|
}
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
'/customers-corporate/notes/create',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, ['note' => json_encode($note)])
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Delete corporate customer note
|
|
*
|
|
* @param integer $id
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateNotesDelete($id)
|
|
{
|
|
if (empty($id)) {
|
|
throw new InvalidArgumentException(
|
|
'Note id must be set'
|
|
);
|
|
}
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/notes/$id/delete",
|
|
Client::METHOD_POST
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get corporate customer addresses by id or externalId
|
|
*
|
|
* @param string $id corporate customer identifier
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
* @param string $by (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateAddresses(
|
|
$id,
|
|
array $filter = [],
|
|
$page = null,
|
|
$limit = null,
|
|
$by = 'externalId',
|
|
$site = null
|
|
) {
|
|
$this->checkIdParameter($by);
|
|
$parameters = ['by' => $by];
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/$id/addresses",
|
|
Client::METHOD_GET,
|
|
$this->fillSite($site, $parameters)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create corporate customer address
|
|
*
|
|
* @param string $id corporate customer identifier
|
|
* @param array $address (default: array())
|
|
* @param string $by (default: 'externalId')
|
|
* @param null $site (default: null)
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateAddressesCreate($id, array $address = [], $by = 'externalId', $site = null): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/$id/addresses/create",
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, ['address' => json_encode($address), 'by' => $by])
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit corporate customer address
|
|
*
|
|
* @param string $customerId corporate customer identifier
|
|
* @param string $addressId corporate customer identifier
|
|
* @param array $address (default: array())
|
|
* @param string $customerBy (default: 'externalId')
|
|
* @param string $addressBy (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateAddressesEdit(
|
|
$customerId,
|
|
$addressId,
|
|
array $address = [],
|
|
$customerBy = 'externalId',
|
|
$addressBy = 'externalId',
|
|
$site = null
|
|
) {
|
|
$addressFiltered = array_filter($address);
|
|
if ((count(array_keys($addressFiltered)) <= 1)
|
|
&& (!isset($addressFiltered['text'])
|
|
|| (isset($addressFiltered['text']) && empty($addressFiltered['text']))
|
|
)
|
|
) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `address` must contain address text or all other address field'
|
|
);
|
|
}
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/$customerId/addresses/$addressId/edit",
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, [
|
|
'address' => json_encode($address),
|
|
'by' => $customerBy,
|
|
'entityBy' => $addressBy
|
|
])
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create corporate customer company
|
|
*
|
|
* @param string $id corporate customer identifier
|
|
* @param array $company (default: array())
|
|
* @param string $by (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateCompaniesCreate($id, array $company = [], $by = 'externalId', $site = null)
|
|
{
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/$id/companies/create",
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, ['company' => json_encode($company), 'by' => $by])
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit corporate customer company
|
|
*
|
|
* @param string $customerId corporate customer identifier
|
|
* @param string $companyId corporate customer identifier
|
|
* @param array $company (default: array())
|
|
* @param string $customerBy (default: 'externalId')
|
|
* @param string $companyBy (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
*/
|
|
public function customersCorporateCompaniesEdit(
|
|
$customerId,
|
|
$companyId,
|
|
array $company = [],
|
|
$customerBy = 'externalId',
|
|
$companyBy = 'externalId',
|
|
$site = null
|
|
) {
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/$customerId/companies/$companyId/edit",
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, [
|
|
'company' => json_encode($company),
|
|
'by' => $customerBy,
|
|
'entityBy' => $companyBy
|
|
])
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit corporate customer contact
|
|
*
|
|
* @param string $customerId corporate customer identifier
|
|
* @param string $contactId corporate customer identifier
|
|
* @param array $contact (default: array())
|
|
* @param string $customerBy (default: 'externalId')
|
|
* @param string $contactBy (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
*/
|
|
public function customersCorporateContactsEdit(
|
|
$customerId,
|
|
$contactId,
|
|
array $contact = [],
|
|
$customerBy = 'externalId',
|
|
$contactBy = 'externalId',
|
|
$site = null
|
|
) {
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
"/customers-corporate/$customerId/contacts/$contactId/edit",
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, [
|
|
'contact' => json_encode($contact),
|
|
'by' => $customerBy,
|
|
'entityBy' => $contactBy
|
|
])
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit a corporate customer
|
|
*
|
|
* @param array $params corporate customer data
|
|
* @param string $by (default: 'externalId')
|
|
* @param null $site (default: null)
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
*/
|
|
public function customersCorporateEdit(
|
|
array $params,
|
|
$by = 'externalId',
|
|
$site = null
|
|
): ApiResponse {
|
|
if (!count($params)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `customerCorporate` must contains a data'
|
|
);
|
|
}
|
|
|
|
if (!isset($params['urlId'])) {
|
|
throw new InvalidArgumentException(
|
|
'urlId should be in $params'
|
|
);
|
|
}
|
|
|
|
$urlId = $params['urlId'];
|
|
|
|
unset($params['urlId']);
|
|
$this->checkIdParameter($by);
|
|
|
|
if (!array_key_exists($by, $params)) {
|
|
throw new InvalidArgumentException(
|
|
sprintf('Corporate customer array must contain the "%s" parameter.', $by)
|
|
);
|
|
}
|
|
/* @noinspection PhpUndefinedMethodInspection */
|
|
return $this->client->makeRequest(
|
|
sprintf('/customers-corporate/%s/edit', $urlId),
|
|
Client::METHOD_POST,
|
|
$this->fillSite(
|
|
$site,
|
|
['customerCorporate' => json_encode($params), 'by' => $by]
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create a order
|
|
*
|
|
* @param array $order order data
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersCreate(array $order, $site = null): ApiResponse
|
|
{
|
|
if (!count($order)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `order` must contains a data'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/orders/create',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, ['order' => json_encode($order)])
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Save order IDs' (id and externalId) association in the CRM
|
|
*
|
|
* @param array $ids order identificators
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersFixExternalIds(array $ids)
|
|
{
|
|
if (! count($ids)) {
|
|
throw new InvalidArgumentException(
|
|
'Method parameter must contains at least one IDs pair'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/orders/fix-external-ids',
|
|
Client::METHOD_POST,
|
|
array('orders' => json_encode($ids)
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns statuses of the orders
|
|
*
|
|
* @param array $ids (default: array())
|
|
* @param array $externalIds (default: array())
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersStatuses(array $ids = array(), array $externalIds = array())
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($ids)) {
|
|
$parameters['ids'] = $ids;
|
|
}
|
|
if (count($externalIds)) {
|
|
$parameters['externalIds'] = $externalIds;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/orders/statuses',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Upload array of the orders
|
|
*
|
|
* @param array $orders array of orders
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersUpload(array $orders, $site = null)
|
|
{
|
|
if (!count($orders)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `orders` must contains array of the orders'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/orders/upload',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, array('orders' => json_encode($orders)))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get order by id or externalId
|
|
*
|
|
* @param string $id order identificator
|
|
* @param string $by (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersGet($id, $by = 'externalId', $site = null)
|
|
{
|
|
$this->checkIdParameter($by);
|
|
|
|
return $this->client->makeRequest(
|
|
"/orders/$id",
|
|
Client::METHOD_GET,
|
|
$this->fillSite($site, array('by' => $by))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit a order
|
|
*
|
|
* @param array $order order data
|
|
* @param string $by (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersEdit(array $order, $by = 'externalId', $site = null): ApiResponse
|
|
{
|
|
if (!count($order)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `order` must contains a data'
|
|
);
|
|
}
|
|
|
|
$this->checkIdParameter($by);
|
|
|
|
if (!array_key_exists($by, $order)) {
|
|
throw new InvalidArgumentException(
|
|
sprintf('Order array must contain the "%s" parameter.', $by)
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/orders/%s/edit', $order[$by]),
|
|
Client::METHOD_POST,
|
|
$this->fillSite(
|
|
$site,
|
|
['order' => json_encode($order), 'by' => $by]
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get orders history
|
|
*
|
|
* @param array $filter
|
|
* @param int|null $limit
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersHistory(array $filter = [], ?int $limit = 100)
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/orders/history',
|
|
Client::METHOD_GET,
|
|
['filter' => $filter, 'limit' => $limit]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns filtered customers list
|
|
*
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersList(array $filter = array(), $page = null, $limit = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/customers',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create a customer
|
|
*
|
|
* @param array $customer customer data
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersCreate(array $customer, $site = null)
|
|
{
|
|
if (! count($customer)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `customer` must contains a data'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/customers/create',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, array('customer' => json_encode($customer)))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Save customer IDs' (id and externalId) association in the CRM
|
|
*
|
|
* @param array $ids ids mapping
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersFixExternalIds(array $ids)
|
|
{
|
|
if (! count($ids)) {
|
|
throw new InvalidArgumentException(
|
|
'Method parameter must contains at least one IDs pair'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/customers/fix-external-ids',
|
|
Client::METHOD_POST,
|
|
array('customers' => json_encode($ids))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Upload array of the customers
|
|
*
|
|
* @param array $customers array of customers
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersUpload(array $customers, $site = null)
|
|
{
|
|
if (! count($customers)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `customers` must contains array of the customers'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/customers/upload',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, array('customers' => json_encode($customers)))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get customer by id or externalId
|
|
*
|
|
* @param string $id customer identificator
|
|
* @param string $by (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersGet($id, $by = 'externalId', $site = null)
|
|
{
|
|
$this->checkIdParameter($by);
|
|
|
|
return $this->client->makeRequest(
|
|
"/customers/$id",
|
|
Client::METHOD_GET,
|
|
$this->fillSite($site, array('by' => $by))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit a customer
|
|
*
|
|
* @param array $customer customer data
|
|
* @param string $by (default: 'externalId')
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersEdit(array $customer, $by = 'externalId', $site = null)
|
|
{
|
|
if (!count($customer)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `customer` must contains a data'
|
|
);
|
|
}
|
|
|
|
$this->checkIdParameter($by);
|
|
|
|
if (!array_key_exists($by, $customer)) {
|
|
throw new InvalidArgumentException(
|
|
sprintf('Customer array must contain the "%s" parameter.', $by)
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/customers/%s/edit', $customer[$by]),
|
|
Client::METHOD_POST,
|
|
$this->fillSite(
|
|
$site,
|
|
array('customer' => json_encode($customer), 'by' => $by)
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get customers history
|
|
*
|
|
* @param array $filter
|
|
* @param int|null $limit
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersHistory(array $filter = [], ?int $limit = 100)
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/customers/history',
|
|
Client::METHOD_GET,
|
|
['filter' => $filter, 'limit' => $limit]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Combine orders
|
|
*
|
|
* @param array $order
|
|
* @param array $resultOrder
|
|
* @param string $technique
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersCombine($order, $resultOrder, $technique = 'ours')
|
|
{
|
|
$techniques = array('ours', 'summ', 'theirs');
|
|
|
|
if (!count($order) || !count($resultOrder)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameters `order` & `resultOrder` must contains a data'
|
|
);
|
|
}
|
|
|
|
if (!in_array($technique, $techniques)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `technique` must be on of ours|summ|theirs'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/orders/combine',
|
|
Client::METHOD_POST,
|
|
array(
|
|
'technique' => $technique,
|
|
'order' => json_encode($order),
|
|
'resultOrder' => json_encode($resultOrder)
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create an order payment
|
|
*
|
|
* @param array $payment order data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersPaymentCreate(array $payment, $site = null)
|
|
{
|
|
if (!count($payment)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `payment` must contains a data'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/orders/payments/create',
|
|
Client::METHOD_POST,
|
|
$this->fillSite(
|
|
$site,
|
|
array('payment' => json_encode($payment))
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit an order payment
|
|
*
|
|
* @param array $payment order data
|
|
* @param string $by by key
|
|
* @param null $site site code
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersPaymentEdit(array $payment, $by = 'id', $site = null)
|
|
{
|
|
if (!count($payment)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `payment` must contains a data'
|
|
);
|
|
}
|
|
|
|
$this->checkIdParameter($by);
|
|
|
|
if (!array_key_exists($by, $payment)) {
|
|
throw new InvalidArgumentException(
|
|
sprintf('Order array must contain the "%s" parameter.', $by)
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/orders/payments/%s/edit', urlencode($payment[$by])),
|
|
Client::METHOD_POST,
|
|
$this->fillSite(
|
|
$site,
|
|
array('payment' => json_encode($payment), 'by' => $by)
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Delete an order payment
|
|
*
|
|
* @param integer $id id order payment
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersPaymentDelete($id)
|
|
{
|
|
if (empty($id)) {
|
|
throw new InvalidArgumentException(
|
|
'Note id must be set'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/orders/payments/$id/delete",
|
|
Client::METHOD_POST
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Combine customers
|
|
*
|
|
* @param array $customers
|
|
* @param array $resultCustomer
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersCombine(array $customers, $resultCustomer)
|
|
{
|
|
|
|
if (!count($customers) || !count($resultCustomer)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameters `customers` & `resultCustomer` must contains a data'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/customers/combine',
|
|
Client::METHOD_POST,
|
|
array(
|
|
'customers' => json_encode($customers),
|
|
'resultCustomer' => json_encode($resultCustomer)
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns filtered customers notes list
|
|
*
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersNotesList(array $filter = array(), $page = null, $limit = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/customers/notes',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create customer note
|
|
*
|
|
* @param array $note (default: array())
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersNotesCreate($note, $site = null)
|
|
{
|
|
if (empty($note['customer']['id']) && empty($note['customer']['externalId'])) {
|
|
throw new InvalidArgumentException(
|
|
'Customer identifier must be set'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/customers/notes/create',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, array('note' => json_encode($note)))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Delete customer note
|
|
*
|
|
* @param integer $id
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customersNotesDelete($id)
|
|
{
|
|
if (empty($id)) {
|
|
throw new InvalidArgumentException(
|
|
'Note id must be set'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/customers/notes/$id/delete",
|
|
Client::METHOD_POST
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get custom fields list
|
|
*
|
|
* @param array $filter
|
|
* @param null $limit
|
|
* @param null $page
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customFieldsList(array $filter = array(), $limit = null, $page = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/custom-fields',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create custom field
|
|
*
|
|
* @param $entity
|
|
* @param $customField
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customFieldsCreate($entity, $customField)
|
|
{
|
|
if (!count($customField) ||
|
|
empty($customField['code']) ||
|
|
empty($customField['name']) ||
|
|
empty($customField['type'])
|
|
) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `customField` must contain a data & fields `code`, `name` & `type` must be set'
|
|
);
|
|
}
|
|
|
|
if (empty($entity) || !in_array($entity, array('customer', 'order'))) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `entity` must contain a data & value must be `order` or `customer`'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/custom-fields/$entity/create",
|
|
Client::METHOD_POST,
|
|
array('customField' => json_encode($customField))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit custom field
|
|
*
|
|
* @param $entity
|
|
* @param $customField
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customFieldsEdit($entity, $customField)
|
|
{
|
|
if (!count($customField) || empty($customField['code'])) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `customField` must contain a data & fields `code` must be set'
|
|
);
|
|
}
|
|
|
|
if (empty($entity) || !in_array($entity, array('customer', 'order'))) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `entity` must contain a data & value must be `order` or `customer`'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/custom-fields/$entity/edit/{$customField['code']}",
|
|
Client::METHOD_POST,
|
|
array('customField' => json_encode($customField))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get custom field
|
|
*
|
|
* @param $entity
|
|
* @param $code
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customFieldsGet($entity, $code)
|
|
{
|
|
if (empty($code)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `code` must be not empty'
|
|
);
|
|
}
|
|
|
|
if (empty($entity) || !in_array($entity, array('customer', 'order'))) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `entity` must contain a data & value must be `order` or `customer`'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/custom-fields/$entity/$code",
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get custom dictionaries list
|
|
*
|
|
* @param array $filter
|
|
* @param null $limit
|
|
* @param null $page
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customDictionariesList(array $filter = array(), $limit = null, $page = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/custom-fields/dictionaries',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create custom dictionary
|
|
*
|
|
* @param $customDictionary
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customDictionariesCreate($customDictionary)
|
|
{
|
|
if (!count($customDictionary) ||
|
|
empty($customDictionary['code']) ||
|
|
empty($customDictionary['elements'])
|
|
) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `dictionary` must contain a data & fields `code` & `elemets` must be set'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/custom-fields/dictionaries/{$customDictionary['code']}/create",
|
|
Client::METHOD_POST,
|
|
array('customDictionary' => json_encode($customDictionary))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit custom dictionary
|
|
*
|
|
* @param $customDictionary
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customDictionariesEdit($customDictionary)
|
|
{
|
|
if (!count($customDictionary) ||
|
|
empty($customDictionary['code']) ||
|
|
empty($customDictionary['elements'])
|
|
) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `dictionary` must contain a data & fields `code` & `elemets` must be set'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/custom-fields/dictionaries/{$customDictionary['code']}/edit",
|
|
Client::METHOD_POST,
|
|
array('customDictionary' => json_encode($customDictionary))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get custom dictionary
|
|
*
|
|
* @param $code
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function customDictionariesGet($code)
|
|
{
|
|
if (empty($code)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `code` must be not empty'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/custom-fields/dictionaries/$code",
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get tasks list
|
|
*
|
|
* @param array $filter
|
|
* @param null $limit
|
|
* @param null $page
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function tasksList(array $filter = array(), $limit = null, $page = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/tasks',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create task
|
|
*
|
|
* @param array $task
|
|
* @param null $site
|
|
*
|
|
* @return ApiResponse
|
|
*
|
|
*/
|
|
public function tasksCreate($task, $site = null)
|
|
{
|
|
if (!count($task)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `task` must contain a data'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/tasks/create",
|
|
Client::METHOD_POST,
|
|
$this->fillSite(
|
|
$site,
|
|
array('task' => json_encode($task))
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit task
|
|
*
|
|
* @param array $task
|
|
* @param null $site
|
|
*
|
|
* @return ApiResponse
|
|
*
|
|
*/
|
|
public function tasksEdit($task, $site = null)
|
|
{
|
|
if (!count($task)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `task` must contain a data'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/tasks/{$task['id']}/edit",
|
|
Client::METHOD_POST,
|
|
$this->fillSite(
|
|
$site,
|
|
array('task' => json_encode($task))
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get custom dictionary
|
|
*
|
|
* @param $id
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function tasksGet($id)
|
|
{
|
|
if (empty($id)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `id` must be not empty'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/tasks/$id",
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get orders assembly list
|
|
*
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersPacksList(array $filter = array(), $page = null, $limit = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/orders/packs',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Create orders assembly
|
|
*
|
|
* @param array $pack pack data
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersPacksCreate(array $pack, $site = null)
|
|
{
|
|
if (!count($pack)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `pack` must contains a data'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/orders/packs/create',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, array('pack' => json_encode($pack)))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get orders assembly history
|
|
*
|
|
* @param array $filter
|
|
* @param int|null $limit
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersPacksHistory(array $filter = [], ?int $limit = 100)
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/orders/packs/history',
|
|
Client::METHOD_GET,
|
|
['filter' => $filter, 'limit' => $limit]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get orders assembly by id
|
|
*
|
|
* @param string $id pack identificator
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersPacksGet($id)
|
|
{
|
|
if (empty($id)) {
|
|
throw new InvalidArgumentException('Parameter `id` must be set');
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
"/orders/packs/$id",
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Delete orders assembly by id
|
|
*
|
|
* @param string $id pack identificator
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersPacksDelete($id)
|
|
{
|
|
if (empty($id)) {
|
|
throw new InvalidArgumentException('Parameter `id` must be set');
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/orders/packs/%s/delete', $id),
|
|
Client::METHOD_POST
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit orders assembly
|
|
*
|
|
* @param array $pack pack data
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function ordersPacksEdit(array $pack, $site = null)
|
|
{
|
|
if (!count($pack) || empty($pack['id'])) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `pack` must contains a data & pack `id` must be set'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/orders/packs/%s/edit', $pack['id']),
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, array('pack' => json_encode($pack)))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get purchace prices & stock balance
|
|
*
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function storeInventories(array $filter = array(), $page = null, $limit = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/store/inventories',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Upload store inventories
|
|
*
|
|
* @param array $offers offers data
|
|
* @param string $site (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function storeInventoriesUpload(array $offers, $site = null)
|
|
{
|
|
if (!count($offers)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `offers` must contains array of the offers'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/store/inventories/upload',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, array('offers' => json_encode($offers)))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Upload store prices
|
|
*
|
|
* @param array $prices prices data
|
|
* @param string $site default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function storePricesUpload(array $prices, $site = null)
|
|
{
|
|
if (!count($prices)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `prices` must contains array of the prices'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/store/prices/upload',
|
|
Client::METHOD_POST,
|
|
$this->fillSite($site, array('prices' => json_encode($prices)))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get products
|
|
*
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function storeProducts(array $filter = array(), $page = null, $limit = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/store/products',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get module configuration
|
|
*
|
|
* @param string $code
|
|
*
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \InvalidArgumentException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function integrationModulesGet($code)
|
|
{
|
|
if (empty($code)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `code` must be set'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/integration-modules/%s', $code),
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit module configuration
|
|
*
|
|
* @param array $configuration
|
|
*
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \InvalidArgumentException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function integrationModulesEdit(array $configuration)
|
|
{
|
|
if (!count($configuration) || empty($configuration['code'])) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `configuration` must contains a data & configuration `code` must be set'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/integration-modules/%s/edit', $configuration['code']),
|
|
Client::METHOD_POST,
|
|
array('integrationModule' => json_encode($configuration))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Delivery tracking update
|
|
*
|
|
* @param string $code
|
|
* @param array $statusUpdate
|
|
*
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \InvalidArgumentException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function deliveryTracking($code, array $statusUpdate)
|
|
{
|
|
if (empty($code)) {
|
|
throw new InvalidArgumentException('Parameter `code` must be set');
|
|
}
|
|
|
|
if (!count($statusUpdate)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `statusUpdate` must contains a data'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/delivery/generic/%s/tracking', $code),
|
|
Client::METHOD_POST,
|
|
array('statusUpdate' => json_encode($statusUpdate))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns available county list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function countriesList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/countries',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns deliveryServices list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function deliveryServicesList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/delivery-services',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit deliveryService
|
|
*
|
|
* @param array $data delivery service data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function deliveryServicesEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/delivery-services/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('deliveryService' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns deliveryTypes list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function deliveryTypesList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/delivery-types',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit deliveryType
|
|
*
|
|
* @param array $data delivery type data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function deliveryTypesEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/delivery-types/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('deliveryType' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns orderMethods list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function orderMethodsList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/order-methods',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit orderMethod
|
|
*
|
|
* @param array $data order method data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function orderMethodsEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/order-methods/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('orderMethod' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns orderTypes list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function orderTypesList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/order-types',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit orderType
|
|
*
|
|
* @param array $data order type data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function orderTypesEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/order-types/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('orderType' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns paymentStatuses list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function paymentStatusesList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/payment-statuses',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit paymentStatus
|
|
*
|
|
* @param array $data payment status data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function paymentStatusesEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/payment-statuses/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('paymentStatus' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns paymentTypes list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function paymentTypesList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/payment-types',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit paymentType
|
|
*
|
|
* @param array $data payment type data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function paymentTypesEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/payment-types/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('paymentType' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns productStatuses list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function productStatusesList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/product-statuses',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit productStatus
|
|
*
|
|
* @param array $data product status data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function productStatusesEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/product-statuses/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('productStatus' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get products groups
|
|
*
|
|
* @param array $filter (default: array())
|
|
* @param int $page (default: null)
|
|
* @param int $limit (default: null)
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function storeProductsGroups(array $filter = array(), $page = null, $limit = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/store/product-groups',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns sites list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function sitesList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/sites',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit site
|
|
*
|
|
* @param array $data site data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function sitesEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/sites/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('site' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns statusGroups list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function statusGroupsList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/status-groups',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns statuses list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function statusesList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/statuses',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit order status
|
|
*
|
|
* @param array $data status data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function statusesEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/statuses/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('status' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns stores list
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function storesList()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/stores',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit store
|
|
*
|
|
* @param array $data site data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function storesEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
if (!array_key_exists('name', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "name" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/stores/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('store' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get prices types
|
|
*
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function pricesTypes()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/reference/price-types',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Edit price type
|
|
*
|
|
* @param array $data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function pricesEdit(array $data)
|
|
{
|
|
if (!array_key_exists('code', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "code" parameter.'
|
|
);
|
|
}
|
|
|
|
if (!array_key_exists('name', $data)) {
|
|
throw new InvalidArgumentException(
|
|
'Data must contain "name" parameter.'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
sprintf('/reference/price-types/%s/edit', $data['code']),
|
|
Client::METHOD_POST,
|
|
array('priceType' => json_encode($data))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Call event
|
|
*
|
|
* @param string $phone phone number
|
|
* @param string $type call type
|
|
* @param array $codes
|
|
* @param string $hangupStatus
|
|
* @param string $externalPhone
|
|
* @param array $webAnalyticsData
|
|
*
|
|
* @return ApiResponse
|
|
* @internal param string $code additional phone code
|
|
* @internal param string $status call status
|
|
*
|
|
*/
|
|
public function telephonyCallEvent(
|
|
$phone,
|
|
$type,
|
|
$codes,
|
|
$hangupStatus,
|
|
$externalPhone = null,
|
|
$webAnalyticsData = array()
|
|
)
|
|
{
|
|
if (!isset($phone)) {
|
|
throw new InvalidArgumentException('Phone number must be set');
|
|
}
|
|
|
|
if (!isset($type)) {
|
|
throw new InvalidArgumentException('Type must be set (in|out|hangup)');
|
|
}
|
|
|
|
if (empty($codes)) {
|
|
throw new InvalidArgumentException('Codes array must be set');
|
|
}
|
|
|
|
$parameters['phone'] = $phone;
|
|
$parameters['type'] = $type;
|
|
$parameters['codes'] = $codes;
|
|
$parameters['hangupStatus'] = $hangupStatus;
|
|
$parameters['callExternalId'] = $externalPhone;
|
|
$parameters['webAnalyticsData'] = $webAnalyticsData;
|
|
|
|
|
|
return $this->client->makeRequest(
|
|
'/telephony/call/event',
|
|
Client::METHOD_POST,
|
|
array('event' => json_encode($parameters))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Upload calls
|
|
*
|
|
* @param array $calls calls data
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function telephonyCallsUpload(array $calls)
|
|
{
|
|
if (!count($calls)) {
|
|
throw new InvalidArgumentException(
|
|
'Parameter `calls` must contains array of the calls'
|
|
);
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/telephony/calls/upload',
|
|
Client::METHOD_POST,
|
|
array('calls' => json_encode($calls))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get call manager
|
|
*
|
|
* @param string $phone phone number
|
|
* @param bool $details detailed information
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function telephonyCallManager($phone, $details)
|
|
{
|
|
if (!isset($phone)) {
|
|
throw new InvalidArgumentException('Phone number must be set');
|
|
}
|
|
|
|
$parameters['phone'] = $phone;
|
|
$parameters['details'] = isset($details) ? $details : 0;
|
|
|
|
return $this->client->makeRequest(
|
|
'/telephony/manager',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Get segments list
|
|
*
|
|
* @param array $filter
|
|
* @param null $limit
|
|
* @param null $page
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function segmentsList(array $filter = array(), $limit = null, $page = null)
|
|
{
|
|
$parameters = array();
|
|
|
|
if (count($filter)) {
|
|
$parameters['filter'] = $filter;
|
|
}
|
|
if (null !== $page) {
|
|
$parameters['page'] = (int) $page;
|
|
}
|
|
if (null !== $limit) {
|
|
$parameters['limit'] = (int) $limit;
|
|
}
|
|
|
|
return $this->client->makeRequest(
|
|
'/segments',
|
|
Client::METHOD_GET,
|
|
$parameters
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Update CRM basic statistic
|
|
*
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
* @throws \RetailCrm\Exception\InvalidJsonException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function statisticUpdate()
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/statistic/update',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Return current site
|
|
*
|
|
* @return string
|
|
*/
|
|
public function getSite()
|
|
{
|
|
return $this->siteCode;
|
|
}
|
|
|
|
/**
|
|
* Set site
|
|
*
|
|
* @param string $site site code
|
|
*
|
|
* @return void
|
|
*/
|
|
public function setSite($site)
|
|
{
|
|
$this->siteCode = $site;
|
|
}
|
|
|
|
/**
|
|
* Check ID parameter
|
|
*
|
|
* @param string $by identify by
|
|
*
|
|
* @return bool
|
|
* @throws \InvalidArgumentException
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
protected function checkIdParameter(string $by): bool
|
|
{
|
|
$allowedForBy = [
|
|
'externalId',
|
|
'id',
|
|
];
|
|
|
|
if (!in_array($by, $allowedForBy, false)) {
|
|
throw new InvalidArgumentException(
|
|
sprintf(
|
|
'Value "%s" for "by" param is not valid. Allowed values are %s.',
|
|
$by,
|
|
implode(', ', $allowedForBy)
|
|
)
|
|
);
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Fill params by site value
|
|
*
|
|
* @param string $site site code
|
|
* @param array $params input parameters
|
|
*
|
|
* @return array
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
protected function fillSite($site, array $params)
|
|
{
|
|
if ($site) {
|
|
$params['site'] = $site;
|
|
} elseif ($this->siteCode) {
|
|
$params['site'] = $this->siteCode;
|
|
}
|
|
|
|
return $params;
|
|
}
|
|
|
|
/**
|
|
* @param array $request
|
|
* @param int $checkId
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function checkStatusPlVerification(array $request, int $checkId): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
"/verification/sms/$checkId/status",
|
|
Client::METHOD_GET,
|
|
$request
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array $request
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function loyaltyOrderApply(array $request): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
"/orders/loyalty/apply",
|
|
Client::METHOD_POST,
|
|
[
|
|
'site' => $request['site'],
|
|
'order' => json_encode($request['order']),
|
|
'bonuses' => $request['bonuses'],
|
|
]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array $request
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function loyaltyOrderCalculate(array $request): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
"/loyalty/calculate",
|
|
Client::METHOD_POST,
|
|
[
|
|
'site' => json_encode($request['site']),
|
|
'order' => json_encode($request['order']),
|
|
'bonuses' => $request['bonuses']
|
|
]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function getCredentials(): ApiResponse
|
|
{
|
|
return $this->unversionedClient->makeRequest(
|
|
"/credentials",
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array $request
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function createLoyaltyAccount(array $request): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
"/loyalty/account/create",
|
|
Client::METHOD_POST,
|
|
[
|
|
'loyaltyAccount' => json_encode($request['loyaltyAccount']),
|
|
'site' => $request['site'],
|
|
]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param int $loyaltyId
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function activateLoyaltyAccount(int $loyaltyId): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
"/loyalty/account/".$loyaltyId."/activate",
|
|
Client::METHOD_POST
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array $request
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function sendVerificationCode(array $request): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
"/verification/sms/confirm",
|
|
Client::METHOD_POST,
|
|
[
|
|
'verification'=> json_encode($request['verification'])
|
|
]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array $request
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function getLoyaltyAccounts(array $request): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
"/loyalty/accounts",
|
|
Client::METHOD_GET,
|
|
$request
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param int $loyaltyId
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function getLoyaltyLoyalty(int $loyaltyId): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/loyalty/loyalties/' . $loyaltyId,
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function getLoyaltyLoyalties(): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/loyalty/loyalties',
|
|
Client::METHOD_GET
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array $request
|
|
* @param int $accountId
|
|
*
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function editLoyaltyAccount(array $request, int $accountId): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/loyalty/account/' . $accountId . '/edit',
|
|
Client::METHOD_POST,
|
|
[
|
|
'loyaltyAccount'=> json_encode($request['loyaltyAccount']),
|
|
'id' => $request['id']
|
|
]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array $request
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
protected function confirmLpVerificationBySMS(array $request): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/verification/sms/confirm',
|
|
Client::METHOD_POST,
|
|
$request
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array $request
|
|
* @return \RetailCrm\Response\ApiResponse
|
|
* @throws \RetailCrm\Exception\CurlException
|
|
*/
|
|
public function sendSmsForLpVerification(array $request): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/verification/sms/send',
|
|
Client::METHOD_POST,
|
|
$request
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param int $customerId
|
|
* @param string $site
|
|
* @param string $by
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function cartGet(int $customerId, string $site, string $by = 'externalId'): ApiResponse
|
|
{
|
|
$this->checkIdParameter($by);
|
|
|
|
return $this->client->makeRequest(
|
|
'/customer-interaction/' . $site . '/cart/' . $customerId,
|
|
Client::METHOD_GET,
|
|
$this->fillSite($site, ['by' => $by])
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array $cart
|
|
* @param string $site
|
|
* @throws CurlException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function cartSet(array $cart, string $site): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/customer-interaction/' . $site . '/cart/set',
|
|
Client::METHOD_POST,
|
|
['cart' => json_encode($cart)]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @param array $cart
|
|
* @param string $site
|
|
* @throws CurlException
|
|
*
|
|
* @return ApiResponse
|
|
*/
|
|
public function cartClear(array $cart, string $site): ApiResponse
|
|
{
|
|
return $this->client->makeRequest(
|
|
'/customer-interaction/' . $site . '/cart/clear',
|
|
Client::METHOD_POST,
|
|
['cart' => json_encode($cart)]
|
|
);
|
|
}
|
|
}
|