Skip to main content

Python library for Shipday API

Project description

Shipday Python SDK

The Shipday Python sdk provides easier access to Shipday API's from Python applications and scripts.

Documentation

See the shipday api docs for Python.

Requirements

Python 3.6 or higher

Installation

pip install shipday

Usage

Import Shipday from shipday package.

from shipday import Shipday

You need to provide the shipday api-key in order to use the library. To get your API key login to your Shipday Dispatch Dashboard and Find the API key from integrations tab.

Example usages looks like following:-

API_KEY = '##########.#######################'
my_shipday = Shipday(api_key=API_KEY)

This my_shipday object contains three services (CarrierService, OrderService and OnDemandDeliveryService) which you can use to get your job done. Here are few examples,

Carrier Service

To get all your carriers, use get_carriers() function of the CarrierService. Following example prints the number of carriers you have -

my_carriers = my_shipday.CarrierService.get_carriers()
print('I have {} carriers'.format(len(my_carriers)))

To add a carrier, you need to create a CarrierRequest and send it using add_carrier() function of CarrierService. See the example below -

from shipday.carrier import CarrierRequest

carrier_req = CarrierRequest(name='John Doe',
                             email='john.doe@shipday.com',
                             phone_number='+123456789')
my_shipday.CarrierService.add_carrier(carrier_req)

To delete a carrier, use delete_carrier() function of the CarrierService. For example-

my_shipday.CarrierService.delete_carrier(carrier_id=1234)

Order Service

To get all the orders, use get_orders() function of the OrderService.

my_orders = my_shipday.OrderService.get_orders()

To add an order, you need to create an Order object and send it using insert_order() function of OrderService. For example -

from shipday.order import Address, Customer, Pickup, OrderItem, Order

new_order = Order(orderNumber='100')

# Add customer details
new_order.customer = Customer(
    name='John Doe', email='john.doe', phone_number='+12367124',
    address=Address(street='556 Crestlake Dr', city='San Francisco', state='California', country='USA')
)
# Don't worry if you forget to send a parameter, you can also set it later like following line
new_order.customer.address.zip = 'CA 94132'

# Add pickup details
new_order.pickup = Pickup(
    name='My pickup point', phone_number='+132462374'
)
new_order.pickup.address = Address(street='890 Geneva Av', city='San Fransisco', state='California', zip='CA 94132',
                                   country='USA')

# Add order items
new_order.order_items = [OrderItem(name='Pizza', unit_price=10.0, quantity=1)]
new_order.order_items.append(
    OrderItem(name='Popcorn Shrimp', quantity=1, unit_price=5)
)

my_shipday.OrderService.insert_order(new_order)

To retrieve orders by order number, use get_order function. This will return a list of orders matching the given order_number.

orders = my_shipday.OrderService.get_order(order_number='100')

To assign an order to a carrier, use assign_order() function. For example,

my_shipday.OrderService.assign_order(order_id=7995257, carrier_id=242324)

To delete an order, use delete_order() function. For example,

my_shipday.OrderService.delete_order(order_id=7995246)

You can also query orders using query() function. For that you need to create a OrderQuery object. Following code retrieves all orders from last 24 hours -

from shipday.order import OrderQuery

query = OrderQuery()

from datetime import datetime, timedelta

query.start_time = datetime.now() - timedelta(days=1)

my_shipday.OrderService.query(query=query)

OnDemandDeliveryService

To get informations on On-Demand Delivery Services use get_services() function like following code -

my_shipday.OnDemandDeliveryService.get_services()

You can use get_active_services() function to retrieve the service names of those available to your account.

my_shipday.OnDemandDeliveryService.get_active_services()

To estimate the cost and required delivery time from available delivery services, use estimate() function -

my_shipday.OnDemandDeliveryService.estimate(order_id=123424)

You can assign an order to a delivery service provider by calling assign() method. For example,

my_shipday.OnDemandDeliveryService.assign(order_id=1234, service_name='Uber')

After assigning an order to a service, you can get the details using get_details() method.

my_shipday.OnDemandDeliveryService.get_details(order_id=1234)

If something goes wrong, you can cancel an assigned order using cancel() function. But this is not guaranteed to work-.

my_shipday.OnDemandDeliveryService.cancel(order_id=1234)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

shipday-1.4.3.tar.gz (13.9 kB view details)

Uploaded Source

Built Distribution

shipday-1.4.3-py3-none-any.whl (17.8 kB view details)

Uploaded Python 3

File details

Details for the file shipday-1.4.3.tar.gz.

File metadata

  • Download URL: shipday-1.4.3.tar.gz
  • Upload date:
  • Size: 13.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.6

File hashes

Hashes for shipday-1.4.3.tar.gz
Algorithm Hash digest
SHA256 b8a5832bd1bd1d3872981bf4855ac15ee109c9c41a1e338f0f703b35fe2c7de3
MD5 3708f0ab0d2d7d432327d4a639e44ef8
BLAKE2b-256 db2d92fedb64e317898e37bbe5d0b2230236d22e4480dfca50678b56051cb361

See more details on using hashes here.

File details

Details for the file shipday-1.4.3-py3-none-any.whl.

File metadata

  • Download URL: shipday-1.4.3-py3-none-any.whl
  • Upload date:
  • Size: 17.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.6

File hashes

Hashes for shipday-1.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 99c5ee7faffc5ee833292b0e44784b32ff3c225ca9b4207667f0f2b04dab43d4
MD5 d9b535f7169638ff84517cd4b1a16e91
BLAKE2b-256 19f0a1e24fbae648e672c1609f37060b67ace2cfc361ce1e34e4bb94f39d624a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page