API Reference

Get the pricing for an order.

post
https://vinoshipper.com/api/v3/p/orders/estimate

Used to provide accurate pricing for an order before you create the order. Pricing includes: shipping and packaging, automatic discounts and all taxes and fees. The create/update order API does not automatically apply packaging and automatic discounts. If you want an API order to include those values you need to first call this estimate API and pass those values when creating the order.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string

Optional order number to use instead of generating one

string

Optional link to the order in the source system

customer
object
required
shipToAddress
object

Where the order will be shipped to

string
enum
required

The type of productId used in the request to identify orders in our system

Allowed:
products
array of objects
required

A list of products that will go on the order

products*
shippingRate
object
required

The shipping rate that will be used to ship the order. You can call the Estimate Shipping API to get a list of shipping rates for a specific address. You can also call the Get Shipping Rate Codes API to get a list of all possible rate codes for the producer.

number
required

When collecting money directly from the customer, you may collect a different tax amount than Vinoshipper calculates. If the custom tax amount is less than Vinoshipper calculates, the producer will be charged the difference. If the custom tax amount is greater than Vinoshipper calculates, the producer will be responsible for refunding the difference to the customer.

number
required

Vinoshipper calculates additional fees, such as CO Retail Delivery fees and CA container deposit fees.If your system collects these fees they should be passed here so that Vinoshipper does not try to collect those fees from the producer. The value of this field will be compared to the total extra fees that Vinoshipper calculated and if you under charged fees they will collected from you during payout.

number
required

Amount of tip added to the order

discount
object
metaFields
object

A list of key value pairs to attach as metadata to this order.

specialInstructions
object
boolean
required

Disable all customer communications about this order. This includes things like the order confirmation email as well as order shipping status notifications.

customerNotificationPreferences
object

Granular email notification preferences that override the global disableCustomerNotifications setting. Allows independent control of specific notification types.

boolean
required

Complete this order and mark it as paid. This money will be collected from the producer.

int32

Store id for the order (default will be used if null)

int32

Shipper id to use for this order (default will be used if null)

string
length between 0 and 255

The fulfillment account or route name to use when the producer allows multiple external fulfillment options. Most producers will not use this field.

int32

Sale location id to indicate where the sale was made (default will be used if null)

soldBy
object

The Vinoshipper team member information

boolean
required
deprecated

This field is deprecated, please use the paid field (without "is" prefix)

Responses

401

Authentication failed

403

Insufficient permission

404

Not Found

Updated 3 months ago

Did this page help you?
Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?