NAME

WWW::ShipStation - ShipStation API

SYNOPSIS

use WWW::ShipStation;

DESCRIPTION

WWW::ShipStation is for http://www.shipstation.com/developer-api/

refer examples for running code

METHODS

new

my $ws = WWW::ShipStation->new(
    user => 'blabla',
    pass => 'blabla'
);

• user

  required, API key

• pass

  required, API secret

• ua

  optional, LWP::UserAgent based.

• json

  optional, JSON based

getCarriers

my $carriers = $ws->getCarriers();

http://www.shipstation.com/developer-api/#/reference/customers/list-carriers

getCustomer

my $customer = $ws->getCustomer($customer_id);

getCustomers

my $customers = $ws->getCustomers();
my $customers = $ws->getCustomers(
    stateCode => ...
    countryCode => ...
);

http://www.shipstation.com/developer-api/#/reference/customers/list-customers/list-customers

getMarketplaces

my $marketplaces = $ws->getMarketplaces();

http://www.shipstation.com/developer-api/#/reference/stores/storesmarketplaces/get

getOrders

my $orders = $ws->getOrders();
my $orders = $ws->getOrders(
    customerName => ...
    createDateStart => ...
);

http://www.shipstation.com/developer-api/#/reference/orders/orders/get

getOrder

my $order = $ws->getOrder($orderId);

http://www.shipstation.com/developer-api/#/reference/orders/order/get-order

getProducts

my $products = $ws->getProducts(
    sku => ...
);

http://www.shipstation.com/developer-api/#/reference/products/products/get

getShipments

my $shipments = $ws->getShipments(
    orderId => ...
);

http://www.shipstation.com/developer-api/#/reference/shipments/shipments/get

getStores

my $stores = $ws->getStores(
    showInactive => 1,
);

http://www.shipstation.com/developer-api/#/reference/stores

getWarehouses

my $warehouses = $ws->getWarehouses();

http://www.shipstation.com/developer-api/#/reference/warehouses/warehouses/get

createOrder

my $order = $ws->createOrder({
  "orderNumber" => "TEST-ORDER-API-DOCS",
  "orderKey" => "0f6bec18-3e89-4771-83aa-f392d84f4c74",
  "orderDate" => "2015-06-29T08:46:27.0000000",
  "paymentDate" => "2015-06-29T08:46:27.0000000",
  "orderStatus" => "awaiting_shipment",
  "customerUsername" => 'headhoncho@whitehouse.gov',
  "customerEmail" => 'headhoncho@whitehouse.gov',
  "billTo" => {
    "name" => "The President",
    "company" => undef,
    "street1" => undef,
    "street2" => undef,
    "street3" => undef,
    "city" => undef,
    "state" => undef,
    "postalCode" => undef,
    "country" => undef,
    "phone" => undef,
    "residential" => undef
  },
  "shipTo" => {
    "name" => "The President",
    "company" => "US Govt",
    "street1" => "1600 Pennsylvania Ave",
    "street2" => "Oval Office",
    "street3" => undef,
    "city" => "Washington",
    "state" => "DC",
    "postalCode" => "20500",
    "country" => "US",
    "phone" => "555-555-5555",
    "residential" => 1
  },
  "items" => [
    {
      "lineItemKey" => "vd08-MSLbtx",
      "sku" => "ABC123",
      "name" => "Test item #1",
      "imageUrl" => undef,
      "weight" => {
        "value" => 24,
        "units" => "ounces"
      },
      "quantity" => 2,
      "unitPrice" => 99.99,
      "warehouseLocation" => "Aisle 1, Bin 7",
      "options" => [
        {
          "name" => "Size",
          "value" => "Large"
        }
      ],
      "adjustment" => 0
    },
    {
      "lineItemKey" => undef,
      "sku" => "DISCOUNT CODE",
      "name" => "10% OFF",
      "imageUrl" => undef,
      "weight" => {
        "value" => 0,
        "units" => "ounces"
      },
      "quantity" => 1,
      "unitPrice" => -20.55,
      "warehouseLocation" => undef,
      "options" => [],
      "adjustment" => 1
    }
  ],
  "amountPaid" => 218.73,
  "taxAmount" => 5,
  "shippingAmount" => 10,
  "customerNotes" => "Thanks for ordering!",
  "internalNotes" => "Customer called and would like to upgrade shipping",
  "gift" => 1,
  "giftMessage" => "Thank you!",
  "paymentMethod" => "Credit Card",
  "requestedShippingService" => "Priority Mail",
  "carrierCode" => "fedex",
  "serviceCode" => "fedex_2day",
  "packageCode" => "package",
  "confirmation" => "delivery",
  "shipDate" => "2015-07-02",
  "weight" => {
    "value" => 25,
    "units" => "ounces"
  },
  "dimensions" => {
    "units" => "inches",
    "length" => 7,
    "width" => 5,
    "height" => 6
  },
  "insuranceOptions" => {
    "provider" => "carrier",
    "insureShipment" => 1,
    "insuredValue" => 200
  },
  "internationalOptions" => {
    "contents" => undef,
        "customsItems" => undef
  },
  "advancedOptions" => {
    "warehouseId" => 0,
    "nonMachinable" => 0,
    "saturdayDelivery" => 0,
    "containsAlcohol" => 0,
    "storeId" => 0,
    "customField1" => "Custom data",
    "customField2" => "Per UI settings, this information",
    "customField3" => "can appear on some carrier's shipping labels",
    "source" => "Webstore"
  }
});

deleteOrder

my $is_success = $ws->deleteOrder($OrderID);

request

my $data = $ws->request('customers');
my $data = $ws->request('warehouses');

internal use

AUTHOR

Fayland Lam fayland@gmail.com

COPYRIGHT

Copyright 2014- Fayland Lam

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO