Project

bosta

0.0
The project is in a healthy, maintained state
This gem simplifies the integration process with Bosta. create, update and track your shimpents easily
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
 Project Readme

Bosta Ruby Package

The Bosta Ruby SDK provides convenient access to the Bosta API from applications written in the Ruby language.

  • Installation
  • Usage
  • Contribution
  • License

Installation

gem install bosta

Usage

Initiating Bosta Client

require('bosta');

Bosta.api_key= ENV['API_KEY']
Bosta.base_url= ENV['BASE_URL']

API_KEY is your integartion api key with bosta, to get an api key you must be registered, here is the registration link Bosta. And BASE_URL is the url to bosta Apis wheither it's staging or production. If BASE_URL is not sent in initialization as parameter it's production by default.

Use initiated bosta client to do the functionality of the following

list utilities
delivery types to use in shipment creation
deliveryTypes = Bosta::DELIVERY_TYPES;
pickup timeslots to use in pickup creation
pickupTimeSlots_1 = Bosta::TIME_SLOT_10_TO_13;
pickupTimeSlots_2 = Bosta::TIME_SLOT_13_TO_16;
Shipments
created shipment
receiver1 = Bosta::Receiver.new('Ahmad Mohamad', '01029394959')
address1 = Bosta::Address.new('EG-01', 'address firstline')
type = Bosta::DELIVERY_TYPES[:SEND]
spec = Bosta::Specs.new(Bosta::DELIVERY_SIZES[:SMALL])
create_delivery = Bosta::Delivery.create(type, 100, receiver1, address1,  spec)

delivery_id = create_delivery['_id'];
tracking_number = create_delivery['trackingNumber'];
update shipment by id
update_delivery = Bosta::Delivery.update(delivery_id, cod=nil, address= nil, receiver = nil, business_reference=nil, webhook_url=nil, notes=nil);
list all created shipments
deliveries = Bosta::Delivery.find_all_deliveries();
get shipment by tracking number
delivery = Bosta::Delivery.find_delivery_by_traking_number(tracking_number);
track shipment
tracking_history = Bosta::Delivery.track_delivery(tracking_number);
print airwayBill
airwayBill = Bosta::Delivery.print_delivery_awb(delivery_id);
terminate delivery
Bosta::Delivery.terminate_delivery(delivery_id);
pickups
get your pickup location
pickup_locations = Bosta::Pickup.find_pickup_locations();
business_location_id = pickup_locations["pickupLocations"][0]['_id'];
create pickup
create_pickup = Bosta::Pickup.create(business_location_id, scheduled_date, scheduled_time_slot, contact_person);
update pickup
update_pickup = Bosta::Pickup.update(pickup_id, business_location_id=nil, scheduled_date=nil, scheduled_time_slot=nil, contact_person=nil, notes=nil);
get all pickups
pickup_requests = Bosta::Pickup.find_pickups();
get pickup by id
pikcup_request = Bosta::Pickup.find_pickup_by_id(pickup_id);
delete pickup
Bosta::Pickup.delete_pickup(pickup_id);
cities
get all cities to select one of them and its code in shipment
cities = Bosta::City.find_all_cities();
zones
get zones of the city by city id to use one of them in the shipment
zones = Bosta::City.show_city_zones(city_id);

Contribution

We are open to, and grateful for, any contributions made by the community. By contributing to Bosta, you agree to abide by the code of conduct.

License

The MIT License (MIT) License.