README

Wet... dirt... code

Установка

Минимальные требования — PHP 5.3+.

curl enabled

composer require seal/fetchr_sdk

Test

В директории test создан интерфейс для тестирования нужно только вставить в файл user_token.php свой api token

Токен можно получить обратившись в службу поддержки fetchr ( support@fetchr.us )

Использование

require_once 'vendor/autoload.php';

$fetchr = new Seal\fetchr_sdk( USER_TOKEN );


/**
 * @param $method_name - метод к которому обращаетесь
 * 
 * @param $data - данные которые передаете 
 * ( структура полностю соответствует данным из документации https://xapidoc.docs.apiary.io/ )
 *
 * @return array
 */

$response = $fetchr->init( $method_name, $data );

	

Ответ

{

	"body": {"SOME DATA FETCHR"},
	"header": "response header",
	"method": "the method that was used",

}

В $response['body'] находятся данные соответствующие ответу из документации https://xapidoc.docs.apiary.io/

!!! ИЗМЕНЕН ОТВЕТ ДЛЯ МЕТОДОВ ТРЕКИНГА !!! (для страндартизации всех ответов)

Пример ответа для методов трекинга:

{

	"body": {
		"status":"OK",
		"data": [

			{
			  "tracking_information": {
			    "status_name": "uploaded",
			    "status_code": "UPL",
			    "status_date": "2018-06-27T10:20:37.317385",
			    "source": "fetchr",
			    "status_date_local": "2018-06-27 14:20:46",
			    "status_description": "Order Created"
			  },
			  "order_information": {
			    "tracking_no": "34146607575779",
			    "client_ref": "199619721aabb12345"
			  },

			  "status":"OK"
			}

		]
	},
	"header": "response header",
	"method": "the method that was used",

}

Методы

• Order Creation:

  • Create Dropship Orders - Fetchr забирает продукты ИЗ МЕСТОПОЛОЖЕНИЯ ОТПРАВИТЕЛЯ и доставляет их получателю.

     $response = $fetchr->init( 'createDropshipOrders', $data );

  • Create Reverse Orders - Обратный заказ - это заказ на получение товаров (которые необходимо вернуть) у получателя и отправка обратно отправителю

     $response = $fetchr->init( 'createReverseOrders', $data );

  • Create Fulfillment Orders - Fulfillment Orders - это заказ по сбору товара на складе Fetchr и доставке получателю.

     $response = $fetchr->init( 'createFulfillmentOrders', $data );

  • Get Fulfillment SKU Stock Info - Используется для получения информации о складе для выполнения заказов по sku

     $response = $fetchr->init( 'getFulfillmentSKUInfo', $data );

• Order Tracking:

  • Get Order Status - Получаем последний статус для заказа

     $response = $fetchr->init( 'getOrderStatus', $data );

  • Get Order History - Получаем историю статусов для заказа

     $response = $fetchr->init( 'getOrderHistory', $data );

  • Get Bulk Order Status - Получаем последний статус заказа для нескольких ттн

     $response = $fetchr->init( 'getBulkOrderStatus', $data );

  • Get Bulk Order History - Получаем историю статусов нескольких ттн

     $response = $fetchr->init( 'getBulkOrderHistory', $data );

• Order Service:

  • Get AWB Link - Получаем ссылку пдф

     $response = $fetchr->init( 'getAWBLink', $data );

• Cancel Order:

  • Cancel Order - отмена созданого заказа

     $response = $fetchr->init( 'cancelOrder', $data );

• Schedule:

  • Get Timeslots
  • Schedule Order

Лицензия

Данный SDK распространяется под лицензией MIT.