Lieberman's API Documentation

GetCountries

https://services.liebermans.net/api/v2/liebermansservice.asmx?op=GetCountries

Retrieves a string array of countries that Lieberman's will ship to. When submitting orders, the ShippingCountryName must match one of the items listed in the return array from this method.

GetOrderItemPricing

https://services.liebermans.net/api/v2/liebermansservice.asmx?op=GetOrderItemPricing

The GetOrderItemPricing web method will return pricing and product information for an OrderItem. This web method accepts one input parameter, item, which represents an OrderItem. Please see the OrderItem examples in the SubmitOrder documentation for more information on how to identify products.

GetOrderStatus

https://services.liebermans.net/api/v2/liebermansservice.asmx?op=GetOrderStatus

The GetOrderStatus web method will return status information an Order and its OrderItems. This web method accepts one input parameter, orderID.

Each OrderItem on the Order has a Status property. The Status will be one of the following values:

SubmitOrder

https://services.liebermans.net/api/v2/liebermansservice.asmx?op=SubmitOrder

The SubmitOrder web method accepts two input parameters, order and options. The order parameter contains the details of the order and the items to be ordered, while the options parameter provides instructions on how to process the order.

The Order object contains several properties. However, when submitting an order using the SubmitOrder method, most of these fields do not need to be supplied. The fields that are required are as follows:

The are several ways to define an OrderItem. For each OrderItem, you can supply a CustomerReferenceNumber (optional - this usually maps to an item ID in the client's database), and you must supply a Quantity.

For print orders, you can specify the PID:

<OrderItem>
	<PID>407779</PID>
	<Quantity>1</Quantity>
</OrderItem>

Or, you can specify the PublisherCode and PublisherItemNumber:

<OrderItem>
	<PublisherCode>TEL</PublisherCode>
	<PublisherItemNumber>6420223</PublisherItemNumber>
	<Quantity>1</Quantity>
</OrderItem>

Each Xml fragment listed above describes the same unframed piece of artwork. When adding services like framing or canvas transfers to an order, you can indicate the artwork to be framed or transferred to canvas in the same manner. If we were to frame this item, the OrderItem Xml would look like:

<OrderItem>
	<PID>407779</PID>
	<Quantity>1</Quantity>
	<FrameOptions>
		<CroppingStyle>None</CroppingStyle>
		<MouldingID>222</MouldingID>
		<NumberOfMats>2</NumberOfMats>
		<TopMatID>101</TopMatID>
		<MiddleMatID>0</MiddleMatID>
		<BottomMatID>188</BottomMatID>
		<TopMatWidthInches>3.0</TopMatWidthInches>
		<GlazingID>2</GlazingID>
	</FrameOptions>
</OrderItem>

Note: Use 0 to indicate no mat. If this piece was not matted, 0's should be used for TopMatID, MiddleMatID and BottomMatID.

Alternatively, you can also specify the SKU. Since the SKU contains the framing options, there is no need to specify them separately:

<OrderItem>
	<SKU>R407779-Y8F9AGOGDM</SKU>
	<Quantity>1</Quantity>
</OrderItem>

Please view the following links to see sample Orders for a variety of products:
Print Order
Frame Order
Canvas Transfer Order
Framed Canvas Transfer Order
Plaque Order
Laminate Order

Validation Errors
If there is an error processing your order, ValidationErrors will be returned. The data contained in the ValidationErrors element will help you to identify the data needs to be corrected in order for you to be able to submit your order. There are two types of ValidationErrors, fatal and non fatal. If no fatal errors occur, then your order will be processed into Lieberman's order fulfillment system (see SubmitOrderOptions below).

SubmitOrderOptions
When submitting an order, it is also necessary to pass in the SubmitOrderOptions. These options are all boolean values and are defined as follows: