seal/fetchr_sdk

sdk for Delivery Service Fetchr ( https://fetchr.us/ )

v1.0 2019-02-25 11:08 UTC

This package is auto-updated.

Last update: 2025-09-14 23:17:03 UTC


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.