pwinty 3.0.5 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed7db0843764844edfd7aa88b2c2bcfd9ea3445363cce5ac04a099f0db05478a
-  data.tar.gz: 0c8dfce677943320fa92a672a739c5ec05ae323357af47bcc3856426e44b06c1
+  metadata.gz: 834f6357c9970480b7572f388a1ff47f27a50449b56b09ec9913fecf527e510c
+  data.tar.gz: 56552af641deb119beed08897f8f3ca3655554d58cfef1cd838a8f6b250e27c7
 SHA512:
-  metadata.gz: dea713ec0c5667fa2578f9c82d8654f8b0bd25e2240715cc630db018414a3398f3744a7278c6b373363d74a2eae72e6b27a049904110aef013095d2c636475ea
-  data.tar.gz: b816f723de43d8ac43d03077ad6d6ca1002d95ba12808caae6291fde1215ff9c3b57256a09ab0c890f8f7a95f22a869e1d9c1ee32706b40a93ee624ffc127287
+  metadata.gz: 8d24ae448259424a7d1e51c02e508b5ee0f05d2a06bb346390c0cb9fc5a4c2803ff8458a1dc32bf797ac3ba413050b09203dfde80a6dde94c7a995d24bb3eec8
+  data.tar.gz: 1fb7637795fe4ad025089c77ac62a6fc1596b6c7517227752c3680081fdad75b71678a9ce3c42fc6840852ba857b17498db22dec96b8c6e08a59e8c462cbedb0

data/.devcontainer/Dockerfile

@@ -0,0 +1,17 @@
+# [Choice] Ruby version (use -bullseye variants on local arm64/Apple Silicon): 3, 3.1, 3.0, 2, 2.7, 2.6, 3-bullseye, 3.1-bullseye, 3.0-bullseye, 2-bullseye, 2.7-bullseye, 2.6-bullseye, 3-buster, 3.1-buster, 3.0-buster, 2-buster, 2.7-buster, 2.6-buster
+ARG VARIANT=2-bullseye
+FROM mcr.microsoft.com/vscode/devcontainers/ruby:0-${VARIANT}
+
+# [Choice] Node.js version: none, lts/*, 16, 14, 12, 10
+ARG NODE_VERSION="none"
+RUN if [ "${NODE_VERSION}" != "none" ]; then su vscode -c "umask 0002 && . /usr/local/share/nvm/nvm.sh && nvm install ${NODE_VERSION} 2>&1"; fi
+
+# [Optional] Uncomment this section to install additional OS packages.
+# RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+#     && apt-get -y install --no-install-recommends <your-package-list-here>
+
+# [Optional] Uncomment this line to install additional gems.
+# RUN gem install <your-gem-names-here>
+
+# [Optional] Uncomment this line to install global node packages.
+# RUN su vscode -c "source /usr/local/share/nvm/nvm.sh && npm install -g <your-package-here>" 2>&1

data/.devcontainer/base.Dockerfile

@@ -0,0 +1,43 @@
+# [Choice] Ruby version (use -bullseye variants on local arm64/Apple Silicon): 3, 3.1, 3.0, 2, 2.7, 2.6, 3-bullseye, 3.1-bullseye, 3.0-bullseye, 2-bullseye, 2.7-bullseye, 2.6-bullseye, 3-buster, 3.1-buster, 3.0-buster, 2-buster, 2.7-buster, 2.6-buster
+ARG VARIANT=2-bullseye
+FROM ruby:${VARIANT}
+
+# Copy library scripts to execute
+COPY library-scripts/*.sh library-scripts/*.env /tmp/library-scripts/
+
+# [Option] Install zsh
+ARG INSTALL_ZSH="true"
+# [Option] Upgrade OS packages to their latest versions
+ARG UPGRADE_PACKAGES="true"
+# Install needed packages and setup non-root user. Use a separate RUN statement to add your own dependencies.
+ARG USERNAME=vscode
+ARG USER_UID=1000
+ARG USER_GID=$USER_UID
+RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+    # Remove imagemagick due to https://security-tracker.debian.org/tracker/CVE-2019-10131
+    && apt-get purge -y imagemagick imagemagick-6-common \
+    # Install common packages, non-root user, rvm, core build tools
+    && bash /tmp/library-scripts/common-debian.sh "${INSTALL_ZSH}" "${USERNAME}" "${USER_UID}" "${USER_GID}" "${UPGRADE_PACKAGES}" "true" "true" \
+    && bash /tmp/library-scripts/ruby-debian.sh "none" "${USERNAME}" "true" "true" \
+    && apt-get autoremove -y && apt-get clean -y && rm -rf /var/lib/apt/lists/*
+
+# [Choice] Node.js version: none, lts/*, 16, 14, 12, 10
+ARG NODE_VERSION="none"
+ENV NVM_DIR=/usr/local/share/nvm
+ENV NVM_SYMLINK_CURRENT=true \
+    PATH=${NVM_DIR}/current/bin:${PATH}
+RUN bash /tmp/library-scripts/node-debian.sh "${NVM_DIR}" "${NODE_VERSION}" "${USERNAME}" \
+    && apt-get clean -y && rm -rf /var/lib/apt/lists/*
+
+ # Remove library scripts for final image
+RUN rm -rf /tmp/library-scripts
+
+# [Optional] Uncomment this section to install additional OS packages.
+# RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+#     && apt-get -y install --no-install-recommends <your-package-list-here>
+
+# [Optional] Uncomment this line to install additional gems.
+# RUN gem install <your-gem-names-here>
+
+# [Optional] Uncomment this line to install global node packages.
+# RUN su vscode -c "source /usr/local/share/nvm/nvm.sh && npm install -g <your-package-here>" 2>&1

data/.devcontainer/devcontainer.json

@@ -0,0 +1,37 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
+// https://github.com/microsoft/vscode-dev-containers/tree/v0.231.6/containers/ruby
+{
+	"name": "Ruby",
+	"build": {
+		"dockerfile": "Dockerfile",
+		"args": { 
+			// Update 'VARIANT' to pick a Ruby version: 3, 3.1, 3.0, 2, 2.7, 2.6
+			// Append -bullseye or -buster to pin to an OS version.
+			// Use -bullseye variants on local on arm64/Apple Silicon.
+			"VARIANT": "3-bullseye",
+			// Options
+			"NODE_VERSION": "lts/*"
+		}
+	},
+
+	// Set *default* container specific settings.json values on container create.
+	"settings": {},
+
+	// Add the IDs of extensions you want installed when the container is created.
+	"extensions": [
+		"rebornix.Ruby"
+	],
+	
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	// "postCreateCommand": "ruby --version",
+
+	// Comment out to connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root.
+	"remoteUser": "vscode",
+	"features": {
+		"git": "os-provided"
+	}
+
+}

data/.rubocop.yml

@@ -0,0 +1,8 @@
+AllCops:
+  DisabledByDefault: true
+Layout/IndentationStyle:
+  Enabled: true
+Layout/IndentationWidth:
+  Enabled: true
+Layout/IndentationConsistency:
+  Enabled: true

data/.travis.yml

@@ -3,7 +3,7 @@ language: ruby
 cache: bundler
 rvm:
 - 2.5.5
-before_install: gem install bundler -v 1.17.3
+before_install: gem install bundler -v 2.2.10
 before_script:
 - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64
   > ./cc-test-reporter

data/Gemfile.lock

@@ -1,99 +1,118 @@
 PATH
   remote: .
   specs:
-    pwinty (3.0.5)
+    pwinty (4.0.0)
       dry-struct (~> 1.0)
-      dry-struct-setters (~> 0.2)
-      faraday (~> 0.15)
-      faraday_middleware (~> 0.13)
-      json (~> 2.2)
+      dry-struct-setters (~> 0.4)
+      faraday (~> 1.0)
+      faraday_middleware (~> 1.2)
+      json (~> 2.6)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.7.0)
+    addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
-    concurrent-ruby (1.1.6)
-    crack (0.4.3)
-      safe_yaml (~> 1.0.0)
-    diff-lcs (1.3)
-    docile (1.3.2)
-    dotenv (2.7.5)
-    dry-configurable (0.11.5)
+    concurrent-ruby (1.1.10)
+    crack (0.4.5)
+      rexml
+    diff-lcs (1.5.0)
+    docile (1.4.0)
+    dotenv (2.7.6)
+    dry-configurable (0.15.0)
       concurrent-ruby (~> 1.0)
-      dry-core (~> 0.4, >= 0.4.7)
-      dry-equalizer (~> 0.2)
-    dry-container (0.7.2)
+      dry-core (~> 0.6)
+    dry-container (0.9.0)
       concurrent-ruby (~> 1.0)
-      dry-configurable (~> 0.1, >= 0.1.3)
-    dry-core (0.4.9)
+      dry-configurable (~> 0.13, >= 0.13.0)
+    dry-core (0.7.1)
       concurrent-ruby (~> 1.0)
-    dry-equalizer (0.3.0)
-    dry-inflector (0.2.0)
-    dry-logic (1.0.6)
+    dry-inflector (0.2.1)
+    dry-logic (1.2.0)
       concurrent-ruby (~> 1.0)
-      dry-core (~> 0.2)
-      dry-equalizer (~> 0.2)
-    dry-struct (1.3.0)
-      dry-core (~> 0.4, >= 0.4.4)
-      dry-equalizer (~> 0.3)
-      dry-types (~> 1.3)
+      dry-core (~> 0.5, >= 0.5)
+    dry-struct (1.4.0)
+      dry-core (~> 0.5, >= 0.5)
+      dry-types (~> 1.5)
       ice_nine (~> 0.11)
-    dry-struct-setters (0.2.0)
-      dry-struct (>= 0.5.0)
-    dry-types (1.4.0)
+    dry-struct-setters (0.4.0)
+      dry-struct (>= 1.4.0)
+    dry-types (1.5.1)
       concurrent-ruby (~> 1.0)
       dry-container (~> 0.3)
-      dry-core (~> 0.4, >= 0.4.4)
-      dry-equalizer (~> 0.3)
+      dry-core (~> 0.5, >= 0.5)
       dry-inflector (~> 0.1, >= 0.1.2)
       dry-logic (~> 1.0, >= 1.0.2)
-    faraday (0.17.3)
+    faraday (1.10.0)
+      faraday-em_http (~> 1.0)
+      faraday-em_synchrony (~> 1.0)
+      faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
+      faraday-net_http (~> 1.0)
+      faraday-net_http_persistent (~> 1.0)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
+      ruby2_keywords (>= 0.0.4)
+    faraday-em_http (1.0.0)
+    faraday-em_synchrony (1.0.0)
+    faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-multipart (1.0.3)
       multipart-post (>= 1.2, < 3)
-    faraday_middleware (0.14.0)
-      faraday (>= 0.7.4, < 1.0)
+    faraday-net_http (1.0.1)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.3)
+    faraday_middleware (1.2.0)
+      faraday (~> 1.0)
     hashdiff (1.0.1)
     ice_nine (0.11.2)
-    json (2.3.0)
+    json (2.6.1)
     multipart-post (2.1.1)
-    public_suffix (4.0.5)
-    rake (13.0.1)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.2)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
+    public_suffix (4.0.7)
+    rake (13.0.6)
+    rexml (3.2.5)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
-    safe_yaml (1.0.5)
-    simplecov (0.18.5)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+    ruby2_keywords (0.0.5)
+    simplecov (0.21.2)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
-    simplecov-html (0.12.2)
-    vcr (5.1.0)
-    webmock (3.8.3)
-      addressable (>= 2.3.6)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.12.3)
+    simplecov_json_formatter (0.1.4)
+    vcr (6.1.0)
+    webmock (3.14.0)
+      addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
 
 PLATFORMS
-  ruby
+  aarch64-linux
 
 DEPENDENCIES
-  bundler (~> 1.17)
+  bundler
   dotenv (~> 2.7.5)
   pwinty!
-  rake (~> 13.0)
-  rspec (~> 3.0)
-  simplecov (~> 0.17)
-  vcr (~> 5.0)
-  webmock (~> 3.6)
+  rake
+  rspec
+  simplecov (~> 0.21)
+  vcr (~> 6.0)
+  webmock (~> 3.14)
 
 BUNDLED WITH
-   1.17.3
+   2.3.7

data/README.md

@@ -7,10 +7,10 @@
 [![Known Vulnerabilities](https://snyk.io//test/github/tomharvey/pwinty3-rb/badge.svg?targetFile=Gemfile.lock)](https://snyk.io//test/github/tomharvey/pwinty3-rb?targetFile=Gemfile.lock)
 
 
-This wraps the Pwinty API at version 3 and aims to make your ruby life easier
+This wraps the Prodigi Pwinty API at version 4 and aims to make your ruby life easier
 when interacting with the API.
 
-See http://pwinty.com and https://pwinty.com/api for more details around the
+See https://www.prodigi.com and https://www.prodigi.com/print-api/docs/ for more details around the
 core service.
 
 ## Installation
@@ -18,7 +18,7 @@ core service.
 Add this line to your application's Gemfile:
 
 ``` ruby
-gem 'pwinty'
+gem 'pwinty', '~>4'
 ```
 
 And then execute:
@@ -37,7 +37,7 @@ app.
 
 #### Authentication
 To authenticate requests you must get your merchant ID and API Key from the
-[Integration Settings in the Pwinty Dashboard](https://beta-dashboard.pwinty.com/settings/integrations).
+[Integration Settings in the Pwinty Sandbox Dashboard](https://sandbox-beta-dashboard.pwinty.com/settings/integrations).
 
 These values must be set as the Environment Variables
 `PWINTY_MERCHANT_ID` and `PWINTY_API_KEY`
@@ -50,7 +50,7 @@ Pwinty::API_KEY = 'your api key'
 
 #### Production vs Sandbox
 The Pwinty API provides a sandbox endpoint to test and develop against at
-`https://sandbox.pwinty.com`. This is the default
+`https://api.sandbox.prodigi.com`. This is the default
 endpoint used by this library.
 
 When you are ready to switch to the production endpoint, set the
@@ -58,116 +58,73 @@ Environment Variable `PWINTY_BASE_URL` or declare the
 constant in your app:
 
 ``` ruby
-Pwinty::BASE_URL = 'https://api.pwinty.com'  # Without a trailing slash
+Pwinty::BASE_URL = 'https://api.prodigi.com'  # Without a trailing slash
 ```
 
 ## Usage
 
-### Create an Order
+### Create and submit an Order
 
-These are the minimum variables you need to send to the API to register your
-order, you'll want to add more or update later.
+These are the minimum variables you need to create an order and submit it for printing.
+
+This method will return a `Pwinty::Order` object.
 
 See the `lib/pwinty/order.rb` file or the
-[API documentation](https://pwinty.com/api/#orders-create)
+[API documentation](https://www.prodigi.com/print-api/docs/reference/#create-order)
 to understand the full list of attributes to send.
 
 ``` ruby
-order = Pwinty::Order.create(
-    recipientName: "FirstName LastName",
-    countryCode: "US",
-    preferredShippingMethod: "Budget"
+order = Pwinty::Order.new(
+    shippingMethod: "Budget",
+		recipient: {
+			name: "Tom Harvey",
+		},
+		items: [
+			{
+				sku: "GLOBAL-PHO-4X6-PRO",
+				copies: 1,
+				assets: [
+					{url: 'https://example.com/image.jpg'}
+				],
+				attributes: {finish: 'lustre'},
+			}
+		]
 )
-```
 
-This create method will return a `Pwinty::Order` object.
+submitted_order = order.submit
+
+p submitted_order
+>>> "ord_1234"
+```
 
 ### Get an existing Order from the API
 
 Once an order is created you can retreive it from the API to further manage it,
 or if it has been submitted you can see the latest production and shipping details.
 
-``` ruby
-order = Pwinty::Order.find(1)  # Pass the ID returned when you created the Order
-```
-
 This method will return a `Pwinty::Order` object.
 
-### Update an Order
-
-Using the `order` object created in the above, we can update this using:
-
 ``` ruby
-order.update(
-    address1: 'Street Name',
-)
+order = Pwinty::Order.find('ord_1234')  # Pass the ID returned when you created the Order
 ```
 
-This update method will update the `Pwinty::Order` object.
-
-### Validate an Order
-
-Before submitting you might want to validate the order and check all is well.
 
-``` ruby
-status = order.submission_status
-```
+### Cancel an order
 
-This will return a `Pwinty::OrderStatus` object. See the
-[API documentation](https://pwinty.com/api/#orders-validate)
-for more details of the shape of this reponse. But, you'll at least want the
-`status.isValid` method for a boolean
-check to see if it can be submitted.
+Orders which are not being processed can be cancelled.
 
-### Add an Image to your Order
-
-Add a single image by passing a hash to:
-
-``` ruby
-order.add_image(
-	sku: "GLOBAL-PHO-4X6-PRO",
-	url: "http://example.com/mytestphoto.jpg",
-	copies: 1,
-)
-```
-
-or you can add multiple images by passing a list of hashes to the pluralised method:
-
-``` ruby
-order.add_images([
-	{
-		sku: "GLOBAL-PHO-4X6-PRO",
-		url: "http://example.com/myTestPhoto.jpg",
-		copies: 1,
-	}, {
-		sku: "GLOBAL-PHO-10X12-PRO",
-		url: "http://example.com/myLargeTestPhoto.jpg",
-		copies: 1,
-	}
-])
-```
-
-On completion there will be a list of `Pwinty::Image` objects associated with `order.images`
-
-
-### Submit, Cancel or Hold an order
+This method will return a `Pwinty::Order` object.
 
-Before you submit you should run Validate and ensure there are no errors.
+See https://www.prodigi.com/print-api/docs/reference/#order-actions for more on the actions
+you can take on an order and at which point in an order lifecycle you can take them.
 
 ``` ruby
-order.submit
->>> true
-
-order.cancel
->>> true
-
-order.hold
->>> true
+order = Pwinty::Order.find('ord_1234')
+cancelled_order = order.cancel
+p cancelled_order.status.stage
+>>> "Cancelled"
 ```
 
-These methods will either submit your order for processing, or cancel/hold the
-processing. Each will return a boolean.
-
 ### Check the shipment status of a submitted Order
 
 Once created you can use the `find` method to get the most up to date info about an Order.
@@ -175,12 +132,11 @@ Following submission, this will contain a shippingInfo with a price for shipping
 a list of `Pwinty::Shipment` objects
 
 ``` ruby
-order = Pwinty::Order.find(1)
-order.shippingInfo.price
->>> 500
+order = Pwinty::Order.find('ord_1234')
+order.shipments
 
-order.shippingInfo.shipments[0]
->>> #<Pwinty::Shipment shipmentId="1" isTracked=true trackingNumber="XYZ123456ABC" ...
+order.shipments[0].dispatchDate
+>>> '2022-04-29T00:00:00"
 ```
 
 ### List your orders
@@ -188,22 +144,17 @@ order.shippingInfo.shipments[0]
 ``` ruby
 orders = Pwinty::Order.list
 ```
-**N.B - This will get all of your orders - this can take some time. By default, it will request the orders from Pwinty in batches of 50; so 500 orders will take 10 requests to complete.** 
+**N.B - This will get all of your orders - this can take some time. By default, it will request the orders from Pwinty in batches of 10; so 500 orders will take 50 requests to complete.** 
 
 Will return an array of `Pwinty::Order` objects.
 
-### Count your orders
-
-``` ruby
-count = Pwinty::Order.count
-```
-Will return an integer of the number of orders you have.
-
-
 
 ## Development
 
-After checking out the repo, run `bundle` to install dependencies.
+There is a VSCode devcontainer included, so reopen the repo in a devcontainer if you want
+a quick way to setup your ruby environment. This defaults to using ruby v3
+
+After checking out the repo, or opening in a devcontainer, run `bundle` to install dependencies.
 
 Then, run `rake` to run the tests.
 

data/lib/pwinty/api_models/order.rb

@@ -0,0 +1,114 @@
+require 'dry/struct/with_setters'
+
+require "pwinty/api_models/order_asset"
+require "pwinty/api_models/order_charge"
+require "pwinty/api_models/order_cost"
+require "pwinty/api_models/order_item"
+require "pwinty/api_models/order_packing_slip"
+require "pwinty/api_models/order_recipient"
+require "pwinty/api_models/order_shipment"
+require "pwinty/api_models/order_status"
+
+module Pwinty
+
+  DEFAULT_PAGE_SIZE = 10
+
+  class Order < Pwinty::Base
+    """https://www.prodigi.com/print-api/docs/reference/#order-object"""
+    attribute? :id, Types::String.optional
+    attribute? :created, Types::String.optional
+    attribute? :callbackUrl, Types::String.optional
+    attribute? :merchantReference, Types::String.optional
+    attribute? :shippingMethod, Types::String.optional
+    attribute? :idempotencyKey, Types::String.optional
+    attribute? :status, Pwinty::OrderStatus.optional
+    attribute? :charges, Types::Array.of(Pwinty::OrderCharge).optional
+    attribute? :shipments, Types::Array.of(Pwinty::OrderShipment).optional
+    attribute? :recipient, Pwinty::OrderRecipient.default(Pwinty::OrderRecipient.new)
+    attribute? :items, Types::Array.of(Pwinty::OrderItem).default([])
+    attribute? :packingSlip, Pwinty::OrderPackingSlip.optional
+    attribute? :metadata, Types::Hash.optional
+
+    def self.find(id)
+      response = Pwinty.conn.get("orders/#{id}")
+      new(response.body['order'])
+    end
+
+    def self.list(page_size: DEFAULT_PAGE_SIZE, limit: 0)
+      """ Get all of the orders - this can take a while!
+
+      Page size maximum is 100.
+      Limit of 0 will get all of them.
+      """
+      all_orders = list_each_page(page_size: page_size, limit: limit)
+      Pwinty.collate_results(all_orders, self)
+    end
+
+    def self.list_each_page(page_size: DEFAULT_PAGE_SIZE, limit: 0)
+      all_orders = []
+      page_start = 0
+      has_more = true
+      limit_reached = false
+      while has_more and not limit_reached
+        response = Pwinty.conn.get("orders?top=#{page_size}&skip=#{page_start}")
+        all_orders = all_orders + response.body['orders']
+        page_start += page_size
+        limit_reached = Pwinty::is_limit_reached(all_orders.count, limit: limit)
+        has_more = response.body['hasMore']
+      end
+      all_orders
+    end
+
+    def add_image image
+      self.items << Pwinty::OrderItem.new(
+        sku: image[:sku],
+        copies: image[:copies],
+        assets: [Pwinty::OrderAsset.new(
+          url: image[:url],
+        )]
+      )
+    end
+
+    def serializable
+      order_attrs = Hash.new
+      order_attrs.update(self.attributes)
+
+      order_attrs[:items] = []
+      for item in self.items
+        order_attrs[:items] << item.serializable
+      end
+
+      order_attrs[:recipient] = self.recipient.serializable
+      order_attrs
+    end
+
+    def submit
+      """Send the order to Prodigi."""
+      response = Pwinty.conn.post("orders", self.serializable)
+      new(response.body['order'])
+    end
+
+    def cancel
+      """Cancel the order.
+      https://www.prodigi.com/print-api/docs/reference/#cancel-an-order
+      """
+      response = Pwinty.conn.post("orders/#{self.id}/actions/cancel")
+      outcome = response.body['outcome']
+      case outcome
+        when 'failedToCancel'; raise Pwinty::Error, response.body
+        when 'actionNotAvailable'; raise Pwinty::OrderActionUnavailable, response.body
+      end
+
+      new(response.body['order'])
+    end
+
+  end
+
+  protected
+
+  def self.is_limit_reached(number_of_records, limit: 0)
+    return false if limit === 0
+    return number_of_records >= limit
+  end
+
+end

data/lib/pwinty/api_models/order_asset.rb

@@ -0,0 +1,7 @@
+module Pwinty
+  class OrderAsset < Pwinty::Base
+    """https://www.prodigi.com/print-api/docs/reference/#order-object-asset"""
+    attribute? :printArea, Types::String.default('default')
+    attribute? :url, Types::String
+  end
+end