checkout
/checkout
The checkout API provides all the necessary functionality to implement custom checkouts with UltraCart.
/checkout
The checkout API provides all the necessary functionality to implement custom checkouts with UltraCart.
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class Introduction
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void IntroductionCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class Introduction {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
To make working with our API easier, we package an SDK in the languages listed to the right. Select the language that you are interested in and sample code with additional commentary will be available. All of our APIs are available on GitHub at:
http://www.github.com/UltraCart/
By using an SDK you receive a number of important benefits.
There are four steps to instantiating the API.
The checkout REST API has the capability to expand everything related to the cart. By default, when you read
a cart, a limited object is returned. If you specify the _expand parameter, additional properties of the cart
object are returned. We encourage you to limit the amount of information that you query for carts
to the minimal amount possible to have optimal communication. The following expansion operations are
available.
Register an affiliate click. Used by custom checkouts that are completely API based and do not perform checkout handoff.
SDK Function Name: registerAffiliateClick
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| register_affiliate_click_request | Register affiliate click request | body | RegisterAffiliateClickRequest | required |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class RegisterAffiliateClick
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void RegisterAffiliateClickCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class RegisterAffiliateClick {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Lookup the allowed countries for this merchant id
SDK Function Name: getAllowedCountries
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class GetAllowedCountries
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void GetAllowedCountriesCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class GetAllowedCountries {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Setup a browser key authenticated application with checkout permissions. This REST call must be made with an authentication scheme that is not browser key. The new application will be linked to the application that makes this call. If this application is disabled / deleted, then so will the application setup by this call. The purpose of this call is to allow an OAuth application, such as the Wordpress plugin, to setup the proper browser based authentication for the REST checkout API to use.
SDK Function Name: setupBrowserKey
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| browser_key_request | Setup browser key request | body | CheckoutSetupBrowserKeyRequest | required |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class SetupBrowserKey
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void SetupBrowserKeyCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class SetupBrowserKey {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
If the cookie is set on the browser making the request then it will return their active cart. Otherwise it will create a new cart.
SDK Function Name: getCart
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| UltraCartShoppingCartID | Cart ID passed as a cookie (primary tracking method) | cookie | string | optional |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class GetCart
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void GetCartCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class GetCart {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
<?php /** @noinspection DuplicatedCode */
require_once '../vendor/autoload.php';
require_once '../constants.php';
// this example is the same for both getCart.php and getCartByCartId.php. They work as a pair and are called
// depending on the presence of an existing cart id or not. For new carts, getCart() is used. For existing
// carts, getCartByCartId($cart_id) is used.
$checkout_api = ultracart\v2\api\CheckoutApi::usingApiKey(Constants::API_KEY);
$expansion = "items"; // for this example, we're just getting a cart to insert some items into it.
$cart_id = null;
if(isset($_COOKIE[Constants::CART_ID_COOKIE_NAME])){
$cart_id = $_COOKIE[Constants::CART_ID_COOKIE_NAME];
}
$cart = null;
if(is_null($cart_id)){
$api_response = $checkout_api->getCart($expansion);
} else {
$api_response = $checkout_api->getCartByCartId($cart_id, $expansion);
}
$cart = $api_response->getCart();
// TODO: set or re-set the cart cookie if this is part of a multi-page process. two weeks is a generous cart id time.
setcookie(Constants::CART_ID_COOKIE_NAME, $cart->getCartId(), time() + 1209600, "/");
echo '<html lang="en"><body><pre>';
var_dump($cart);
echo '</pre></body></html>';
# frozen_string_literal: true
require 'json'
require 'yaml'
require 'ultracart_api'
require_relative '../constants'
api = UltracartClient::CheckoutApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
# this example is the same for both get_cart.rb and get_cart_by_id.rb. They work as a pair and are called
# depending on the presence of an existing cart id or not. For new carts, getCart() is used. For existing
# carts, getCartByCartId(cart_id) is used.
expansion = 'items' # for this example, we're just getting a cart to insert some items into it.
# do you have the cart id from a cookie or some other server side state engine?
cart_id = nil
# run this example once to get a cart id, then you can add it here to test.
# the cart id below will not work for you.
# cart_id = 'C6A8693A3C78C6017FDA7A50EE380100'
api_response = if cart_id.nil?
api.get_cart({ '_expand': expansion })
else
api.get_cart_by_cart_id(cart_id, { '_expand': expansion })
end
cart = api_response.cart
puts cart.to_yaml
Update the cart.
SDK Function Name: updateCart
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| cart | Cart | body | Cart | required |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class UpdateCart
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void UpdateCartCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class UpdateCart {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
<?php /** @noinspection DuplicatedCode */
require_once '../vendor/autoload.php';
require_once '../constants.php';
// this example uses the getCart.php code as a starting point, because we must get a cart to update a cart.
// getCart.php code start ----------------------------------------------------------------------------
// this example is the same for both getCart.php and getCartByCartId.php. They work as a pair and are called
// depending on the presence of an existing cart id or not. For new carts, getCart() is used. For existing
// carts, getCartByCartId($cart_id) is used.
$checkout_api = ultracart\v2\api\CheckoutApi::usingApiKey(Constants::API_KEY);
$expansion = "items"; // for this example, we're just getting a cart to insert some items into it.
$cart_id = null;
if(isset($_COOKIE[Constants::CART_ID_COOKIE_NAME])){
$cart_id = $_COOKIE[Constants::CART_ID_COOKIE_NAME];
}
$cart = null;
if(is_null($cart_id)){
$api_response = $checkout_api->getCart($expansion);
} else {
$api_response = $checkout_api->getCartByCartId($cart_id, $expansion);
}
$cart = $api_response->getCart();
// getCart.php code end ----------------------------------------------------------------------------
// for this simple example, items will be added to the cart. so our expansion variable is simply 'items' above.
// Get the items array on the cart, creating it if it doesn't exist.
$items = $cart->getItems();
// If null, go ahead and initialize it to an empty array
if ($items == null) {
$items = array();
}
// Create a new item
$item = new ultracart\v2\models\CartItem();
$item->setItemId("BASEBALL"); // TODO: Adjust the item id
$item->setQuantity(1); // TODO: Adjust the quantity
// TODO: If your item has options then you need to create a new ultracart\v2\models\CartItemOption object and push it into the array.
$options = array();
$item->setOptions($options);
// Add the item to the $items array
array_push($items, $item);
// Make sure to update the $cart with the new array
$cart->setItems($items);
// Push the cart up to save the item
$cart_response = $checkout_api->updateCart($cart, $expansion);
// Extract the updated cart from the response
$cart = $cart_response->getCart();
// TODO: set or re-set the cart cookie if this is part of a multi-page process. two weeks is a generous cart id time.
setcookie(Constants::CART_ID_COOKIE_NAME, $cart->getCartId(), time() + 1209600, "/");
echo '<html lang="en"><body><pre>';
var_dump($cart);
echo '</pre></body></html>';
Finalize the cart into an order. This method can not be called with browser key authentication. It is ONLY meant for server side code to call.
SDK Function Name: finalizeOrder
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| finalize_request | Finalize request | body | CartFinalizeOrderRequest | required |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class FinalizeOrder
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void FinalizeOrderCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class FinalizeOrder {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Handoff the browser to UltraCart for view cart on StoreFront, transfer to PayPal, transfer to Affirm, transfer to Sezzle or finalization of the order (including upsell processing).
SDK Function Name: handoffCart
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| handoff_request | Handoff request | body | CheckoutHandoffRequest | required |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class HandoffCart
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void HandoffCartCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class HandoffCart {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
<?php /** @noinspection DuplicatedCode */
require_once '../vendor/autoload.php';
require_once '../constants.php';
// this example uses the getCart.php code as a starting point, because we must get a cart to handoff a cart.
// here, we are handing off the cart to the ultracart engine with an operation of 'view', meaning that we
// simply added some items to the cart and wish for UltraCart to gather the remaining customer information
// as part of a normal checkout operation.
// valid operations are: "view", "checkout", "paypal", "paypalcredit", "affirm", "sezzle"
// Besides "view", the other operations are finalizers.
// "checkout": finalize the transaction using a customer's personal credit card (traditional checkout)
// "paypal": finalize the transaction by sending the customer to PayPal
// getCart.php code start ----------------------------------------------------------------------------
// this example is the same for both getCart.php and getCartByCartId.php. They work as a pair and are called
// depending on the presence of an existing cart id or not. For new carts, getCart() is used. For existing
// carts, getCartByCartId($cart_id) is used.
$checkout_api = ultracart\v2\api\CheckoutApi::usingApiKey(Constants::API_KEY);
$expansion = "items"; // for this example, we're just getting a cart to insert some items into it.
$cart_id = null;
if(isset($_COOKIE[Constants::CART_ID_COOKIE_NAME])){
$cart_id = $_COOKIE[Constants::CART_ID_COOKIE_NAME];
}
$cart = null;
if(is_null($cart_id)){
$api_response = $checkout_api->getCart($expansion);
} else {
$api_response = $checkout_api->getCartByCartId($cart_id, $expansion);
}
$cart = $api_response->getCart();
// getCart.php code end ----------------------------------------------------------------------------
// Although the above code checks for a cookie and retrieves or creates a cart based on the cookie presence, typically
// a php script calling the handoff() method will have an existing cart, so you may wish to check for a cookie and
// redirect if there isn't one. However, it is possible that you wish to create a cart, update it, and hand it off
// to UltraCart all within one script, so we've left the conditional cart creation calls intact.
$handoff_request = new \ultracart\v2\models\CheckoutHandoffRequest();
$handoff_request->setCart($cart);
$handoff_request->setOperation("view");
$handoff_request->setErrorReturnUrl("/some/page/on/this/php/server/that/can/handle/errors/if/ultracart/encounters/an/issue/with/this/cart.php");
$handoff_request->setErrorParameterName("uc_error"); // name this whatever the script supplied in ->setErrorReturnUrl() will check for in the $_GET object.
$handoff_request->setSecureHostName("mystorefront.com"); // set to desired storefront. some merchants have multiple storefronts.
$api_response = $checkout_api->handoffCart($handoff_request, $expansion);
if(!is_null($api_response->getErrors()) && !empty($api_response->getErrors())){
// TODO: handle errors that might happen before handoff and manage those
} else {
$redirect_url = $api_response->getRedirectToUrl();
header('Location: '. $redirect_url);
}
Login in to the customer profile specified by cart.billing.email and password
SDK Function Name: login
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| login_request | Login request | body | CartProfileLoginRequest | required |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class Login
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void LoginCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class Login {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Log the cart out of the current profile. No error will occur if they are not logged in.
SDK Function Name: logout
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| cart | Cart | body | Cart | required |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class Logout
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void LogoutCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class Logout {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Register a new customer profile. Requires the cart.billing object to be populated along with the password.
SDK Function Name: register
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| register_request | Register request | body | CartProfileRegisterRequest | required |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class Register
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void RegisterCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class Register {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Validate the cart for errors. Specific checks can be passed and multiple validations can occur throughout your checkout flow.
SDK Function Name: validateCart
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| validation_request | Validation request | body | CartValidationRequest | required |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class ValidateCart
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void ValidateCartCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class ValidateCart {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Get a cart specified by the cart_id parameter.
SDK Function Name: getCartByCartId
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| cart_id | Cart ID to retrieve | path | string | required |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class GetCartByCartId
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void GetCartByCartIdCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class GetCartByCartId {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
<?php /** @noinspection DuplicatedCode */
require_once '../vendor/autoload.php';
require_once '../constants.php';
// this example is the same for both getCart.php and getCartByCartId.php. They work as a pair and are called
// depending on the presence of an existing cart id or not. For new carts, getCart() is used. For existing
// carts, getCartByCartId($cart_id) is used.
$checkout_api = ultracart\v2\api\CheckoutApi::usingApiKey(Constants::API_KEY);
$expansion = "items"; // for this example, we're just getting a cart to insert some items into it.
$cart_id = null;
if(isset($_COOKIE[Constants::CART_ID_COOKIE_NAME])){
$cart_id = $_COOKIE[Constants::CART_ID_COOKIE_NAME];
}
$cart = null;
if(is_null($cart_id)){
$api_response = $checkout_api->getCart($expansion);
} else {
$api_response = $checkout_api->getCartByCartId($cart_id, $expansion);
}
$cart = $api_response->getCart();
// TODO: set or re-set the cart cookie if this is part of a multi-page process. two weeks is a generous cart id time.
setcookie(Constants::CART_ID_COOKIE_NAME, $cart->getCartId(), time() + 1209600, "/");
echo '<html lang="en"><body><pre>';
var_dump($cart);
echo '</pre></body></html>';
# frozen_string_literal: true
require 'json'
require 'yaml'
require 'ultracart_api'
require_relative '../constants'
api = UltracartClient::CheckoutApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
# this example is the same for both get_cart.rb and get_cart_by_id.rb. They work as a pair and are called
# depending on the presence of an existing cart id or not. For new carts, getCart() is used. For existing
# carts, getCartByCartId(cart_id) is used.
expansion = 'items' # for this example, we're just getting a cart to insert some items into it.
# do you have the cart id from a cookie or some other server side state engine?
cart_id = nil
# run this example once to get a cart id, then you can add it here to test.
# the cart id below will not work for you.
# cart_id = 'C6A8693A3C78C6017FDA7A50EE380100'
api_response = if cart_id.nil?
api.get_cart({ '_expand': expansion })
else
api.get_cart_by_cart_id(cart_id, { '_expand': expansion })
end
cart = api_response.cart
puts cart.to_yaml
Get a Affirm checkout object for the specified cart_id parameter.
SDK Function Name: getAffirmCheckout
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| cart_id | Cart ID to retrieve | path | string | required |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class GetAffirmCheckout
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void GetAffirmCheckoutCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class GetAffirmCheckout {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Look up the city and state for the shipping zip code. Useful for building an auto complete for parts of the shipping address
SDK Function Name: cityState
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| cart | Cart | body | Cart | required |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class CityState
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void CityStateCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class CityState {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Retrieve all the related items for the cart contents. Expansion is limited to content, content.assignments, content.attributes, content.multimedia, content.multimedia.thumbnails, options, pricing, and pricing.tiers.
SDK Function Name: relatedItemsForItem
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| item_id | Item ID to retrieve related items for | path | string | required |
| cart | Cart | body | Cart | required |
| _expand | The object expansion to perform on the result. See item resource documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class RelatedItemsForItem
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void RelatedItemsForItemCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class RelatedItemsForItem {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Retrieve all the related items for the cart contents. Expansion is limited to content, content.assignments, content.attributes, content.multimedia, content.multimedia.thumbnails, options, pricing, and pricing.tiers.
SDK Function Name: relatedItemsForCart
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| cart | Cart | body | Cart | required |
| _expand | The object expansion to perform on the result. See item resource documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class RelatedItemsForCart
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void RelatedItemsForCartCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class RelatedItemsForCart {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Get a cart specified by the return code parameter.
SDK Function Name: getCartByReturnCode
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| return_code | Return code to lookup cart ID by | path | string | required |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class GetCartByReturnCode
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void GetCartByReturnCodeCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class GetCartByReturnCode {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Get a cart specified by the encrypted return token parameter.
SDK Function Name: getCartByReturnToken
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| return_token | Return token provided by StoreFront Communications | query | string | optional |
| _expand | The object expansion to perform on the result. See documentation for examples | query | string | optional |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class GetCartByReturnToken
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void GetCartByReturnTokenCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class GetCartByReturnToken {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
Lookup a state/province list for a given country code
SDK Function Name: getStateProvincesForCountry
| Parameter | Description | Location | Data Type | Required |
|---|---|---|---|---|
| country_code | Two letter ISO country code | path | string | required |
using System;
using com.ultracart.admin.v2.Api;
using com.ultracart.admin.v2.Model;
using NUnit.Framework;
namespace SdkSample.checkout
{
public class GetStateProvincesForCountry
{
[Test]
public void ExecuteTest()
{
//TODO-PT
}
public static void GetStateProvincesForCountryCall()
{
const string simpleKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
var api = new CheckoutApi(simpleKey);
}
}
}
package checkout;
import com.ultracart.admin.v2.CheckoutApi;
import com.ultracart.admin.v2.models.Coupon;
import com.ultracart.admin.v2.models.CouponResponse;
import com.ultracart.admin.v2.util.ApiException;
public class GetStateProvincesForCountry {
public static void main(String[] args) throws ApiException {
// Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
final String apiKey = "109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00";
CheckoutApi checkoutApi = new CheckoutApi(apiKey);
// TODO-PT
}
}
The following webhook events are generated for this resource.
| Event | Description | Response | Expansion |
|---|---|---|---|
| checkout_cart_abandon | Fired when a cart is abandoned by the customer | Cart | Yes |
| Name | Data Type | Description |
|---|---|---|
| action | string | |
| channel | string | |
| metric | string | |
| storefront_oid | integer (int32) | |
| subject | string | |
| ts | integer (int64) | |
| type | string | |
| uuid | string |
| Name | Data Type | Description |
|---|---|---|
| arbitrary_item_id | string | Arbitrary item id that should be rebilled instead of the normal schedule |
| arbitrary_percentage_discount | number | An arbitrary percentage discount to provide on future rebills |
| arbitrary_quantity | number | Arbitrary quantity to rebill |
| arbitrary_schedule_days | integer (int32) | The number of days to rebill if the frequency is set to an arbitrary number of days |
| arbitrary_unit_cost | number | Arbitrary unit cost that rebills of this item should occur at |
| arbitrary_unit_cost_remaining_orders | integer (int32) | The number of rebills to give the arbitrary unit cost on before reverting to normal pricing. |
| auto_order_item_oid | integer (int32) | Primary key of AutoOrderItem |
| calculated_next_shipment_dts | (read only) string (dateTime) | Calculated Date/time that this item is scheduled to rebill. Will be null if no more shipments are going to occur on this item |
| first_order_dts | (read only) string (dateTime) | Date/time of the first order of this item. Null if item added to auto order and has not been rebilled yet. |
| frequency | string | Frequency of the rebill if not a fixed schedule
Allowed Values
|
| future_schedules | array of AutoOrderItemFutureSchedule | The future rebill schedule for this item up to the next ten rebills |
| last_order_dts | string (dateTime) | Date/time of the last order of this item |
| life_time_value | number | The life time value of this item including the original purchase |
| next_item_id | (read only) string | Calculated next item id |
| next_preshipment_notice_dts | string (dateTime) | The date/time of when the next pre-shipment notice should be sent |
| next_shipment_dts | string (dateTime) | Date/time that this item is scheduled to rebill |
| no_order_after_dts | string (dateTime) | Date/time after which no additional rebills of this item should occur |
| number_of_rebills | integer (int32) | The number of times this item has rebilled |
| options | array of AutoOrderItemOption | Options associated with this item |
| original_item_id | string | The original item id purchased. This item controls scheduling. If you wish to modify a schedule, for example, from monthly to yearly, change this item from your monthly item to your yearly item, and then change the next_shipment_dts to your desired date. |
| original_quantity | number | The original quantity purchased |
| paused | boolean | True if paused. This field is an object instead of a primitive for backwards compatibility. |
| paypal_payer_id | string | The PayPal Payer ID tied to this item |
| paypal_recurring_payment_profile_id | string | The PayPal Profile ID tied to this item |
| preshipment_notice_sent | boolean | True if the preshipment notice associated with the next rebill has been sent |
| rebill_value | number | The value of the rebills of this item |
| remaining_repeat_count | integer (int32) | The number of rebills remaining before this item is complete |
| simple_schedule | AutoOrderItemSimpleSchedule | If the item is configured as an automatic rebill and only has a simple single step schedule then details are provided within this object |
| Name | Data Type | Description |
|---|---|---|
| item_id | string | Item ID that should rebill |
| rebill_count | integer (int32) | The number of times this rebill represents |
| shipment_dts | string (dateTime) | Date/time that this item is scheduled to rebill |
| unit_cost | number | The unit cost of the item rebilling |
| Name | Data Type | Description |
|---|---|---|
| label | string(50) | Label |
| value | string(1024) | Value |
| Name | Data Type | Description |
|---|---|---|
| frequency | (read only) string | Frequency of the rebill if not a fixed schedule
Allowed Values
|
| item_id | (read only) string | Item ID that should rebill |
| repeat_count | integer (int32) | The number of times this simple schedule is configured for |
| Name | Data Type | Description |
|---|---|---|
| device | BrowserDevice | |
| os | BrowserOS | |
| user_agent | BrowserUserAgent |
| Name | Data Type | Description |
|---|---|---|
| family | string |
| Name | Data Type | Description |
|---|---|---|
| family | string | |
| major | string | |
| minor | string | |
| patch | string | |
| patch_minor | string |
| Name | Data Type | Description |
|---|---|---|
| family | string | |
| major | string | |
| minor | string | |
| patch | string |
| Name | Data Type | Description |
|---|---|---|
| affiliate | CartAffiliate | Affiliate |
| affiliate_network_pixel_oid | (read only) integer (int32) | The affiliate network pixel identifier associated with the cart |
| base_currency_code | (read only) string(3) | The ISO-4217 three letter base currency code of the account |
| billing | CartBilling | Billing |
| buysafe | CartBuysafe | buySAFE |
| cart_id | (read only) string | Unique identifier for this cart |
| checkout | CartCheckout | Checkout |
| coupons | array of CartCoupon | Coupons |
| currency_code | string(3) | The ISO-4217 three letter currency code the customer is viewing prices in |
| currency_conversion | CartCurrencyConversion | Currency conversion information for this cart |
| customer_profile | CartCustomerProfile | Customer profile if logged in |
| exchange_rate | (read only) number | The exchange rate if the customer is viewing a different currency than the base |
| gift | CartGift | Gift |
| gift_certificate | CartGiftCertificate | Gift certificate |
| items | array of CartItem | Items |
| language_iso_code | string(3) | The ISO-631 three letter code the customer would like to checkout with |
| logged_in | boolean | True if the customer is logged into their profile |
| marketing | CartMarketing | Marketing |
| merchant_id | (read only) string | Merchant ID this cart is associated with |
| payment | CartPayment | Payment |
| properties | array of CartProperty | Properties associated with the cart |
| settings | (read only) CartSettings | Settings for options that should be available during the checkout |
| shipping | CartShipping | Shipping |
| summary | CartSummary | Summary |
| taxes | CartTaxes | Taxes |
| upsell_after | CartUpsellAfter | Upsell After |
| Name | Data Type | Description |
|---|---|---|
| affiliate_id | integer (int32) | Affiliate id associated with the cart |
| affiliate_sub_id | string(50) | Affiliate sub id associated with the cart |
| Name | Data Type | Description |
|---|---|---|
| checkout_json | string | Checkout JSON object |
| errors | array of string | Errors that should be displayed to the customer |
| Name | Data Type | Description |
|---|---|---|
| address1 | string(50) | Address line 1 |
| address2 | string(50) | Address line 2 |
| cc_emails | array of string | CC emails. Multiple allowed, but total length of all emails can not exceed 100 characters. |
| cell_phone | string(25) | Cell phone |
| cell_phone_e164 | (read only) string(25) | Cell phone (E164 format) |
| city | string(32) | City |
| company | string(50) | Company |
| country_code | string(2) | ISO-3166 two letter country code |
| day_phone | string(25) | Day phone |
| string(100) | ||
| email_confirm | string(100) | Email entered for confirmation |
| evening_phone | string(25) | Evening phone |
| first_name | string(30) | First name |
| last_name | string(30) | Last name |
| postal_code | string(20) | Postal code |
| state_region | string(32) | State for United States otherwise region or province for other countries |
| title | string(50) | Title |
| Name | Data Type | Description |
|---|---|---|
| bond_available | (read only) boolean | True if buySAFE is willing to bond the order |
| bond_cost | (read only) Currency | Cost of the bond if the customer wants to purchase it |
| bond_free | (read only) boolean | True if the bond is free (merchant paying for it) |
| bond_wanted | boolean | True if the customer wants the bond |
| cart_display_text | (read only) string | Recommend text to display to the customer |
| cart_display_url | (read only) string | URL associated with the recommended text |
| Name | Data Type | Description |
|---|---|---|
| comments | string(2000) | Comments from the customer. Rarely used on the single page checkout. |
| current_step | (read only) string | Current step of the checkout (read only) |
| custom_field1 | string(50) | Custom field 1 |
| custom_field10 | string(200) | Custom field 10 |
| custom_field2 | string(50) | Custom field 2 |
| custom_field3 | string(50) | Custom field 3 |
| custom_field4 | string(50) | Custom field 4 |
| custom_field5 | string(75) | Custom field 5 |
| custom_field6 | string(50) | Custom field 6 |
| custom_field7 | string(50) | Custom field 7 |
| custom_field8 | string(200) | Custom field 8 |
| custom_field9 | string(200) | Custom field 9 |
| ip_address | string | IP Address (read only unless non-browser key authenticated) |
| return_code | (read only) string | Return code assigned for send return email operation |
| return_url | string(2048) | The URL to redirect the customer to when they return from an abandon cart email. Must be https protocol. |
| screen_branding_theme_code | string(10) | Screen branding theme code |
| storefront_host_name | string | StoreFront Host Name |
| user_agent | string | User agent of the browser |
| Name | Data Type | Description |
|---|---|---|
| coupon_code | string | Coupon code |
| Name | Data Type | Description |
|---|---|---|
| base_currency_Code | string | Base currency code for this merchant |
| currencies | array of Currency | Conversion information for 1 unit of base currency to target currencies |
| Name | Data Type | Description |
|---|---|---|
| allow_3rd_party_billing | boolean | True if profile is allowed to bill to their 3rd party shipping account |
| allow_cod | boolean | True if this profile is allowed to use a COD |
| allow_purchase_order | boolean | True if this profile is allowed to use a purchase order |
| billing_addresses | array of CartCustomerProfileAddress | Billing addresses on file for this profile |
| credit_cards | array of CartCustomerProfileCreditCard | Credit cards on file for this profile (masked) |
| customer_profile_oid | integer (int32) | Unique identifier |
| dhl_account_number | string | DHL account number on file |
| dhl_duty_account_number | string | DHL duty account number on file |
| string | ||
| fedex_account_number | string | FedEx account number on file |
| free_shipping | boolean | True if this profile always qualifies for free shipping |
| free_shipping_minimum | number | The minimum amount that this profile has to purchase to qualify for free shipping |
| maximum_item_count | integer (int32) | Maximum item count this profile can purchase |
| minimum_item_count | integer (int32) | Minimum item count this profile must purchase |
| minimum_subtotal | number | Minimum subtotal this profile must purchase |
| no_coupons | boolean | True if this profile is prevented from using coupons |
| no_free_shipping | boolean | True if this profile is never given free shipping |
| no_realtime_charge | boolean | True if this customers orders are not charged in real-time |
| pricing_tiers | array of string | Pricing tier names this profile qualifies for |
| shipping_addresses | array of CartCustomerProfileAddress | Shipping addresses on file for this profile |
| signup_dts | (read only) string | Signup date |
| tax_exempt | boolean | True if this profile is exempt from sales tax |
| ups_account_number | string | UPS account number on file |
| Name | Data Type | Description |
|---|---|---|
| address1 | string | Address 1 |
| address2 | string | Address 2 |
| city | string | City |
| company | string | Company |
| country_code | string | ISO-3166 Country code |
| day_phone | string | Day phone |
| evening_phone | string | Evening phone |
| first_name | string | First name |
| last_name | string | Last name |
| oid | integer (int32) | Unique identifier for this address |
| postal_code | string | Postal code |
| state_region | string | State for United States otherwise region or province for other countries |
| tax_county | string | Tax county if a billing address |
| title | string | Title |
| Name | Data Type | Description |
|---|---|---|
| card_expiration_month | integer (int32) | Card expiration month (1-12) |
| card_expiration_year | integer (int32) | Card expiration year (four digit) |
| card_number | string | Card number (masked last 4 digits) |
| card_type | string | Card type
Allowed Values
|
| customer_profile_credit_card_id | integer (int32) | Unique identifier for this stored card |
| last_used_date | string (dateTime) | Last used |
| Name | Data Type | Description |
|---|---|---|
| cart | Cart | Cart |
| options | CartFinalizeOrderRequestOptions | Options that control the finalize order operation |
| Name | Data Type | Description |
|---|---|---|
| auto_approve_purchase_order | boolean | Automatically approve the purchase order |
| channel_partner_code | string | Channel partner code to associate this order with |
| channel_partner_oid | integer (int32) | Channel partner oid to associate this order with |
| channel_partner_order_id | string | If channel_partner_oid or channel_partner_code specified Channel partner order id for reference |
| consider_recurring | boolean | Consider this order a recurring order for the purposes of payment gateway recurring flag |
| credit_card_authorization_amount | number | If the order was authorized outside of UltraCart, this is the amount of the authorization |
| credit_card_authorization_date | string (dateTime) | If the order was authorized outside of UltraCart, this is the date/time of the authorization |
| credit_card_authorization_reference_number | string(60) | If the order was authorized outside of UltraCart, this is the authorization reference number |
| no_realtime_payment_processing | boolean | Prevents normal real-time processing of the payment and sends the order to Accounts Receivable |
| setup_next_cart | boolean | True if the system should create another cart automatically if the current cart was logged into a profile |
| skip_payment_processing | boolean | Skip payment processing and move the order on to shipping (or completed if no shipping required) |
| store_completed | boolean | True the order in the completed stage |
| store_if_payment_declines | boolean | Store the order in accounts receivable if the payment declines |
| Name | Data Type | Description |
|---|---|---|
| errors | array of string | Error messages if the order could not be completed |
| next_cart | Cart | Next cart if options.setup_next_cart=true and order created successfully |
| order | Order | Order generated from the cart |
| order_id | string | Order ID assigned to the order |
| successful | boolean | True if the cart was converted successfully to an order |
| Name | Data Type | Description |
|---|---|---|
| gift | boolean | True if this order is a gift |
| gift_charge | (read only) Currency | Additional charge for making this order a gift |
| gift_email | string(100) | Email address of the gift recipient |
| gift_message | string(10000) | Message to the gift recipient |
| gift_wrap_cost | (read only) Currency | Cost of the gift wrap selected |
| gift_wrap_title | string(30) | Title of the selected gift wrap |
| Name | Data Type | Description |
|---|---|---|
| gift_certificate_amount | (read only) Currency | The amount used on the gift certificate |
| gift_certificate_code | string | Gift certificate code |
| gift_certificate_remaining_balance_after_order | (read only) Currency | The amount of money left on the gift certificate after this order is completed |
| Name | Data Type | Description |
|---|---|---|
| arbitrary_unit_cost | Currency | If authentication type is not browser key Arbitrary unit cost |
| attributes | (read only) array of CartItemAttribute | Attributes |
| auto_order_schedule | string | If schedules array is populated Auto order schedule the customer selected |
| default_image_url | (read only) string | URL to the default multimedia image |
| default_thumbnail_url | (read only) string | URL to the default multimedia thumbnail |
| description | (read only) string | Description of the item |
| discount | (read only) Currency | The discount on this item provided by a coupon |
| extended_description | (read only) string | Extended description of the item |
| item_id | string | Item ID |
| item_oid | integer (int32) | Item object identifier |
| kit | (read only) boolean | True if this item is a kit |
| kit_component_options | array of CartKitComponentOption | Options associated with the kit components |
| manufacturer_suggested_retail_price | (read only) Currency | Manufacture suggested retail price |
| maximum_quantity | (read only) number | Maximum quantity the customer can purchase |
| minimum_quantity | (read only) number | Minimum quantity the customer can purchase |
| multimedia | (read only) array of CartItemMultimedia | Multimedia |
| options | array of CartItemOption | Options |
| phsyical | CartItemPhysical | Physical characteristcs |
| position | (read only) integer (int32) | Position of the item in the cart |
| preorder | (read only) boolean | True if this item is on pre-order |
| properties | array of CartItemProperty | Properties associated with the item |
| quantity | number | quantity |
| schedules | (read only) array of string | Customer selectable auto order schedules |
| total_cost | (read only) Currency | Total cost of item before discount |
| total_cost_with_discount | (read only) Currency | Total cost of this item after discount |
| unit_cost | (read only) Currency | Unit cost of the item |
| unit_cost_with_discount | (read only) Currency | Unit cost of the item after discounts |
| upsell | boolean | True if this item was added to the cart as part of an upsell |
| variations | array of CartItemVariationSelection | Variations |
| view_url | (read only) string | URL to view the product on the site |
| Name | Data Type | Description |
|---|---|---|
| name | string | Name of the attribute |
| type | string | Type of attribute
Allowed Values
|
| value | string | Value of the attribute |
| Name | Data Type | Description |
|---|---|---|
| code | string | Code assigned to the multimedia |
| description | string | Description |
| exclude_from_gallery | boolean | True if the image should be excluded from galleries |
| image_height | integer (int32) | If type = Image Image height |
| image_width | integer (int32) | If type = Image Image width |
| is_default | boolean | True if the multimedia is the default for this type |
| thumbnails | array of CartItemMultimediaThumbnail | Thumbnails of the images |
| type | string | Type of multimedia
Allowed Values
|
| url | string | URL to view multimedia at |
| Name | Data Type | Description |
|---|---|---|
| height | integer (int32) | Height in pixels |
| png | boolean | True if thumbnail is a PNG, otherwise its a JPEG |
| square | boolean | True if the thumbnail is square |
| url | string | URL for the thumbnail |
| width | integer (int32) | Width in pixels |
| Name | Data Type | Description |
|---|---|---|
| cost_if_specified | (read only) Currency | Cost if the option is specified |
| cost_per_letter | (read only) Currency | Cost per letter of text (single or multiline options) |
| cost_per_line | (read only) Currency | Cost per line of text (multiline options) |
| ignore_if_default | (read only) boolean | True if the default answer is ignored |
| label | (read only) string | Display label for the option |
| name | (read only) string | Name of the option |
| one_time_fee | (read only) boolean | Charge the fee a single time instead of multiplying by the quantity |
| option_oid | (read only) integer (int32) | Unique identifier for the option |
| required | (read only) boolean | True if the customer is required to select a value |
| selected_value | string(1024) | The value of the option specified by the customer |
| type | (read only) string | Type of option
Allowed Values
|
| values | (read only) array of CartItemOptionValue | Values that the customer can select from for radio or select type options |
| Name | Data Type | Description |
|---|---|---|
| additional_cost | Currency | Additional cost of the item if this option value is selected |
| additional_weight | Weight | Additional weight of the item if this option is selected |
| default_value | boolean | True if this is the default value |
| display_order | integer (int32) | Display order of the option value |
| value | string | Value of the option the customer can select |
| Name | Data Type | Description |
|---|---|---|
| height | (read only) Distance | Height |
| length | (read only) Distance | Length |
| weight | (read only) Weight | Weight |
| width | (read only) Distance | Width |
| Name | Data Type | Description |
|---|---|---|
| display | boolean | True if this property is displayed to the customer |
| expiration_dts | string (dateTime) | The date/time that the property expires and is deleted |
| name | string(100) | Name |
| value | string(3800) | Value |
| Name | Data Type | Description |
|---|---|---|
| variation_name | string | Variation name |
| variation_value | string | Variation value |
| Name | Data Type | Description |
|---|---|---|
| cost_if_specified | (read only) Currency | Cost if the option is specified |
| cost_per_letter | (read only) Currency | Cost per letter of text (single or multi-line options) |
| cost_per_line | (read only) Currency | Cost per line of text (multiline options) |
| ignore_if_default | (read only) boolean | True if the default answer is ignored |
| item_id | (read only) string | Kit component item id |
| item_oid | (read only) integer (int32) | Unique identifier for the kit component item |
| label | (read only) string | Display label for the option |
| name | (read only) string | Name of the option |
| one_time_fee | (read only) boolean | Charge the fee a single time instead of multiplying by the quantity |
| option_oid | (read only) integer (int32) | Unique identifier for the option |
| required | (read only) boolean | True if the customer is required to select a value |
| selected_value | string(1024) | The value of the option specified by the customer |
| type | (read only) string | Type of option
Allowed Values
|
| values | (read only) array of CartItemOptionValue | Values that the customer can select from for radio or select type options |
| Name | Data Type | Description |
|---|---|---|
| advertising_source | string | The advertising source the customer indicated |
| cell_phone_opt_in | boolean | True if the customer agrees to receiving marketing SMS messages |
| mailing_list_opt_in | boolean | True if the customer agrees to receiving marketing emails |
| Name | Data Type | Description |
|---|---|---|
| affirm | CartPaymentAffirm | If payment_method = Affirm Affirm |
| amazon | CartPaymentAmazon | If payment_method = Amazon Amazon |
| check | CartPaymentCheck | If payment_method = Check Check |
| credit_card | CartPaymentCreditCard | If payment_method = Credit Card Credit card |
| health_benefit_card | CartPaymentHealthBenefitCard | Health benefit card |
| payment_method | string | Payment method
Allowed Values
|
| purchase_order | CartPaymentPurchaseOrder | If payment_method = Purchase Order Purchase order |
| rtg_code | string | Rotating transaction gateway code |
| Name | Data Type | Description |
|---|---|---|
| affirm_checkout_token | string | Affirm checkout token |
| Name | Data Type | Description |
|---|---|---|
| amazon_order_reference_id | string | Amazon order reference id |
| Name | Data Type | Description |
|---|---|---|
| check_number | integer (int32) | Check number they are paying with |
| Name | Data Type | Description |
|---|---|---|
| card_expiration_month | integer (int32) | Card expiration month (1-12) |
| card_expiration_year | integer (int32) | Card expiration year (four digit year) |
| card_number | string | Card number (masked to the last 4) |
| card_number_token | string | Hosted field token for the card number |
| card_type | string | Card type |
| card_verification_number | string | Card verification number (masked) |
| card_verification_number_token | string | Hosted field token for the card verification number |
| customer_profile_credit_card_id | integer (int32) | ID of the stored credit card to use |
| store_credit_card | boolean | True if the customer wants to store the card on their profile for future re-use |
| Name | Data Type | Description |
|---|---|---|
| health_benefit_card_expiration_month | integer (int32) | Health benefit expiration month (1-12) |
| health_benefit_card_expiration_year | integer (int32) | Health benefit card expiration year (four digit year) |
| health_benefit_card_number | string | Health benefit card number (masked to the last 4) |
| health_benefit_card_number_token | string | Hosted field token for the card number |
| health_benefit_card_verification_number | string | Health benefit card verification number (masked) |
| health_benefit_card_verification_number_token | string | Hosted field token for the health benefit card verification number |
| Name | Data Type | Description |
|---|---|---|
| purchase_order_number | string | Purchase order number |
| Name | Data Type | Description |
|---|---|---|
| cart | Cart | Cart |
| customer_profile_oid | integer (int32) | Unique identifier for customer profile. Can not be used with browser key authentication type. |
| password | string | Password for the profile |
| Name | Data Type | Description |
|---|---|---|
| cart | Cart | Cart |
| errors | array of string | Errors to display to the customer if they failed any of the validations checked |
| Name | Data Type | Description |
|---|---|---|
| cart | Cart | Cart |
| password | string | Password for the profile |
| Name | Data Type | Description |
|---|---|---|
| cart | Cart | Cart |
| errors | array of string | Errors to display to the customer if they failed any of the validations checked |
| Name | Data Type | Description |
|---|---|---|
| display | boolean | True if this property is displayed to the customer |
| expiration_dts | string (dateTime) | The date/time that the property expires and is deleted |
| name | string(100) | Name |
| value | string(3800) | Value |
| Name | Data Type | Description |
|---|---|---|
| cart | Cart | Cart |
| errors | array of string | Errors that should be displayed to the customer |
| Name | Data Type | Description |
|---|---|---|
| billing | CartSettingsBilling | Billing settings for this cart |
| gift | CartSettingsGift | Gift giving settings |
| payment | CartSettingsPayment | Payment settings for this cart |
| shipping | CartSettingsShipping | Shipping settings for this cart |
| taxes | CartSettingsTaxes | Information on taxes for this cart |
| terms | CartSettingsTerms | Terms of the checkout the customer must agree to |
| Name | Data Type | Description |
|---|---|---|
| provinces | array of CartSettingsProvince | If _expand=settings.billing.provinces specified Provinces |
| Name | Data Type | Description |
|---|---|---|
| allow_gifts | boolean | True if this checkout supports gift giving |
| gift_charge | Currency | The cost associated with sending a gift |
| gift_wraps | array of CartSettingsGiftWrap | The gift wraps available for the customer to select from |
| max_message_length | integer (int32) | The maximum length of the gift message the giver can enter |
| Name | Data Type | Description |
|---|---|---|
| cost | Currency | Cost if this gift wrap is selected |
| title | string | Title of the gift wrap |
| url | string | URL for the sample of the gift wrap |
| Name | Data Type | Description |
|---|---|---|
| amazon | CartSettingsPaymentAmazon | If supports_amazon = true Amazon Payments information |
| credit_card | CartSettingsPaymentCreditCard | If supports_credit_card = true Credit card payment information |
| need_payment | boolean | True if this card requires a payment from the customer |
| paypal | CartSettingsPaymentPayPal | If supports_paypal = true PayPal information |
| supports_amazon | boolean | True if Amazon payments are available on this order |
| supports_check | boolean | True if check payments are available on this order |
| supports_cod | boolean | True if COD payments are available on this order |
| supports_credit_card | boolean | True if credit card payments are available on this order |
| supports_money_order | boolean | True if money order payments are available on this order |
| supports_paypal | boolean | True if PayPal payments are available on this order |
| supports_purchase_order | boolean | True if purchase order payments are available on this order |
| supports_quote_request | boolean | True if quote requests payments are available on this order |
| supports_wire_transfer | boolean | True if wire transfer payments are available on this order |
| Name | Data Type | Description |
|---|---|---|
| amazon_button_url | string | Amazon button URL |
| amazon_merchant_id | string | Amazon merchant ID |
| amazon_widget_url | string | Amazon widget URL |
| Name | Data Type | Description |
|---|---|---|
| collect_credit_card_verification_number | boolean | True if the credit card verification number should be collected |
| collect_credit_card_verification_number_minimum | number | If this field is null or the total is greater than or equal to this value then collect the CVV2. |
| credit_card_types | array of string | Available credit card types
Allowed Values
|
| hosted_fields_shopping_cart_token | string | The shoppingCartToken needed for proper initialization of hosted fields collection |
| Name | Data Type | Description |
|---|---|---|
| paypal_button_alt_text | string | PayPal button alt text |
| paypal_button_url | string | PayPal button URL |
| paypal_credit_button_url | string | PayPal Credit button URL |
| paypal_credit_legal_image_url | string | PayPal Credit legal image URL |
| paypal_credit_legal_url | string | PayPal Credit legal URL |
| Name | Data Type | Description |
|---|---|---|
| code | string | |
| province | string |
| Name | Data Type | Description |
|---|---|---|
| deliver_on_date | CartSettingsShippingCalendar | If _expand=settings.shipping.deliver_on_date specified Deliver on date calendar information |
| estimates | array of CartSettingsShippingEstimate | If _expand=settings.shipping.estimates specified Estimates for this cart |
| need_shipping | boolean | True if this order needs shipping |
| provinces | array of CartSettingsProvince | If _expand=settings.shipping.provinces specified Provinces |
| ship_on_date | CartSettingsShippingCalendar | If _expand=settings.shipping.ship_on_date specified Ship on date calendar information |
| Name | Data Type | Description |
|---|---|---|
| blackouts | array of string | Specified dates that are blacked out on the calendar in ISO8601 format |
| days_of_week | array of boolean | Days of week that should be enabled on the calendar (0 - Sunday through 6 - Saturday) |
| earliest | string | The earliest date that can be selected on the calendar |
| require | boolean | True if the customer is required to select a date |
| show | boolean | True if this calendar should be shown to the customer |
| Name | Data Type | Description |
|---|---|---|
| allow_3rd_party_billing | boolean | True if this method allows the customer to use their own shipper account number |
| comment | string | Comment to display to the customer about this method |
| cost | Currency | Cost of this method |
| cost_before_discount | Currency | Cost before discount by coupon |
| default_method | boolean | True if this is the default method |
| discount | Currency | Amount discounted by a coupon |
| discounted | boolean | True if this method is discounted because of a coupon |
| display_name | string | The name to display to the customer |
| estimated_delivery | string | Date of the estimated delivery (or range) |
| lift_gate_option | boolean | True if a lift gate option for this method should be offered to the customer |
| name | string | Shipping method name |
| pickup | boolean | True if this shipping method requires customers to physically pickup product themselves |
| tax | Currency | Tax applied to this method if selected |
| total_tax | Currency | Total amount of tax on the order if this method is selected |
| Name | Data Type | Description |
|---|---|---|
| counties | array of string |
| Name | Data Type | Description |
|---|---|---|
| html | string | HTML version of the terms |
| text | string | Text version of the terms. |
| Name | Data Type | Description |
|---|---|---|
| address1 | string(50) | Address line 1 |
| address2 | string(50) | Address line 2 |
| city | string(32) | City |
| company | string(50) | Company |
| country_code | string(2) | ISO-3166 two letter country code |
| day_phone | string(25) | Day time phone |
| delivery_date | string (dateTime) | Date the customer is requesting delivery on. Typically used for perishable product delivery. |
| evening_phone | string(25) | Evening phone |
| first_name | string(30) | First name |
| last_name | string(30) | Last name |
| lift_gate | boolean | Lift gate requested (LTL shipping methods only) |
| postal_code | string(25) | Postal code |
| ship_on_date | string (dateTime) | Date the customer is requesting that the order ship on. Typically used for perishable product delivery. |
| ship_to_residential | boolean | True if the shipping adress is residential. Effects the methods that are available to the customer as well as the price of the shipping method. |
| shipping_3rd_party_account_number | string(20) | 3rd party account number to ship against for UPS or FedEx |
| shipping_method | string(40) | Shipping method |
| special_instructions | string(10000) | Special instructions from the customer regarding shipping |
| state_region | string(32) | State/Region |
| title | string(50) | Title |
| Name | Data Type | Description |
|---|---|---|
| arbitrary_shipping_handling_total | Currency | If Overwrites the shipping and handling total normally calculated by UltraCart. Usable only if API authentication is not browser key. Arbitrary shipping/handling total |
| arbitrary_tax | Currency | If Overwrites the calculated tax determined by UltraCart. Usable only if API authentication is not browser key. Arbitrary tax |
| arbitrary_tax_rate | Currency | If Overwrites the tax rate normally calculated by UltraCart. Usable only if API authentication is not browser key. Arbitrary tax rate |
| arbitrary_taxable_subtotal | Currency | If Overwrites the taxable subtotal normally calculated by UltraCart. Usable only if API authentication is not browser key. Arbitrary taxable subtotal |
| health_benefit_card_amount | (read only) Currency | Health benefit card amount used |
| health_benefit_card_balance | (read only) Currency | Health benefit card balance |
| health_benefit_card_requirements | (read only) string | Health benefit card requirements |
| internal_gift_certificate_amount | (read only) Currency | Internal gift certificate amount used (store credit) |
| shipping_handling | Currency | Shipping/handling |
| shipping_handling_discount | Currency | Shipping/handling discount |
| shipping_handling_with_discount | Currency | Shipping/handling with discount |
| subtotal | (read only) Currency | Subtotal |
| subtotal_discount | (read only) Currency | Subtotal discount |
| subtotal_with_discount | (read only) Currency | Subtotal with discount |
| surcharge | (read only) Currency | Surcharge associated with the payment method |
| tax | (read only) Currency | Tax |
| taxable_subtotal | (read only) Currency | Taxable subtotal |
| taxable_subtotal_discount | (read only) Currency | Taxable subttotal discount |
| taxable_subtotal_with_discount | (read only) Currency | Taxable subtotal with discount |
| total | (read only) Currency | Total |
| Name | Data Type | Description |
|---|---|---|
| county | string(32) | Tax county if the state requires it. |
| exempt | (read only) boolean | True if tax exempt |
| rate | (read only) number | Tax rate |
| Name | Data Type | Description |
|---|---|---|
| finalize_after_dts | string (dateTime) | The date/time after which the cart will finalize into an order. |
| finalize_after_minutes | integer (int32) | The amount of inactivity in minutes after which the cart should be finalized into an order. This will calculate the finalize_after_dts field. |
| upsell_path_code | string(5) | Upsell path code |
| Name | Data Type | Description |
|---|---|---|
| cart | Cart | Cart |
| checks | array of string | Checks to perform
Allowed Values
|
| Name | Data Type | Description |
|---|---|---|
| cart | Cart | Cart |
| errors | array of string | Errors to display to the customer if they failed any of the validations checked |
| Name | Data Type | Description |
|---|---|---|
| cart | Cart | Cart |
| error_parameter_name | string | If any error happen during the processing on the UltraCart side, the browser will be redirected to your error_return_url with the error passed in this parameter name. |
| error_return_url | string | The URL to return the browser to if there are processing errors on the UltraCart side. |
| operation | string | The type of handoff operation to perform
Allowed Values
|
| paypal_maximum_upsell_revenue | number | If operation=payPal or payPalCredit The maximum amount of revenue that you think the customer could add during a custom upsell after sequence on your checkout. |
| paypal_return_url | string | If operation=payPal or payPalCredit The URl to return the customers browser to after they have completed the PayPal process. |
| secure_host_name | string | The desired secure host name to perform the handoff on. This should match the desired StoreFront. |
| ucacid | string | The UltraCart Analytics cookie value. Populate this if you're handing off from a different domain than the checkout. |
| Name | Data Type | Description |
|---|---|---|
| cart | Cart | Cart |
| errors | array of string | Errors that occurred which are preventing the handoff operation. Display these to the customer. |
| redirect_to_url | string | The URL that you should redirect the customers browser to |
| Name | Data Type | Description |
|---|---|---|
| allowed_referrers | array of string | Allowed referrers. If URLs are specified, automatic translation will convert them to proper allowed referrer maskes. |
| Name | Data Type | Description |
|---|---|---|
| browser_key | string | Browser key that is used to authenticate against the new linked application. |
| Name | Data Type | Description |
|---|---|---|
| stateProvinces | array of StateProvince |
| Name | Data Type | Description |
|---|---|---|
| city | string | |
| error | string | |
| state | string | |
| validZip | boolean | |
| zip | string |
| Name | Data Type | Description |
|---|---|---|
| iso_2_code | string(2) | iso_2_code |
| name | string(50) | name |
| Name | Data Type | Description |
|---|---|---|
| currency_code | string | Currency code of the localized value |
| exchange_rate | number | Exchange rate used to localize |
| localized | number | Value localized to the customer |
| localized_formatted | string | Value localized and formatted for the customer |
| value | number | Value in base currency |
| Name | Data Type | Description |
|---|---|---|
| activity | CustomerActivity | activity by this customer |
| affiliate_oid | integer (int32) | Affiliate oid |
| allow_3rd_party_billing | boolean | Allow 3rd party billing |
| allow_cod | boolean | Allow COD |
| allow_drop_shipping | boolean | Allow Drop Shipping |
| allow_purchase_order | boolean | Allow purchase orders by this customer |
| allow_quote_request | boolean | Allow quote request |
| allow_selection_of_address_type | boolean | Allow selection of residential or business address type |
| attachments | array of CustomerAttachment | Attachments |
| auto_approve_cod | boolean | Auto approve COD |
| auto_approve_purchase_order | boolean | Auto approve purchase orders by this customer |
| automatic_merchant_notes | string | Automatic merchant notes are added to every order placed |
| billing | array of CustomerBilling | Billing addresses for this customer |
| business_notes | string(2000) | Business notes (internally visible only) |
| cards | array of CustomerCard | Credit Cards for this customer |
| cc_emails | array of CustomerEmail | Additional emails to CC notification |
| customer_profile_oid | (read only) integer (int32) | Customer profile object identifier |
| dhl_account_number | string(20) | DHL account number |
| dhl_duty_account_number | string(20) | DHL duty account number |
| do_not_send_mail | boolean | Do not send mail (null will not update) |
| edi | CustomerEDI | EDI settings |
| string | Email address of this customer profile | |
| exempt_shipping_handling_charge | boolean | Exempt shipping handling charge |
| fedex_account_number | string(20) | FedEx account number |
| free_shipping | boolean | This customer always receives free shipping |
| free_shipping_minimum | number | If free_shipping is true, this is the minimum subtotal required for free shipping |
| last_modified_by | (read only) string(100) | Last modified by |
| last_modified_dts | (read only) string (dateTime) | Last modified date |
| loyalty | CustomerLoyalty | Loyalty |
| maximum_item_count | integer (int32) | Maximum item count |
| merchant_id | (read only) string | Merchant ID |
| minimum_item_count | integer (int32) | Minimum item count |
| minimum_subtotal | number | Minimum subtotal |
| no_coupons | boolean | No coupons |
| no_free_shipping | boolean | No free shipping regardless of coupons or item level settings |
| no_realtime_charge | boolean | No realtime charge |
| orders | array of Order | Orders associated with this customer profile |
| orders_summary | CustomerOrdersSummary | Summary of orders placed by this customer profile |
| password | string(30) | Password (may only be set, never read) |
| pricing_tiers | array of CustomerPricingTier | Pricing tiers for this customer |
| privacy | CustomerPrivacy | Privacy settings of the customer profile |
| properties | array of CustomerProperty | Properties for this customer |
| qb_class | string | QuickBooks class to import this customer as |
| qb_code | string | QuickBooks name to import this customer as |
| qb_tax_exemption_reason_code | integer (int32) | QuickBooks tax exemption reason code |
| quotes | array of Order | Quotes associated with this customer profile |
| quotes_summary | CustomerQuotesSummary | Summary of the quotes submitted by this customer profile |
| referral_source | string(50) | Referral Source |
| reviewer | CustomerReviewer | Item reviewer information |
| sales_rep_code | string(10) | Sales rep code |
| send_signup_notification | boolean | Send signup notification, if true during customer creation, will send a notification. |
| shipping | array of CustomerShipping | Shipping addresses for this customer |
| signup_dts | (read only) string | Signup date |
| software_entitlements | array of CustomerSoftwareEntitlement | Software entitlements owned by this customer |
| suppress_buysafe | boolean | Suppress buySAFE (deprecated) |
| tags | array of CustomerTag | Tags for this customer |
| tax_codes | CustomerTaxCodes | Tax codes used by tax integrations |
| tax_exempt | boolean | True if the customer is tax exempt |
| tax_id | string(15) | Tax ID |
| terms | string | Terms for this customer |
| track_separately | boolean | True if the customer should be tracked separately in QuickBooks |
| unapproved | boolean | Unapproved |
| ups_account_number | string(20) | UPS account number |
| website_url | string(100) | Website url |
| Name | Data Type | Description |
|---|---|---|
| activities | array of Activity | |
| global_unsubscribed | boolean | |
| global_unsubscribed_dts | string | |
| memberships | array of ListSegmentMembership | |
| metrics | array of Metric | |
| properties_list | array of Property | |
| spam_complaint | boolean | |
| spam_complaint_dts | string |
| Name | Data Type | Description |
|---|---|---|
| customer_profile_attachment_oid | (read only) integer (int32) | Attachment identifier |
| description | string | Description |
| file_name | (read only) string | File name |
| mime_type | (read only) string | Mime typoe |
| upload_dts | (read only) string (dateTime) | Upload date/time |
| Name | Data Type | Description |
|---|---|---|
| address1 | string(50) | Address line 1 |
| address2 | string(50) | Address line 2 |
| city | string(32) | City |
| company | string(50) | Company |
| country_code | string(2) | ISO-3166 two letter country code |
| customer_billing_oid | (read only) integer (int32) | Customer profile billing object identifier |
| customer_profile_oid | (read only) integer (int32) | Customer profile object identifier |
| day_phone | string(25) | Day phone |
| default_billing | boolean | Default billing |
| evening_phone | string(25) | Evening phone |
| first_name | string(30) | First name |
| last_name | string(30) | Last name |
| last_used_dts | string (dateTime) | Last used date |
| postal_code | string(20) | Postal code |
| state_region | string(32) | State for United States otherwise region or province for other countries |
| tax_county | string(32) | Tax County |
| title | string(50) | Title |
| Name | Data Type | Description |
|---|---|---|
| card_expiration_month | integer (int32) | Card expiration month (1-12) |
| card_expiration_year | integer (int32) | Card expiration year (four digit year) |
| card_number | string | Card number (masked to the last 4) |
| card_number_token | string | Hosted field token for the card number |
| card_type | string | Card type |
| customer_profile_credit_card_id | integer (int32) | ID of the stored credit card to use |
| customer_profile_oid | (read only) integer (int32) | Customer profile object identifier |
| last_used_dts | string (dateTime) | Last used date |
| Name | Data Type | Description |
|---|---|---|
| channel_partner_oid | integer (int32) | EDI channel partner this customer profile is associated with |
| distribution_center_number | string | The EDI distribution center number associated with this customer profile. |
| store_number | string | The EDI store number associated with this customer profile. |
| Name | Data Type | Description |
|---|---|---|
| customer_profile_email_oid | integer (int32) | ID of the email |
| string(100) | ||
| label | string(100) | Label |
| receipt_notification | boolean | CC this email on receipt notifications |
| refund_notification | boolean | CC this email on refund notifications |
| shipment_notification | boolean | CC this email on shipment notifications |
| Name | Data Type | Description |
|---|---|---|
| current_points | (read only) integer (int32) | Current points |
| internal_gift_certificate | GiftCertificate | The internal gift certificate that is used to manage cashback points under the hood |
| internal_gift_certificate_balance | (read only) string | Loyalty Cashback / Store credit balance (internal gift certificate balance) |
| internal_gift_certificate_oid | (read only) integer (int32) | Internal gift certificate oid used to tracking loyalty cashback / store credit. |
| ledger_entries | (read only) array of CustomerLoyaltyLedger | Ledger entries |
| pending_points | (read only) integer (int32) | Pending Points |
| redemptions | (read only) array of CustomerLoyaltyRedemption | Redemptions |
| Name | Data Type | Description |
|---|---|---|
| created_by | (read only) string | Created By |
| created_dts | (read only) string (dateTime) | Created date |
| description | (read only) string | Description |
| (read only) string | ||
| item_id | (read only) string | Item Id |
| item_index | (read only) integer (int32) | Item Index |
| ledger_dts | (read only) string (dateTime) | Ledger date |
| loyalty_campaign_oid | (read only) integer (int32) | Loyalty campaign oid |
| loyalty_ledger_oid | (read only) integer (int32) | Loyalty ledger oid |
| loyalty_points | (read only) integer (int32) | Loyalty points |
| modified_by | (read only) string | Modified By |
| modified_dts | (read only) string (dateTime) | Modified date |
| order_id | (read only) string | Order Id |
| quantity | (read only) integer (int32) | Quantity |
| vesting_dts | (read only) string (dateTime) | Vesting date |
| Name | Data Type | Description |
|---|---|---|
| coupon_code | (read only) string | Coupon code |
| coupon_code_oid | (read only) integer (int32) | Coupon code OID |
| coupon_used | (read only) boolean | Coupon used |
| description_for_customer | (read only) string | Description for customer |
| expiration_dts | (read only) string (dateTime) | Expiration date |
| gift_certificate_code | (read only) string | Gift certificate code |
| gift_certificate_oid | (read only) integer (int32) | Gift certificate oid |
| loyalty_ledger_oid | (read only) integer (int32) | Loyalty ledger OID |
| loyalty_points | (read only) integer (int32) | Loyalty points |
| loyalty_redemption_oid | (read only) integer (int32) | Loyalty redemption OID |
| order_id | (read only) string | Order id |
| redemption_dts | (read only) string (dateTime) | Redemption date |
| remaining_balance | (read only) number | Remaining balance |
| Name | Data Type | Description |
|---|---|---|
| first_order_dts | (read only) string (dateTime) | First order date |
| last_order_dts | (read only) string (dateTime) | Last order date |
| order_count | integer (int32) | Total number of orders |
| total | number | Total amount associated with the orders |
| Name | Data Type | Description |
|---|---|---|
| name | string(50) | Name |
| pricing_tier_oid | integer (int32) | Pricing Tier Oid |
| Name | Data Type | Description |
|---|---|---|
| last_update_dts | (read only) string (dateTime) | Last update date |
| marketing | (read only) boolean | The customer has opted in to marketing |
| preference | (read only) boolean | The customer has opted in to preference tracking |
| statistics | (read only) boolean | The customer has opted in to statistics collection |
| Name | Data Type | Description |
|---|---|---|
| customer_profile_property_oid | integer (int32) | Customer profile property oid |
| expiration_dts | string (dateTime) | The date/time that the property expires and is deleted |
| name | string(100) | Name |
| value | string(1500) | Value |
| Name | Data Type | Description |
|---|---|---|
| first_quote_dts | (read only) string (dateTime) | First quote date |
| last_quote_dts | (read only) string (dateTime) | Last quote date |
| quote_count | integer (int32) | Total number of quote |
| total | number | Total amount associated with the quotes |
| Name | Data Type | Description |
|---|---|---|
| auto_approve | boolean | True if reviewes from this customer profile should automatically be approved |
| average_overall_rating | (read only) number | Average overall rating of items reviewed |
| expert | boolean | True if the customer is an expert |
| first_review | (read only) string (dateTime) | First review |
| last_review | (read only) string (dateTime) | Last review |
| location | string | Location of the reviewer |
| nickname | string | Nickname of the reviewer |
| number_helpful_review_votes | (read only) integer (int32) | Number of helpful review votes |
| rank | (read only) integer (int32) | Rank of this reviewer |
| reviews_contributed | (read only) integer (int32) | Number of reviews contributed |
| Name | Data Type | Description |
|---|---|---|
| address1 | string(50) | Address line 1 |
| address2 | string(50) | Address line 2 |
| city | string(32) | City |
| company | string(50) | Company |
| country_code | string(2) | ISO-3166 two letter country code |
| customer_profile_oid | (read only) integer (int32) | Customer profile object identifier |
| customer_shipping_oid | (read only) integer (int32) | Customer profile shipping object identifier |
| day_phone | string(25) | Day phone |
| default_shipping | boolean | Default shipping |
| evening_phone | string(25) | Evening phone |
| first_name | string(30) | First name |
| last_name | string(30) | Last name |
| last_used_dts | string (dateTime) | Last used date |
| postal_code | string(20) | Postal code |
| state_region | string(32) | State for United States otherwise region or province for other countries |
| tax_county | string(32) | Tax County |
| title | string(50) | Title |
| Name | Data Type | Description |
|---|---|---|
| activation_code | string(50) | Activation Code Associated with the software |
| activation_dts | string (dateTime) | Date/time when the activation code was created |
| customer_software_entitlement_oid | (read only) integer (int32) | Customer profile software entitlement object identifier |
| expiration_dts | string (dateTime) | Date/time when the activation code will expire |
| purchased_via_item_description | (read only) string(512) | Item description used to purchase this software. |
| purchased_via_item_id | (read only) string(20) | Item ID used to purchase this software. |
| purchased_via_order_id | (read only) string(30) | Order ID used to purchase this software. |
| software_sku | string(30) | SKU of the software |
| Name | Data Type | Description |
|---|---|---|
| tag_value | string(250) | Tag Value |
| Name | Data Type | Description |
|---|---|---|
| avalara_customer_code | string | Avalara customer code |
| avalara_entity_use_code | string | Avalara entity use code |
| sovos_customer_code | string | Sovos customer code |
| taxjar_customer_id | string | TaxJar customer id |
| taxjar_exemption_type | string | TaxJar exemption type |
| Name | Data Type | Description |
|---|---|---|
| uom | string | Unit of measure
Allowed Values
|
| value | number | The distance measured in UOM |
| Name | Data Type | Description |
|---|---|---|
| developer_message | string | A technical message meant to be read by a developer |
| error_code | string | HTTP status code |
| more_info | string | Additional information often a link to additional documentation |
| object_id | string | Object id that the error is associated with |
| user_message | string | An end-user friendly message suitable for display to the customer |
| Name | Data Type | Description |
|---|---|---|
| error | Error | Error object if unsuccessful |
| metadata | ResponseMetadata | Meta-data about the response such as payload or paging information |
| success | boolean | Indicates if API call was successful |
| warning | Warning | Warning object if a non-fatal issue or side-effect occurs |
| Name | Data Type | Description |
|---|---|---|
| activated | boolean | True if this gift certificate is activated and ready to apply to purchases. |
| code | (read only) string | The code used by the customer to purchase against this gift certificate. |
| customer_profile_oid | (read only) integer (int32) | This is the customer profile oid associated with this internally managed gift certificate. |
| deleted | boolean | True if this gift certificate was deleted. |
| string(100) | Email of the customer associated with this gift certificate. | |
| expiration_dts | string (dateTime) | Expiration date time. |
| gift_certificate_oid | (read only) integer (int32) | Gift certificate oid. |
| internal | (read only) boolean | This is an internally managed gift certificate associated with the loyalty cash rewards program. |
| ledger_entries | (read only) array of GiftCertificateLedgerEntry | A list of all ledger activity for this gift certificate. |
| merchant_id | string | Merchant Id |
| merchant_note | string | A list of all ledger activity for this gift certificate. |
| original_balance | (read only) number | Original balance of the gift certificate. |
| reference_order_id | (read only) string | The order used to purchase this gift certificate. This value is ONLY set during checkout when a certificate is purchased, not when it is used. Any usage is recorded in the ledger |
| remaining_balance | (read only) number | The remaining balance on the gift certificate. This is never set directly, but calculated from the ledger. To change the remaining balance, add a ledger entry. |
| Name | Data Type | Description |
|---|---|---|
| amount | number | The amount of the activity. |
| description | string(50) | Description of what this ledger entry is used. |
| entry_dts | string (dateTime) | Date time of this ledger activity. |
| gift_certificate_ledger_oid | integer (int32) | Gift certificate ledger oid is a primary key for this object, used internally. |
| gift_certificate_oid | integer (int32) | Gift certificate oid. |
| reference_order_id | string | The order id if this gift certificate was used as part of the payment. |
| Name | Data Type | Description |
|---|---|---|
| accounting | ItemAccounting | Accounting such as QuickBooks codes |
| amember | ItemAmember | Amember configuration |
| auto_order | ItemAutoOrder | Auto Order |
| ccbill | ItemCCBill | CCBill.com (Deprecated) |
| channel_partner_item_mappings | array of ItemChannelPartnerMapping | Channel Partner Item Mapping |
| chargeback | ItemChargeback | Chargeback (deprecated) |
| checkout | ItemCheckout | Checkout |
| content | ItemContent | Content such as multimedia and attributes |
| creation_dts | (read only) string (dateTime) | Date/time of creation |
| description | string(512) | Description of the item up to 500 characters. |
| description_translated_text_instance_oid | (read only) integer (int32) | Description translated text instance id |
| digital_delivery | ItemDigitalDelivery | Digital Delivery |
| ebay | ItemEbay | e-Bay |
| email_notifications | ItemEmailNotifications | Email notifications |
| enrollment123 | ItemEnrollment123 | Enrollment123.com |
| fulfillment_addons | array of ItemFulfillmentAddon | Fulfillment Add-ons |
| gift_certificate | ItemGiftCertificate | Gift Certificate |
| google_product_search | ItemGoogleProductSearch | Google Product Search |
| identifiers | ItemIdentifiers | Identifiers such as SKU, Barcode, etc. |
| inactive | boolean | True if this item is inactive and can not be purchased |
| instant_payment_notifications | ItemInstantPaymentNotifications | Instance Payment Notifications |
| internal | ItemInternal | Internal information such as memo |
| kit | boolean | True if this item is a kit |
| kit_component_only | boolean | True if this item can only be usd as a kit component |
| kit_definition | ItemKitDefinition | Kit Definition |
| last_modified_dts | (read only) string (dateTime) | Date/time of last modification |
| merchant_id | string(5) | UltraCart merchant ID owning item |
| merchant_item_id | string(20) | Unique item id assigned to this item |
| merchant_item_oid | (read only) integer (int32) | Unique object identifier for this item |
| options | array of ItemOption | Options |
| parent_category_id | integer (int32) | Parent category of the item. Zero indicates the root folder. |
| parent_category_path | string | Parent category path. / indicates the root folder. |
| payment_processing | ItemPaymentProcessing | Payment Processing |
| physical | ItemPhysical | Physical characters like weight and measurements |
| pricing | ItemPricing | Pricing |
| properties | array of ItemProperty | Properties |
| realtime_pricing | ItemRealtimePricing | Real-time Pricing |
| recommend_replenishment_days | integer (int32) | Number of days to recommend replenishment after. Null is not configured. Set to zero to disable. |
| related | ItemRelated | Related items |
| reporting | ItemReporting | Reporting |
| restriction | ItemRestriction | Restrictions |
| revguard | ItemRevguard | Revguard.com (Deprecated) |
| reviews | ItemReviews | Reviews |
| salesforce | ItemSalesforce | Salesforce.com configuration |
| shipping | ItemShipping | Shipping |
| tags | ItemTags | Tags |
| tax | ItemTax | Tax settings |
| third_party_email_marketing | array of ItemThirdPartyEmailMarketing | 3rd Party Email Marketing |
| variant_items | array of ItemVariantItem | Variant Items |
| variations | array of ItemVariation | Variations |
| wishlist_member | ItemWishlistMember | WishList Member |
| Name | Data Type | Description |
|---|---|---|
| accounting_code | string(50) | QuickBooks item name if different than the item id |
| qb_class | string(31) | QuickBooks class if you are classifying items on your invoices/receipts |
| Name | Data Type | Description |
|---|---|---|
| amember_payment_duration_days | integer (int32) | The number of days that the customer should be given access to the item |
| amember_product_id | string(10) | A-member product id give customer access to when they purchase this item |
| Name | Data Type | Description |
|---|---|---|
| auth_future_amount | number | Amount to try and authorize for the future rebill |
| auth_test_amount | number | Amount to try and test authorize |
| auto_order_cancel_charge_minimum_balance | boolean | If true, the cost of the cancel item will be the remaining balance of the minimum rebill or lifetime value |
| auto_order_cancel_item_id | string(20) | Item id to attempt charging the customer for if they cancel |
| auto_order_cancel_item_oid | integer (int32) | Item object identifier to attempt charging the customer for if they cancel |
| auto_order_cancel_minimum_life_time_count | integer (int32) | The minimum life time count that must be billed in order to not be charged the cancellation item. |
| auto_order_cancel_minimum_life_time_value | number | The minimum life time value that must be paid in order to not be charged the cancellation item. |
| auto_order_cancel_minimum_rebill_count | integer (int32) | The minimum rebill count that must be billed in order to not be charged the cancellation item. |
| auto_order_cancel_minimum_rebill_value | number | The minimum rebill value that must be paid in order to not be charged the cancellation item. |
| auto_order_downgrade_items | array of string | List of downgrade items presented to customer service representatives |
| auto_order_paused | boolean | True if the rebill processing of this item is paused |
| auto_order_prohibit_expiring_cards | integer (int32) | Minimum number of months before expiration for the card. Overrides the account level setting if higher. Set to zero to disable. |
| auto_order_schedules | array of string | The user selectable schedules that are available
Allowed Values
|
| auto_order_upgrade_items | array of string | List of upgrade items presented to customer service representatives |
| auto_order_upsell | boolean | True if this item uses a fixed upsell step schedule |
| auto_order_upsell_no_easy_cancel | boolean | Do not send the easy cancel email to the customer |
| auto_order_upsell_one_per_customer | boolean | Limit the purchase of this item to one per customer |
| auto_orderable | boolean | True if this item can be automatically ordered by the customer |
| cancel_other_auto_orders | boolean | True if other auto orders for this customer should be canceled when this item is ordered |
| free_shipping_auto_order | boolean | True if the customer should be given free shipping |
| refund_other_auto_orders | boolean | True if other auto orders for this customer should refunded if this item is refunded. |
| steps | array of ItemAutoOrderStep | The rebill steps if this auto order is an upsell |
| Name | Data Type | Description |
|---|---|---|
| arbitrary_schedule_days | integer (int32) | If the schedule is arbitrary, then this is the number of days |
| arbitrary_unit_cost | number | Arbitrary unit cost used to override the regular item cost |
| arbitrary_unit_cost_schedules | array of ItemAutoOrderStepArbitraryUnitCostSchedule | Arbitrary unit costs schedules for more advanced discounting by rebill attempt |
| grandfather_pricing | array of ItemAutoOrderStepGrandfatherPricing | Grand-father pricing configuration if the rebill schedule has changed over time |
| managed_by | string | Managed by (defaults to UltraCart)
Allowed Values
|
| pause_days | integer (int32) | Number of days to pause |
| pause_until_date | string (dateTime) | Wait for this step to happen until the specified date |
| pause_until_day_of_month | integer (int32) | Pause until a specific day of the month |
| pause_until_minimum_delay_days | integer (int32) | Pause at least this many days between the last order and the calculated next day of month |
| preshipment_notice_days | integer (int32) | If set, a pre-shipment notice is sent to the customer this many days in advance |
| recurring_merchant_item_id | string(20) | Item id to rebill |
| recurring_merchant_item_oid | integer (int32) | Item object identifier to rebill |
| repeat_count | integer (int32) | Number of times to rebill. Last step can be null for infinite |
| schedule | string | Frequency of the rebill
Allowed Values
|
| subscribe_email_list_name | string | Email list name to subscribe the customer to when the rebill occurs (decommissioned email engine) |
| subscribe_email_list_oid | integer (int32) | Email list identifier to subscribe the customer to when this rebill occurs (decommissioned email engine) |
| type | string | Type of step (item, kit only, loop or pause)
Allowed Values
|
| Name | Data Type | Description |
|---|---|---|
| arbitrary_unit_cost | number | Arbitrary unit cost |
| retry_days | integer (int32) | Retry days |
| Name | Data Type | Description |
|---|---|---|
| on_or_before_date | string (dateTime) | On or before date |
| unit_cost | number | Unit cost |
| Name | Data Type | Description |
|---|---|---|
| ccbill_allowed_currencies | string | Allowed currencies |
| ccbill_allowed_types | string | Allowed types |
| ccbill_currency_code | string | Currency code |
| ccbill_form_name | string | Form name |
| ccbill_subaccount_id | string | Sub-account id |
| ccbill_subscription_type_id | string | Subscription type id |
| Name | Data Type | Description |
|---|---|---|
| barcode_ua | string | Barcode UA (EDI only) |
| barcode_uc | string | Barcode UC (EDI only) |
| barcode_ui | string | Barcode UI (EDI only) |
| barcode_uk | string | Barcode UK (EDI only) |
| buyer_catalog_number | string | Buyer catalog number (EDI only) |
| buyer_dpci | string | Buyer DPCI (EDI only) |
| buyer_item_number | string | Buyer item number (EDI only) |
| channel_partner_code | string | Channel partner code |
| channel_partner_oid | integer (int32) | Channel partner object identifier |
| cost | number | Cost given to this channel partner |
| from_item_id | string(30) | From Item ID |
| from_sku | string(50) | From SKU |
| mutually_defined_number | string | Mutually defined number (EDI only) |
| quantity_ratio_cp | integer (int32) | Ratio (Channel Partner) |
| quantity_ratio_uc | integer (int32) | Ratio (UltraCart) |
| sku | string(50) | SKU |
| unit_of_measure | string | Unit of measure |
| vendor_number | string | Vendor number (EDI only) |
| vendor_style_number | string | Vendor style number (EDI only) |
| Name | Data Type | Description |
|---|---|---|
| addendums | array of ItemChargebackAddendum | Addendums (deprecated) |
| adjustment_requests | array of ItemChargebackAdjustmentRequest | Adjustment requests (deprecated) |
| Name | Data Type | Description |
|---|---|---|
| chargeback_addendum_oid | integer (int32) | Chargeback addendum object identifier |
| description | string | Description |
| file_size | integer (int32) | Size of the file |
| pages | integer (int32) | Number of pages |
| Name | Data Type | Description |
|---|---|---|
| chargeback_adjustment_request_oid | integer (int32) | Chargeback adjustment request object identifier |
| description | string | Description |
| reason_code | string | Reason code |
| Name | Data Type | Description |
|---|---|---|
| suppress_buysafe | boolean | True to suppress buySAFE (deprecated) |
| terms | string(10000) | Terms for purchasing this item |
| terms_if_auto_order | boolean | Terms only apply if the item is on auto order |
| terms_translated_text_instance_oid | (read only) integer (int32) | Terms translated text instance identifier |
| Name | Data Type | Description |
|---|---|---|
| assignments | array of ItemContentAssignment | StoreFront assignments |
| attributes | array of ItemContentAttribute | StoreFront attributes |
| custom_thank_you_url | string | Custom Thank You URL |
| exclude_from_search | boolean | Exclude from search |
| exclude_from_sitemap | boolean | Exclude from the sitemap for the StoreFront |
| exclude_from_top_sellers | boolean | Exclude from the top sellers list in the StoreFront |
| extended_description | string(10000) | Extended description (max 10000 characters) |
| extended_description_translated_text_instance_oid | (read only) integer (int32) | Extneded description text translation instance identifier |
| multimedia | array of ItemContentMultimedia | Multimedia |
| new_item | boolean | True if the item is new |
| new_item_end | string (dateTime) | The date the item should no longer be considered new |
| new_item_start | string (dateTime) | The date the item should start being considered new |
| view_url | string | Legacy view URL (not used by StoreFronts) |
| Name | Data Type | Description |
|---|---|---|
| default_assignment | boolean | True if this group is the default assignment for this item |
| group_oid | integer (int32) | Page (group) object identifier |
| group_path | string | Page (group) path |
| host | string | StoreFront host name |
| sort_order | integer (int32) | Sort order (optional) |
| url_part | string(150) | URL part if the item id is not used |
| Name | Data Type | Description |
|---|---|---|
| name | string(400) | Attribute name |
| translated_text_instance_oid | (read only) integer (int32) | Attribute translated text instance identifier |
| type | string | Attribute type
Allowed Values
|
| value | string(100000) | Attribute value |
| Name | Data Type | Description |
|---|---|---|
| cloud_url | (read only) string | URL where the image can be downloaded from the cloud |
| cloud_url_expiration | (read only) string (dateTime) | Expiration date of the cloud URL |
| code | string(20) | Code assigned to the file |
| description | string(50000) | Description |
| exclude_from_gallery | boolean | True to exclude from multimedia gallery |
| file_name | string(75) | File name |
| height | integer (int32) | Height of the image |
| merchant_item_multimedia_oid | integer (int32) | Item multimedia object identifier |
| orphan | boolean | True if the multimedia is an orphan of the active StoreFront themes |
| placeholder | boolean | True if the object is a place holder that can be populated |
| temp_multimedia_oid | integer (int32) | Temporary multimedia object identifier assigned if uploading new multimedia |
| thumbnails | array of ItemContentMultimediaThumbnail | Thumbnails of this image |
| type | string | Type of file
Allowed Values
|
| url | string | URL to download file (on new multimedia record this can be a URL for UltraCart to fetch) |
| width | integer (int32) | Width of the image |
| Name | Data Type | Description |
|---|---|---|
| height | integer (int32) | Height of the thumbnail |
| http_url | string | HTTP URL to view the thumbnail |
| https_url | string | HTTPS URL to view the thumbnail |
| png_format | boolean | True if PNG, false if JPEG |
| square | boolean | True if the thumbnail is square |
| width | integer (int32) | Width of the thumbnail |
| Name | Data Type | Description |
|---|---|---|
| activation_code_description | string(50) | Description of the activation code |
| activation_code_low_warning | integer (int32) | The number of activation codes whcih should generate a warning email |
| activation_code_realtime_url | string(350) | The URL to retrieve activation codes from in real-time |
| activation_code_shared_secret | string(20) | Shared secret used when communicating with the real-time URL |
| activation_code_type | string | Type of activation code
Allowed Values
|
| digital_items | array of ItemDigitalItem | Digital items that customer can download when this item is purchased |
| Name | Data Type | Description |
|---|---|---|
| click_wrap_agreement | string | Click wrap agreement is presented to the customer before they can purchase your product. |
| creation_dts | (read only) string (dateTime) | File creation date |
| description | string(200) | Description of the digital item |
| digital_item_oid | integer (int32) | The Digital item oid is a primary key used internally by UltraCart. You should not set or change this value. Doing so will have no effect. |
| external_id | string(100) | External Id useful for syncing with a remote filesystem, this may be an MD5 hash or whatever suits your needs. |
| file_size | (read only) integer (int64) | File size |
| import_from_url | string | This url is sourced to create or update a digital file in your digital library. It is only considered during an insert or update operation. |
| mime_type | (read only) string(100) | Mime type associated with the file |
| original_filename | string(250) | Original filename |
| pdf_meta | ItemDigitalItemPdfMeta | Additional properties for pdf files |
| Name | Data Type | Description |
|---|---|---|
| assembly_allowed | boolean | Assembly allowed |
| copy_allowed | boolean | Copy/Paste is allowed |
| custom_footer | string(8000) | A custom footer for each pdf page |
| custom_header | string(8000) | A custom header for each pdf page |
| degraded_printing_allowed | boolean | Degraded printing allowed |
| fillin_allowed | boolean | Fillin is allowed |
| modify_annotations_allowed | boolean | Modifying annotations is allowed |
| modify_contents_allowed | boolean | Modifying contents is allowed |
| printing_allowed | boolean | Printing is allowed |
| screen_readers_allowed | boolean | Screen readers are allowed |
| tagged | boolean | PDF is tagged |
| Name | Data Type | Description |
|---|---|---|
| active | boolean | True if the item is active for listing |
| category_id | integer (int32) | e-Bay category ID |
| category_specifics | array of ItemEbayCategorySpecific | Answers to category specific questions |
| condition_description | string | Description of the condition (e-Bay constant) |
| condition_id | integer (int32) | Numerical ID of the condition (e-Bay constant) |
| consecutive_failures | integer (int32) | Number of consecutive failures trying to list this item |
| custom_category1 | integer (int64) | e-Bay Store category 1 |
| custom_category2 | integer (int64) | e-Bay Store category 2 |
| dispatch_time_max | integer (int32) | Maximum number of days it will take to ship the item |
| domestic_1_additional_cost | number | Domestic 1 method additional item cost |
| domestic_1_first_cost | number | Domestic 1 method first item cost |
| domestic_2_additional_cost | number | Domestic 2 method additional item cost |
| domestic_2_first_cost | number | Domestic 2 method first item cost |
| domestic_3_additional_cost | number | Domestic 3 method additional item cost |
| domestic_3_first_cost | number | Domestic 3 method first item cost |
| domestic_4_additional_cost | number | Domestic 4 method additional item cost |
| domestic_4_first_cost | number | Domestic 4 method first item cost |
| ebay_auction_id | string | If listed, this is the e-Bay auction id |
| ebay_specific_inventory | integer (int32) | e-Bay specific inventory |
| ebay_template_name | string | The template name to use hwen rendering the e-Bay listing |
| ebay_template_oid | integer (int32) | The template object identifier to use when rendering the e-Bay listing |
| end_time | (read only) string (dateTime) | Date/time of the auction end |
| free_shipping | boolean | True if item receives free shipping |
| free_shipping_method | string | The method that is free for free shipping |
| international_1_additional_cost | number | International 1 method additional item cost |
| international_1_first_cost | number | International 1 method first item cost |
| international_2_additional_cost | number | International 2 method additional item cost |
| international_2_first_cost | number | International 2 method first item cost |
| international_3_additional_cost | number | International 3 method additional item cost |
| international_3_first_cost | number | International 3 method first item cost |
| international_4_additional_cost | number | International 4 method additional item cost |
| international_4_first_cost | number | International 4 method first item cost |
| last_status_dts | (read only) string (dateTime) | Date/time of the last status check |
| listed_dispatch_time_max | integer (int32) | Current listing dispatch time maximum |
| listed_ebay_template_oid | integer (int32) | The template object identifier used for the listing |
| listing_dts | (read only) string (dateTime) | Date/time of the listing |
| listing_duration | string | The duration of the listing
Allowed Values
|
| listing_price | number | Price to list the item at |
| listing_price_override | number | The price to list the item at if different than the regular UltraCart item price |
| listing_type | string | The type of e-Bay listing |
| marketplace_analysis | (read only) ItemEbayMarketPlaceAnalysis | Details of the marketplace analysis |
| marketplace_analysis_perform | boolean | True if marketplace analysis should be performed |
| marketplace_final_value_fee_percentage | number | Marketplace FVF percentage |
| marketplace_last_check_dts | (read only) string (dateTime) | Date/time of the marketplace analysis last check |
| marketplace_lowest | (read only) boolean | True if we are the lowest offer in the marketplace |
| marketplace_map_violation | (read only) boolean | True if another seller is violating MAP |
| marketplace_multiplier | number | Marketplace multiplier |
| marketplace_other_price | (read only) number | Marketplace other price |
| marketplace_other_seller | (read only) string | Marketplace other seller |
| marketplace_other_shipping | (read only) number | Marketplace other shipping |
| marketplace_other_total | (read only) number | Marketplace other total |
| marketplace_our_additional_profit_potential | number | Marketplace our additional profit potential |
| marketplace_our_price | (read only) number | Marketplace our price |
| marketplace_our_profit | (read only) number | Marketplace our profit |
| marketplace_our_shipping | (read only) number | Marketplace our shipping |
| marketplace_our_total | (read only) number | Marketplace our total |
| marketplace_overhead | number | Marketplace overhead |
| marketplace_profitable | (read only) boolean | True if our listing is profitable to sell |
| next_attempt_dts | (read only) string (dateTime) | Date/time for the next attempt to list |
| next_listing_duration | string | The next listing duration to use when the current listing ends.
Allowed Values
|
| no_promotional_shipping | boolean | True if the item should not qualify for promotional shipping |
| packaging_handling_costs | number | Packaging and handling costs |
| previous_ebay_auction_id | (read only) string | Previous e-Bay auction id |
| quantity | integer (int32) | Quantity available of the item |
| reserve_price | number | Reserve price |
| send_dimensions_and_weight | string | How to send the item dimensions and weights to e-Bay
Allowed Values
|
| start_time | (read only) string | Date/time of the auction start |
| status | string | Status of the item's listing
Allowed Values
|
| target_dispatch_time_max | integer (int32) | Typical number of days it will take to ship the item |
| Name | Data Type | Description |
|---|---|---|
| name | string | Name of the category specification field |
| value | string | Value |
| Name | Data Type | Description |
|---|---|---|
| auction_id | string | Auction ID |
| price | number | Price |
| seller | string | Seller |
| shipping | number | Shipping |
| total | number | Total |
| Name | Data Type | Description |
|---|---|---|
| adjusted_price | number | Adjusted price |
| adjusted_shipping | number | Adjusted shipping |
| adjusted_total | number | Adjusted total |
| cogs | number | Cost of goods sold |
| final_value_fee | number | Final value fee |
| minimum_advertised_price | number | Minimum advertised price |
| other_listings | array of ItemEbayMarketListing | Other listings |
| our_listing | ItemEbayMarketListing | Our listing |
| overhead | number | Overhead |
| profit_potential | number | Profit potential |
| Name | Data Type | Description |
|---|---|---|
| skip_receipt | boolean | Skip receipt email to customer |
| skip_shipment_notification | boolean | Skip shipment notification to customer |
| Name | Data Type | Description |
|---|---|---|
| enrollment123_product_code | string | Enrolment 123 product code |
| Name | Data Type | Description |
|---|---|---|
| add_item_id | (read only) string | Add Item Id |
| add_item_oid | integer (int32) | Add Item object identifier |
| initial_order_only | boolean | Initial Order Only |
| once_per_order | boolean | Once Per Order |
| quantity | integer (int32) | Quantity |
| Name | Data Type | Description |
|---|---|---|
| gift_certificate | boolean | True if the purchase of this item generates a gift certificate |
| gift_certificate_expiration_days | integer (int32) | The number of days that the gift certificate is good for (optional) |
| Name | Data Type | Description |
|---|---|---|
| adwords_grouping | string(50) | Adwords grouping |
| adwords_label1 | string(50) | Adwords label 1 |
| adwords_label2 | string(50) | Adwords label 2 |
| adwords_label3 | string(50) | Adwords label 3 |
| adwords_label4 | string(50) | Adwords label 4 |
| adwords_label5 | string(50) | Adwords label 5 |
| age_group | string(5) | Age group |
| available_at_physical_store | boolean | Available at physical store |
| book_author | string(50) | Book - author |
| book_format | string(50) | Book - format |
| book_isbn | string(20) | Bood - ISBN |
| book_publisher | string(50) | Book - publisher |
| category_description | string(1000) | Category description |
| color | string(100) | Color |
| condition | string(15) | Condition |
| custom_label0 | string(50) | Custom label 0 |
| custom_label1 | string(50) | Custom label 1 |
| custom_label2 | string(50) | Custom label 2 |
| custom_label3 | string(50) | Custom label 3 |
| custom_label4 | string(50) | Custom label 4 |
| gender | string(6) | Gender |
| google_product_category | string(250) | Google product category |
| music_artist | string(50) | Music - artist |
| music_format | string(5) | Music - format |
| music_release_date | string (dateTime) | Music - release date |
| omit_from_feed | boolean | Omit from feed |
| product_type | string(10) | Product type |
| promotion_id1 | string(30) | Promotion ID 1 |
| promotion_id10 | string(30) | Promotion ID 10 |
| promotion_id2 | string(30) | Promotion ID 2 |
| promotion_id3 | string(30) | Promotion ID 3 |
| promotion_id4 | string(30) | Promotion ID 4 |
| promotion_id5 | string(30) | Promotion ID 5 |
| promotion_id6 | string(30) | Promotion ID 6 |
| promotion_id7 | string(30) | Promotion ID 7 |
| promotion_id8 | string(30) | Promotion ID 8 |
| promotion_id9 | string(30) | Promotion ID 9 |
| search_dts | string (dateTime) | Search date/time |
| search_lowest_price | number | Search lowest price |
| search_lowest_url | string(250) | Search lowest URL |
| search_position | integer (int32) | Search position |
| shippingLabel | string | |
| size | string(20) | Size |
| video_director | string(50) | Video - director |
| video_format | string(5) | Video - format |
| video_rating | string(5) | Video - rating |
| video_release_date | string (dateTime) | Video - release date |
| video_starring | string(150) | Video - starring |
| Name | Data Type | Description |
|---|---|---|
| barcode | string(30) | Barcode |
| barcode_gtin12 | string(12) | Barcode - GTIN 12 |
| barcode_gtin14 | string(14) | Barcode - GTIN 14 |
| barcode_upc11 | string(11) | Barcode - UPC 11 |
| barcode_upc12 | string(12) | Barcode - UPC 12 |
| manufacturer_name | string(50) | Manufacturer Name |
| manufacturer_sku | string(25) | Manufacturer SKU |
| unspsc | string(20) | UNSPSC |
| Name | Data Type | Description |
|---|---|---|
| post_operation | boolean | True for HTTP POST instead of GET |
| successful_response_text | string(1024) | Successful response text |
| url | string(1024) | URL |
| Name | Data Type | Description |
|---|---|---|
| notifications | array of ItemInstantPaymentNotification | Notifications |
| Name | Data Type | Description |
|---|---|---|
| memo | string(250) | Memo |
| Name | Data Type | Description |
|---|---|---|
| component_cost | number | Component item cost |
| component_description | (read only) string | Component item description |
| component_merchant_item_id | string | Component item ID |
| component_merchant_item_oid | integer (int32) | Component item object identifier |
| quantity | integer (int32) | Quantity |
| Name | Data Type | Description |
|---|---|---|
| components | array of ItemKitComponent | Components |
| Name | Data Type | Description |
|---|---|---|
| cost_if_specified | number | Cost if specified |
| cost_per_letter | number | Cost per letter |
| cost_per_line | number | Cost per line |
| ignore_if_default | boolean | Ignore this option on the order if the default value is selected |
| label | string(50) | Label |
| label_translated_text_instance_oid | (read only) integer (int32) | Label translated text instance ID |
| name | string(50) | Name |
| name_translated_text_instance_oid | (read only) integer (int32) | Name translated text instance ID |
| one_time_fee | boolean | One time fee |
| option_oid | integer (int32) | Option object identifier |
| required | boolean | True if the customer is required to specify an answer |
| system_option | boolean | True if this is a system option |
| type | string | Type of option
Allowed Values
|
| values | array of ItemOptionValue | Values |
| Name | Data Type | Description |
|---|---|---|
| additional_dimension_application | string | Additional dimensions application
Allowed Values
|
| additional_items | array of ItemOptionValueAdditionalItem | Additional items to add to the order if this value is selected |
| cost_change | number | Cost change |
| default_value | boolean | True if default value |
| digital_items | array of ItemOptionValueDigitalItem | Digital items to allow the customer to download if this option value is selected |
| height | Distance | If additional_dimension_application != none Additional dimensions (height) |
| length | Distance | If additional_dimension_application != none Additional dimensions (length) |
| merchant_item_multimedia_oid | integer (int32) | Multimedia object identifier associated with this option value |
| option_value_oid | integer (int32) | Option value object identifier |
| percent_cost_change | number | Percentage cost change |
| translated_text_instance_oid | (read only) integer (int32) | Translated text instance id |
| value | string(1024) | Value |
| weight_change | Weight | Weight change |
| weight_change_percent | number | Percentage weight change |
| width | Distance | If additional_dimension_application != none Additional dimensions (width) |
| Name | Data Type | Description |
|---|---|---|
| additional_merchant_item_id | string | Additional item id |
| additional_merchant_item_oid | integer (int32) | Additional item object identifier |
| Name | Data Type | Description |
|---|---|---|
| digital_item_oid | integer (int32) | Digital item object identifier |
| original_filename | string | Original filename |
| Name | Data Type | Description |
|---|---|---|
| block_prepaid | boolean | True if prepaid cards should be blocked from buying this item |
| credit_card_transaction_type | string | Credit card transaction type
Allowed Values
|
| no_realtime_charge | boolean | True if no real-time charge should be performed on this item. |
| payment_method_validity | array of string | Payment method validity
Allowed Values
|
| rotating_transaction_gateway_codes | array of string | Rotating transaction gateway codes |
| Name | Data Type | Description |
|---|---|---|
| height | Distance | Height |
| length | Distance | Length |
| weight | Weight | Weight |
| width | Distance | Width |
| Name | Data Type | Description |
|---|---|---|
| allow_arbitrary_cost | boolean | Allow arbitrary cost |
| arbitrary_cost_velocity_code | string(10000) | Arbitrary cost velocity code |
| auto_order_cost | number | Cost if customer selects to receive item on auto order. Set to zero to delete. |
| automatic_pricing_tier_name | string | Automatic pricing tier name |
| automatic_pricing_tier_oid | integer (int32) | Automatic pricing tier object identifier |
| cogs | number | Cost of goods sold |
| cost | number | Cost |
| currency_code | string(3) | Currency code
Allowed Values
|
| manufacturer_suggested_retail_price | number | Manufacturer suggested retail price |
| maximum_arbitrary_cost | number | Maximum arbitrary cost |
| minimum_advertised_price | number | Minimum advertised price |
| minimum_arbitrary_cost | number | Minimum arbitrary cost |
| mix_and_match_group | string | Mix and match group |
| mix_and_match_group_oid | integer (int32) | Mix and match group object identifier |
| sale_cost | number | Sale cost |
| sale_end | string (dateTime) | If sale_cost specified Sale end |
| sale_start | string (dateTime) | If sale_cost specified Sale start |
| tiers | array of ItemPricingTier | Tiers |
| Name | Data Type | Description |
|---|---|---|
| default_tier | (read only) boolean | True if this is the default tier |
| discounts | array of ItemPricingTierDiscount | Discounts |
| limit | ItemPricingTierLimit | Limits |
| name | (read only) string | Pricing tier name |
| pricing_tier_oid | (read only) integer (int32) | Pricing tier object identifier |
| Name | Data Type | Description |
|---|---|---|
| cost | number | Cost |
| quantity | integer (int32) | Quantity |
| Name | Data Type | Description |
|---|---|---|
| cumulative_order_limit | integer (int32) | Cumulative order limit |
| exempt_from_minimum_item_count | boolean | Exempt from Minimum Item Count |
| individual_order_limit | integer (int32) | Individual order limit |
| multiple_quantity | integer (int32) | Multiple quantity |
| payment_method_validity | array of string | Payment method validity
Allowed Values
|
| Name | Data Type | Description |
|---|---|---|
| expirationDts | (read only) string (dateTime) | Expiration of the property |
| name | string(100) | Property name |
| value | string(1000) | Property value |
| Name | Data Type | Description |
|---|---|---|
| realtime_pricing_parameter | string | Real-time pricing provider parameters |
| realtime_pricing_provider | string | Real-time pricing provider name |
| realtime_pricing_provider_oid | integer (int32) | Real-time pricing provide object identifier |
| Name | Data Type | Description |
|---|---|---|
| no_system_calculated_related_items | boolean | True to suppress system calculated relationships |
| not_relatable | boolean | Not relatable |
| related_items | array of ItemRelatedItem | Related items |
| Name | Data Type | Description |
|---|---|---|
| related_merchant_item_id | string | Related item id |
| related_merchant_item_oid | integer (int32) | Related item object identifier |
| type | string | Relationship type
Allowed Values
|
| Name | Data Type | Description |
|---|---|---|
| report_as_upsell | boolean | Report as an upsell |
| report_pickable_quantities | array of integer (int32) | Report pickable quantities (deprecated) |
| Name | Data Type | Description |
|---|---|---|
| exclude_coupon | boolean | Exclude coupons |
| exclude_from_free_promotion | boolean | Exclude from free promotion |
| items | array of ItemRestrictionItem | Items |
| maximum_quantity | integer (int32) | Maximum quantity |
| minimum_quantity | integer (int32) | Minimum quantity (defaults to 1) |
| multiple_quantity | integer (int32) | Multiple of quantity |
| one_per_customer | boolean | One per customer |
| purchase_separately | boolean | Purchase separately |
| Name | Data Type | Description |
|---|---|---|
| restrict_merchant_item_id | string | Restrict item id |
| restrict_merchant_item_oid | integer (int32) | Restrict item object identifier |
| type | string | Restriction type
Allowed Values
|
| Name | Data Type | Description |
|---|---|---|
| revguard_canceled_csr_prompt_group | integer (int64) | Canceled CSR prompt group |
| revguard_canceled_ivr_prompt_group | integer (int64) | IVR prompt group |
| revguard_canceled_web_prompt_group | integer (int64) | Canceled web prompt group |
| revguard_client_brand | integer (int64) | Client brand |
| revguard_csr_prompt_group | integer (int64) | CSR prompt group |
| revguard_ivr_prompt_group | integer (int64) | IVR prompt group |
| revguard_web_prompt_group | integer (int64) | Web prompt group |
| Name | Data Type | Description |
|---|---|---|
| customer_profile_oid | integer (int32) | Customer profile object identifier |
| featured | boolean | |
| helperful_no_votes | integer (int32) | |
| helpful_yes_votes | integer (int32) | |
| order_id | string | |
| overall | number | |
| rating_name1 | string(100) | Rating Name 1 |
| rating_name10 | string(100) | Rating Name 10 |
| rating_name2 | string(100) | Rating Name 2 |
| rating_name3 | string(100) | Rating Name 3 |
| rating_name4 | string(100) | Rating Name 4 |
| rating_name5 | string(100) | Rating Name 5 |
| rating_name6 | string(100) | Rating Name 6 |
| rating_name7 | string(100) | Rating Name 7 |
| rating_name8 | string(100) | Rating Name 8 |
| rating_name9 | string(100) | Rating Name 9 |
| rating_score1 | number | |
| rating_score10 | number | |
| rating_score2 | number | |
| rating_score3 | number | |
| rating_score4 | number | |
| rating_score5 | number | |
| rating_score6 | number | |
| rating_score7 | number | |
| rating_score8 | number | |
| rating_score9 | number | |
| recommend_store_to_friend | integer (int32) | |
| recommend_to_friend | boolean | |
| review | string(10000) | Review |
| review_oid | integer (int32) | |
| reviewed_nickname | string(25) | Nickname |
| reviewer_email | string(100) | Reviewer Email |
| reviewer_location | string(25) | Location |
| status | string | Status of the review
Allowed Values
|
| store_feedback | string(10000) | Store Feedback |
| submitted_dts | string (dateTime) | Date/time of review submission |
| title | string(250) | Title |
| Name | Data Type | Description |
|---|---|---|
| has_approved_review | (read only) boolean | True if the item has an approved review |
| has_review | (read only) boolean | True if the item has a review |
| individual_reviews | array of ItemReview | |
| review_count | (read only) integer (int32) | Number of approved reviews |
| review_overall | (read only) number | Overall score of reviews |
| review_template_name | string | Review template name |
| review_template_oid | integer (int32) | Review template object identifier |
| reviewable | boolean | True if the item is reviewable |
| share_reviews_with_merchant_item_id | (read only) string | Share reviews with item id. To set, use the share_reviews_with_merchant_item_oid field. |
| share_reviews_with_merchant_item_oid | integer (int32) | Share reviews with item oid. To null out this field, set teh value to zero. |
| Name | Data Type | Description |
|---|---|---|
| sfdc_pricebook_id | string | Salesforce.com pricebook id |
| sfdc_product_id | string | Salesforce.com product id |
| Name | Data Type | Description |
|---|---|---|
| allow_back_order | boolean | Allow back order |
| amazon_fba | boolean | Fulfillment by Amazon.com |
| case_inner_packs | integer (int32) | Case inner packs |
| case_units | integer (int32) | Case units |
| cases | array of ItemShippingCase | Cases |
| collect_serial_numbers | boolean | This item is on pre-order |
| country_code_of_origin | string(2) | Country code of origin for customs forms. (ISO-3166 two letter code) |
| customs_description | string | Customs description |
| customs_value | number | Customs value |
| delivery_on_friday | boolean | Delivery on Friday |
| delivery_on_monday | boolean | Delivery on Monday |
| delivery_on_saturday | boolean | Delivery on Saturday |
| delivery_on_sunday | boolean | Delivery on Sunday |
| delivery_on_thursday | boolean | Delivery on Thursday |
| delivery_on_tuesday | boolean | Delivery on Tuesday |
| delivery_on_wednesday | boolean | Delivery on Wednesday |
| destination_markups | array of ItemShippingDestinationMarkup | Destination markups |
| destination_restrictions | array of ItemShippingDestinationRestriction | Destination restrictions |
| distribution_centers | array of ItemShippingDistributionCenter | Distribution centers |
| eta | string (dateTime) | Estimated time of arrival |
| free_shipping | boolean | Qualifies for free shipping |
| freight_class | string | Freight class |
| hazmat | boolean | Hazardous material |
| hold_for_transmission | boolean | Hold for transmission |
| made_to_order | boolean | True if this item is made to order |
| made_to_order_lead_time | integer (int32) | Number of days lead time it takes to make the item before ite can ship |
| max_days_time_in_transit | integer (int32) | Maximum days allowed in transit |
| methods | array of ItemShippingMethod | Methods |
| no_shipping_discount | boolean | No shipping discounts |
| package_requirements | array of ItemShippingPackageRequirement | Package requirements |
| perishable_class |