Class: Peddler::APIs::MerchantFulfillmentV0

Inherits:
Peddler::API show all
Defined in:
lib/peddler/apis/merchant_fulfillment_v0.rb

Overview

Selling Partner API for Merchant Fulfillment

With the Selling Partner API for Merchant Fulfillment, you can build applications that sellers can use to purchase shipping for non-Prime and Prime orders using Amazon's Buy Shipping Services.

Instance Attribute Summary

Attributes inherited from Peddler::API

#access_token, #endpoint, #parser, #retries

Instance Method Summary collapse

Methods inherited from Peddler::API

#endpoint_uri, #http, #initialize, #meter, #retriable, #sandbox, #sandbox?, #use, #via

Constructor Details

This class inherits a constructor from Peddler::API

Instance Method Details

#cancel_shipment(shipment_id, rate_limit: 1.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Cancel the shipment indicated by the specified shipment identifier.

Parameters:

  • shipment_id (String) —

    The Amazon-defined shipment identifier for the shipment to cancel.

  • rate_limit (Float) (defaults to: 1.0) —

    Requests per second

Returns:



48
49
50
51
52
 
# File 'lib/peddler/apis/merchant_fulfillment_v0.rb', line 48

def cancel_shipment(shipment_id, rate_limit: 1.0)
  path = "/mfn/v0/shipments/#{percent_encode(shipment_id)}"

  meter(rate_limit).delete(path)
end

#create_shipment(body, rate_limit: 2.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Create a shipment with the information provided.

Parameters:

  • body (Hash) —

    The request schema for the CreateShipment operation.

  • rate_limit (Float) (defaults to: 2.0) —

    Requests per second

Returns:



60
61
62
63
64
 
# File 'lib/peddler/apis/merchant_fulfillment_v0.rb', line 60

def create_shipment(body, rate_limit: 2.0)
  path = "/mfn/v0/shipments"

  meter(rate_limit).post(path, body:)
end

#get_additional_seller_inputs(body, rate_limit: 1.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Gets a list of additional seller inputs required for a ship method. This is generally used for international shipping.

Parameters:

  • body (Hash) —

    The request schema for the GetAdditionalSellerInputs operation.

  • rate_limit (Float) (defaults to: 1.0) —

    Requests per second

Returns:



73
74
75
76
77
 
# File 'lib/peddler/apis/merchant_fulfillment_v0.rb', line 73

def get_additional_seller_inputs(body, rate_limit: 1.0)
  path = "/mfn/v0/additionalSellerInputs"

  meter(rate_limit).post(path, body:)
end

#get_eligible_shipment_services(body, rate_limit: 6.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Returns a list of shipping service offers that satisfy the specified shipment request details.

Parameters:

  • body (Hash) —

    The request schema for the GetEligibleShipmentServices operation.

  • rate_limit (Float) (defaults to: 6.0) —

    Requests per second

Returns:



24
25
26
27
28
 
# File 'lib/peddler/apis/merchant_fulfillment_v0.rb', line 24

def get_eligible_shipment_services(body, rate_limit: 6.0)
  path = "/mfn/v0/eligibleShippingServices"

  meter(rate_limit).post(path, body:)
end

#get_shipment(shipment_id, rate_limit: 1.0) ⇒ Peddler::Response

Note:

This operation can make a static sandbox call.

Returns the shipment information for an existing shipment.

Parameters:

  • shipment_id (String) —

    The Amazon-defined shipment identifier for the shipment.

  • rate_limit (Float) (defaults to: 1.0) —

    Requests per second

Returns:



36
37
38
39
40
 
# File 'lib/peddler/apis/merchant_fulfillment_v0.rb', line 36

def get_shipment(shipment_id, rate_limit: 1.0)
  path = "/mfn/v0/shipments/#{percent_encode(shipment_id)}"

  meter(rate_limit).get(path)
end